Diretrizes de template do WhatsApp
Um template que você cria precisa passar nas verificações de envio do Bird e na revisão da Meta antes de poder ser usado. Esta página explica os limites de conteúdo que o Bird verifica, como fornecer variáveis e como responder a uma decisão de revisão. Passar na validação local não garante aprovação da Meta nem entrega posterior.
O Bird também oferece templates de catálogo gerenciados. Leia Templates do WhatsApp para verificar os idiomas disponíveis e a capacidade de envio atual, e Criação de templates para criar um template na sua própria conta.
Limites de caracteres por componente
O Bird verifica esses limites quando você envia conteúdo autoral:
| Componente | Limite | Observações |
|---|---|---|
| Cabeçalho de texto | 60 caracteres | Um cabeçalho por template, e aceita no máximo uma variável |
| Corpo | 1.024 caracteres | Aceita múltiplas variáveis |
| Rodapé | 60 caracteres | Sem variáveis |
| Rótulo do botão | 25 caracteres | Aplica-se a botões de chamada, URL e resposta rápida |
| Destino do botão de URL | 2.000 caracteres | Aceita uma variável, anexada ao final da URL |
| Valor do botão copy-code | 20 caracteres | A string copiada para a área de transferência do dispositivo |
O corpo de um card de carrossel tem um limite separado de 160 caracteres. Regras de categoria e componente também se aplicam: um template de autenticação usa o texto gerado pela Meta, enquanto cabeçalhos GIF, carrosséis e botões copy-code de cupom pertencem a templates de marketing no fluxo de criação do Bird. Verifique a resposta de validação para o idioma e o campo afetados.
Variáveis
Variáveis são as partes de um template que você preenche no momento do envio. Use o formato correspondente ao componente que você está criando:
- O Bird cria templates de autenticação com parâmetros posicionais, escritos como {{1}} e {{2}}. O texto deles vem do formato de autenticação da Meta. Texto de nível superior em templates de utilidade e marketing usa parâmetros nomeados, como {{order_number}}.
- Placeholders posicionais são números de índice a partir de {{1}}, e tanto os valores de amostra quanto os de envio são lidos na ordem em que os placeholders aparecem. Um corpo que pula de {{2}} para {{5}} é rejeitado.
- Placeholders nomeados usam letras minúsculas, números e underscores, como {{order_number}}, e nenhum nome se repete dentro de um idioma. Seus valores são correspondidos por nome e não por posição, então a ordem em que são fornecidos não importa.
- Envolva cada placeholder em chaves duplas. O texto de cards de carrossel usa parâmetros posicionais e valores de amostra posicionais. Um botão de URL com variável usa um placeholder posicional terminal, como https://example.com/orders/{{1}}, mesmo quando o corpo do template usa parâmetros nomeados.
- Mantenha caracteres especiais como #, $ e % fora do placeholder em si.
- Nunca comece nem termine um template com uma variável. A Meta rejeita parâmetros soltos, porque uma mensagem que abre ou fecha com texto substituído não dá contexto ao leitor.
- Cerque cada placeholder com texto fixo que indique o que é o valor substituído. A Meta rejeita um template com placeholders demais para contexto de menos, porque um corpo que é quase todo variáveis parece um formulário em branco em vez de uma mensagem. Adicione texto ou reduza o número de valores.
- Envie valores de amostra junto com o template. A revisão é feita com base em uma pré-visualização renderizada, e um envio sem amostras não pode ser avaliado.
Formatação
O WhatsApp aceita um pequeno conjunto de formatação inline no corpo: negrito, itálico, tachado e monoespaçado. Emoji são permitidos no corpo e nos botões, e o texto do cabeçalho não aceita nenhuma marcação de formatação.
A Meta não aceita HTML, links estilizados como texto âncora nem controle de comprimento de linha além das quebras de linha que você escreve. Uma URL no texto do corpo é renderizada como link bruto, que é exatamente o que os botões de URL existem para evitar.
Revisão e aprovação
Enviar um novo idioma ou uma edição inicia o processo de revisão aplicável. Verifique o status atual no Bird e no WhatsApp Manager em vez de programar um lançamento em torno de um prazo de decisão garantido. Antes de enviar, confirme que o idioma solicitado está disponível, que o número de envio pertence à conta correta e que o destinatário é elegível.
Aprovação e qualidade são coisas separadas. A Meta atualiza a qualidade do template conforme recebe dados de uso e feedback dos destinatários. Uma classificação média ou baixa exige investigação; um idioma pausado ou desativado fica indisponível para envio. Acompanhe o status atual e a ação que a Meta indica em vez de presumir que uma mudança de classificação o restaura automaticamente.
O Bird exibe tanto o status quanto o veredito por idioma no próprio template. Templates do WhatsApp define cada valor e o que ele significa para um envio.
Por que templates são rejeitados
Use o motivo retornado para o idioma afetado. Problemas a verificar incluem:
- Formatação de variáveis. Chaves incompatíveis, placeholders não sequenciais, uma variável bem no início ou no fim, ou mais variáveis do que texto fixo.
- Duplicação. Um template cujo corpo e rodapé correspondem a um texto já registrado na sua conta é rejeitado como duplicata. A Meta informa o template existente na rejeição, para que você possa enviar aquele. Templates de autenticação são isentos dessa verificação.
- Política. Conteúdo que viola a Política de Mensagens Comerciais do WhatsApp ou, para qualquer coisa transacional, a Política de Comércio. Bens proibidos são o caso mais claro, mas também se aplica a uma mensagem cujo propósito o leitor não reconheceria como vindo de você.
- Categorização incorreta. Uma mensagem de marketing enviada como utilidade, na maioria das vezes. A categoria determina tanto o que a Meta permite quanto o custo da mensagem, então a Meta corrige em vez de deixar passar.
Leia a decisão no WhatsApp Manager ou no Business Support Home e nas notificações que a Meta fornece. Corrija o problema relatado e reenvie. Se a decisão oferecer recurso e você discordar, forneça o contexto e os valores de amostra solicitados. Acompanhe o status da revisão; aprovação e prazo de conclusão não são garantidos.
Próximos passos
- Templates do WhatsApp: catálogo, status e variáveis no Bird
- Envio de mensagens do WhatsApp: preenchendo as variáveis de um template no envio
- A janela de atendimento ao cliente do WhatsApp: quando você precisa de um template para entrar em contato com alguém
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
Assista ao guiaBuilding and submitting a WhatsApp templateEntenda o conceitoWhat is a WhatsApp message template?Use a ferramentaWhatsApp message builderExplore a funcionalidadeWhatsApp templates
Experimente na prática e obtenha um resumo de implementação