Templates do WhatsApp
Crie modelos de mensagem, acompanhe a aprovação da Meta e use-os no Chat de conversas, no funil e nos disparos.
Nesta página
Template é um modelo de mensagem que a Meta aprova antes de você usar. No WhatsApp API oficial ele é o único jeito de iniciar uma conversa ou de escrever para quem não fala com você há mais de 24 horas. No Leadz você cria o template, acompanha a aprovação e depois escolhe o modelo no Chat de conversas, no funil e nos disparos.
Templates existem só no WhatsApp API oficial. O WhatsApp por QR Code não usa.
#Por que a Meta exige template
A Meta só deixa a empresa escrever livremente para quem mandou mensagem nas últimas 24 horas. Fora disso, ela quer conferir antes o que será enviado, para proteger as pessoas de spam. Por isso todo template passa por análise. Veja Janela de 24 horas.
#Abrir a lista de templates
- Abra Conexões › Integrações, na aba Canais.
- No cartão WhatsApp Cloud, clique em Configurar contas.
- Na aba Números conectados, clique no número que vai usar.
- Abra a aba Templates de mensagem.
A lista mostra os templates daquele número, com filtros Todos, Aprovados, Em análise e Rejeitados e uma busca por nome ou texto.
#Criar um template
- Na aba Templates de mensagem, clique em Novo template.
- Preencha Nome (snake_case): letras minúsculas, números e sublinhado, sem espaços. Exemplo:
promo_setembro. - Escolha a Categoria e o Idioma.
- Se quiser, escolha um Cabeçalho: Texto, Imagem, Vídeo ou Documento (PDF).
- Escreva o Corpo da mensagem. Para um dado que muda a cada envio, clique em Inserir variável e preencha o exemplo pedido.
- Se quiser, preencha o Rodapé e adicione Botões.
- Confira a prévia ao lado e clique em Enviar para análise da Meta.
Aparece o aviso «Template enviado para análise da Meta. O status atualiza sozinho (ou em «Sincronizar»).» e o template entra na lista como Em análise.
#Categorias
| Categoria | Quando usar |
|---|---|
| Marketing | Oferta, lançamento, convite, reativação. Aceita todos os tipos de botão. |
| Utilidade | Aviso ligado a algo que a pessoa já fez: confirmação de compra, acesso liberado, lembrete. Não aceita o botão Copiar código. |
| Autenticação (código) | Código de verificação. O texto é fixo da Meta; você define só a validade e o texto do botão. |
A Meta confere se o conteúdo combina com a categoria. Oferta enviada como Utilidade costuma ser recusada.
#Tamanhos e formatos
| Parte | Limite |
|---|---|
| Texto do cabeçalho | 60 caracteres |
| Mídia do cabeçalho | Imagem (JPG, PNG, WEBP ou AVIF), vídeo (MP4, MOV ou WEBM) ou PDF, até 50 MB. O Leadz comprime imagem e vídeo para o tamanho que a Meta aceita. |
| Corpo da mensagem | 1.024 caracteres. Aceita negrito e itálico, como no WhatsApp. |
| Rodapé | 60 caracteres, sem variáveis |
| Botões | Até 10 no total |
| Texto de cada botão | 25 caracteres |
#Variáveis
Variável é o trecho que muda a cada envio, como o nome da pessoa. No corpo ela aparece como {{1}}, {{2}} e assim por diante.
- Use variáveis só no corpo. No cabeçalho e no rodapé elas não são preenchidas.
- Para cada variável, a Meta exige um exemplo (por exemplo, «Maria»). O exemplo serve só para a análise; o valor real é escolhido em cada envio.
- No envio, você liga cada variável a um dado do contato (nome, campo personalizado) ou escreve um texto fixo.
#Botões
| Botão | O que faz | Quantos |
|---|---|---|
| Resposta rápida | A pessoa toca e responde com aquele texto. No funil, cada resposta pode abrir um caminho. | Até 10 |
| Abrir site | Abre um link. O endereço aceita variáveis, como {{utm_source}}. |
Até 2 |
| Ligar | Liga para um número com DDI. | 1 |
| Copiar código | Copia um cupom de até 15 caracteres, sem espaços. | 1 |
Quando há respostas rápidas e outros botões juntos, as respostas rápidas vão primeiro: é exigência da Meta.
#Aprovação e sincronização
- A análise da Meta costuma sair em minutos e pode levar até 24 horas.
- O status muda sozinho na lista. Para conferir na hora, clique em Sincronizar Meta.
- Sincronizar Meta também traz os templates criados direto no gerenciador da Meta e tira da lista os que foram apagados lá.
| Status | Significado |
|---|---|
| Em análise | A Meta ainda não respondeu. Não dá para enviar. |
| Aprovado | Pronto para usar. |
| Rejeitado | A Meta recusou. O motivo aparece no próprio template. |
| Pausado | A Meta pausou o template por baixa qualidade. |
| Desativado | A Meta desativou o template. |
Depois de alguns envios, cada template ganha uma nota de qualidade: Qualidade alta, Qualidade média ou Qualidade baixa. Ela reflete bloqueios e denúncias de quem recebeu.
#Editar, recriar e apagar
- Editar troca o conteúdo e manda o template de volta para revisão. Nome e idioma não mudam, e a categoria de um template aprovado também não. A Meta permite 1 edição a cada 24 horas e 10 a cada 30 dias.
- Recriar pelo Sparkle Leadz copia um template criado no gerenciador da Meta para um novo, criado pelo Leadz. Use quando o template tem botão de link e aparece com o selo «Botão de link sem rastreio · bloqueado para funis».
- Apagar template remove o modelo na Meta.
#Onde os templates são usados
- Chat de conversas. Com a janela de 24 horas fechada, a caixa de texto dá lugar a Enviar template de mensagem. Escolha o modelo, preencha as variáveis e clique em Enviar mensagem (template).
- Funil. No bloco de mensagem do WhatsApp oficial, escolha o modelo em Template aprovado (Meta). Só aparecem os aprovados.
- Disparos. No envio pelo WhatsApp oficial, o template é o que permite alcançar quem está fora da janela de 24 horas.
Template com mídia no cabeçalho precisa ter a mídia guardada no Leadz. Se a lista mostrar «sem mídia para os envios — Inbox, fluxos e disparos vão falhar», clique em Enviar mídia naquele template.
#Problemas comuns
O template foi rejeitado
O motivo aparece no template, em «Motivo rejeição». As causas mais comuns são categoria errada (oferta em Utilidade), texto vago demais e variável sem contexto. Corrija com Editar ou crie outro com nome diferente.
«Falta exemplo para {{1}} — a Meta exige.»
Toda variável do corpo precisa de um exemplo. Preencha o campo em Exemplos para a Meta.
«Envie o arquivo de amostra — a Meta exige para aprovar.»
Você escolheu cabeçalho de imagem, vídeo ou PDF e não enviou o arquivo. Envie a mídia no próprio formulário.
«Duas respostas rápidas com o mesmo texto — a Meta recusa.»
Cada botão de resposta rápida precisa de um texto diferente.
O template sumiu da lista ou do funil
Ele foi apagado na Meta. Ao sincronizar, o Leadz tira da lista o que a Meta não tem mais. Crie o template de novo, com outro nome se o antigo foi apagado há menos de 30 dias, e escolha o novo no funil.
No Chat aparece «Nenhum template aprovado. Cadastre em Canais → Templates Meta.»
O número não tem template com status Aprovado. Crie um ou espere a análise terminar, e clique em Sincronizar Meta.
O envio falhou com «Parâmetro inválido no envio (#100)»
Em template, quase sempre é variável a mais, variável a menos ou botão alterado depois da aprovação. Clique em Sincronizar Meta e escolha o template de novo no funil ou no disparo.
«A Meta segurou esta mensagem: o contato já recebeu marketing a mais no período (#131049)»
A Meta limita quantas mensagens de marketing cada pessoa recebe, somando todas as empresas. Não é erro do template. Espere algumas horas ou use um template de Utilidade.
O selo «Botão de link sem rastreio · bloqueado para funis» aparece no template
O template foi criado no gerenciador da Meta e tem botão de link. Clique em Recriar pelo Sparkle Leadz para criar uma cópia que pode ser usada em funis.
#Veja também
Que bom! Obrigado pelo retorno.
Poxa. Tente a solução de problemas ou fale com o suporte.
Mais em Canais
Ver os 10 artigos