Quando você usa a WhatsApp Cloud API (integração oficial Meta) e precisa enviar mensagem pra um cliente que não respondeu nas últimas 24 horas, o WhatsApp não permite mensagem livre — só templates HSM (Highly Structured Messages) pré-aprovados pela Meta.
Templates servem pra:
- Iniciar conversa com lead frio (cobrança, lembrete, oferta)
- Mandar follow-up depois que o cliente sumiu
- Notificações automáticas (código de verificação, confirmação de pedido, agendamento)
⚠️ Atenção: templates HSM só funcionam em números conectados via Cloud API. Se sua única integração é QR Code, você não tem janela de 24h restritiva e usa texto livre normalmente.
Pré-requisitos
- Pelo menos 1 instância WhatsApp Cloud API conectada.
- Permissão de admin ou manager.
- Feature flag
whatsapp_cloud_apiativa pra sua conta.
Categorias de templates
A Meta classifica todo template numa das três categorias:
- Marketing — promoções, ofertas, campanhas. Aprovação mais rigorosa.
- Utilidade — confirmação de pedido, lembrete de consulta, status de entrega. Aprovação mais rápida.
- Autenticação — códigos OTP, verificações 2FA. Categoria especial com formato fixo.
A Meta pode reclassificar automaticamente sua categoria. Por exemplo, se você submete como Utilidade mas o conteúdo tem cara de promoção, ela move pra Marketing. Isso é normal — não é bug do Syncro.
Criar um template
- Acesse Configurações → Templates WhatsApp.
- Leia o subtítulo do topo: "Mensagens pré-aprovadas pela Meta usadas pra iniciar conversa fora da janela de 24h."
- Clique em Criar template.
- Você entra num wizard com preview de iPhone à direita pra ver como vai aparecer pro cliente.
- Preencha:
- Nome do template: snake_case, sem acentos. Ex:
lembrete_consulta,codigo_otp. Esse é o ID interno — o cliente não vê. - Idioma: ex: pt_BR, en_US, es_ES.
- Categoria: Marketing, Utilidade ou Autenticação.
- Monte o Corpo da mensagem:
- Use
{{1}},{{2}},{{3}}pra variáveis dinâmicas (até 1024 caracteres no total). - Ex: "Oi {{1}}, sua consulta com {{2}} está marcada pra {{3}}. Confirma?"
- Pros botões da plataforma (Nome do cliente, Data, Hora, Empresa, Valor, Código, Link, Outro), clique e o Syncro insere a variável no cursor com label amigável.
- (Opcional) Adicione Cabeçalho com texto, imagem, vídeo ou documento. Pra mídia, faça upload — vira exemplo que a Meta usa pra avaliar.
- (Opcional) Adicione Rodapé (até 60 caracteres) — texto pequeno embaixo do corpo.
- (Opcional) Adicione Botões:
- Resposta rápida (até 3) — botões que viram um clique do cliente
- Visitar site — link externo
- Ligar — botão de telefone
- Preencha Variáveis de exemplo: o que cada
{{1}},{{2}}etc. seria num caso real. A Meta usa isso pra avaliar o conteúdo. - Clique em Enviar pra análise da Meta.
- Aparece o toast Template enviado pra análise da Meta. Aprovação leva 24 a 72h..
Acompanhar o status de aprovação
Volte em Configurações → Templates WhatsApp. Cada template lista um badge:
- Em análise ⏳ — Meta ainda não revisou (24-72h normalmente)
- Aprovado ✅ — pronto pra enviar
- Rejeitado ❌ — clique no template pra ver o motivo (
rejected_reason)
Forçar sincronização com a Meta
O Syncro sincroniza automaticamente o status dos templates uma vez por dia. Pra forçar um sync manual:
- Em Configurações → Templates WhatsApp, clique em Sincronizar com Meta.
- O botão muda pra Sincronizando... durante o processo.
- Em segundos, os badges são atualizados com o status real da Meta.
Enviar um template no chat
Depois que o template está Aprovado:
- Abra a conversa em Chat com a pessoa pra quem quer mandar.
- Se a janela de 24h estiver fechada, você verá uma mensagem: "A janela de 24h dessa conversa foi fechada. Use um template aprovado pra retomar." — clique em Enviar template.
- Se a janela ainda está aberta, clique no botão + ao lado do campo de mensagem e escolha Template.
- No modal Enviar template, selecione:
- O template aprovado da lista
- Use o campo Buscar por nome... se tiver muitos
- Preencha as variáveis (campos
{{1}},{{2}}etc) com os valores reais. - Se o template tem cabeçalho de mídia, anexe a mídia do cabeçalho.
- Clique em Enviar.
- A mensagem é entregue como template oficial pelo WhatsApp Cloud API.
Por que meu template foi rejeitado?
Razões comuns de rejeição:
- Conteúdo promocional disfarçado de utilidade
- Variáveis sem exemplo claro ou no início/fim do corpo da mensagem
- Linguagem vaga ou que parece spam
- Erros gramaticais ou caracteres especiais demais
Pra fazer correção:
- Apague o template rejeitado (ou crie um novo com nome diferente).
- Ajuste o conteúdo conforme o feedback.
- Submeta de novo.
A Meta tem diretrizes oficiais de templates que valem a pena ler antes de criar template grande.
Custos de envio
Cada envio de template é cobrado pela Meta (não pelo Syncro), com preço variável por categoria e por país. A cobrança vai direto pra sua conta WhatsApp Business / Meta Business — o Syncro não intermedia esse pagamento.