API Oficial do WhatsApp (Meta)

Este guia explica como integrar a API Oficial do WhatsApp (WABA) ao sistema NextChat.

API Oficial do WhatsApp (Meta)

⚠️ Considerações importantes

A API oficial não oferece suporte a grupos.
O envio de templates está configurado ➤ Tabela oficial de preços da Meta
A API oficial não exibe a foto do contato.
Você tem 24 horas para responder uma mensagem do cliente via NextChat. Após 24 horas somente via template pode ser iniciada uma conversa.
API oficial também pode ser banida.

✅ Manual de Integração com a API Oficial do WhatsApp (Meta)

1️⃣ Acessar o Painel da Meta

Entre em: https://developers.facebook.com/
Faça login com sua conta do Facebook.
Clique em Criar Aplicativo.
Selecione Outro > Empresa.

2️⃣ Configurar o WhatsApp

No painel de Produtos, localize WhatsApp e clique em Configurar.
Escolha a empresa vinculada à sua conta.

Se ainda não tiver uma empresa, será necessário criar uma.
Clique em Começar a usar a API.

3️⃣ Ajustes Iniciais do Aplicativo

Acesse Configurações do App > Básico.
Preencha os campos obrigatórios:
- URL da Política de Privacidade
- URL dos Termos de Serviço
Clique em Salvar Alterações.
No topo da página, altere o status do app de Em Desenvolvimento para Ativo.

4️⃣ Configurar a API do WhatsApp

No menu lateral, vá em WhatsApp > Configuração da API.
Na etapa 5, clique em Adicionar Número de Telefone.
Informe os dados solicitados e conclua a validação.

📲 Caso precise de um número para utilizar no sistema, você pode adquirir facilmente através do portal:
https://telera.nextchat.com.br

5️⃣ Gerar Token Temporário

Ainda na tela de configuração da API, clique em Gerar Token de Acesso Temporário.
Copie o token gerado (ele será usado no NextChat).

6️⃣ Adicionar Canal no NextChat

No NextChat, vá em Adicionar Canal.
Selecione a opção WABA API Oficial.
Cole o Token de Acesso gerado anteriormente.

📌 Também será necessário copiar exatamente como aparece no painel da Meta:

ID do Número de Telefone
ID da Conta do WhatsApp Business
Versão da API (ex.: v23.0)

⚠️ Importante: No campo Versão da API, informe exatamente o valor exibido pela Meta, incluindo a letra "v" minúscula no início (ex.: v23.0, v24.0).

Não altere o formato. Exemplos incorretos:

❌ 23.0
❌ V23.0
❌ v 23.0

Exemplos corretos:

✅ v23.0
✅ v24.0

7️⃣ Configurar Webhook

No painel da Meta, acesse WhatsApp > Configuração da API > Etapa 3: Configure Webhooks.
No NextChat, clique em Gerar Token de Webhook e copie:
- Token de Verificação
- URL de Callback
Salve o canal no nextchat
Retorne ao painel da Meta, clique em Configurar Webhook e cole as informações.
Clique em Verificar e Salvar.
Marque o máximos para Assinado, principalmente o de messages.
Não esqueça marcar messages ele principal.

8️⃣ Registrar Telefone no NextChat

Acesse Ferramentas > Registrar Telefone.
Digite um PIN de 6 dígitos (caso já tenha usado um PIN antes, utilize o mesmo).

🔐 PIN de Verificação em Duas Etapas

Informe um PIN de 6 dígitos numéricos.

Se você nunca configurou um PIN para este número, crie um PIN de 6 dígitos (exemplo: 123456).
Se já configurou um PIN anteriormente, informe o mesmo PIN utilizado na época.

⚠️ Importante: Esse PIN é configurado apenas uma vez para cada número de WhatsApp Business. Caso ele já exista, será necessário informar exatamente o mesmo PIN para concluir a conexão.

9️⃣ Gerar Token Permanente

⚠️ O token temporário expira em algumas horas.
Para garantir o funcionamento contínuo, gere um Token Permanente.

👉 Guia oficial:
Gerar Token Permanente – Meta

🔟 Atualizar Token no NextChat

No NextChat, edite o canal criado e substitua o Token de Acesso temporário pelo Token Permanente.

✅ Pronto! Seu NextChat está integrado com a API Oficial do WhatsApp (Meta).

Esse guia pode lhe ajudar também https://blog.meujames.com/como-habilitar-seu-numero-api-oficial-whatsapp/

Essa tela exibe:

📄 Dados gerais da conta
📞 Informações do número conectado
🔗 URLs de Webhook configuradas
⚙️ Detalhes técnicos usados pela API Oficial

➡️ Utilize essa tela para confirmar se:

O número está corretamente vinculado
O Webhook está preenchido
As informações da conta estão atualizadas

🔄 Atualizando o Webhook pelo NEXTCHAT

📌 Caminho no sistema

Ferramentas → Atualizar URL Webhook

Essa opção:

Configura automaticamente o Webhook oficial do NextChat
Garante que os eventos (mensagens, status, erros) sejam recebidos corretamente

Importante

Em versões mais antigas do sistema, essa opção pode não estar disponível. Nesse caso, a configuração deve ser feita manualmente via Postman.

https://developers.facebook.com/community/threads/728867380278968/

🔧 Tente configurar o Webhook diretamente pela API da Meta

Utilize a requisição oficial no Postman para sobrescrever (override) a URL do Webhook:

https://www.postman.com/meta/whatsapp-business-platform/request/13382743-d9da58cd-7fc6-4dbc-a7cc-756d13c3c25a?tab=body

Essa requisição força a API da Meta a usar a URL informada como Webhook principal.

🔍 Verificando qual Webhook está ativo

É possível consultar qual URL de Webhook está realmente configurada no número.

Passo importante

Verifique o campo Webhook (WBA)
Se existir uma URL nesse campo:
- ⚠️ Ela tem prioridade sobre o Webhook configurado na aplicação
- Mesmo que o NextChat esteja configurado corretamente, ele não receberá eventos

Consulta via Postman

Utilize a requisição abaixo para consultar os números e seus Webhooks configurados:

https://www.postman.com/meta/whatsapp-business-platform/request/l8ugxbv/get-phone-numbers?tab=auth

✅ Checklist rápido de solução

Antes verifique:

✔️ Webhook aparece corretamente em Ferramentas → Informações da Conta
✔️ Não existe outro Webhook configurado em Webhook (WBA)
✔️ URL do Webhook está pública e acessível
✔️ Webhook foi atualizado pelo NextChat ou via Postman
✔️ Eventos de mensagem estão habilitados na Meta

📌 Dica importante

Sempre que:

Trocar domínio
Migrar servidor
Restaurar backup
Alterar configurações da conta Meta

➡️ Atualize novamente o Webhook, pois a Meta pode manter URLs antigas ativas.

API Oficial do WhatsApp (Meta)