Sign inGet started

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:
ComponenteLimiteObservações
Cabeçalho de texto60 caracteresUm cabeçalho por template, e aceita no máximo uma variável
Corpo1.024 caracteresAceita múltiplas variáveis
Rodapé60 caracteresSem variáveis
Rótulo do botão25 caracteresAplica-se a botões de chamada, URL e resposta rápida
Destino do botão de URL2.000 caracteresAceita uma variável, anexada ao final da URL
Valor do botão copy-code20 caracteresA 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