Ajuda › WhatsApp Oficial e templates

WhatsApp Oficial e templates

O WhatsApp Oficial usa a API da Meta (WhatsApp Cloud API). É estável, permite templates e disparos, e convive com o WhatsApp por QR code: cada número escolhe um dos dois.

Como conectar o WhatsApp oficial#

Você vai precisar de uma conta na Meta (gratuita) com um número que não esteja no aplicativo WhatsApp comum.

1. Acesse developers.facebook.com, crie um app do tipo Empresa e adicione o produto WhatsApp.
2. Em WhatsApp › Configuração da API, anote o Phone Number ID e o WABA ID (ID da conta do WhatsApp Business).
3. Em Configurações do negócio › Usuários › Usuários do sistema, crie um usuário do sistema, dê acesso ao app e à conta do WhatsApp e gere um token permanente com as permissões whatsapp_business_messaging e whatsapp_business_management.
4. Em Configurações do app › Básico, copie o App Secret (e o ID do app, se quiser usar templates com imagem).
5. No NexaChat: Canais › Adicionar canal › WhatsApp › API oficial e cole os dados. Você pode escolher o seu próprio Verify Token ou deixar o NexaChat gerar um.
6. Clique em Testar conexão: o NexaChat confere o token, o número, a conta e a permissão de templates, e mostra a qualidade e o limite diário do número.
7. No painel da Meta, em WhatsApp › Configuração › Webhook, cole a URL de retorno e o Verify Token mostrados no NexaChat, clique em Verificar e salvar e assine os campos messages e message_template_status_update.
8. Volte ao NexaChat e clique em Ativar canal.

O NexaChat valida a assinatura (X-Hub-Signature-256) de todo evento: o que não vier assinado pela Meta é recusado. Credenciais ficam cifradas e nunca voltam para o navegador.

A janela de 24 horas#

Depois que o cliente escreve, você pode responder livremente por 24 horas. A conversa mostra “Janela de 24h: 19 h 40 min” em contagem regressiva. Quando a janela fecha, o texto livre e os anexos ficam bloqueados e aparece o botão Enviar template: só templates aprovados podem abrir uma conversa fora da janela. Se o cliente responder, a janela reabre.

Enviar um template no atendimento#

Enviar template abre a lista de templates aprovados, mostra a pré-visualização e já preenche as variáveis com dados do contato, do atendimento e (botão Preencher com dados do ERP) da fatura do cliente. Você pode ajustar qualquer valor antes de enviar.

Como criar e aprovar templates#

Em Canais › seu número oficial › Templates:

• Biblioteca para provedor: 10 modelos prontos em português (fatura disponível, lembrete de vencimento, fatura vencida, pagamento confirmado, desbloqueio de confiança, manutenção programada, conexão normalizada, retomar atendimento, pesquisa de satisfação e código de verificação). Clique em Enviar para aprovação.
• Novo template: nome (minúsculas e sublinhado), categoria, idioma, cabeçalho (texto, imagem, documento ou vídeo), corpo com variáveis {{1}}, {{2}}…, rodapé e botões (resposta rápida, link, telefone, copiar código). Ao lado você vê a pré-visualização igual à do WhatsApp, e o NexaChat avisa na hora se alguma regra da Meta não foi seguida (variável no começo ou no fim do texto, exemplos faltando, botão grande demais…).
• Categorias: UTILITY (avisos de serviço: fatura, manutenção), MARKETING (promoções, mais caro e exige quem aceitou receber) e AUTHENTICATION (código de uso único).
• Situação em tempo real: Em análise, Aprovado, Rejeitado (com o motivo), Pausado e Desativado, mais a qualidade. Atualiza sozinho pelo webhook; Sincronizar com a Meta busca os que já existem lá. A aprovação costuma levar de minutos a algumas horas.
• Dá para editar e excluir (a exclusão também vale na Meta).

Usar templates automaticamente#

• Fluxos: bloco Enviar template (WhatsApp Oficial), com saídas Sucesso e Falha; as variáveis aceitam dados do fluxo, como {{nome_contato}}.
• Gatilhos do ERP: em Gatilhos do ERP escolha qual template enviar em cada evento (fatura gerada, lembrete, vencida, pagamento, desbloqueio, manutenção, conexão normalizada). O ERP avisa com POST /api/ext/erp-event e o token de integração; o campo reference evita envio em duplicidade.
• API pública: POST /api/v1/messages/template (veja em Webhooks e API); aceita variáveis em lista ou com nome.
• Disparo em massa (Campanhas): vai para uma fila com limite por minuto e respeita o limite diário do número definido pela Meta (250, 1.000, 10.000… clientes diferentes a cada 24 h). Ao atingir o limite a campanha pausa e mostra o motivo, e continua sozinha quando libera.
• Custos: cada envio é registrado com a categoria; o painel mostra quantos de cada tipo foram enviados.

Descadastro (SAIR)#

Se o cliente responder SAIR, PARAR ou similar, ele recebe a confirmação e fica marcado: templates de MARKETING não são mais enviados a ele (avisos de serviço continuam). Responder VOLTAR reativa.

Quando um envio falha#

A mensagem aparece como Falhou, com o motivo em português e o código da Meta (por exemplo: janela de 24 h fechada, número sem WhatsApp, limite de envio, token expirado, template não aprovado).

Testar sem enviar nada#

No Simulador escolha o WhatsApp Oficial: dá para simular a janela de 24 h expirada e testar o envio de templates sem chamar a Meta.

Cadastro incorporado#

O NexaChat já tem pronto o cadastro incorporado da Meta (conectar o número em poucos cliques), mas ele está desligado até o NexaChat ser aprovado como Provedor de Tecnologia pela Meta. Por enquanto, use a conexão manual acima.