Templates HSM (WhatsApp Cloud API)

Atualizado em 24 de setembro de 2026

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_api ativa 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

1.Acesse Configurações → Templates WhatsApp. 2.Leia o subtítulo do topo: "Mensagens pré-aprovadas pela Meta usadas pra iniciar conversa fora da janela de 24h." 3.Clique em Criar template. 4.Você entra num wizard com preview de iPhone à direita pra ver como vai aparecer pro cliente. 5.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. 6.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. 7.(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. 8.(Opcional) Adicione Rodapé (até 60 caracteres) — texto pequeno embaixo do corpo. 9.(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 10.Preencha Variáveis de exemplo: o que cada {{1}}, {{2}} etc. seria num caso real. A Meta usa isso pra avaliar o conteúdo. 11.Clique em Enviar pra análise da Meta. 12.Aparece o toast Template enviado pra análise da Meta. Aprovação leva 24 a 72h..

[IMAGEM AQUI]wizard de criação de template com preview de iPhone à direita mostrando a mensagem renderizada

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:

1.Em Configurações → Templates WhatsApp, clique em Sincronizar com Meta. 2.O botão muda pra Sincronizando... durante o processo. 3.Em segundos, os badges são atualizados com o status real da Meta.

Enviar um template no chat

Depois que o template está Aprovado:

1.Abra a conversa em Chat com a pessoa pra quem quer mandar. 2.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. 3.Se a janela ainda está aberta, clique no botão + ao lado do campo de mensagem e escolha Template. 4.No modal Enviar template, selecione: -O template aprovado da lista -Use o campo Buscar por nome... se tiver muitos 5.Preencha as variáveis (campos {{1}}, {{2}} etc) com os valores reais. 6.Se o template tem cabeçalho de mídia, anexe a mídia do cabeçalho. 7.Clique em Enviar. 8.A mensagem é entregue como template oficial pelo WhatsApp Cloud API.

[IMAGEM AQUI]modal "Enviar template" com lista de templates aprovados e campo de busca

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: 1.Apague o template rejeitado (ou crie um novo com nome diferente). 2.Ajuste o conteúdo conforme o feedback. 3.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.