{"id":272,"date":"2026-10-25T13:04:51","date_gmt":"2026-10-25T13:04:51","guid":{"rendered":"https:\/\/vectalk.com.br\/blog\/glossario-api-whatsapp\/"},"modified":"2026-10-25T13:04:52","modified_gmt":"2026-10-25T13:04:52","slug":"glossario-api-whatsapp","status":"publish","type":"post","link":"https:\/\/vectalk.com.br\/blog\/glossario-api-whatsapp\/","title":{"rendered":"Gloss\u00e1rio da API do WhatsApp: WABA, Phone Number ID, template e mais"},"content":{"rendered":"\n<p><em>Atualizado em 25\/10\/2026<\/em><\/p>\n\n\n\n<p>WABA (WhatsApp Business Account) \u00e9 a conta que, na API oficial do WhatsApp, reunia n\u00fameros, templates e cobran\u00e7a de uma empresa. Desde o novo modelo de contas da Meta, implantado entre setembro e outubro de 2026, ela se dividiu em duas: a <strong>conta do WhatsApp<\/strong>, que guarda o n\u00famero e a identidade da empresa, e a <strong>conta de mensagens<\/strong>, que guarda templates, cobran\u00e7a e webhooks. O <code>waba_id<\/code> que voc\u00ea j\u00e1 usa continua funcionando e passou a identificar a conta de mensagens.<\/p>\n\n\n\n<p>Este gloss\u00e1rio re\u00fane mais de 40 termos que aparecem na documenta\u00e7\u00e3o da Meta, nos payloads e nos pain\u00e9is, agrupados por assunto. Cada defini\u00e7\u00e3o tem uma ou duas frases e, quando existe, um link para o artigo que aprofunda o tema. Para o panorama geral, comece pelo guia <a href=\"https:\/\/vectalk.com.br\/blog\/api-oficial-do-whatsapp\/\">API Oficial do WhatsApp<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Contas e ativos<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Termo<\/th><th>O que \u00e9<\/th><th>Onde aparece<\/th><\/tr><\/thead><tbody><tr><td>Portf\u00f3lio empresarial<\/td><td>Conta da empresa na Meta (antes chamada Business Manager). Cont\u00e9m as contas do WhatsApp, as contas de mensagens, usu\u00e1rios e apps. \u00c9 obrigat\u00f3rio.<\/td><td><code>business_id<\/code>, Meta Business Suite<\/td><\/tr><tr><td>WABA (WhatsApp Business Account)<\/td><td>Conta que reunia n\u00fameros, templates e cobran\u00e7a. No modelo novo, o ID dela passou a identificar a conta de mensagens.<\/td><td><code>waba_id<\/code><\/td><\/tr><tr><td>Conta de mensagens (Messaging account)<\/td><td>Guarda templates, forma de pagamento e assinaturas de webhook. Cada parceiro que atende um mesmo n\u00famero tem a sua.<\/td><td><code>waba_id<\/code>, aba &#8220;Contas de mensagens&#8221;<\/td><\/tr><tr><td>Conta do WhatsApp (WAAC)<\/td><td>Guarda o n\u00famero, o perfil comercial e, no futuro, o nome de usu\u00e1rio. \u00c9 sempre da empresa e pode ser compartilhada com parceiros.<\/td><td>Aba &#8220;Contas do WhatsApp&#8221;<\/td><\/tr><tr><td>N\u00famero de telefone comercial<\/td><td>N\u00famero registrado na Cloud API para enviar e receber mensagens. Pode ser celular, fixo ou virtual.<\/td><td>WhatsApp Manager<\/td><\/tr><tr><td>Phone Number ID<\/td><td>Identificador do n\u00famero na API. Vai na URL de envio. N\u00e3o \u00e9 o n\u00famero em si.<\/td><td><code>phone_number_id<\/code>, <code>POST \/&lt;PHONE_NUMBER_ID&gt;\/messages<\/code><\/td><\/tr><tr><td>display_phone_number<\/td><td>O n\u00famero formatado, do jeito que aparece para as pessoas.<\/td><td>Webhooks, <code>GET \/phone_numbers<\/code><\/td><\/tr><tr><td>wa_id<\/td><td>ID do usu\u00e1rio do WhatsApp, geralmente o n\u00famero sem <code>+<\/code>. Pode n\u00e3o ser igual ao n\u00famero que voc\u00ea enviou em <code>to<\/code>.<\/td><td>Resposta de envio, webhooks<\/td><\/tr><tr><td>Nome de exibi\u00e7\u00e3o<\/td><td>Nome da empresa mostrado no perfil e, depois de aprovado, no topo da conversa. Ver <a href=\"https:\/\/vectalk.com.br\/blog\/nome-de-exibicao-whatsapp-api\/\">nome de exibi\u00e7\u00e3o na API<\/a>.<\/td><td><code>verified_name<\/code>, <code>name_status<\/code><\/td><\/tr><tr><td>Perfil comercial<\/td><td>Endere\u00e7o, site, descri\u00e7\u00e3o, e-mail e categoria mostrados no perfil do n\u00famero.<\/td><td><code>whatsapp_business_profile<\/code><\/td><\/tr><tr><td>Conta comercial oficial (OBA)<\/td><td>N\u00famero de empresa verificada que ganha selo azul ao lado do nome. Ver <a href=\"https:\/\/vectalk.com.br\/blog\/selo-verde-whatsapp-conta-oficial\/\">selo verde\/azul<\/a>.<\/td><td>WhatsApp Manager<\/td><\/tr><tr><td>Verifica\u00e7\u00e3o da empresa<\/td><td>Processo em que a Meta confirma que o portf\u00f3lio \u00e9 de uma empresa real. Destrava limites maiores. Ver <a href=\"https:\/\/vectalk.com.br\/blog\/verificacao-empresa-meta-business\/\">verifica\u00e7\u00e3o da empresa<\/a>.<\/td><td>Central de Seguran\u00e7a<\/td><\/tr><tr><td>PIN de verifica\u00e7\u00e3o em duas etapas<\/td><td>PIN de seis d\u00edgitos definido no registro do n\u00famero. \u00c9 pedido para trocar o PIN ou excluir o n\u00famero da plataforma.<\/td><td><code>POST \/&lt;PHONE_NUMBER_ID&gt;\/register<\/code><\/td><\/tr><tr><td>WhatsApp Manager<\/td><td>Painel da Meta para gerenciar n\u00fameros, templates, qualidade e m\u00e9tricas.<\/td><td>business.facebook.com<\/td><\/tr><tr><td>Billing Hub e linha de cr\u00e9dito<\/td><td>Billing Hub \u00e9 onde se cadastra a forma de pagamento. Linha de cr\u00e9dito \u00e9 o cr\u00e9dito que um Solution Partner estende ao cliente.<\/td><td>Meta Business Suite<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Fontes: <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/about-the-platform\" target=\"_blank\" rel=\"noreferrer noopener\">About the platform<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/account-model-evolution\" target=\"_blank\" rel=\"noreferrer noopener\">Updates to WhatsApp Business accounts<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/business-phone-numbers\/phone-numbers\" target=\"_blank\" rel=\"noreferrer noopener\">Business phone numbers<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/official-business-accounts\" target=\"_blank\" rel=\"noreferrer noopener\">Official Business Accounts<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Mensagens<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Termo<\/th><th>O que \u00e9<\/th><th>Onde aparece<\/th><\/tr><\/thead><tbody><tr><td>Template (modelo de mensagem)<\/td><td>Mensagem pr\u00e9-aprovada pela Meta, com vari\u00e1veis. \u00danico tipo que pode ser enviado fora da janela de atendimento. Ver <a href=\"https:\/\/vectalk.com.br\/blog\/templates-whatsapp-api\/\">templates<\/a>.<\/td><td><code>type: \"template\"<\/code><\/td><\/tr><tr><td>Categoria do template<\/td><td>Marketing, utilidade ou autentica\u00e7\u00e3o. Define a revis\u00e3o e o pre\u00e7o.<\/td><td><code>category<\/code><\/td><\/tr><tr><td>Par\u00e2metros nomeados e posicionais<\/td><td>Vari\u00e1veis do template no formato <code>{{first_name}}<\/code> ou <code>{{1}}<\/code>.<\/td><td><code>parameter_format<\/code><\/td><\/tr><tr><td>Mensagem de servi\u00e7o<\/td><td>Mensagem livre (texto, m\u00eddia, bot\u00f5es) enviada dentro da janela de atendimento.<\/td><td>Categoria <code>service<\/code><\/td><\/tr><tr><td>Janela de atendimento (24 h)<\/td><td>Per\u00edodo de 24 horas aberto por cada mensagem ou liga\u00e7\u00e3o do cliente. Fora dela, s\u00f3 templates. Ver <a href=\"https:\/\/vectalk.com.br\/blog\/janela-24-horas-whatsapp\/\">janela de 24 horas<\/a>.<\/td><td>Erro <code>131047<\/code><\/td><\/tr><tr><td>Janela de ponto de entrada gratuito (FEP)<\/td><td>Janela de at\u00e9 7 dias aberta quando a empresa responde a quem chegou por an\u00fancio de clique para o WhatsApp. Nela, as mensagens n\u00e3o s\u00e3o cobradas.<\/td><td><code>pricing.type<\/code><\/td><\/tr><tr><td>Click-to-WhatsApp (CTWA)<\/td><td>An\u00fancio do Facebook ou Instagram que abre uma conversa no WhatsApp.<\/td><td>Objeto <code>referral<\/code> no webhook<\/td><\/tr><tr><td>wamid<\/td><td>ID da mensagem no WhatsApp. Volta na resposta do envio e aparece nos webhooks de status.<\/td><td><code>messages[0].id<\/code><\/td><\/tr><tr><td>Mensagens interativas<\/td><td>Bot\u00f5es de resposta (at\u00e9 3), listas, bot\u00e3o de link (CTA URL), pedido de localiza\u00e7\u00e3o. Ver <a href=\"https:\/\/vectalk.com.br\/blog\/mensagens-interativas-whatsapp-api\/\">mensagens interativas<\/a>.<\/td><td><code>type: \"interactive\"<\/code><\/td><\/tr><tr><td>WhatsApp Flows<\/td><td>Formul\u00e1rios com v\u00e1rias telas dentro da conversa, para agendamento, cadastro, pesquisa.<\/td><td><code>interactive.type: \"flow\"<\/code><\/td><\/tr><tr><td>Media ID<\/td><td>ID devolvido pelo upload de um arquivo, usado no lugar do link ao enviar m\u00eddia.<\/td><td><code>image.id<\/code>, <code>document.id<\/code><\/td><\/tr><tr><td>Status da mensagem<\/td><td><code>sent<\/code>, <code>delivered<\/code>, <code>read<\/code> e <code>failed<\/code>, entre outros, recebidos por webhook. Ver <a href=\"https:\/\/vectalk.com.br\/blog\/status-mensagem-webhook-whatsapp\/\">status de mensagem<\/a>.<\/td><td>Webhook <code>statuses<\/code><\/td><\/tr><tr><td>Meta Business Agent<\/td><td>Agentes de IA da pr\u00f3pria Meta que atendem no WhatsApp, com categoria de pre\u00e7o pr\u00f3pria.<\/td><td>Categoria de pre\u00e7o<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Fontes: <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/templates\/overview\" target=\"_blank\" rel=\"noreferrer noopener\">Templates<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/messages\/send-messages\" target=\"_blank\" rel=\"noreferrer noopener\">Service messages<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/pricing\" target=\"_blank\" rel=\"noreferrer noopener\">Pricing<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/webhooks\/reference\/messages\/status\" target=\"_blank\" rel=\"noreferrer noopener\">Status webhook<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Limites, qualidade e pre\u00e7o<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Termo<\/th><th>O que \u00e9<\/th><th>Onde aparece<\/th><\/tr><\/thead><tbody><tr><td>Limite de mensagens<\/td><td>Quantos destinat\u00e1rios \u00fanicos o portf\u00f3lio alcan\u00e7a em 24 horas fora da janela: 250, 2.000, 10.000, 100.000 ou ilimitado. \u00c9 do portf\u00f3lio, n\u00e3o do n\u00famero. Ver <a href=\"https:\/\/vectalk.com.br\/blog\/limite-mensagens-whatsapp-api\/\">limite de mensagens<\/a>.<\/td><td><code>whatsapp_business_manager_messaging_limit<\/code><\/td><\/tr><tr><td>Throughput (mps)<\/td><td>Mensagens por segundo que um n\u00famero envia: 80 por padr\u00e3o, at\u00e9 1.000 com upgrade autom\u00e1tico, 20 fixo em coexist\u00eancia.<\/td><td>Erro <code>130429<\/code><\/td><\/tr><tr><td>Classifica\u00e7\u00e3o de qualidade<\/td><td>Nota do n\u00famero com base em bloqueios, den\u00fancias e outros sinais dos \u00faltimos 7 dias.<\/td><td><code>quality_rating<\/code> (ex.: <code>GREEN<\/code>)<\/td><\/tr><tr><td>Limite por usu\u00e1rio de marketing<\/td><td>Teto de templates de marketing que cada pessoa recebe de todas as empresas, conforme o engajamento dela.<\/td><td>Erro <code>131049<\/code><\/td><\/tr><tr><td>Pausa de template<\/td><td>Template com qualidade baixa \u00e9 pausado; depois de pausas repetidas, \u00e9 desativado.<\/td><td>Erros <code>132015<\/code> e <code>132016<\/code><\/td><\/tr><tr><td>Opt-in<\/td><td>Permiss\u00e3o do cliente para receber mensagens da empresa. Exigida pela pol\u00edtica do WhatsApp.<\/td><td>Pol\u00edtica de mensagens<\/td><\/tr><tr><td>Cobran\u00e7a por mensagem (PMP)<\/td><td>Modelo em vigor desde 1\u00ba de julho de 2025: a Meta cobra cada mensagem entregue, por categoria e pa\u00eds.<\/td><td><code>pricing_model: \"PMP\"<\/code><\/td><\/tr><tr><td>Objeto pricing<\/td><td>Bloco do webhook de status que diz se a mensagem \u00e9 cobr\u00e1vel, a categoria e o tipo de pre\u00e7o.<\/td><td><code>billable<\/code>, <code>category<\/code>, <code>type<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Fontes: <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/messaging-limits\" target=\"_blank\" rel=\"noreferrer noopener\">Messaging limits<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/throughput\" target=\"_blank\" rel=\"noreferrer noopener\">Throughput<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/support\/error-codes\" target=\"_blank\" rel=\"noreferrer noopener\">Error codes<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/pricing\" target=\"_blank\" rel=\"noreferrer noopener\">Pricing<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Integra\u00e7\u00e3o e autentica\u00e7\u00e3o<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Termo<\/th><th>O que \u00e9<\/th><th>Onde aparece<\/th><\/tr><\/thead><tbody><tr><td>Cloud API<\/td><td>A API oficial de mensagens e liga\u00e7\u00f5es do WhatsApp, hospedada pela Meta. Ver <a href=\"https:\/\/vectalk.com.br\/blog\/whatsapp-cloud-api\/\">WhatsApp Cloud API<\/a>.<\/td><td><code>graph.facebook.com<\/code><\/td><\/tr><tr><td>Graph API<\/td><td>A API HTTP da Meta sobre a qual a Cloud API \u00e9 constru\u00edda. Tem vers\u00f5es (ex.: v26.0).<\/td><td>URL base<\/td><\/tr><tr><td>Business Management API<\/td><td>Parte da plataforma que gerencia contas, n\u00fameros, templates e m\u00e9tricas.<\/td><td>Endpoints de WABA<\/td><\/tr><tr><td>Marketing Messages API<\/td><td>API para envio de marketing com otimiza\u00e7\u00f5es que a Cloud API n\u00e3o tem.<\/td><td>Documenta\u00e7\u00e3o da Meta<\/td><\/tr><tr><td>On-Premises API<\/td><td>Vers\u00e3o antiga, hospedada pela empresa. Encerrada pela Meta em 23 de outubro de 2025.<\/td><td>Documenta\u00e7\u00e3o legada<\/td><\/tr><tr><td>Webhook<\/td><td>URL do seu sistema que recebe mensagens e status em JSON. Ver <a href=\"https:\/\/vectalk.com.br\/blog\/webhook-whatsapp-api\/\">webhooks da API<\/a>.<\/td><td><code>object: \"whatsapp_business_account\"<\/code><\/td><\/tr><tr><td>Verify token e hub.challenge<\/td><td>Na configura\u00e7\u00e3o, a Meta faz um GET com <code>hub.verify_token<\/code> e <code>hub.challenge<\/code>; voc\u00ea confere o token e devolve o challenge.<\/td><td>Query string<\/td><\/tr><tr><td>X-Hub-Signature-256<\/td><td>Cabe\u00e7alho com o HMAC-SHA256 do corpo, calculado com o segredo do app, para validar que o webhook veio da Meta.<\/td><td>Cabe\u00e7alho HTTP<\/td><\/tr><tr><td>Usu\u00e1rio do sistema<\/td><td>Usu\u00e1rio t\u00e9cnico do portf\u00f3lio que representa um servi\u00e7o, n\u00e3o uma pessoa. Pode ser admin ou funcion\u00e1rio.<\/td><td>Configura\u00e7\u00f5es do neg\u00f3cio<\/td><\/tr><tr><td>Token de usu\u00e1rio do sistema<\/td><td>Token de longa dura\u00e7\u00e3o para integra\u00e7\u00e3o direta. Ver <a href=\"https:\/\/vectalk.com.br\/blog\/token-permanente-api-whatsapp\/\">token permanente<\/a>.<\/td><td><code>Authorization: Bearer<\/code><\/td><\/tr><tr><td>Business token<\/td><td>Token restrito a um cliente, obtido pelo parceiro ao fim do Cadastro Incorporado.<\/td><td>Fluxo de parceiros<\/td><\/tr><tr><td>Cadastro Incorporado (Embedded Signup)<\/td><td>Janela da Meta que cria portf\u00f3lio, contas e n\u00famero e autoriza o app de um parceiro.<\/td><td>Site do provedor<\/td><\/tr><tr><td>App Review e Advanced access<\/td><td>Revis\u00e3o do app pela Meta, exigida de parceiros para acessar contas de outras empresas. Sem ela, erro <code>200<\/code>.<\/td><td>Painel de apps<\/td><\/tr><tr><td>Coexist\u00eancia<\/td><td>Uso do mesmo n\u00famero no app WhatsApp Business e na Cloud API. Ver <a href=\"https:\/\/vectalk.com.br\/blog\/coexistencia-whatsapp-api\/\">coexist\u00eancia<\/a>.<\/td><td><code>is_on_biz_app<\/code><\/td><\/tr><tr><td>smb_message_echoes<\/td><td>Campo de webhook que avisa quando a empresa responde pelo app em coexist\u00eancia.<\/td><td>Assinatura de webhook<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Fontes: <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/about-the-platform\" target=\"_blank\" rel=\"noreferrer noopener\">About the platform<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/webhooks\/create-webhook-endpoint\" target=\"_blank\" rel=\"noreferrer noopener\">Create a webhook endpoint<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/access-tokens\" target=\"_blank\" rel=\"noreferrer noopener\">Access tokens<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/embedded-signup\/overview\" target=\"_blank\" rel=\"noreferrer noopener\">Embedded Signup<\/a>, <a href=\"https:\/\/developers.facebook.com\/docs\/whatsapp\/on-premises\/sunset\" target=\"_blank\" rel=\"noreferrer noopener\">On-Premises API Sunset<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Parceiros<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Termo<\/th><th>O que \u00e9<\/th><\/tr><\/thead><tbody><tr><td>Solution Partner (BSP)<\/td><td>Meta Business Partner com linha de cr\u00e9dito: pode faturar o uso da API diretamente ao cliente.<\/td><\/tr><tr><td>Tech Provider<\/td><td>Oferece os servi\u00e7os da plataforma sem linha de cr\u00e9dito; a Meta cobra o cliente diretamente.<\/td><\/tr><tr><td>Tech Partner<\/td><td>Tech Provider que tamb\u00e9m \u00e9 Meta Business Partner.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>A diferen\u00e7a entre eles est\u00e1 explicada em <a href=\"https:\/\/vectalk.com.br\/blog\/bsp-tech-provider-whatsapp\/\">o que \u00e9 BSP e Tech Provider<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Como os IDs se encaixam numa chamada real<\/h2>\n\n\n\n<p>Um envio pela Cloud API junta v\u00e1rios termos deste gloss\u00e1rio: o Phone Number ID na URL, o token no cabe\u00e7alho, o n\u00famero do cliente em <code>to<\/code> e o template no corpo.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code class=\"language-bash\">curl 'https:\/\/graph.facebook.com\/v26.0\/PHONE_NUMBER_ID\/messages' \\\n  -H 'Authorization: Bearer TOKEN_DO_USUARIO_DO_SISTEMA' \\\n  -H 'Content-Type: application\/json' \\\n  -d '{\n    \"messaging_product\": \"whatsapp\",\n    \"to\": \"+5584999999999\",\n    \"type\": \"template\",\n    \"template\": { \"name\": \"lembrete_consulta\", \"language\": { \"code\": \"pt_BR\" } }\n  }'<\/code><\/pre>\n\n\n\n<p>A resposta traz o <code>wa_id<\/code> do cliente e o <code>wamid<\/code> da mensagem. \u00c9 esse <code>wamid<\/code> que voc\u00ea usa para casar os webhooks de status com o envio. Mais exemplos em <a href=\"https:\/\/vectalk.com.br\/blog\/enviar-mensagem-api-whatsapp-exemplos\/\">como enviar mensagem pela API<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Os mesmos termos na Vectalk<\/h2>\n\n\n\n<p>A Vectalk \u00e9 um proxy da WhatsApp Cloud API oficial: os payloads e webhooks s\u00e3o os da Meta, ent\u00e3o todo este gloss\u00e1rio vale do mesmo jeito. Muda s\u00f3 o acesso. Na documenta\u00e7\u00e3o da Vectalk, cada n\u00famero conectado vira uma <strong>inst\u00e2ncia<\/strong>, que guarda <code>phone_number_id<\/code>, <code>waba_id<\/code>, <code>business_id<\/code> e o token da Meta. Voc\u00ea se autentica com um <strong>token de organiza\u00e7\u00e3o<\/strong>, que acessa todas as inst\u00e2ncias e exige <code>phone_number_id<\/code> no corpo do envio, ou com um <strong>token de inst\u00e2ncia<\/strong>, que resolve o n\u00famero sozinho. Os detalhes est\u00e3o em <a href=\"https:\/\/docs.vectalk.com.br\/concepts\/instances\">Inst\u00e2ncias<\/a> e <a href=\"https:\/\/docs.vectalk.com.br\/authentication\">Autentica\u00e7\u00e3o<\/a>. Para come\u00e7ar, <a href=\"https:\/\/apps.vectalk.com.br\/register\">crie sua conta<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Perguntas frequentes<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">WABA e conta do WhatsApp Business no celular s\u00e3o a mesma coisa?<\/h3>\n\n\n\n<p>N\u00e3o. O app WhatsApp Business no celular \u00e9 uma conta de uso manual. WABA \u00e9 o termo da plataforma para a conta usada pela API. Com a coexist\u00eancia, a conta do app pode ser convertida e passar a funcionar tamb\u00e9m na API.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Qual a diferen\u00e7a entre Phone Number ID e o n\u00famero de telefone?<\/h3>\n\n\n\n<p>O n\u00famero de telefone \u00e9 o que o cliente v\u00ea, como +55 84 99999-9999. O Phone Number ID \u00e9 um identificador num\u00e9rico gerado pela Meta para esse n\u00famero dentro da API e \u00e9 ele que vai na URL de envio.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">O que mudou com a divis\u00e3o da WABA?<\/h3>\n\n\n\n<p>A WABA virou duas contas: a conta do WhatsApp, com o n\u00famero, e a conta de mensagens, com templates e cobran\u00e7a. IDs, endpoints e tokens antigos continuam funcionando. A principal novidade \u00e9 que um n\u00famero pode ser compartilhado com v\u00e1rios parceiros, cada um com sua conta de mensagens.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">wa_id \u00e9 sempre igual ao n\u00famero que enviei?<\/h3>\n\n\n\n<p>N\u00e3o necessariamente. A Meta avisa que o <code>wa_id<\/code> pode n\u00e3o coincidir com o valor enviado em <code>to<\/code>. No Brasil, a API pode ajustar o prefixo do n\u00famero. Guarde o <code>wa_id<\/code> devolvido pela API como identificador do contato.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p><strong>Fontes oficiais consultadas em 25\/10\/2026:<\/strong> <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/about-the-platform\" target=\"_blank\" rel=\"noreferrer noopener\">About the platform<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/account-model-evolution\" target=\"_blank\" rel=\"noreferrer noopener\">Updates to WhatsApp Business accounts<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/business-phone-numbers\/phone-numbers\" target=\"_blank\" rel=\"noreferrer noopener\">Business phone numbers<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/display-names\" target=\"_blank\" rel=\"noreferrer noopener\">Display names<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/official-business-accounts\" target=\"_blank\" rel=\"noreferrer noopener\">Official Business Accounts<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/templates\/overview\" target=\"_blank\" rel=\"noreferrer noopener\">Templates<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/messages\/send-messages\" target=\"_blank\" rel=\"noreferrer noopener\">Service messages<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/webhooks\/reference\/messages\/status\" target=\"_blank\" rel=\"noreferrer noopener\">Status webhook<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/messaging-limits\" target=\"_blank\" rel=\"noreferrer noopener\">Messaging limits<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/throughput\" target=\"_blank\" rel=\"noreferrer noopener\">Throughput<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/pricing\" target=\"_blank\" rel=\"noreferrer noopener\">Pricing<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/support\/error-codes\" target=\"_blank\" rel=\"noreferrer noopener\">Error codes<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/access-tokens\" target=\"_blank\" rel=\"noreferrer noopener\">Access tokens<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/webhooks\/create-webhook-endpoint\" target=\"_blank\" rel=\"noreferrer noopener\">Create a webhook endpoint<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/embedded-signup\/overview\" target=\"_blank\" rel=\"noreferrer noopener\">Embedded Signup<\/a>, <a href=\"https:\/\/developers.facebook.com\/documentation\/business-messaging\/whatsapp\/solution-providers\/overview\" target=\"_blank\" rel=\"noreferrer noopener\">Partners<\/a>, <a href=\"https:\/\/developers.facebook.com\/docs\/whatsapp\/on-premises\/sunset\" target=\"_blank\" rel=\"noreferrer noopener\">On-Premises API Sunset<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>WABA, conta de mensagens, Phone Number ID, wamid, template, janela de atendimento, FEP, webhook, token: os termos da API do WhatsApp explicados em uma p\u00e1gina.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[8],"tags":[],"class_list":["post-272","post","type-post","status-publish","format-standard","hentry","category-uncategorized-pt"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.7 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>WABA: o que \u00e9? Gloss\u00e1rio da API do WhatsApp | Vectalk<\/title>\n<meta name=\"description\" content=\"WABA: o que \u00e9, e mais 40 termos da API do WhatsApp explicados: Phone Number ID, wa_id, wamid, template, janela de 24 h, webhook, token e limites.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vectalk.com.br\/blog\/glossario-api-whatsapp\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"WABA: o que \u00e9? Gloss\u00e1rio da API do WhatsApp | Vectalk\" \/>\n<meta property=\"og:description\" content=\"WABA: o que \u00e9, e mais 40 termos da API do WhatsApp explicados: Phone Number ID, wa_id, wamid, template, janela de 24 h, webhook, token e limites.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vectalk.com.br\/blog\/glossario-api-whatsapp\/\" \/>\n<meta property=\"og:site_name\" content=\"Blog Vectalk\" \/>\n<meta property=\"article:published_time\" content=\"2026-10-25T13:04:51+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2026-10-25T13:04:52+00:00\" \/>\n<meta name=\"author\" content=\"wanderleyfcunha\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"wanderleyfcunha\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"10 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/glossario-api-whatsapp\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/glossario-api-whatsapp\\\/\"},\"author\":{\"name\":\"wanderleyfcunha\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\"},\"headline\":\"Gloss\u00e1rio da API do WhatsApp: WABA, Phone Number ID, template e mais\",\"datePublished\":\"2026-10-25T13:04:51+00:00\",\"dateModified\":\"2026-10-25T13:04:52+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/glossario-api-whatsapp\\\/\"},\"wordCount\":1876,\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/glossario-api-whatsapp\\\/\",\"url\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/glossario-api-whatsapp\\\/\",\"name\":\"WABA: o que \u00e9? Gloss\u00e1rio da API do WhatsApp | Vectalk\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#website\"},\"datePublished\":\"2026-10-25T13:04:51+00:00\",\"dateModified\":\"2026-10-25T13:04:52+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\"},\"description\":\"WABA: o que \u00e9, e mais 40 termos da API do WhatsApp explicados: Phone Number ID, wa_id, wamid, template, janela de 24 h, webhook, token e limites.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/glossario-api-whatsapp\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/glossario-api-whatsapp\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/glossario-api-whatsapp\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Gloss\u00e1rio da API do WhatsApp: WABA, Phone Number ID, template e mais\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/\",\"name\":\"Blog Vectalk\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/vectalk.com.br\\\/blog\\\/#\\\/schema\\\/person\\\/ff36ecd9d8257856f227f8e5d639db2b\",\"name\":\"wanderleyfcunha\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g\",\"caption\":\"wanderleyfcunha\"},\"sameAs\":[\"https:\\\/\\\/vectalk.com.br\\\/blog\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"WABA: o que \u00e9? Gloss\u00e1rio da API do WhatsApp | Vectalk","description":"WABA: o que \u00e9, e mais 40 termos da API do WhatsApp explicados: Phone Number ID, wa_id, wamid, template, janela de 24 h, webhook, token e limites.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vectalk.com.br\/blog\/glossario-api-whatsapp\/","og_locale":"en_US","og_type":"article","og_title":"WABA: o que \u00e9? Gloss\u00e1rio da API do WhatsApp | Vectalk","og_description":"WABA: o que \u00e9, e mais 40 termos da API do WhatsApp explicados: Phone Number ID, wa_id, wamid, template, janela de 24 h, webhook, token e limites.","og_url":"https:\/\/vectalk.com.br\/blog\/glossario-api-whatsapp\/","og_site_name":"Blog Vectalk","article_published_time":"2026-10-25T13:04:51+00:00","article_modified_time":"2026-10-25T13:04:52+00:00","author":"wanderleyfcunha","twitter_card":"summary_large_image","twitter_misc":{"Written by":"wanderleyfcunha","Est. reading time":"10 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/vectalk.com.br\/blog\/glossario-api-whatsapp\/#article","isPartOf":{"@id":"https:\/\/vectalk.com.br\/blog\/glossario-api-whatsapp\/"},"author":{"name":"wanderleyfcunha","@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b"},"headline":"Gloss\u00e1rio da API do WhatsApp: WABA, Phone Number ID, template e mais","datePublished":"2026-10-25T13:04:51+00:00","dateModified":"2026-10-25T13:04:52+00:00","mainEntityOfPage":{"@id":"https:\/\/vectalk.com.br\/blog\/glossario-api-whatsapp\/"},"wordCount":1876,"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/vectalk.com.br\/blog\/glossario-api-whatsapp\/","url":"https:\/\/vectalk.com.br\/blog\/glossario-api-whatsapp\/","name":"WABA: o que \u00e9? Gloss\u00e1rio da API do WhatsApp | Vectalk","isPartOf":{"@id":"https:\/\/vectalk.com.br\/blog\/#website"},"datePublished":"2026-10-25T13:04:51+00:00","dateModified":"2026-10-25T13:04:52+00:00","author":{"@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b"},"description":"WABA: o que \u00e9, e mais 40 termos da API do WhatsApp explicados: Phone Number ID, wa_id, wamid, template, janela de 24 h, webhook, token e limites.","breadcrumb":{"@id":"https:\/\/vectalk.com.br\/blog\/glossario-api-whatsapp\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vectalk.com.br\/blog\/glossario-api-whatsapp\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/vectalk.com.br\/blog\/glossario-api-whatsapp\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vectalk.com.br\/blog\/"},{"@type":"ListItem","position":2,"name":"Gloss\u00e1rio da API do WhatsApp: WABA, Phone Number ID, template e mais"}]},{"@type":"WebSite","@id":"https:\/\/vectalk.com.br\/blog\/#website","url":"https:\/\/vectalk.com.br\/blog\/","name":"Blog Vectalk","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vectalk.com.br\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/vectalk.com.br\/blog\/#\/schema\/person\/ff36ecd9d8257856f227f8e5d639db2b","name":"wanderleyfcunha","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/21c37077f1731eb558973f27a7b647d55f72fde5200a843ac5f5345b247ea725?s=96&d=mm&r=g","caption":"wanderleyfcunha"},"sameAs":["https:\/\/vectalk.com.br\/blog"]}]}},"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/272","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/comments?post=272"}],"version-history":[{"count":1,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/272\/revisions"}],"predecessor-version":[{"id":275,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/posts\/272\/revisions\/275"}],"wp:attachment":[{"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/media?parent=272"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/categories?post=272"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/vectalk.com.br\/blog\/wp-json\/wp\/v2\/tags?post=272"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}