Atualizado em 29/10/2026
O Phone Number ID do WhatsApp aparece na seção API Setup do seu app no painel de desenvolvedores da Meta, junto do ID da conta de mensagens (o antigo WABA ID); o App ID fica na barra no topo do painel do app. Se você não tem acesso ao painel, dá para descobrir tudo pela API: GET /debug_token devolve o App ID e os IDs das contas de mensagens que o token alcança, e GET /{waba-id}/phone_numbers lista os números com seus IDs.
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.
Os três IDs (e por que não dá para trocar um pelo outro)
Quem começa na API oficial do WhatsApp costuma confundir os IDs, porque todos são números longos sem prefixo. Cada um aponta para um objeto diferente da Graph API:
| ID | O que identifica | Onde você usa |
|---|---|---|
| Phone Number ID | Um número de telefone cadastrado na Cloud API | POST /{phone-number-id}/messages, mídia, registro do número, perfil comercial |
| WABA ID (ID da conta de mensagens) | A conta que guarda templates, cobrança e assinatura de webhooks | GET/POST/DELETE /{waba-id}/message_templates, GET /{waba-id}/phone_numbers, assinatura de webhooks |
| App ID | O app criado no painel de desenvolvedores da Meta | Configuração de webhooks, Cadastro Incorporado, depuração de tokens |
| ID do portfólio empresarial | A empresa no Business Manager | Gestão de usuários do sistema, ativos e verificação da empresa |
O erro clássico é colocar o WABA ID no caminho de /messages. A chamada falha porque aquele objeto não é um número de telefone. O contrário também acontece: tentar listar templates passando o Phone Number ID. Se você tem dúvida sobre os termos, o glossário da API do WhatsApp explica cada sigla.
O que mudou com a nova estrutura da WABA
Desde 23/09/2026 a Meta separa a WABA em duas contas (a migração foi escalonada e, pelo cronograma da Meta, alcança todas as empresas até meados de outubro de 2026): a conta do WhatsApp, que guarda o número e o perfil, e a conta de mensagens, que guarda templates, cobrança e webhooks. Segundo a página de atualizações nas contas do WhatsApp Business, os WABA IDs existentes continuam iguais e passam a designar o ID da conta de mensagens. Os Phone Number IDs também continuam valendo em todas as APIs.
O ID da conta do WhatsApp ainda não é exposto: a Meta prevê isso para uma nova versão da Graph API no 1º semestre de 2027, e só a partir da fase 3 (1º semestre de 2028) as rotas que hoje recebem o Phone Number ID no caminho vão exigir esse novo ID. Os detalhes estão em conta do WhatsApp x conta de mensagens. Por isso, neste artigo, “WABA ID” e “ID da conta de mensagens” são o mesmo número.
Onde encontrar no painel de desenvolvedores da Meta
O caminho abaixo segue o guia de primeiros passos da Cloud API.
- Acesse developers.facebook.com/apps e abra o app que usa o caso de uso do WhatsApp.
- No menu lateral, abra API Setup (na criação do app, você cai em Customize use case > Connect on WhatsApp > Quickstart, e o API Setup fica no menu da esquerda).
- Depois que o app está ligado a uma conta de mensagens, o ID da conta de mensagens aparece no painel API Setup.
- No mesmo painel, você escolhe o número no campo From para enviar a mensagem de teste. O guia da Meta pede para guardar o phone number ID e o ID da conta de mensagens desse passo para usar depois.
Se você tem mais de um número, confira qual está selecionado em From antes de copiar: cada número tem o próprio Phone Number ID, e todos podem pertencer à mesma conta de mensagens.
App ID
O App ID é gerado quando o app é criado. A documentação do painel de apps diz que a barra no topo do painel, depois que você seleciona um app, mostra o App ID e permite alternar entre apps. As configurações ficam em Settings, dividido em Basic e Advanced; é em Basic que você 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.
Quer testar enquanto lê? Crie sua conta na Vectalk e envie a primeira mensagem pela API oficial. Criar conta grátis →
Onde encontrar no Business Settings
Se você não é desenvolvedor do app, mas é administrador da empresa, o caminho é o Business Manager. A página da Meta sobre usuários do sistema indica:
- ID da conta de mensagens (WABA ID): Business Settings > Accounts > WhatsApp Business Accounts. Selecione a conta e o painel de detalhes mostra o ID.
- ID do portfólio empresarial: Business Settings > Business Info.
Depois da migração, a Meta informa que o menu Accounts do Meta Business Suite passa a ter duas abas, WhatsApp Accounts e Messaging Accounts, no lugar da visão única de WABA; o ID da conta de mensagens fica na aba Messaging Accounts. Lembre que o ID que aparece na URL do Business Manager é o do portfólio que você está usando, não necessariamente o dono da conta do WhatsApp.
Como descobrir os IDs pela API
Quando você recebe só um token (de um cliente, de um colega ou de um Cadastro Incorporado), a API é o jeito mais confiável de descobrir os IDs. Os exemplos usam a versão v26.0 da Graph API, a mesma dos exemplos atuais da Meta.
1. App ID e WABA ID com debug_token
O endpoint debug_token inspeciona um token. Segundo a referência do debug_token, a resposta traz app_id, application, is_valid, expires_at, scopes e granular_scopes, entre outros. Para chamar, use um token de app ou um token de usuário do desenvolvedor do app; no fluxo de parceiros, a Meta usa o token do usuário do sistema no cabeçalho.
curl -G "https://graph.facebook.com/v26.0/debug_token" \
--data-urlencode "input_token=TOKEN_A_INSPECIONAR" \
-H "Authorization: Bearer TOKEN_DO_USUARIO_DO_SISTEMA"Resposta resumida (valores de exemplo):
{
"data": {
"app_id": "670843887433847",
"application": "Minha Integração",
"is_valid": true,
"scopes": ["whatsapp_business_management", "whatsapp_business_messaging"],
"granular_scopes": [
{
"scope": "whatsapp_business_management",
"target_ids": ["102289599326934"]
},
{
"scope": "whatsapp_business_messaging",
"target_ids": ["102289599326934"]
}
]
}
}O app_id é o App ID. Em granular_scopes, os target_ids do escopo whatsapp_business_management são os IDs das contas de mensagens que deram essa permissão ao app. A página de gestão de contas para parceiros explica que as contas integradas mais recentemente aparecem primeiro, então, logo depois de um Cadastro Incorporado, o primeiro ID da lista é o da conta recém-compartilhada.
2. Phone Number IDs com /phone_numbers
Com o WABA ID em mãos, liste os números da conta, como mostra a documentação de números de telefone:
curl "https://graph.facebook.com/v26.0/102289599326934/phone_numbers" \
-H "Authorization: Bearer SEU_TOKEN"{
"data": [
{
"verified_name": "Loja Exemplo",
"display_phone_number": "+55 11 3000-0000",
"id": "1906385232743451",
"quality_rating": "GREEN"
}
]
}O campo id de cada item é o Phone Number ID. display_phone_number ajuda a saber qual é qual quando a conta tem vários números, e quality_rating mostra a qualidade do número.
3. Conferir um número específico
Se você já tem um Phone Number ID e quer confirmar a que número ele corresponde:
curl "https://graph.facebook.com/v26.0/1906385232743451" \
-H "Authorization: Bearer SEU_TOKEN"A resposta traz display_phone_number, verified_name, quality_rating, code_verification_status e o próprio id.
4. Pelo webhook
Os IDs também chegam em todo evento. Em um webhook de mensagem, entry[].id é o WABA ID (agora, o ID da conta de mensagens) e value.metadata.phone_number_id é o Phone Number ID do número que recebeu a mensagem. É útil para rotear eventos quando um mesmo endpoint atende vários números.
{
"object": "whatsapp_business_account",
"entry": [{
"id": "102289599326934",
"changes": [{
"field": "messages",
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "551130000000",
"phone_number_id": "1906385232743451"
}
}
}]
}]
}Erros comuns ao usar os IDs
- WABA ID no lugar do Phone Number ID em
/messages: a chamada falha porque o objeto não suporta a operação. Confira comGET /{id}o que aquele número representa. - Phone Number ID do número de teste em produção: o número de teste do API Setup tem um ID próprio. Ao migrar para o número real, troque o ID na configuração.
- Token sem acesso ao ativo: o ID está certo, mas o token (de outro app ou de um usuário do sistema sem o ativo atribuído) não enxerga a conta. Gere um token permanente com usuário do sistema com os ativos certos.
- ID do portfólio confundido com WABA ID: o ID que aparece na URL do Business Manager é do portfólio.
Os códigos de erro que aparecem em cada caso estão em erros da API do WhatsApp. Para testar essas chamadas sem escrever código, veja como testar a API do WhatsApp no Postman.
Onde ver os IDs na Vectalk
Na Vectalk, cada número conectado vira uma instância. Ao conectar a conta pelo Cadastro Incorporado em Instâncias → Conectar conta, a plataforma importa o phone_number_id, o waba_id e o token de acesso, como descreve o guia rápido. Pela documentação de instâncias, cada instância reúne phone_number_id, waba_id (com a nova estrutura, o ID da conta de mensagens), business_id e o token, que fica sob gestão da Vectalk.
No painel, a tela de instâncias mostra o perfil e os IDs do número, além de webhooks, API keys e o envio de mensagem de teste. Pela API, com um token de instância:
# Dados do número da instância (o Phone Number ID é resolvido pelo token)
curl "https://apis.vectalk.com.br/api/phone-numbers?fields=id,display_phone_number,verified_name,quality_rating" \
-H "Authorization: Bearer SEU_TOKEN_DE_INSTANCIA"
# Todos os números da conta de mensagens (o WABA ID é resolvido pelo token)
curl "https://apis.vectalk.com.br/api/phone-numbers/list" \
-H "Authorization: Bearer SEU_TOKEN_DE_INSTANCIA"As duas rotas estão em Obter número e Listar números do WABA. Com token de instância, você nem precisa passar o Phone Number ID para enviar mensagens; com token de organização, inclua phone_number_id no corpo, como explica a página de autenticação. O mesmo vale para enviar templates. Para começar, crie a conta em apps.vectalk.com.br/register.
Perguntas frequentes
O Phone Number ID é o número de telefone?
Não. É um identificador interno da Meta para aquele número na Cloud API. O número em si aparece em display_phone_number. No campo to das mensagens você usa o telefone do destinatário; no caminho da URL, o Phone Number ID do remetente.
O WABA ID mudou com a nova estrutura de contas?
Não. A Meta informa que os WABA IDs existentes continuam iguais e passam a designar o ID da conta de mensagens. O ID da conta do WhatsApp só deve ser exposto numa versão nova da Graph API prevista para 2027.
Onde fica o App Secret?
Em Settings > Basic do painel do app. Ele serve para validar a assinatura dos webhooks e nunca deve ir para o front-end nem para o repositório.
Consigo descobrir o WABA ID só com o token?
Sim. Chame GET /debug_token com o token em input_token e leia os target_ids do escopo whatsapp_business_management. Depois use GET /{waba-id}/phone_numbers para chegar aos Phone Number IDs.
Um número pode ter dois Phone Number IDs?
Não há indicação disso na documentação: cada número tem um Phone Number ID. O que muda no novo modelo é que um mesmo número pode estar ligado a mais de uma conta de mensagens, cada uma com seu ID. Para começar do zero, veja como conseguir acesso à API do WhatsApp.
Fontes oficiais consultadas em 29/10/2026: Get started (Meta), Phone numbers (Meta), Manage accounts para parceiros (Meta), Usuários do sistema (Meta), Atualizações nas contas do WhatsApp Business (Meta), Debug Token (Graph API), Painel de apps (Meta), Instâncias (Vectalk), Números de telefone (Vectalk).
Coloque o WhatsApp oficial da sua empresa para funcionar
Crie sua conta, conecte seu número à API oficial (dá para manter o app com coexistência) e comece a atender e enviar mensagens.