Templates de WhatsApp: criar, editar, excluir e usar o construtor

Visão geral

O construtor de templates de WhatsApp do Cloud Chat ganhou um novo formulário com preview ao vivo, validação na hora e painel para templates rejeitados pela Meta. Agora dá pra montar mensagens com o leque completo de botões suportados pela Meta — resposta rápida, URL, telefone e o novo Copy Code (cupom que o cliente copia com 1 clique). Templates em revisão (status PENDING) também passam a ser editáveis, e anexos do tipo documento agora preservam o nome do arquivo no destinatário.

A ideia é resolver os problemas mais comuns de template sem precisar abrir o Meta Business Manager — útil principalmente para times que não têm acesso ao painel da Meta porque ele fica sob gestão de outra área da empresa.

Este artigo cobre o uso do construtor de templates dentro do Cloud Chat. Para entender as regras oficiais da Meta sobre estrutura, categorias e motivos de reprovação, vá para Regras de templates do WhatsApp (Meta): categorias, estrutura e reprovações.

O que são templates do WhatsApp

Templates são mensagens pré-aprovadas pela Meta que permitem que sua empresa inicie conversas com clientes. São necessários para:

Enviar promoções e campanhas
Confirmar pedidos e agendamentos
Enviar códigos de verificação
Notificar sobre entregas

Pré-requisitos

Ser administrador da conta no Cloud Chat
Ter uma caixa de entrada de WhatsApp já configurada

Onde fica

Configurações → Caixas de entrada → escolha uma inbox de WhatsApp → aba Templates.

Daqui você consegue:

Criar um template novo
Editar templates PENDING (em revisão) e APPROVED (aprovados)
Visualizar o motivo de rejeição de templates REJECTED
Excluir templates
Sincronizar manualmente o status com a Meta

Como criar um template

Clique em Adicionar template.
Preencha as informações básicas (nome, categoria, idioma).
Monte os componentes do template (cabeçalho, corpo, rodapé, botões) — todos opcionais, exceto o corpo.
Acompanhe o preview ao vivo ao lado do formulário (ou abaixo, no celular) para ver como o template vai aparecer no WhatsApp.
Clique em Salvar. O template é enviado para a Meta e fica em estado PENDING até a revisão.

O botão Salvar fica desabilitado até todos os campos estarem válidos. Se ele estiver cinza, role o formulário para encontrar o campo com erro destacado em vermelho.

Informações básicas

Campo	Regras
Nome	Letras minúsculas, números e underscore. Sem espaços ou acentos.
Categoria	Marketing, Utility ou Authentication.
Idioma	Idioma do conteúdo (ex.: Português (Brasil), English, Español).

A categoria afeta as regras: templates Authentication não aceitam cabeçalho, rodapé, botões de URL nem Copy Code — só botões de resposta rápida.

Padrão de nome recomendado: categoria_proposito (ex.: pedido_confirmacao, promocao_black_friday). Evite acentos, espaços e maiúsculas — nomes como Promoção Black Friday não passam na validação.

Cabeçalho (opcional)

Tipo único por template. Quatro opções:

Tipo	O que aparece	Limite
Texto	Linha de texto em negrito acima do corpo	60 caracteres, no máximo 1 variável
Imagem	Imagem grande no topo da mensagem	JPG ou PNG, até 5 MB
Vídeo	Vídeo reproduzido inline	MP4, até 16 MB
Documento	Anexo (PDF, planilha etc.) com nome visível	PDF, até 100 MB

Para mídia (imagem, vídeo, documento), você faz upload do arquivo de exemplo — a Meta usa esse arquivo para revisar o template. Na hora de enviar uma campanha, você pode substituir pelo arquivo final.

O nome do arquivo enviado é preservado no destinatário em anexos do tipo Documento.

Corpo (obrigatório)

O texto principal da mensagem. Aceita variáveis no formato {{...}} para personalização por destinatário.

Dois formatos de variável:

Formato	Sintaxe	Uso recomendado
Posicional	`{{1}}`, `{{2}}`, `{{3}}`	Templates simples, integrações via API por posição
Nomeado	`{{nome_cliente}}`, `{{cupom}}`	Templates com muitas variáveis, mais legíveis

O formato é detectado automaticamente pelo conteúdo do corpo. Misturar os dois no mesmo template não é permitido.

Regras:

Limite de 1024 caracteres
Variáveis em snake_case (letras minúsculas, números, underscore)
Não pode começar ou terminar com variável
Para cada variável, é preciso preencher um valor de exemplo (usado pela Meta na revisão)

Rodapé (opcional)

Texto curto abaixo do corpo, sem variáveis.

Limite de 60 caracteres
Útil para assinaturas, avisos legais ou instruções para "Responder STOP para sair"

Botões (opcional)

Até 10 botões no total. Quatro tipos disponíveis:

Tipo	O que faz
Resposta rápida	Envia um texto pré-definido como resposta ao apertar
URL estática	Abre uma URL fixa
Telefone	Inicia uma ligação para o número configurado
Copy Code	Copia um código (cupom, voucher) para o clipboard ao apertar

Limites por categoria:

Marketing / Utility: até 10 botões. Pode misturar tipos.
Authentication: apenas botões de resposta rápida.

Botão Copy Code

Mostra um botão que, quando apertado, copia um código para o clipboard do destinatário. Ideal para cupons, vouchers, códigos promocionais.

