Templates

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.

Antes de começar

• Escolha o cliente no seletor do topo do painel. Sem número conectado, a tela mostra Conecte um número primeiro. (ou o nome do cliente) e nada pode ser criado.
• 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.

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.

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 é "Responda PARAR para não receber mais".

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.
• Link: abre um endereço que começa com http:// ou https://. 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é 15 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.

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:

1. Escolha o Formato de mídia (todos os cards): Imagem ou Vídeo. Todos os cards usam o mesmo.
2. 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.
3. 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

1. No menu de ações (⋮) do template, clique em Editar.
2. Ajuste o conteúdo. Cliente, Nome e Idioma ficam travados; a categoria pode mudar.
3. 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

1. No menu de ações (⋮) do template, clique em Excluir.
2. Confirme em Excluir.

O template é apagado na Meta e aqui. Não dá para desfazer.

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.

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 "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.