{"id":795,"date":"2026-10-29T13:29:59","date_gmt":"2026-10-29T13:29:59","guid":{"rendered":"https:\/\/vectalk.com.br\/blog\/onde-encontrar-phone-number-id-whatsapp\/"},"modified":"2026-10-29T13:30:06","modified_gmt":"2026-10-29T13:30:06","slug":"onde-encontrar-phone-number-id-whatsapp","status":"publish","type":"post","link":"https:\/\/vectalk.com.br\/blog\/onde-encontrar-phone-number-id-whatsapp\/","title":{"rendered":"Onde encontrar o Phone Number ID, o WABA ID e o App ID da API do WhatsApp"},"content":{"rendered":"\n

Atualizado em 29\/10\/2026<\/em><\/p>\n\n\n\n

O Phone Number ID<\/strong> do WhatsApp aparece na se\u00e7\u00e3o API Setup<\/strong> do seu app no painel de desenvolvedores da Meta, junto do ID da conta de mensagens (o antigo WABA ID); o App ID<\/strong> fica na barra no topo do painel do app. Se voc\u00ea n\u00e3o tem acesso ao painel, d\u00e1 para descobrir tudo pela API: GET \/debug_token<\/code> devolve o App ID e os IDs das contas de mensagens que o token alcan\u00e7a, e GET \/{waba-id}\/phone_numbers<\/code> lista os n\u00fameros com seus IDs.<\/p>\n\n\n\n

Este guia explica o que cada ID identifica, onde achar cada um na interface da Meta, como obter pela Graph API e onde eles ficam na Vectalk.<\/p>\n\n\n\n

Os tr\u00eas IDs (e por que n\u00e3o d\u00e1 para trocar um pelo outro)<\/h2>\n\n\n\n

Quem come\u00e7a na API oficial do WhatsApp<\/a> costuma confundir os IDs, porque todos s\u00e3o n\u00fameros longos sem prefixo. Cada um aponta para um objeto diferente da Graph API:<\/p>\n\n\n\n

ID<\/th>O que identifica<\/th>Onde voc\u00ea usa<\/th><\/tr><\/thead>
Phone Number ID<\/td>Um n\u00famero de telefone cadastrado na Cloud API<\/td>POST \/{phone-number-id}\/messages<\/code>, m\u00eddia, registro do n\u00famero, perfil comercial<\/td><\/tr>
WABA ID (ID da conta de mensagens)<\/td>A conta que guarda templates, cobran\u00e7a e assinatura de webhooks<\/td>GET\/POST\/DELETE \/{waba-id}\/message_templates<\/code>, GET \/{waba-id}\/phone_numbers<\/code>, assinatura de webhooks<\/td><\/tr>
App ID<\/td>O app criado no painel de desenvolvedores da Meta<\/td>Configura\u00e7\u00e3o de webhooks, Cadastro Incorporado, depura\u00e7\u00e3o de tokens<\/td><\/tr>
ID do portf\u00f3lio empresarial<\/td>A empresa no Business Manager<\/td>Gest\u00e3o de usu\u00e1rios do sistema, ativos e verifica\u00e7\u00e3o da empresa<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

O erro cl\u00e1ssico \u00e9 colocar o WABA ID no caminho de \/messages<\/code>. A chamada falha porque aquele objeto n\u00e3o \u00e9 um n\u00famero de telefone. O contr\u00e1rio tamb\u00e9m acontece: tentar listar templates passando o Phone Number ID. Se voc\u00ea tem d\u00favida sobre os termos, o gloss\u00e1rio da API do WhatsApp<\/a> explica cada sigla.<\/p>\n\n\n\n

O que mudou com a nova estrutura da WABA<\/h3>\n\n\n\n

Desde 23\/09\/2026 a Meta separa a WABA em duas contas (a migra\u00e7\u00e3o foi escalonada e, pelo cronograma da Meta, alcan\u00e7a todas as empresas at\u00e9 meados de outubro de 2026): a conta do WhatsApp<\/strong>, que guarda o n\u00famero e o perfil, e a conta de mensagens<\/strong>, que guarda templates, cobran\u00e7a e webhooks. Segundo a p\u00e1gina de atualiza\u00e7\u00f5es nas contas do WhatsApp Business<\/a>, os WABA IDs existentes continuam iguais e passam a designar o ID da conta de mensagens. Os Phone Number IDs tamb\u00e9m continuam valendo em todas as APIs.<\/p>\n\n\n\n

O ID da conta do WhatsApp ainda n\u00e3o \u00e9 exposto: a Meta prev\u00ea isso para uma nova vers\u00e3o da Graph API no 1\u00ba semestre de 2027, e s\u00f3 a partir da fase 3 (1\u00ba semestre de 2028) as rotas que hoje recebem o Phone Number ID no caminho v\u00e3o exigir esse novo ID. Os detalhes est\u00e3o em conta do WhatsApp x conta de mensagens<\/a>. Por isso, neste artigo, “WABA ID” e “ID da conta de mensagens” s\u00e3o o mesmo n\u00famero.<\/p>\n\n\n\n

Onde encontrar no painel de desenvolvedores da Meta<\/h2>\n\n\n\n

O caminho abaixo segue o guia de primeiros passos da Cloud API<\/a>.<\/p>\n\n\n\n

    \n
  1. Acesse developers.facebook.com\/apps<\/a> e abra o app que usa o caso de uso do WhatsApp.<\/li>\n\n\n
  2. No menu lateral, abra API Setup<\/strong> (na cria\u00e7\u00e3o do app, voc\u00ea cai em Customize use case > Connect on WhatsApp > Quickstart<\/em>, e o API Setup fica no menu da esquerda).<\/li>\n\n\n
  3. Depois que o app est\u00e1 ligado a uma conta de mensagens, o ID da conta de mensagens<\/strong> aparece no painel API Setup.<\/li>\n\n\n
  4. No mesmo painel, voc\u00ea escolhe o n\u00famero no campo From<\/strong> para enviar a mensagem de teste. O guia da Meta pede para guardar o phone number ID<\/strong> e o ID da conta de mensagens<\/strong> desse passo para usar depois.<\/li>\n\n<\/ol>\n\n\n\n

    Se voc\u00ea tem mais de um n\u00famero, confira qual est\u00e1 selecionado em From<\/strong> antes de copiar: cada n\u00famero tem o pr\u00f3prio Phone Number ID, e todos podem pertencer \u00e0 mesma conta de mensagens.<\/p>\n\n\n\n

    App ID<\/h3>\n\n\n\n

    O App ID \u00e9 gerado quando o app \u00e9 criado. A documenta\u00e7\u00e3o do painel de apps<\/a> diz que a barra no topo do painel, depois que voc\u00ea seleciona um app, mostra o App ID e permite alternar entre apps. As configura\u00e7\u00f5es ficam em Settings<\/strong>, dividido em Basic<\/strong> e Advanced<\/strong>; \u00e9 em Basic que voc\u00ea encontra o App Secret, usado para validar a assinatura dos webhooks. O App ID pode aparecer no front-end (no Cadastro Incorporado, por exemplo); o App Secret nunca.<\/p>\n\n\n\n

    Onde encontrar no Business Settings<\/h2>\n\n\n\n

    Se voc\u00ea n\u00e3o \u00e9 desenvolvedor do app, mas \u00e9 administrador da empresa, o caminho \u00e9 o Business Manager. A p\u00e1gina da Meta sobre usu\u00e1rios do sistema<\/a> indica:<\/p>\n\n\n\n