// GLOSSÁRIO · WABA
Glossário da
API Oficial do WhatsApp
Os termos técnicos da API Oficial (WABA) explicados em pt-BR — definições curtas, contexto de uso e referências cruzadas. Use o índice abaixo para saltar direto ao termo, ou role para navegar todo o glossário.
WABA — WhatsApp Business API
// Canal corporativo oficial da Meta que permite empresas enviar e receber mensagens em escala via API HTTPS, com número dedicado e suporte oficial.
- A WhatsApp Business API (WABA) é o produto da Meta voltado para uso corporativo do WhatsApp em escala. Diferente do WhatsApp pessoal e do WhatsApp Business app, a WABA exige um número dedicado, é acessada via endpoints HTTPS oficiais e cobra por conversa iniciada. É o único canal autorizado pela Meta para disparo em massa e integrações comerciais.
BSP — Business Solution Provider
// Parceiro homologado pela Meta que intermedia o acesso à API Oficial. Pode revender com markup ou apenas hospedar a infraestrutura.
- BSPs (Business Solution Providers) são empresas autorizadas pela Meta a fornecer acesso à API Oficial. Alguns BSPs operam como SaaS de fachada (com markup no preço por mensagem); outros são apenas pontos de entrada técnicos. Empresas que vão direto pela Meta (sem BSP intermediário) economizam markup mas precisam configurar a infraestrutura própria.
Template
// Mensagem pré-aprovada pela Meta que pode ser enviada para iniciar conversa fora da janela de 24h. Categorizada como utilidade, marketing ou autenticação.
- Templates são modelos de mensagem aprovados manualmente pela Meta antes do uso. Servem para iniciar conversa com um contato fora da janela de 24h. Aprovação leva até 24h. Cada template tem categoria fiscal: utilidade (~R$0,04/conversa), marketing (~R$0,34/conversa) ou autenticação (~R$0,04/conversa). Templates mal-formados ou enganosos são rejeitados pela Meta.
Conversation (conversa)
// Unidade tarifária da Meta: janela de 24h iniciada por uma mensagem da empresa ou pelo cliente. Mensagens dentro da janela contam como uma conversa só.
- A Meta cobra a API Oficial por conversa, não por mensagem individual. Uma conversa é uma janela de 24h aberta por uma mensagem inicial. Dentro dessa janela, qualquer número de mensagens trocadas com o mesmo contato conta como uma conversa única. Existem categorias: marketing, utilidade, autenticação e serviço (essa última é grátis quando iniciada pelo cliente).
Tier (limite de disparo)
// Sistema da Meta que limita conversas iniciadas por dia. Sobe automaticamente conforme score de qualidade: 250 → 1k → 10k → 100k → ilimitado.
- Tier é o limite diário de conversas que uma BM pode iniciar. BM nova começa em 250/dia. BM verificada começa em 2.000/dia. Sete dias mantendo qualidade boa libera 10.000/dia. Mais sete dias libera 100.000/dia. Após isso, ilimitado. Score de qualidade baixo trava upgrade ou rebaixa o tier.
Quality Score (score de qualidade)
// Métrica da Meta que avalia a saúde do número. Calculada com base em bloqueios, reportes de spam, taxa de leitura e engajamento. Verde / amarelo / vermelho.
- Quality score reflete como os contatos respondem às mensagens da empresa. Sinais negativos: bloqueios, reportes de spam, taxa de leitura baixa. Sinais positivos: respostas, leituras rápidas. Score baixo (vermelho) trava upgrade de tier e pode levar à pausa do número. O painel Meta exibe o status em janelas de 24h e 7 dias.
BM — Business Manager
// Conta corporativa da Meta que agrega ativos: páginas, contas de anúncio, números WhatsApp, BSPs. É o nível de governança onde mora a verificação de empresa.
- Business Manager é a estrutura corporativa da Meta. Cada empresa tem uma BM que pode hospedar múltiplas contas de anúncio, páginas e números WhatsApp. BM verificada (CNPJ aprovado) destrava recursos premium: começo em tier 2.000, selo verde Business e maior credibilidade nas verificações da Meta.
Phone Number ID
// Identificador único do número de WhatsApp dentro da API Oficial. Usado em todos os endpoints como parte da URL: /v20.0/<phone-number-id>/messages.
- Phone Number ID é o identificador interno que a Meta atribui ao número quando você cadastra na API Oficial. É diferente do número de telefone visível ao usuário. Aparece em todas as URLs de endpoint que enviam ou consultam mensagens. Você encontra no painel Meta na seção Configuração da API.
CTWA — Click-to-WhatsApp Ads
// Anúncio do Facebook/Instagram que abre conversa direto no WhatsApp. Conversas geradas têm janela de serviço de 72h gratuita (3x maior que a padrão).
- Click-to-WhatsApp Ads são anúncios pagos no Facebook ou Instagram que, ao serem clicados, abrem uma conversa pré-preenchida no WhatsApp. A grande vantagem é que essas conversas abrem uma janela de serviço de 72h gratuita — três vezes maior que a janela padrão de 24h. Estratégia popular para captação de leads no WhatsApp via tráfego pago.
Opt-in (consentimento)
// Consentimento explícito do contato para receber mensagens da empresa. Exigido pela Meta antes de enviar qualquer template.
- Opt-in é o consentimento documentado do contato para receber mensagens. Pode ser via formulário web (checkbox), conversa anterior, compra (pós-venda), ou clique em CTWA. A Meta exige que a empresa tenha registro do opt-in. Disparo em massa para listas sem opt-in é o caminho mais rápido para reportes de spam, downgrade de tier e banimento.
Webhook
// Endpoint HTTPS na sua infra que a Meta chama para entregar mensagens recebidas, status de entrega e mudanças de qualidade. Configurado no painel Meta.
- Webhook é a URL pública (HTTPS obrigatório) que você cadastra no painel Meta. Sempre que um contato manda mensagem, ou quando muda o status de entrega de uma mensagem da empresa, a Meta faz POST para essa URL com payload JSON. n8n, servidores próprios e Cloudfy podem ser destinos. A Meta valida via Verify Token na primeira inscrição.
Template de utilidade
// Categoria de template para mensagens transacionais: confirmação de pedido, lembrete, recibo, status de entrega. Custa ~R$0,04/conversa.
- Templates de utilidade têm preço reduzido (~R$0,04 por conversa) porque a Meta entende que servem ao contato — confirmar pedido, lembrar de compromisso, mandar recibo, notificar status de entrega. Para qualificar como utilidade, precisa ser ativado por uma ação prévia do contato. Tem taxa de bloqueio menor que marketing.
Template de marketing
// Categoria de template para promoção, oferta e campanha de aquisição. Custa ~R$0,34/conversa, 8x mais que utilidade.
- Templates de marketing são para mensagens promocionais — ofertas, lançamentos, campanhas para a base. Preço ~R$0,34 por conversa, oito vezes mais que utilidade. Estratégia de quem domina a API Oficial: usar utilidade sempre que possível, reservar marketing para casos com ROI claro (carrinho abandonado, retenção, base quente).
Service window (janela de serviço)
// Janela de 24h após o cliente responder ou iniciar conversa. Dentro dela, qualquer mensagem da empresa é gratuita.
- Service window é o intervalo de 24h aberto quando o cliente envia uma mensagem para a empresa. Durante essa janela, a empresa pode responder com qualquer texto, mídia, botão ou lista — sem custo Meta nem necessidade de template. Fora da janela, só template aprovado. Anúncios CTWA estendem essa janela para 72h.
Token Permanente
// Credencial de autenticação da API Oficial que não expira em 24h. Gerada via System User na BM, usada como Bearer Token nos endpoints.
- Token Permanente é a credencial usada para autenticar requests à API Oficial. Diferente do Access Token padrão (expira em 24h), o Permanente fica válido enquanto o System User da BM existir. Geração: BM → Configurações de Sistema → Adicionar Sistema → atribuir permissões WhatsApp → Gerar Token. Trate como senha — quem tiver o token tem acesso a enviar mensagens.
Relacionados: BSP · Template · Phone Number ID
Relacionados: Conversation (conversa) · Template de utilidade · Template de marketing
Relacionados: Template · Service window (janela de serviço) · CTWA
Relacionados: Quality Score (score de qualidade) · BM
Relacionados: Tier (limite de disparo) · BM
Relacionados: Tier (limite de disparo) · Phone Number ID
Relacionados: Service window (janela de serviço) · Conversation (conversa)
Relacionados: Template · Quality Score (score de qualidade)
Relacionados: WABA · Phone Number ID
Relacionados: Template · Template de marketing · Conversation (conversa)
Relacionados: Template · Template de utilidade · Conversation (conversa)
Relacionados: Conversation (conversa) · CTWA · Template
Relacionados: WABA · BM · Phone Number ID