WhatsApp oficial (Meta) e templates
Passo a passo para ligar o WhatsApp Business oficial da Meta ao Nuclevo, configurar o webhook e entender os modelos de mensagem.
Atualizado em
O WhatsApp oficial, da Meta, é o canal que conecta o número comercial da sua imobiliária ao Nuclevo. Com ele, as conversas com os leads aparecem em Conversas e você responde sem sair do sistema.
A configuração é feita por um administrador em Configurações > Integrações, no cartão WhatsApp Oficial (Meta Cloud API).
Antes de começar
Tenha em mãos, no painel da Meta (business.facebook.com):
- o Phone Number ID, que aparece em WhatsApp > API Setup;
- o WABA ID, o número de 16 dígitos da conta de WhatsApp Business. Não use o nome da conta;
- um access token permanente, gerado como usuário do sistema com permissão de WhatsApp.
Você também vai inventar um Verify Token: um texto de 8 a 128 caracteres, sem espaços. Ele precisa ser o mesmo nos dois lados.
Passo a passo
- Em Configurações > Integrações, abra o cartão do WhatsApp Oficial.
- Cole o Phone Number ID e, se quiser, o WABA ID.
- Cole o Access token permanente. Ele é guardado em cofre seguro e não aparece de novo na tela.
- Crie e cole o Verify Token do webhook.
- Escolha o Corretor responsável padrão. Se escolher Notificar toda a equipe, as conversas novas avisam todos.
- Clique em Salvar canal.
- Copie a Callback URL do webhook que aparece no cartão.
- No painel da Meta, em Configuração > Webhook, cole a URL e o mesmo Verify Token, e assine o campo messages.
- Envie uma mensagem para o número da imobiliária.
Quando a mensagem chegar, o status do cartão muda para Webhook conectado. Se ele ficar em Aguardando primeira mensagem, confira o passo 8.
Se aparecer Erro: nenhum canal com token, o canal não consegue responder. Informe o access token e salve de novo.
Templates: as mensagens iniciadas por você
A Meta só deixa uma empresa iniciar conversa fora da janela de 24 horas depois da última mensagem do cliente com um template aprovado. Template é um modelo de texto que a própria Meta revisa.
- Crie os modelos no Gerenciador de templates da Meta, na sua conta WhatsApp Business.
- Use a categoria Utility e um texto transacional, sem promoção ou desconto. Se o texto parecer marketing, a Meta muda a categoria e pode recusar.
- Espere a aprovação antes de usar o modelo. Ela costuma levar algumas horas.
Dentro da janela de 24 horas, uma resposta livre no atendimento não precisa de template.
Problemas comuns
- Número de telefone errado: o campo pede o Phone Number ID, que é um código da Meta, e não o número com DDD.
- Mensagem não chega: confira a Callback URL e o Verify Token no painel da Meta.
- Token recusado: gere um novo token permanente e salve o canal.