Template é uma mensagem pronta que a Meta aprova antes do uso. É o único jeito de falar primeiro com um contato no WhatsApp ou de retomar uma conversa depois que a janela de 24 horas fechou. Transmissões, automações e o envio de modelo na conversa usam os templates aprovados daqui.
Cada template pertence a um número de WhatsApp do cliente escolhido no seletor do topo do painel. Tudo fica em Campanhas › Templates.
Templates são só do WhatsApp. O Instagram não tem template: lá você responde até 24 horas depois da última mensagem do contato, e não há como mandar mensagem para quem não escreveu. Veja Conectar e atender pelo Instagram.
Antes de começar
- Escolha o cliente no seletor do topo do painel. Sem número de WhatsApp conectado, a tela mostra Conecte um número primeiro. (ou o nome do cliente) e nada pode ser criado. Isso vale também para um cliente que só tem Instagram conectado.
- Pense na categoria antes de escrever. A Meta confere se o texto combina com ela e cobra cada categoria de um jeito. Veja Campanhas.
A lista de templates
A tabela mostra Nome, Categoria, Idioma, Status e Última sincronização. A categoria aparece com os mesmos nomes do criador (Marketing, Utilidade ou Autenticação) e o idioma pelo nome, como Português (Brasil). Use Buscar por nome e os filtros Todos, Aprovados, Pendentes e Rejeitados.
O status diz em que ponto o template está:
- Pendente: a Meta está analisando. Ainda não dá para usar.
- Aprovado: pronto para transmissões, automações e conversas.
- Rejeitado: a Meta recusou. O motivo aparece logo abaixo do status.
Depois de aprovado, a Meta ainda pode mudar o status. Nesses casos, uma explicação curta aparece embaixo do status:
- Pausado: a Meta pausou o envio por avaliações negativas de quem recebeu. Revise o texto e edite o template.
- Desativado: a Meta desativou o template por baixa qualidade. Ele não sai mais: crie outro.
- Em recurso: a rejeição foi contestada e a Meta está reavaliando.
- Em alerta: a qualidade caiu e a Meta pode pausar o template. Revise o texto.
- Acima do limite: a conta do WhatsApp chegou ao limite de templates da Meta. Exclua os que não usa.
O status muda sozinho quando a Meta responde: a lista se atualiza sem você recarregar a página.
No menu de ações (⋮) de cada linha ficam Ver, Editar e Excluir. Ver abre a mensagem como ela aparece no WhatsApp, com o idioma, a categoria e o status no topo, por exemplo "Português (Brasil) · Marketing · Aprovado".
Passo a passo: criar um template
1. Abra o criador
Em Campanhas › Templates, clique em Novo template. Ao lado do formulário fica a Prévia ao vivo, que mostra a mensagem como o contato vai ver. Em Exemplo, a prévia troca cada variável pelo valor de exemplo; em Parâmetros, mostra as variáveis como {{1}}, {{2}}.
2. Identificação
- Cliente: o número que vai enviar este template. Só aparecem números ativos do cliente selecionado.
- Nome: só letras minúsculas, números e underscore, como
confirmacao_pedido. Espaços viram underscore enquanto você digita. O nome não muda depois de criado. - Categoria: Marketing (promoções, novidades e ofertas), Utilidade (confirmações, atualizações e avisos de um pedido em andamento) ou Autenticação (códigos de verificação e acesso).
- Idioma: o idioma do texto. Também não muda depois de criado.
Importante: a Meta pode trocar a categoria que você escolheu se achar que o texto é de outro tipo. Um aviso de pedido com oferta, por exemplo, vira Marketing. A lista mostra sempre a categoria que a Meta confirmou.
3. Tipo de conteúdo
Em Tipo de conteúdo, escolha Mensagem padrão (uma mensagem com cabeçalho, corpo, rodapé e botões) ou Carrossel (vários cards deslizáveis, cada um com mídia, texto e botões). Veja Carrossel abaixo.
4. Cabeçalho (opcional)
Em Tipo de cabeçalho, escolha Sem cabeçalho, Texto, Imagem, Vídeo, Documento ou Localização.
-
Texto: até 60 caracteres, com no máximo uma variável, que precisa ser
{{1}}. Com a variável, preencha o exemplo que aparece abaixo. -
Imagem, Vídeo ou Documento: em Mídia do cabeçalho, clique em Enviar arquivo. Quando aparecer Mídia carregada ✓, está pronto. Aceita imagem JPG ou PNG até 5 MB, vídeo MP4 ou 3GP até 16 MB e documento PDF até 100 MB. Sem o arquivo, Enviar para revisão avisa Envie o arquivo de exemplo da mídia do cabeçalho.
-
Localização: não pede nada na criação. O local (um cartão de mapa no topo da mensagem) é escolhido na hora de enviar.
O arquivo enviado aqui é só o exemplo que a Meta usa na análise. Na hora de mandar, você escolhe a mídia de verdade.
5. Corpo
O corpo é o texto principal, com até 1.024 caracteres.
Para personalizar, use variáveis: clique em Adicionar variável ou digite {{}}, que vira o próximo número sozinho. As variáveis precisam seguir a ordem {{1}}, {{2}}, {{3}}, sem pular número.
O corpo conta as variáveis à parte do cabeçalho. Com {{1}} no cabeçalho, o corpo também começa em {{1}}. Os dois não se misturam: no envio, o {{1}} do cabeçalho e o {{1}} do corpo têm um campo cada.
Para cada variável, preencha um valor de exemplo no quadro Valores de exemplo, que a Meta usa para revisar o template. Use exemplos reais, como "Maria" para o nome e "12345" para o pedido. Exemplo vazio ou sem sentido é causa comum de rejeição.
6. Rodapé (opcional)
Uma linha pequena em cinza no fim, com até 60 caracteres e sem variáveis. Um uso comum é "Toque em Parar avisos para não receber mais", com um botão de resposta rápida marcado como de saída (veja o passo 7).
7. Botões (opcional)
Até 3 botões por mensagem. O rótulo tem até 25 caracteres.
- Resposta rápida: o contato toca e a resposta chega na conversa. Cada botão de resposta rápida tem a opção Este botão é para sair das mensagens (veja Botão de saída).
- Link: abre um endereço que começa com
http://ouhttps://. Marque URL dinâmica (adiciona uma variável no fim do link) para mudar o fim do endereço a cada envio (por exemplo, o número do pedido) e preencha URL completa de exemplo. - Telefone: liga para o número de Telefone (com DDI), só dígitos, como
5511999998888. - Copiar código: mostra um botão fixo que copia um cupom. Em Código de exemplo, informe um código de até 20 caracteres, que serve só para a análise da Meta.
- Catálogo: abre o catálogo de produtos ligado ao número.
Para remover um botão, clique na lixeira dele.
Botão de saída
Marque Este botão é para sair das mensagens no botão de resposta rápida que serve para o contato deixar de receber. Quando ele tocar, o BotoZap registra a recusa da finalidade do template: marketing para template de Marketing, avisos para template de Utilidade, e manda ao contato a mesma confirmação de saída da Palavra de saída (texto em Clientes, aba Detalhes). Só os botões marcados fazem isso, qualquer que seja o texto: um "Cancelar" de agenda, por exemplo, continua sendo só cancelar o horário. Se o texto do botão parece de saída (como "Parar avisos"), a tela mostra O texto parece de saída. Marque se este botão deve descadastrar quem tocar. e quem decide é você. O agente de IA não responde a quem toca num botão de saída: o contato recebe só a confirmação.
Para um template que já existe, inclusive os trazidos da Meta, abra o menu ⋮ da linha na lista de templates e clique em Botões de saída. Marque os botões e clique em Salvar: o template não volta para análise, porque a marcação é só do BotoZap.
8. Envie para a análise
Clique em Enviar para revisão. O template aparece na lista como Pendente e a mensagem Template enviado para revisão da Meta. confirma o envio.
Carrossel
Com Carrossel em Tipo de conteúdo, o Corpo vira o texto de apresentação acima dos cards, e o cabeçalho, o rodapé e os botões da mensagem padrão somem.
Em Cards do carrossel:
- Escolha o Formato de mídia (todos os cards): Imagem ou Vídeo. Todos os cards usam o mesmo.
- Em cada card, envie a mídia, escreva o Corpo do card (até 160 caracteres) e adicione de 1 a 2 botões de Resposta rápida ou Link.
- Clique em Adicionar card para o próximo. O limite é 10 cards.
Todos os cards precisam ter os mesmos botões, na mesma ordem. É uma exigência da Meta.
A mídia de cada card enviada aqui também é só o exemplo da análise. Ao mandar o carrossel, numa transmissão ou na conversa, você envia a imagem (ou o vídeo) de cada card e preenche as variáveis do corpo e o fim dos links dinâmicos de cada um. Os botões de Resposta rápida não pedem nada.
Autenticação
Com a categoria Autenticação, o formulário muda. O texto do corpo é escrito pela Meta e você configura só:
- Tipo de botão OTP: Copiar código ou Toque único (Android). O toque único preenche o código direto no seu aplicativo Android e pede Package name do app e Signature hash, que quem desenvolveu o aplicativo fornece.
- Rótulo do botão (opcional).
- Validade do código (minutos, opcional): de 1 a 90 minutos. Aparece no rodapé.
- Adicionar recomendação de segurança (“não compartilhe este código”).
Cada envio de um template de autenticação leva um código de verificação novo, gerado pelo sistema do seu site ou aplicativo. Por isso ele só é enviado pela API, por quem cuida da integração: ele não aparece em Nova transmissão nem no envio de modelo da conversa, e o seletor avisa quantos ficaram de fora. Veja a referência de mensagens.
O que acontece depois
A Meta analisa o template e o status muda sozinho para Aprovado ou Rejeitado.
- Aprovado: o template já aparece em Nova transmissão e no envio de modelo da conversa (menos os de Autenticação). O editor das automações lista só os templates em que o único dado a preencher é o texto do corpo: com mídia, localização ou texto variável no cabeçalho, botão com valor, carrossel ou Autenticação, use uma transmissão.
- Rejeitado: o motivo aparece embaixo do status. Os mais comuns:
- Categoria não corresponde ao conteúdo ou Conteúdo não corresponde à categoria: o texto é de outro tipo. Um aviso com oferta, por exemplo, é Marketing.
- Conteúdo promocional fora da categoria de marketing: há promoção num template de Utilidade.
- Formato inválido (variáveis, exemplos ou componentes): confira a ordem das variáveis e os exemplos.
- Categoria indisponível para esta conta: a conta do WhatsApp não pode usar essa categoria.
- Conteúdo considerado abusivo pela Meta ou Suspeita de golpe: reescreva o texto.
- Outro motivo informado pela Meta: a Meta usou um motivo fora dessa lista. O código dela aparece entre parênteses. Revise o texto, a categoria e os exemplos antes de reenviar.
Um template da categoria Marketing usado numa automação só sai para quem aceitou receber marketing. Veja Automações (réguas).
Editar um template
- No menu de ações (⋮) do template, clique em Editar.
- Ajuste o conteúdo. Cliente, Nome e Idioma ficam travados; a categoria pode mudar.
- Clique em Salvar e reenviar.
O template volta para Pendente até a Meta aprovar de novo. Enquanto está pendente, ele não aparece para novos envios.
Não dá para editar enquanto a Meta analisa: a tela mostra Este template está em análise. Espere a resposta.
Excluir um template
- No menu de ações (⋮) do template, clique em Excluir.
- Confirme em Excluir.
O template é apagado na Meta e aqui. Não dá para desfazer.
Quem usa o BotoZap pela API edita com PATCH e exclui com DELETE em /api/v1/templates/{id}, com as mesmas regras.
Sincronizar com a Meta
Se você criou, alterou ou excluiu templates direto no WhatsApp Manager da Meta, clique em Sincronizar da Meta. O BotoZap confere os templates do cliente escolhido no seletor do topo:
- traz os novos e atualiza categoria, idioma, status e o motivo de rejeição;
- tira da lista os que foram excluídos na Meta.
Os outros clientes da conta não mudam. O aviso diz quantos templates deste cliente foram sincronizados e, se for o caso, quantos saíram da lista por terem sido excluídos na Meta.
A sincronização também corrige uma automação de modelo que ficou esperando a aprovação: se o template já foi aprovado, ela liga.
Use também quando um status parecer parado, por exemplo um template que continua Em análise muito depois do normal. Se o número ficou um tempo sem receber mensagens da Meta, os avisos de aprovação desse período não chegaram, e a sincronização traz o status real. Quando você reconecta o número, o BotoZap já sincroniza sozinho.
Quem usa o BotoZap pela API faz o mesmo com POST /api/v1/templates/sync.
Problemas comuns
O botão Enviar para revisão devolve "Nome inválido". Use só letras minúsculas, números e underscore, sem acento.
Aparece "As variáveis devem ser sequenciais". Renumere para começar em {{1}} e não pular número.
Aparece "No corpo, as variáveis começam de novo em {{1}}". O cabeçalho já tem {{1}} e o corpo continuou a contagem ({{2}}, {{3}}). Troque as do corpo para {{1}}, {{2}}, {{3}}.
Aparece "Preencha um valor de exemplo para cada variável do corpo". Preencha todos os campos do quadro de valores de exemplo.
Aparece "A Meta recusou o template" com um texto em seguida. A Meta não aceitou o envio antes mesmo da análise. Um motivo frequente é já existir um template com o mesmo nome na conta do WhatsApp: clique em Sincronizar da Meta para trazê-lo e use outro nome.
O template aprovado não aparece para enviar. Confira se o cliente selecionado no topo é o dono do número do template. Cada template só vale para o número em que foi criado.
Aparece "O template foi excluído na Meta, mas não foi possível tirá-lo da lista daqui" (ou "A Meta recebeu a edição… mas não foi possível salvar a mudança aqui"). A Meta já fez a mudança, mas o BotoZap não conseguiu gravá-la. Clique em Sincronizar da Meta para a lista ficar igual à da Meta.
Aparece "Uma conexão está sem token de acesso" ao sincronizar. O número precisa ser reconectado: em Configurações › Canais, clique em Reconectar na linha do número.
A integração recebe o erro duplicate_message da API. O mesmo template, com os mesmos dados, já tinha saído para aquele contato menos de 1 minuto antes. O BotoZap não manda a cópia, para o contato não receber a mensagem em dobro. Peça a quem cuida da integração para ver por que o mesmo envio saiu duas vezes. Para mandar de novo de propósito, espere 1 minuto. Veja a referência de mensagens.
Na conversa, aparece "Esta mesma mensagem já foi aceita para este contato há menos de 60 segundos". É a mesma regra: o template, com os mesmos dados, acabou de sair para esse contato, pelo painel ou pela integração. Confira a conversa; se precisar mandar de novo, espere 1 minuto.
