Conecte seu agente ao WhatsApp Business pela API oficial da Meta (Cloud API).
Visão geral
O canal WhatsApp usa a WhatsApp Cloud API, a API oficial da Meta — sem intermediários. Você conecta o número do seu WhatsApp Business diretamente, colando as credenciais do app no Take Sales e a URL de webhook no painel da Meta.
Pré-requisitos
- Conta no Meta Business com o WhatsApp Business configurado
- App no Meta for Developers com o produto WhatsApp adicionado
- Número aprovado para a Cloud API (o número de teste da Meta serve para validar)
- Token de acesso permanente — gerado a partir de um usuário de sistema no Meta Business
Passo a passo
1. Criar o canal no Take Sales
- Acesse Canais no menu lateral
- Clique em Adicionar Canal e selecione WhatsApp
- Dê um nome de exibição (ex.: "WhatsApp Vendas") e preencha as credenciais:
| Campo | Onde encontrar |
|---|---|
| Phone Number ID | Meta for Developers → Seu app → WhatsApp → API Setup |
| Permanent Access Token | Token de um usuário de sistema com permissão no app |
| Webhook Verify Token | Uma string secreta que você escolhe — a mesma vai no painel da Meta |
| WhatsApp Business Account ID | Opcional; aparece na mesma tela de API Setup |
- Clique em Criar Canal
Ao salvar, a plataforma mostra a Callback URL e o Verify Token para você configurar no Meta.
2. Configurar o webhook no Meta
- Acesse Meta for Developers → Seu app → WhatsApp → Configuration
- Em Webhook, clique em Edit e cole a Callback URL e o Verify Token exibidos pelo Take Sales
- Assine o evento messages
- Salve — a Meta faz a verificação e o webhook fica ativo
3. Vincular o canal a um agente
Em Agentes → [agente] → Canais, selecione o canal criado e clique em Conectar. Um canal sem agente vinculado recebe a mensagem, mas não tem quem responda.
4. Testar
- Mande uma mensagem do seu celular para o número configurado
- O agente deve responder
- Confirme que a conversa aparece em Conversas, com o canal WhatsApp
Validação de assinatura (HMAC)
Todo webhook recebido da Meta pode ser verificado contra o App Secret do seu app, usando x-hub-signature-256. No card do canal, o botão de HMAC liga e desliga essa verificação.
Com o HMAC ativo, qualquer webhook sem assinatura válida é rejeitado com 401 — é o comportamento seguro e recomendado. Antes de ativar, confirme que o App Secret cadastrado está correto, senão as mensagens param de chegar.
Problemas comuns
O webhook não verifica
O Verify Token do painel da Meta precisa ser exatamente o mesmo cadastrado nas credenciais do canal. Qualquer diferença (espaço, maiúscula) faz a verificação falhar.
As mensagens não chegam
- Confirme que o evento messages está assinado no app da Meta
- Verifique se o canal está vinculado a um agente ativo
- Se o HMAC estiver ativo, confira o App Secret
O agente responde, mas o cliente não recebe
Normalmente é o token de acesso: tokens temporários expiram em 24 horas. Use um token permanente de usuário de sistema.
Janela de 24 horas
Depois de 24 horas sem interação do cliente, a Meta só permite iniciar conversa com templates aprovados. Respostas dentro da janela não precisam de template.
Boas práticas
- Mensagens curtas — Quem usa WhatsApp espera resposta objetiva; instrua isso nas diretrizes
- Sem markdown — O WhatsApp tem formatação própria; peça texto simples ao agente
- Emojis com moderação
- Respeite a janela de 24h no que for ativo
- Deixe o handoff ligado — WhatsApp é canal de relacionamento; conversa travada vira reclamação