Atualizado em 25/10/2026
WABA (WhatsApp Business Account) é a conta que, na API oficial do WhatsApp, reunia números, templates e cobrança de uma empresa. Desde o novo modelo de contas da Meta, implantado entre setembro e outubro de 2026, ela se dividiu em duas: a conta do WhatsApp, que guarda o número e a identidade da empresa, e a conta de mensagens, que guarda templates, cobrança e webhooks. O waba_id que você já usa continua funcionando e passou a identificar a conta de mensagens.
Este glossário reúne mais de 40 termos que aparecem na documentação da Meta, nos payloads e nos painéis, agrupados por assunto. Cada definição tem uma ou duas frases e, quando existe, um link para o artigo que aprofunda o tema. Para o panorama geral, comece pelo guia API Oficial do WhatsApp.
Contas e ativos
| Termo | O que é | Onde aparece |
|---|---|---|
| Portfólio empresarial | Conta da empresa na Meta (antes chamada Business Manager). Contém as contas do WhatsApp, as contas de mensagens, usuários e apps. É obrigatório. | business_id, Meta Business Suite |
| WABA (WhatsApp Business Account) | Conta que reunia números, templates e cobrança. No modelo novo, o ID dela passou a identificar a conta de mensagens. | waba_id |
| Conta de mensagens (Messaging account) | Guarda templates, forma de pagamento e assinaturas de webhook. Cada parceiro que atende um mesmo número tem a sua. | waba_id, aba “Contas de mensagens” |
| Conta do WhatsApp (WAAC) | Guarda o número, o perfil comercial e, no futuro, o nome de usuário. É sempre da empresa e pode ser compartilhada com parceiros. | Aba “Contas do WhatsApp” |
| Número de telefone comercial | Número registrado na Cloud API para enviar e receber mensagens. Pode ser celular, fixo ou virtual. | WhatsApp Manager |
| Phone Number ID | Identificador do número na API. Vai na URL de envio. Não é o número em si. | phone_number_id, POST /<PHONE_NUMBER_ID>/messages |
| display_phone_number | O número formatado, do jeito que aparece para as pessoas. | Webhooks, GET /phone_numbers |
| wa_id | ID do usuário do WhatsApp, geralmente o número sem +. Pode não ser igual ao número que você enviou em to. | Resposta de envio, webhooks |
| Nome de exibição | Nome da empresa mostrado no perfil e, depois de aprovado, no topo da conversa. Ver nome de exibição na API. | verified_name, name_status |
| Perfil comercial | Endereço, site, descrição, e-mail e categoria mostrados no perfil do número. | whatsapp_business_profile |
| Conta comercial oficial (OBA) | Número de empresa verificada que ganha selo azul ao lado do nome. Ver selo verde/azul. | WhatsApp Manager |
| Verificação da empresa | Processo em que a Meta confirma que o portfólio é de uma empresa real. Destrava limites maiores. Ver verificação da empresa. | Central de Segurança |
| PIN de verificação em duas etapas | PIN de seis dígitos definido no registro do número. É pedido para trocar o PIN ou excluir o número da plataforma. | POST /<PHONE_NUMBER_ID>/register |
| WhatsApp Manager | Painel da Meta para gerenciar números, templates, qualidade e métricas. | business.facebook.com |
| Billing Hub e linha de crédito | Billing Hub é onde se cadastra a forma de pagamento. Linha de crédito é o crédito que um Solution Partner estende ao cliente. | Meta Business Suite |
Fontes: About the platform, Updates to WhatsApp Business accounts, Business phone numbers, Official Business Accounts.
Mensagens
| Termo | O que é | Onde aparece |
|---|---|---|
| Template (modelo de mensagem) | Mensagem pré-aprovada pela Meta, com variáveis. Único tipo que pode ser enviado fora da janela de atendimento. Ver templates. | type: "template" |
| Categoria do template | Marketing, utilidade ou autenticação. Define a revisão e o preço. | category |
| Parâmetros nomeados e posicionais | Variáveis do template no formato {{first_name}} ou {{1}}. | parameter_format |
| Mensagem de serviço | Mensagem livre (texto, mídia, botões) enviada dentro da janela de atendimento. | Categoria service |
| Janela de atendimento (24 h) | Período de 24 horas aberto por cada mensagem ou ligação do cliente. Fora dela, só templates. Ver janela de 24 horas. | Erro 131047 |
| Janela de ponto de entrada gratuito (FEP) | Janela de até 7 dias aberta quando a empresa responde a quem chegou por anúncio de clique para o WhatsApp. Nela, as mensagens não são cobradas. | pricing.type |
| Click-to-WhatsApp (CTWA) | Anúncio do Facebook ou Instagram que abre uma conversa no WhatsApp. | Objeto referral no webhook |
| wamid | ID da mensagem no WhatsApp. Volta na resposta do envio e aparece nos webhooks de status. | messages[0].id |
| Mensagens interativas | Botões de resposta (até 3), listas, botão de link (CTA URL), pedido de localização. Ver mensagens interativas. | type: "interactive" |
| WhatsApp Flows | Formulários com várias telas dentro da conversa, para agendamento, cadastro, pesquisa. | interactive.type: "flow" |
| Media ID | ID devolvido pelo upload de um arquivo, usado no lugar do link ao enviar mídia. | image.id, document.id |
| Status da mensagem | sent, delivered, read e failed, entre outros, recebidos por webhook. Ver status de mensagem. | Webhook statuses |
| Meta Business Agent | Agentes de IA da própria Meta que atendem no WhatsApp, com categoria de preço própria. | Categoria de preço |
Fontes: Templates, Service messages, Pricing, Status webhook.
Limites, qualidade e preço
| Termo | O que é | Onde aparece |
|---|---|---|
| Limite de mensagens | Quantos destinatários únicos o portfólio alcança em 24 horas fora da janela: 250, 2.000, 10.000, 100.000 ou ilimitado. É do portfólio, não do número. Ver limite de mensagens. | whatsapp_business_manager_messaging_limit |
| Throughput (mps) | Mensagens por segundo que um número envia: 80 por padrão, até 1.000 com upgrade automático, 20 fixo em coexistência. | Erro 130429 |
| Classificação de qualidade | Nota do número com base em bloqueios, denúncias e outros sinais dos últimos 7 dias. | quality_rating (ex.: GREEN) |
| Limite por usuário de marketing | Teto de templates de marketing que cada pessoa recebe de todas as empresas, conforme o engajamento dela. | Erro 131049 |
| Pausa de template | Template com qualidade baixa é pausado; depois de pausas repetidas, é desativado. | Erros 132015 e 132016 |
| Opt-in | Permissão do cliente para receber mensagens da empresa. Exigida pela política do WhatsApp. | Política de mensagens |
| Cobrança por mensagem (PMP) | Modelo em vigor desde 1º de julho de 2025: a Meta cobra cada mensagem entregue, por categoria e país. | pricing_model: "PMP" |
| Objeto pricing | Bloco do webhook de status que diz se a mensagem é cobrável, a categoria e o tipo de preço. | billable, category, type |
Fontes: Messaging limits, Throughput, Error codes, Pricing.
Integração e autenticação
| Termo | O que é | Onde aparece |
|---|---|---|
| Cloud API | A API oficial de mensagens e ligações do WhatsApp, hospedada pela Meta. Ver WhatsApp Cloud API. | graph.facebook.com |
| Graph API | A API HTTP da Meta sobre a qual a Cloud API é construída. Tem versões (ex.: v26.0). | URL base |
| Business Management API | Parte da plataforma que gerencia contas, números, templates e métricas. | Endpoints de WABA |
| Marketing Messages API | API para envio de marketing com otimizações que a Cloud API não tem. | Documentação da Meta |
| On-Premises API | Versão antiga, hospedada pela empresa. Encerrada pela Meta em 23 de outubro de 2025. | Documentação legada |
| Webhook | URL do seu sistema que recebe mensagens e status em JSON. Ver webhooks da API. | object: "whatsapp_business_account" |
| Verify token e hub.challenge | Na configuração, a Meta faz um GET com hub.verify_token e hub.challenge; você confere o token e devolve o challenge. | Query string |
| X-Hub-Signature-256 | Cabeçalho com o HMAC-SHA256 do corpo, calculado com o segredo do app, para validar que o webhook veio da Meta. | Cabeçalho HTTP |
| Usuário do sistema | Usuário técnico do portfólio que representa um serviço, não uma pessoa. Pode ser admin ou funcionário. | Configurações do negócio |
| Token de usuário do sistema | Token de longa duração para integração direta. Ver token permanente. | Authorization: Bearer |
| Business token | Token restrito a um cliente, obtido pelo parceiro ao fim do Cadastro Incorporado. | Fluxo de parceiros |
| Cadastro Incorporado (Embedded Signup) | Janela da Meta que cria portfólio, contas e número e autoriza o app de um parceiro. | Site do provedor |
| App Review e Advanced access | Revisão do app pela Meta, exigida de parceiros para acessar contas de outras empresas. Sem ela, erro 200. | Painel de apps |
| Coexistência | Uso do mesmo número no app WhatsApp Business e na Cloud API. Ver coexistência. | is_on_biz_app |
| smb_message_echoes | Campo de webhook que avisa quando a empresa responde pelo app em coexistência. | Assinatura de webhook |
Fontes: About the platform, Create a webhook endpoint, Access tokens, Embedded Signup, On-Premises API Sunset.
Parceiros
| Termo | O que é |
|---|---|
| Solution Partner (BSP) | Meta Business Partner com linha de crédito: pode faturar o uso da API diretamente ao cliente. |
| Tech Provider | Oferece os serviços da plataforma sem linha de crédito; a Meta cobra o cliente diretamente. |
| Tech Partner | Tech Provider que também é Meta Business Partner. |
A diferença entre eles está explicada em o que é BSP e Tech Provider.
Como os IDs se encaixam numa chamada real
Um envio pela Cloud API junta vários termos deste glossário: o Phone Number ID na URL, o token no cabeçalho, o número do cliente em to e o template no corpo.
curl 'https://graph.facebook.com/v26.0/PHONE_NUMBER_ID/messages' \
-H 'Authorization: Bearer TOKEN_DO_USUARIO_DO_SISTEMA' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"to": "+5584999999999",
"type": "template",
"template": { "name": "lembrete_consulta", "language": { "code": "pt_BR" } }
}'A resposta traz o wa_id do cliente e o wamid da mensagem. É esse wamid que você usa para casar os webhooks de status com o envio. Mais exemplos em como enviar mensagem pela API.
Os mesmos termos na Vectalk
A Vectalk é um proxy da WhatsApp Cloud API oficial: os payloads e webhooks são os da Meta, então todo este glossário vale do mesmo jeito. Muda só o acesso. Na documentação da Vectalk, cada número conectado vira uma instância, que guarda phone_number_id, waba_id, business_id e o token da Meta. Você se autentica com um token de organização, que acessa todas as instâncias e exige phone_number_id no corpo do envio, ou com um token de instância, que resolve o número sozinho. Os detalhes estão em Instâncias e Autenticação. Para começar, crie sua conta.
Perguntas frequentes
WABA e conta do WhatsApp Business no celular são a mesma coisa?
Não. O app WhatsApp Business no celular é uma conta de uso manual. WABA é o termo da plataforma para a conta usada pela API. Com a coexistência, a conta do app pode ser convertida e passar a funcionar também na API.
Qual a diferença entre Phone Number ID e o número de telefone?
O número de telefone é o que o cliente vê, como +55 84 99999-9999. O Phone Number ID é um identificador numérico gerado pela Meta para esse número dentro da API e é ele que vai na URL de envio.
O que mudou com a divisão da WABA?
A WABA virou duas contas: a conta do WhatsApp, com o número, e a conta de mensagens, com templates e cobrança. IDs, endpoints e tokens antigos continuam funcionando. A principal novidade é que um número pode ser compartilhado com vários parceiros, cada um com sua conta de mensagens.
wa_id é sempre igual ao número que enviei?
Não necessariamente. A Meta avisa que o wa_id pode não coincidir com o valor enviado em to. No Brasil, a API pode ajustar o prefixo do número. Guarde o wa_id devolvido pela API como identificador do contato.
Fontes oficiais consultadas em 25/10/2026: About the platform, Updates to WhatsApp Business accounts, Business phone numbers, Display names, Official Business Accounts, Templates, Service messages, Status webhook, Messaging limits, Throughput, Pricing, Error codes, Access tokens, Create a webhook endpoint, Embedded Signup, Partners, On-Premises API Sunset.