💬
API do WhatsApp (Cloud API)
Guia completo e ilustrado para configurar sua conta na Meta, do cadastro até a obtenção do WABA ID, Telefone ID, Token Permanente e do Webhook.
Feito para iniciantes — passo a passo, sem pular nada.
Versão 1.0 • Atualizado em Junho de 2026
O que você vai aprender
Este guia leva você do zero até deixar o WhatsApp pronto para enviar e receber mensagens pelo seu sistema. Siga os passos na ordem.
Passo 1. Onde acessar e criar a conta na Metapág. 3
Passo 2. Cadastrar-se como desenvolvedor (Meta for Developers)pág. 4
Passo 3. Criar a Conta Comercial (Meta Business)pág. 5
Passo 4. Adicionar um cartão de crédito para cobrançapág. 6
Passo 5. Criar o aplicativo do WhatsApppág. 7
Passo 6. Encontrar o WABA ID e o Telefone IDpág. 8
Passo 7. Gerar o Token Permanente (que não expira)pág. 9
Passo 8. Configurar o Webhook do seu sistemapág. 11
Resumo final — checklist do que você vai copiarpág. 13
Antes de começar, tenha em mãos:
- Um e-mail e uma conta no Facebook (pessoal mesmo serve para entrar);
- Um número de telefone que ainda não esteja em uso no aplicativo WhatsApp comum (será o número da API);
- Um cartão de crédito internacional para a cobrança;
- O endereço (URL) do seu sistema/provedor, onde o webhook vai apontar.
⚠️ As imagens deste guia são ilustrações que reproduzem o layout do painel da Meta. As telas reais podem ter pequenas diferenças de cor, texto ou posição, pois a Meta atualiza a interface com frequência. Os endereços (URLs) e os nomes dos botões indicados são reais.
1Onde acessar e criar a conta na Meta
Tudo do WhatsApp API é controlado pela Meta (empresa dona do Facebook, Instagram e WhatsApp). O primeiro passo é ter uma conta no Facebook, porque é com ela que você entra em todos os painéis.
🔗 Endereço para acessar: https://www.facebook.com
Como fazer
- Abra o navegador (Chrome, Edge, etc.) e digite facebook.com.
- Se você já tem conta, clique em “Entrar” e faça login.
- Se não tem, clique em “Criar nova conta” e preencha nome, e-mail, senha e data de nascimento.
- Confirme o e-mail/telefone que a Meta enviar.
🔒https://www.facebook.com
facebook
Conecte-se para acessar os painéis da Meta
E-mail ou telefone
voce@email.com
Senha
••••••••
Entrar
———— ou ————
Criar nova conta
💡 Dica: use um e-mail que você acessa com facilidade. A Meta envia códigos de confirmação e avisos de cobrança para esse e-mail.
2Cadastrar-se como desenvolvedor
Para criar aplicativos (incluindo o do WhatsApp), sua conta precisa estar registrada no Meta for Developers. É grátis e leva 2 minutos.
🔗 Endereço para acessar: https://developers.facebook.com
Como fazer
- Acesse developers.facebook.com (já logado no Facebook).
- No canto superior direito, clique em “Começar” (ou “Get Started”).
- Aceite os Termos para Desenvolvedores.
- Confirme seu e-mail e selecione a função (pode escolher “Desenvolvedor”).
🔒https://developers.facebook.com
∞ Meta for Developers
Começar
Crie com a Meta
Registre-se como desenvolvedor para criar aplicativos e usar a API do WhatsApp.
↑ clique aqui para iniciar o cadastro
📌 Observação: se aparecer um pedido de verificação por SMS ou e-mail durante o cadastro, é normal — é a Meta confirmando que a conta é sua.
3Criar a Conta Comercial (Meta Business)
A Conta Comercial da Meta (Meta Business) é onde ficam suas configurações de empresa, formas de pagamento, usuários e a sua conta do WhatsApp. É obrigatória para usar a API em produção.
🔗 Endereço para acessar: https://business.facebook.com
Como fazer
- Acesse business.facebook.com.
- Clique em “Criar conta”.
- Informe o nome da empresa, seu nome e o e-mail comercial.
- Confirme. Pronto: sua conta comercial está criada.
🔒https://business.facebook.com/overview
∞ Meta Business Suite
Criar uma conta comercial
Reúna seus ativos da Meta em um só lugar.
Nome da empresa
Minha Empresa LTDA
Seu nome
João da Silva
E-mail comercial
contato@minhaempresa.com.br
Criar conta
💡 Importante: guarde bem esse acesso. Daqui em diante, o painel business.facebook.com/settings (chamado de Configurações do Negócio) será muito usado — é lá que ficam pagamentos, usuários e tokens.
4Adicionar um cartão de crédito para cobrança
A WhatsApp Cloud API tem um nível gratuito, mas a partir de certo volume de conversas há cobrança. Para não ter o serviço bloqueado, cadastre um cartão de crédito desde já.
🔗 Endereço para acessar: https://business.facebook.com/billing_hub/payment_settings
(ou: Configurações do Negócio → Pagamentos / Cobrança)
Como fazer
- Entre em business.facebook.com/settings.
- No menu da esquerda, procure “Pagamentos” ou “Cobrança / Faturamento”.
- Clique em “Adicionar forma de pagamento”.
- Escolha “Cartão de crédito ou débito”, preencha número, validade, CVV e o nome impresso.
- Salve. O cartão fica vinculado à sua conta comercial.
🔒https://business.facebook.com/billing_hub/payment_settings
Formas de pagamento
Adicione um cartão para cobrir o uso da API.
+ Adicionar forma de pagamento
Número do cartão
4111 1111 1111 1111
Salvar cartão
🚨 Atenção: sem forma de pagamento válida, ao ultrapassar o limite gratuito o envio de mensagens é interrompido. Cadastrar o cartão agora evita surpresas depois.
5Criar o aplicativo do WhatsApp
Agora vamos criar o “aplicativo” na Meta. É ele que conecta o WhatsApp ao seu sistema.
🔗 Endereço para acessar: https://developers.facebook.com/apps
Como fazer
- Acesse developers.facebook.com/apps e clique em “Criar aplicativo”.
- Em “Do que seu aplicativo precisa?”, selecione “Outro” e depois o tipo “Empresa” (Business).
- Dê um nome ao app (ex.: “WhatsApp Meu Provedor”), informe o e-mail e vincule à sua conta comercial (a do Passo 3).
- Clique em “Criar aplicativo” (pode pedir sua senha do Facebook).
- No painel do app, encontre o card “WhatsApp” e clique em “Configurar”.
🔒https://developers.facebook.com/apps/create
∞ Meta for Developers
Criar um aplicativo
Escolha o tipo de aplicativo.
🛍️
Empresa
Recomendado p/ WhatsApp
🎮
Games
👤
Consumidor
Nome do aplicativo
WhatsApp Meu Provedor
Criar aplicativo
📌 Depois de criado, no menu lateral aparecerá “WhatsApp”. Clique em “Configuração da API” (API Setup) — é lá que estão as credenciais do próximo passo.
6Encontrar o WABA ID e o Telefone ID
Na tela “Configuração da API” do WhatsApp, a Meta mostra de uma vez três informações importantes. Vamos identificar cada uma.
🔗 Como chegar: Painel do app → menu lateral WhatsApp → Configuração da API (API Setup)
URL no formato: https://developers.facebook.com/apps/SEU-APP-ID/whatsapp-business/wa-dev-console/
| Credencial | O que é | Onde aparece na tela |
|---|
WABA ID
(ID da Conta do WhatsApp Business) | Identifica a sua conta do WhatsApp dentro da Meta. | Linha “Identificação da conta do WhatsApp Business”. |
Telefone ID
(Phone Number ID) | Identifica o número de telefone específico que envia as mensagens. | Logo abaixo do número, em “Identificação do número de telefone”. |
| Token temporário | Senha de acesso que expira em 24 h — serve só para testes. | Campo “Token de acesso temporário”. No Passo 7 trocaremos por um permanente. |
🔒https://developers.facebook.com/apps/100200300/whatsapp-business/wa-dev-console
∞ Meta WhatsApp › Configuração da API
Token de acesso temporário
EAAG...token-curto-24h...ZDZDCopiar
Identificação do número de telefone
(Telefone ID)
109998887776665
Identificação da conta do WhatsApp Business
(WABA ID)
102030405060708
↑ Estes dois números você vai copiar para o seu sistema.
💡 Copie o WABA ID e o Telefone ID e guarde num bloco de notas. São apenas números e não mudam.
7Gerar o Token Permanente (que não expira)
O token temporário do passo anterior expira em 24 horas — inútil para produção. Vamos criar um token permanente usando um Usuário do Sistema. Parece técnico, mas é só seguir a sequência.
🔗 Endereço para acessar: https://business.facebook.com/settings/system-users
(Configurações do Negócio → Usuários → Usuários do sistema)
7.1 — Criar o Usuário do Sistema
- Acesse o link acima e clique em “Adicionar”.
- Dê um nome (ex.: “sistema-whatsapp”) e escolha a função “Administrador”.
- Clique em “Criar usuário do sistema”.
🔒https://business.facebook.com/settings/system-users
Usuários do sistema
+ Adicionar
Nome
sistema-whatsapp
Função
Administrador
Criar usuário do sistema
7.2 — Dar acesso ao app e à conta do WhatsApp
- Com o usuário selecionado, clique em “Adicionar ativos”.
- Em “Aplicativos”, marque o app criado no Passo 5 e dê controle total.
- Em “Contas do WhatsApp”, marque a sua WABA e dê controle total. Salve.
📌 Esse passo é o que costuma ser esquecido. Sem vincular os ativos (app + conta do WhatsApp), o token gerado não terá permissão para enviar mensagens.
7Gerar o Token Permanente — continuação
7.3 — Gerar o token
- Ainda no usuário do sistema, clique em “Gerar novo token”.
- Selecione o aplicativo do WhatsApp.
- Em “Validade do token”, escolha “Nunca expira” (Never).
- Marque as duas permissões:
whatsapp_business_messaging (enviar/receber mensagens)whatsapp_business_management (gerenciar a conta)
- Clique em “Gerar token”.
🔒https://business.facebook.com/settings/system-users · Gerar token
Gerar token de acesso
Aplicativo
WhatsApp Meu Provedor
Validade do token
Nunca expira ▾
Permissões
☑ whatsapp_business_messaging
☑ whatsapp_business_management
Gerar token
7.4 — Copiar e guardar com segurança
Copie agora — ele só aparece uma vez.
EAAGm0PX4ZCpsBO7permanente9XyZ...esteNAOexpira...ZDZDCopiar
🚨 Guarde este token como uma senha. Ele aparece uma única vez. Se perder, não tem problema — basta gerar outro. Nunca compartilhe nem coloque em lugar público (e-mail, prints, sites). Quem tem o token consegue enviar mensagens pela sua conta.
8Configurar o Webhook do seu sistema
O Webhook é o endereço para onde a Meta envia, em tempo real, as mensagens que chegam no seu WhatsApp. É aqui que você informa o link do seu sistema/provedor.
🔗 Como chegar: Painel do app → menu lateral WhatsApp → Configuração (Configuration) → seção Webhook
URL no formato: https://developers.facebook.com/apps/SEU-APP-ID/whatsapp-business/wa-settings/
Quais valores informar
| Campo | O que colocar |
|---|
URL de retorno de chamada
(Callback URL) | O endereço do webhook do seu sistema. Exemplo deste guia:
https://meu-provedor.vigoweb.com.br/api/webhook_whatsapp |
Token de verificação
(Verify Token) | Uma senha qualquer que você inventa (ex.: meu-token-secreto-123). A mesma senha precisa estar configurada no seu sistema. |
🚨
MUITO IMPORTANTE — substitua o “meu-provedor”!
No exemplo
https://meu-provedor.vigoweb.com.br/api/webhook_whatsapp, o trecho destacado
“meu-provedor” é só um modelo.
Você deve trocá-lo pelo
endereço real do seu sistema. Por exemplo, se o seu provedor for acessado em
acmeprovedor.vigoweb.com.br, o webhook correto fica:
https://acmeprovedor.vigoweb.com.br/api/webhook_whatsapp
O final /api/webhook_whatsapp permanece igual — só muda o nome do seu domínio.
🔒https://developers.facebook.com/apps/100200300/whatsapp-business/wa-settings
∞ Meta WhatsApp › Configuração › Webhook
Editar webhook
URL de retorno de chamada (Callback URL)
https://meu-provedor.vigoweb.com.br/api/webhook_whatsapp
↑ troque "meu-provedor" pelo endereço real do SEU sistema
Token de verificação (Verify Token)
meu-token-secreto-123
Verificar e salvar
8Webhook — finalizar a inscrição
Inscrever-se nos eventos de mensagem
Depois de salvar a URL, você precisa dizer à Meta quais eventos quer receber. O principal é “messages” (mensagens recebidas).
- Na mesma seção Webhook, clique em “Gerenciar” (Manage).
- Procure a linha “messages” e clique em “Inscrever-se” (Subscribe).
- Pronto — agora toda mensagem recebida será enviada ao seu sistema.
🔒Gerenciar campos do webhook
Campos do webhook
| Campo | Descrição | Ação |
|---|
| messages | Mensagens recebidas dos clientes | Inscrito ✓ |
| message_template_status_update | Status de modelos de mensagem | Inscrever-se |
📌 Como a verificação funciona (resumo técnico): ao clicar em “Verificar e salvar”, a Meta faz uma chamada ao seu webhook enviando o verify token. O seu sistema precisa responder confirmando o mesmo token. Se o seu provedor já tem suporte a WhatsApp, isso normalmente é automático — basta cadastrar a URL e o mesmo token nos dois lados.
💡 O seu webhook precisa estar em HTTPS (com cadeado/SSL) e acessível pela internet. Endereços http:// ou localhost não são aceitos pela Meta.
✅ Resumo final — o que você vai usar no seu sistema
Ao terminar todos os passos, você terá em mãos estas informações. Copie-as para a configuração do seu provedor/sistema:
| Informação | Onde obteve | Exemplo |
|---|
| WABA ID | Passo 6 — Configuração da API | 102030405060708 |
| Telefone ID | Passo 6 — Configuração da API | 109998887776665 |
| Token Permanente | Passo 7 — Usuário do sistema | EAAG...ZDZD |
| URL do Webhook | Passo 8 — você define | https://seudominio.vigoweb.com.br/api/webhook_whatsapp |
| Verify Token | Passo 8 — você inventa | meu-token-secreto-123 |
Checklist final
- Conta no Facebook criada e logada
- Cadastro no Meta for Developers concluído
- Conta Comercial (Meta Business) criada
- Cartão de crédito adicionado para cobrança
- Aplicativo do tipo “Empresa” criado com o produto WhatsApp
- WABA ID e Telefone ID copiados
- Token Permanente gerado (validade “Nunca expira”) e guardado com segurança
- Webhook configurado com a URL do seu sistema (com “meu-provedor” substituído pelo domínio real)
- Evento “messages” inscrito
Endereços úteis (favorite todos):
| Para quê | Endereço |
|---|
| Entrar / login | https://www.facebook.com |
| Criar apps (desenvolvedor) | https://developers.facebook.com/apps |
| Configurações do negócio | https://business.facebook.com/settings |
| Usuários do sistema (token) | https://business.facebook.com/settings/system-users |
| Pagamentos / cobrança | https://business.facebook.com/billing_hub/payment_settings |
| Gerenciador do WhatsApp | https://business.facebook.com/wa/manage |
Documento gerado como material de apoio. As imagens são ilustrações do layout do painel da Meta; a interface real pode variar conforme atualizações da plataforma. Em caso de dúvida, a documentação oficial está em https://developers.facebook.com/docs/whatsapp/cloud-api.