Disponível para categorias Marketing e Utility
Versão atual usa código estático (mesmo código para todos os destinatários)

Preview ao vivo

Ao lado do formulário (ou abaixo dele em telas menores), aparece uma simulação de como o template vai chegar no WhatsApp:

Cabeçalho, corpo, rodapé e botões na ordem real
Variáveis aparecem com os valores de exemplo preenchidos
Anexos de mídia mostram a pré-visualização

Estados do template

Os templates aparecem na lista com um badge colorido:

Status	Cor	Significado
APPROVED	Verde	Aprovado pela Meta — pronto para uso
PENDING	Amarelo	Em revisão pela Meta — pode ser usado e também editado
REJECTED	Vermelho	Rejeitado pela Meta — abra o template para ver o motivo
PAUSED	Cinza	Pausado pela Meta (geralmente por baixa qualidade de uso)

A revisão da Meta normalmente leva alguns minutos, mas pode demorar até 24h em casos raros. O Cloud Chat sincroniza o status automaticamente.

Quando um template é rejeitado

Templates REJECTED mostram um painel dedicado no topo do modal de edição com:

Motivo da rejeição em pt-BR (traduzido a partir dos códigos da Meta)
CTA "Editar e reenviar" que abre o formulário para correção
Se o código de rejeição ainda não estiver mapeado, mostra um fallback genérico com o código original

Para entender por que a Meta rejeitou e como ajustar o conteúdo, consulte Regras de templates do WhatsApp (Meta).

Fluxo:

Abra o template rejeitado pela lista.
Leia o motivo no painel vermelho.
Clique em Editar e reenviar.
Ajuste o conteúdo conforme o motivo apontado.
Salve — o template volta para PENDING e a Meta refaz a revisão.

Editar templates em revisão (PENDING)

Templates em PENDING ficam editáveis. Ao salvar, a revisão da Meta reinicia.

O badge amarelo no campo de status traz um lembrete: editar um template PENDING reinicia a revisão. Use quando perceber um erro logo após criar o template.

Como excluir um template

Encontre o template na lista.
Clique em Excluir.
Digite o nome exato do template para confirmar.
Clique em Sim, Deletar.

A exclusão não pode ser desfeita — e a Meta retém o nome do template por 30 dias antes da exclusão definitiva. Nesse período, não dá pra criar outro template com o mesmo nome.

Perguntas frequentes

Posso usar variáveis em qualquer parte do template?
No corpo, sim — desde que não estejam no começo ou no fim. No cabeçalho de texto, até 1 variável. Rodapé não aceita variáveis.

Posso misturar variáveis posicionais ({{1}}) e nomeadas ({{nome}}) no mesmo template?
Não. O Cloud Chat detecta o formato pelo conteúdo do corpo e força consistência — o que estiver no corpo precisa também estar nos botões e cabeçalho.

O que acontece se eu editar um template aprovado?
Ele volta para PENDING e passa por nova revisão. Templates em uso por campanhas continuam funcionando enquanto a revisão acontece. A Meta limita edições em templates aprovados a 1 por dia e 10 por mês por template — se passar do limite, o salvamento falha até a janela renovar.

O Copy Code permite código diferente por destinatário?
Nesta versão, não — o código é estático e definido no template. Suporte a código único por envio está planejado para uma fase futura.

Por que meu template foi rejeitado mesmo passando na validação do Cloud Chat?
A validação do Cloud Chat cobre as regras estruturais da Meta (tamanhos, formatos, sintaxe). A Meta também aplica critérios de qualidade de conteúdo (linguagem promocional, formatação, contexto) que só podem ser avaliados na revisão final. O painel de rejeição mostra o motivo específico. Para detalhes sobre cada motivo de reprovação, veja Regras de templates do WhatsApp (Meta).

Posso criar templates Authentication com botão Copy Code?
Não. Templates Authentication aceitam apenas botões de resposta rápida. Para enviar códigos OTP, considere usar a categoria Utility.

Erros comuns

"Nome já existe"
Já existe um template com esse nome — inclusive nomes em período de retenção de 30 dias após exclusão. Escolha um nome diferente.

"Formato inválido do nome"
O nome tem caracteres especiais, espaços ou maiúsculas. Use apenas letras minúsculas, números e underscore.

"Limite de edições atingido"
A Meta limita edições em templates APPROVED a 1 por dia e 10 por mês (por template). Aguarde a janela renovar.

"Template não pode ser editado"
Aparece quando a Meta ainda não liberou a janela de edição (geralmente em PAUSED). Sincronize manualmente para garantir o status atualizado e tente de novo.

Boas práticas

Use o preview ao vivo como checklist visual. Antes de salvar, olhe o preview e pergunte: a mensagem está clara? Variáveis estão nos lugares certos? O botão tem o texto esperado?

Preencha exemplos realistas nas variáveis. A Meta usa esses valores para revisar — exemplos genéricos como "teste" ou "abc" aumentam a chance de rejeição.

Templates Marketing têm critério mais rígido. Se possível, classifique como Utility quando a mensagem for transacional (confirmação de pedido, lembrete de consulta, atualização de status).

Documentação oficial da Meta

Para regras detalhadas sobre estrutura de templates, categorias e motivos de rejeição, consulte a documentação da Meta:

Meta Developers — Message Templates