← Central de Ajuda

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

  1. Em Configurações > Integrações, abra o cartão do WhatsApp Oficial.
  2. Cole o Phone Number ID e, se quiser, o WABA ID.
  3. Cole o Access token permanente. Ele é guardado em cofre seguro e não aparece de novo na tela.
  4. Crie e cole o Verify Token do webhook.
  5. Escolha o Corretor responsável padrão. Se escolher Notificar toda a equipe, as conversas novas avisam todos.
  6. Clique em Salvar canal.
  7. Copie a Callback URL do webhook que aparece no cartão.
  8. No painel da Meta, em Configuração > Webhook, cole a URL e o mesmo Verify Token, e assine o campo messages.
  9. 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.