Quem começa na API oficial descobre rápido: para falar com um cliente que não escreveu nas últimas 24 horas, só com modelo aprovado. E aí vem a frustração do “template recusado” sem entender o porquê. Criar templates WhatsApp API que passam de primeira é uma habilidade que economiza dias de retrabalho.
Resposta direta: um template é uma mensagem pré-aprovada pela Meta, com cabeçalho opcional, corpo, rodapé opcional e botões. Para ser aprovado, ele precisa estar na categoria certa (utilidade, marketing ou autenticação), usar variáveis no formato correto, trazer exemplos de preenchimento e respeitar as políticas. A análise pode levar até 24 horas. Abaixo, a estrutura, as regras oficiais, os erros mais comuns e exemplos originais para adaptar.
Quando você precisa de templates WhatsApp API
Dentro da janela de 24 horas aberta pela mensagem do cliente, você conversa livremente. Fora dela, a empresa só inicia contato com um template aprovado. Isso vale para lembretes, avisos de pedido, cobranças, retomadas de conversa e campanhas. Explicamos a janela e a cobrança da Meta no guia da API oficial do WhatsApp.
As três categorias
- Utilidade: mensagens ligadas a algo que o cliente fez ou pediu, como confirmação de pedido, lembrete de consulta ou atualização de entrega.
- Marketing: promoções, novidades, convites, reativação de clientes.
- Autenticação: códigos de verificação para login ou confirmação de identidade, com formato mais restrito.
Escolha a categoria pelo objetivo real da mensagem. Oferta com cara de aviso continua sendo marketing.
Estrutura de um template e limites oficiais
A documentação de componentes da Meta define estes limites:
| Componente | Obrigatório? | Limite | Dica |
|---|---|---|---|
| Cabeçalho | Não | Texto de até 60 caracteres (1 variável) ou mídia: imagem, vídeo ou documento | Use para o assunto: “Seu pedido saiu para entrega” |
| Corpo | Sim | Até 1.024 caracteres, com várias variáveis | Frases curtas, uma ideia por parágrafo |
| Rodapé | Não | Até 60 caracteres | Bom lugar para “Responda SAIR para não receber ofertas” |
| Botões | Não | Até 10 no total; texto de até 25 caracteres | Com 4 ou mais, não aparecem no WhatsApp para desktop |
Tipos de botão
- Resposta rápida: até 10 por template. Ótimo para “Confirmar”, “Remarcar”, “Falar com atendente”.
- Link (URL): até 2 por template.
- Ligar: 1 por template.
- Copiar código: 1 por template, com código de até 20 caracteres, útil para cupons.
Nome do template
Segundo a Meta, o nome aceita apenas letras minúsculas, números e sublinhado. Crie um padrão que a equipe entenda, como utilidade_lembrete_consulta_v1 ou marketing_reativacao_90dias. Isso evita duplicados e facilita achar o modelo certo na hora da campanha.
Variáveis: como usar sem ser recusado
Variáveis são os campos que mudam a cada envio, como nome, data ou número do pedido. A Meta aceita dois formatos:
- Posicionais: {{1}}, {{2}}, {{3}}, em sequência.
- Nomeadas: {{nome_cliente}}, {{data_consulta}}, com letras minúsculas e sublinhado.
Pelas diretrizes de análise de templates da Meta, estes são motivos de recusa ligados a variáveis:
- Chaves faltando ou desencontradas.
- Caracteres especiais como #, $ ou % dentro da variável.
- Template que começa ou termina com variável.
- Variáveis fora de sequência, como {{1}}, {{2}}, {{5}}.
- Muitas variáveis para um texto curto.
- Falta de exemplos de preenchimento (amostras) no envio para análise.
Regra prática: se o template ficaria sem sentido com as variáveis vazias, ele está dependendo demais delas. Escreva o texto fixo primeiro e só depois encaixe as variáveis.
Outros motivos de recusa que a Meta cita
- Pedir dados sensíveis, como número completo de cartão ou documento de identidade.
- Tom ameaçador ou abusivo, como ameaçar o cliente com ação judicial.
- Duplicar um template existente com o mesmo texto de corpo e rodapé.
- Descumprir a política de comércio do WhatsApp em mensagens de transação.
Esse ponto do tom pesa muito em cobrança. “Evite problemas judiciais, pague hoje” tende a ser recusado. “Seu boleto vence amanhã. Precisa de ajuda?” resolve o mesmo problema com respeito.
Passo a passo para criar templates WhatsApp API aprovados
- Defina o objetivo em uma frase. “Lembrar o paciente da consulta de amanhã” é um objetivo. “Engajar a base” não é.
- Escolha a categoria de acordo com esse objetivo.
- Escreva o texto fixo e identifique o que muda a cada envio.
- Insira as variáveis em sequência, nunca no início ou no fim do texto.
- Adicione botões que resolvam a próxima ação do cliente.
- Preencha os exemplos de cada variável com dados realistas, como “Mariana” e “15/10 às 14h”.
- Revise contra a lista de recusas acima antes de enviar.
- Envie e acompanhe o status. Aprovado, siga para testes com números internos; recusado, leia o motivo, ajuste e reenvie.
6 exemplos originais para adaptar
1. Lembrete de consulta (utilidade)
Corpo: “Olá, {{1}}! Passando para lembrar da sua consulta com {{2}} em {{3}}. Podemos confirmar sua presença?”
Botões: Confirmar | Preciso remarcar
2. Pedido enviado (utilidade)
Cabeçalho: “Seu pedido está a caminho”
Corpo: “Oi, {{1}}. O pedido {{2}} saiu para entrega hoje. O prazo estimado é {{3}}. Qualquer dúvida, é só responder por aqui.”
Botão: Acompanhar entrega (link)
3. Vencimento próximo (utilidade)
Corpo: “Olá, {{1}}. Sua fatura de {{2}} vence em {{3}}. Se já pagou, pode desconsiderar esta mensagem. Precisa da segunda via?”
Botões: Quero a segunda via | Falar com atendente
4. Retomada de atendimento (utilidade)
Corpo: “Oi, {{1}}! Você falou com a gente sobre {{2}} e a conversa ficou pela metade. Quer continuar de onde paramos?”
Botões: Quero continuar | Agora não
5. Reativação de cliente (marketing)
Corpo: “Olá, {{1}}! Faz tempo que você não passa por aqui, e separamos uma condição especial para sua próxima compra. Quer conhecer?”
Rodapé: “Responda SAIR para não receber ofertas”
Botões: Quero ver | Não tenho interesse
6. Cupom de aniversário (marketing)
Corpo: “Feliz aniversário, {{1}}! Para comemorar, preparamos um cupom para você usar até o fim do mês. Toque no botão para copiar.”
Botão: Copiar código
Repare que nenhum exemplo começa ou termina com variável, todos têm uma ação clara e nenhum pede dado sensível.
Como criar e usar templates no ClikChat
No ClikChat, os modelos de mensagem ficam em uma área própria: você monta cabeçalho, corpo, rodapé e botões, escolhe a categoria (utilidade, marketing ou autenticação) e envia para aprovação da Meta. Depois de aprovado, o modelo pode ser usado para retomar uma conversa fora da janela de 24 horas direto no ticket ou em campanhas oficiais.
Nas campanhas, você escolhe o público por etiqueta ou planilha CSV/XLSX, define janela de execução, intervalo entre mensagens e limite diário por conexão, e acompanha o relatório de enviado, entregue e erro. A blacklist bloqueia quem pediu para sair. Para quem já respondeu e está dentro da janela, as respostas rápidas com variáveis agilizam o atendimento, e o guia de disparo em massa no WhatsApp mostra como planejar envios maiores.
Perguntas frequentes
Quanto tempo a Meta leva para aprovar um template?
Segundo a Meta, a decisão pode levar até 24 horas. Em muitos casos sai antes, mas planeje campanhas com essa folga.
Posso editar um template aprovado?
Em geral, mudanças passam por nova análise. Para campanhas com prazo, é mais seguro criar uma versão nova com outro nome e manter a anterior como reserva.
Quantos templates posso criar?
A Meta limita a criação a 100 templates por hora por conta do WhatsApp Business. Na prática, o desafio é organização: nomes claros e poucos modelos bem feitos rendem mais.
Posso usar emojis?
Sim, com moderação. A Meta indica que alguns formatos têm restrições de caracteres e emojis, então teste antes e evite excesso.
Posso classificar uma oferta como utilidade?
Não é uma boa ideia. A categoria deve refletir o objetivo da mensagem, e classificar errado aumenta a chance de problema na análise.
Por que meu template foi recusado sem motivo claro?
Revise primeiro as variáveis: início ou fim com variável, sequência quebrada e falta de exemplo são os motivos mais frequentes. Depois, confira o tom e se o texto não duplica outro modelo.
Conclusão
Templates WhatsApp API aprovados de primeira seguem uma receita simples: objetivo claro, categoria correta, texto fixo forte, variáveis em sequência e com exemplos, botões que resolvem a próxima ação e tom respeitoso. Com uma biblioteca pequena e bem nomeada, sua equipe retoma conversas e envia avisos sem depender de improviso. Para montar seus modelos, enviar para aprovação e usar tudo em atendimento e campanhas no mesmo lugar, teste o ClikChat grátis por 3 dias.