Integrador

Aparência

Tutorial: ligar o WhatsApp oficial ​

Ao final deste passo a passo, o número oficial da sua empresa recebe e responde mensagens pelo OMNI, com o webhook conferido, os modelos de mensagem criados e um teste real feito. Tempo estimado: 30 a 40 minutos, quase tudo no painel da Meta.

Pré-requisitos ​

  • Perfil de administrador no OMNI (só ele abre a Loja de Plugins).
  • Conta no Meta Business Suite e acesso ao Meta for Developers (developers.facebook.com).
  • Um número de celular dedicado ao WhatsApp Business, que não esteja em uso no aplicativo comum.
  • Licença com o canal WhatsApp API (Oficial) liberado. Confira em Loja de Plugins › Licença.
  • Combine o momento: um número entrega para um webhook só. Ao apontar o webhook para o OMNI, o número para de entregar onde estava.

Passo a passo ​

  1. Reúna os dados na Meta. No aplicativo do WhatsApp, abra WhatsApp › Configuração da API e anote o Business Account ID (WABA) e o Phone Number ID. O Phone Number ID não é o telefone, é um número de identificação.
  2. Gere o Access Token permanente. O token temporário de 24 horas não serve. Em Configurações do negócio › Usuários › Usuários do sistema, crie um usuário, vincule o aplicativo e a conta do WhatsApp e gere o token com as permissões whatsapp_business_messaging e whatsapp_business_management, sem expiração. Copie na hora: ele não aparece de novo.
  3. Copie o App Secret. Em Configurações › Básico do aplicativo, mostre a Chave Secreta do app. Use a do aplicativo do WhatsApp, que pode ser diferente da do Facebook e do Instagram.
  4. Cadastre no OMNI. Abra o seu perfil, clique em Loja de Plugins, toque em WhatsApp, clique em Configurar e depois em Novo. Preencha Nome, Phone Number ID, Business Account ID — WABA, Access Token e App Secret. No Verify Token, clique em Gerar. Deixe Ativo em Sim e clique em Salvar. Veja detalhes em WhatsApp API Oficial.
  5. Copie o webhook. Dê dois cliques na integração salva e, em Webhook, clique em Copiar na URL do webhook.
  6. Configure o webhook na Meta. Em WhatsApp › Configuração, na seção Webhook, clique em Editar. Cole a URL em URL de callback, cole o mesmo Verify Token e clique em Verificar e salvar. Depois, em Campos do webhook, inscreva ao menos messages e message_status.
  7. Teste a conexão. Na Loja, abra o cartão WhatsApp e clique em Testar conexão. O teste só confere o número na Meta e não envia mensagem.
  8. Crie os modelos de mensagem. Na integração, abra a aba Templates e clique em + Novo template. Escolha categoria e idioma, escreva a mensagem e clique em Enviar para análise da Meta. Acompanhe o status: Pendente, Aprovado ou Rejeitado. Detalhes em Templates do WhatsApp.
  9. Faça o teste real. Mande uma mensagem do seu celular pessoal para o número da empresa. Responda pelo painel e confira se a resposta chega ao celular. Para testar o envio ativo, use Testar envio na lista: ele manda uma mensagem de verdade, então digite o seu próprio número.

Como saber que deu certo ​

  • O cartão WhatsApp na Loja aparece como Em operação.
  • Testar conexão responde que a conexão foi validada.
  • Saúde, na lista de integrações, mostra o status ativo e o campo Último erro vazio.
  • A mensagem do seu celular aparece na fila do atendimento em poucos segundos.
  • Em Saída do WhatsApp, os envios passam a ser contados.

Se algo falhar:

  • A Meta recusa o webhook: o Verify Token na Meta é diferente do OMNI.
  • A Meta aceita, mas nada chega: confira se o App Secret é o do aplicativo do WhatsApp e se messages está inscrito.
  • Testar conexão falha: gere de novo o token permanente e confira o Phone Number ID.

Leia também ​

Integrador · software para provedores de internet · integradorisp.com.br

© 2026 Integrador