Conecte um número do WhatsApp Business ao seu agente — pela Meta ou colando as credenciais — e entenda a janela de 24 horas e os modelos aprovados.
Esta página é para quem vende no WhatsApp e quer que o agente atenda no mesmo número. O ChatMade usa a WhatsApp Cloud API da Meta — não é leitor de QR code, não é celular pendurado.
O que você precisa antes
- Uma conta no WhatsApp Business Platform com um número já verificado.
- Um aplicativo criado em developers.facebook.com, com o produto WhatsApp ativado.
- Numa instalação própria, as variáveis
META_APP_ID,META_APP_SECRET,META_WEBHOOK_VERIFY_TOKENeMETA_GRAPH_VERSIONpreenchidas no.envdo backend. - Um administrador do ChatMade com a permissão
manage_organization.
Bom saber: o
META_WEBHOOK_VERIFY_TOKENé qualquer texto aleatório que você escolhe. Ele vai no.enve também no painel do aplicativo da Meta, na configuração de webhook. Os dois precisam bater.
Onde pegar cada credencial
No painel do seu aplicativo na Meta, em WhatsApp → API Setup (“WhatsApp → Configuração da API”):
| O que | Onde está |
|---|---|
| ID do número de telefone | Na tela de API Setup, ao lado do número |
| Token de acesso permanente | Gerado a partir de um usuário do sistema, na Business Manager |
| ID da Conta Comercial do WhatsApp (WABA) | Na mesma tela de API Setup, ou nas configurações da Business Manager |
Conectar
- No painel, abra Settings → Integrations (“Configurações → Integrações”).
- Ache o cartão WhatsApp, com a descrição “Let customers message your AI agent on WhatsApp Business.”
- Clique em Connect (“Conectar”). Abre o modal Connect WhatsApp.
A partir daqui há dois caminhos.
Caminho A — entrar com o Facebook
Se a instalação tem um aplicativo da Meta configurado, o modal abre com o botão Continue with Facebook (“Continuar com o Facebook”) e a linha “Sign in with Facebook to connect your WhatsApp Business number.”
Clique, autorize na janela que abrir, e o ChatMade recebe as credenciais sozinho. Enquanto espera, o botão mostra Waiting for Meta… (“Esperando a Meta…”).
Caminho B — colar as credenciais
Sempre disponível pelo link Enter credentials manually instead (“Colar as credenciais no lugar”). É o caminho de quem tem instalação própria e não configurou a integração com a Meta.
| Campo na tela | O que colar |
|---|---|
| Phone number ID (“ID do número”) | O ID numérico do número, tipo 1234567890 |
| Access token (“Token de acesso”) | O token permanente, que começa com EAAG… |
| WhatsApp Business Account ID (optional) (“ID da conta comercial (opcional)”) | O ID da WABA |
O terceiro campo está marcado como opcional, mas leia o aviso abaixo antes de pular.
Clique em Connect (“Conectar”). O ChatMade consulta a Meta para confirmar o número e o nome verificado. Credencial errada devolve Could not verify WhatsApp credentials: {motivo}.
4. Escolha o agente
O modal passa para a última etapa: escolher o agente em AI agent e clicar em Assign agent (“Atribuir agente”). Sem isso, o número recebe mensagem e não responde nada.
O webhook
Você não configura webhook do WhatsApp na mão, e a tela não mostra URL nenhuma.
Todos os canais da Meta — WhatsApp, Messenger e Instagram — dividem um endereço só, e o ChatMade se inscreve sozinho na sua conta comercial assim que você conecta, desde que o ID da WABA tenha sido informado.
Atenção: sem o WhatsApp Business Account ID, duas coisas deixam de funcionar: a inscrição automática no webhook e a tela de modelos, que devolve o erro “Reconnect this number with its WhatsApp Business Account ID to manage templates”. É “opcional” no formulário, mas na prática você quer preencher.
A janela de 24 horas
Esta é a regra que mais confunde quem está começando.
Passadas 24 horas desde a última mensagem que o cliente te mandou, você não pode mais escrever livremente para ele. É regra da Meta, não do ChatMade. A única forma de reabrir a conversa é mandar um modelo aprovado.
Na caixa de entrada, quando isso acontece, aparece o aviso:
This customer’s 24-hour window has closed. Send an approved template to reopen it.
com o botão Send template (“Enviar modelo”). Esse botão também fica sempre disponível no cabeçalho de qualquer conversa de WhatsApp aberta.
Clicando, abre o modal Send a template (“Enviar um modelo”), com a explicação “This conversation is outside WhatsApp’s 24-hour window. An approved template reopens it.” Você escolhe o modelo, preenche as variáveis — os campos se chamam Variable 1, Variable 2 e assim por diante, com uma Preview (“Prévia”) mostrando o texto montado — e envia. A confirmação é Template sent, com a nota “The customer can reply for the next 24 hours.”
Modelos
O botão Templates (“Modelos”) aparece no cartão do WhatsApp assim que houver um número conectado. Ele abre a tela WhatsApp templates, que explica:
Templates reopen a conversation after the customer’s 24-hour window closes. You write them in WhatsApp Manager; once Meta approves one, it appears here and your agents can send it.
Isso é literal: os modelos não são escritos no ChatMade. Aqui você só lista e envia. A criação e a aprovação acontecem no WhatsApp Manager da Meta.
A tela mostra cada modelo com nome, o estado cru da Meta em maiúsculas (APPROVED, PENDING, REJECTED) e o idioma. No rodapé, o bloco Add a template (“Adicionar um modelo”) com os três passos e o botão Open WhatsApp Manager.
Só aparecem para envio os modelos aprovados. E são escondidos os modelos que pedem coisas que o ChatMade não sabe preencher: variável no cabeçalho ou no rodapé, botão de URL dinâmica e cabeçalho de mídia. Modelos de autenticação são exceção — neles, o campo se chama Verification code (“Código de verificação”).
Começar uma conversa do zero
Na tela de conversas há o botão New conversation (“Nova conversa”), que só aparece quando existe pelo menos um número de WhatsApp conectado.
O modal New WhatsApp conversation abre com um aviso que vale ler:
Only message people who agreed to hear from you on WhatsApp — Meta blocks businesses whose messages get reported.
Campos: From number (“Do número”, só se você tiver mais de um), To (“Para”, em formato internacional com o código do país), Name (optional) (“Nome (opcional)”) e Template (“Modelo”). O botão é Send and open conversation (“Enviar e abrir a conversa”).
Para conversa iniciada por você, a Meta só aceita modelo das categorias Utility ou Authentication.
Testar
Não há botão de teste. O teste é mandar uma mensagem de verdade para o número conectado, do seu celular, e ver a resposta chegar na caixa de entrada.
Limites
- Resposta cortada em 4.096 caracteres.
- Janela de 24 horas.
- Chamadas à Meta com tempo limite de 15 segundos e 2 tentativas.
- Trava contra evento duplicado de 1 hora.
Atenção: o WhatsApp não recebe nem envia mídia neste sistema. Foto, áudio, documento e vídeo que o cliente mandar são descartados — só o texto passa. Botões e listas do WhatsApp funcionam na entrada: o texto do botão escolhido chega como mensagem.
Desconectar
Botão Disconnect (“Desconectar”) no cartão. A confirmação avisa que isso vai parar de receber e responder mensagens, remover o roteamento do agente e exigir que você cole as credenciais de novo.
Próximo passo
Com o WhatsApp no ar, veja Caixa de entrada para entender como a sua equipe assume uma conversa que o agente passou adiante.