Documentos WhatsBot → Configuração da API WhatsApp Cloud
Abra o WhatsBot→
📋 Antes de começar

O que você vai Precisar

Certifique-se de ter tudo pronto antes de começar a montagem. Leva cerca de 5 minutos para reunir tudo.

✓

Conta do Facebook/Meta

A conta pessoal do Facebook para acessar o Portal do Desenvolvedor Meta.

✓

Nome e detalhes da empresa

Nome da sua empresa e endereço de e-mail para contato.

✓

Número de telefone

Um número de telefone que ainda não esteja conectado ao WhatsApp (ou use o número de teste gratuito da Meta).

✓

Conta whatsBot

Uma conta ativa do whatsBot com acesso de administrador.

✓

Verificação de negócios (Opcional)

Necessário apenas se você quiser atualizar para uma conta de nível de produção.

ℹ️
Boas notícias! A Meta oferece um número de telefone de teste gratuito para que você possa testar tudo antes de conectar seu número comercial real. Você pode começar imediatamente, sem qualquer verificação comercial.
🛠️Guia passo a passoe

Completo Guia de Configuração

Siga cada passo com atenção. Capturas de tela estão incluídas em cada etapa para guiá-lo visualmente.

1

Criar conta de desenvolvedor Meta

Go to developers.facebook.com e faça login com sua conta do Facebook. Se esta for sua primeira vez, você será solicitado a se registrar como desenvolvedor — basta seguir as instruções rápidas.

🔗
Visita developers.facebook.com e clique "Comece agora" ou faça login com sua conta existente do Facebook.
✅
Você terminou quando: Você pode ver o painel do Meta Developers e a seção "Meus Aplicativos" na barra de navegação superior.
2

Criar um aplicativo Meta

No painel do Meta Developer, acesse Meus Aplicativos e clique no botão verde "Criar Aplicativo" no canto superior direito.

developers.facebook.com/apps/
Meta Apps Dashboard - Create App
Clique aqui ↗

Quando solicitado a escolher um tipo de aplicativo, role para baixo e selecione "Outro", depois escolha "Negócios" como o tipo de aplicativo. Dê um nome ao seu aplicativo (por exemplo, "Meu WhatsApp Empresarial") e insira seu e-mail de contato.

developers.facebook.com/apps/creation/
Create App Form
Preencha o nome e o e-mail do aplicativo.
Clique em Avançar ↓
⚠️
Selecione "Negócios" como tipo de aplicativo. Isso é importante — outros tipos de aplicativo podem não incluir a opção de produto WhatsApp.
3

Adicione o produto WhatsApp ao seu aplicativo

Após criar o aplicativo, abra-o na sua lista de aplicativos. Você verá o painel do aplicativo. Procure por "Personalizar o caso de uso Conectar com clientes pelo WhatsApp" e clique nele para começar.

developers.facebook.com/apps/ → Selecione seu aplicativo
Select App
Clique no seu cartão de aplicativo
Painel de controle do aplicativo
App Dashboard WhatsApp Use Case
Clique em Caso de Uso do WhatsApp
4

Comece a usar a API do WhatsApp

Você será direcionado para a visão geral da Plataforma WhatsApp Business. Clique no botão "Comece a usar a API" para acessar a configuração da API. É aqui que você conectará sua conta comercial e seu número de telefone.

Início rápido → Plataforma WhatsApp Business
Start using the API
Clique neste botão ↗
✅
A Meta criará automaticamente uma Conta de teste do WhatsApp Business gratuita para você. Você pode usá-la para testar tudo antes de adicionar seu número real.
5

Gere seu token de acesso

Na página Configuração da API, você verá uma seção "Token de acesso" na parte superior. Clique em "Gerar token de acesso" — isso cria um token temporário que você pode usar imediatamente. Para uso em produção, você precisará de um token permanente (explicado na próxima etapa).

Página de configuração da API
Generate Access Token and Copy Credentials
① Gere o token aqui
② Número de telefone ID
③ Número de telefone do WhatsApp e ID da conta comercial
⚠️
O token gerado é temporário (expira em aproximadamente 24 horas). Para obter um token permanente, você precisa criar um Usuário do Sistema no Meta Business Manager. Instruções abaixo.
COMO CRIAR UM TOKEN PERMANENTE
1.
Vá para business.facebook.com
2.
Navegue até Configurações → Usuários → Sistema Usuários
3.
Clique "Adicionar" → Defina a função para "Administrador"
4.
Clique "Gerar novo token" → Select your App
5.
Habilitar whatsapp_business_messaging permissão
6.
Copie o token — esta é a sua opção permanente token!
6

Copie suas credenciais

Na página de Configuração da API, copie estes três valores essenciais. Você precisará dos três para configurar o Wagenius na próxima etapa..

📞 Número de telefone ID
994094020461198

Encontrado abaixo do seletor de número de telefone na página de Configuração da API

🏢 ID da conta do WhatsApp Business
227017153508824

Listado ao lado do ID do número de telefone na mesma página

🔑 Token de acesso
EAAMrXm5cJQBRG8h6sIZBzWo409wuBvtvxBwtGh...

Gerado a partir do botão Gerar token de acesso

🚨
Nunca compartilhe seu Token de Acesso publicamente. Trate-o como uma senha. Se for comprometido, gere um novo imediatamente no Meta Business Manager.
7

Configurar o WhatsBot

Agora, faça login no seu painel do WhatsBot e navegue até as Configurações da sua conta do WhatsApp. Cole as credenciais que você copiou na etapa anterior.

preview.wstacks.com/wagenius/user/whatsapp-account/setting/1
Wagenius WhatsApp Settings
Preencha todos os 4 campos.
Número do WhatsApp Seu número de telefone conectado
ID da conta do WhatsApp Business Em Configuração da API Meta → ID WABA
Número de telefone do WhatsApp Em Configuração da API Meta → ID do telefone
ID do aplicativo Em Configuração da API Meta → ID do aplicativo
Token de Acesso Meta O token que você gerou

Após preencher todos os campos, clique no botão laranja "Enviar" para salvar sua configuração.

✅
Dica para o sucesso: Se os campos ficarem verdes ou você vir uma mensagem de sucesso, suas credenciais foram aceitas. Prossiga para a configuração do webhook!
8

Configure seu Webhook

Webhooks permitem que o Meta envie notificações de mensagens para o Wagenius em tempo real. Volte para o Painel de Desenvolvedores do Meta Painel → seu aplicativo → guia Configuração na barra lateral esquerda.

Aplicativo → Casos de uso → Personalizar → Configuração
Webhook Configuration
Insira o URL de retorno de chamada e verifique o token.
Clique em Verificar e Salvar ↗
🔗 URL de retorno de chamada
https://yourdomain.com/webhook

Obtenha essa informação nas configurações de administrador do WhatsBot.

🔐Verificar token
your_verify_token_here

Defina qualquer string de segurança — ela deve ser igual em ambos os locais.

Após inserir ambos os valores, clique em "Verificar e salvar". O Meta irá enviar um ping para o seu URL de webhook para confirmar que está funcionando.

Webhook recomendado Campos para inscrição:

mensagens
Inscreva-se
message_deliveries
Inscreva-se
message_reads
Inscreva-se
message_echoes
Inscreva-se
⚠️
Certifique-se de que seu servidor Wagenius esteja online e acessível publicamente antes de verificar. O token de verificação deve corresponder exatamente (diferencia maiúsculas de minúsculas).
9

Teste o envio da sua primeira mensagem

Volte para a página de Configuração da API e use a seção "Enviar e receber mensagens". Selecione um número de destinatário no campo "Para" e clique em "Enviar mensagem".

📱
Para testes, o Meta permite que você envie mensagens para até 5 números de telefone gratuitamente, sem qualquer verificação comercial. Adicione seu próprio número para testar!
EXEMPLO DE TESTE DE API (Opcional - Usando cURL)
curl -X POST \
  'https://graph.facebook.com/v25.0/YOUR_PHONE_ID/messages' \
  -H 'Autorização: Bearer YOUR_TOKEN' \
  -H 'Tipo de conteúdo: application/json' \
  -d '{"messaging_product":"whatsapp","para":"RECIPIENT_NUMBER","tipo":"template","modelo":{"name":"hello_world","language":{"code":"en_US"}}}'
🎉
Configuração concluída! Se você recebeu uma mensagem de teste, sua API WhatsApp Cloud está totalmente conectada ao Wagenius. Comece a gerenciar conversas com clientes diretamente da sua caixa de entrada!
💬 Obtenha ajuda

Ainda precisa de ajuda?

Nossa equipe de suporte está pronta para ajudá-lo a se conectar. Escolha a opção que melhor se adapta às suas necessidades.

🎫

Abrir um chamado de suporte

Crie um chamado de suporte e nossa equipe responderá o mais breve possível. Acompanhe e gerencie seus problemas facilmente dentro do WhatsBot.

Criar chamado
📧

Email Support

Send us a detailed message and we'll get back to you within 24 hours.

Send Email
📚

Full Documentation

Browse our complete knowledge base for all features and advanced settings.

Browse Docs
🚀

Ready to get started?

Join thousands of businesses using Wagenius to manage WhatsApp conversations at scale.

Open Wagenius Dashboard →