# 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](/docs/guides/whatsapp/templates) para verificar os idiomas disponíveis e a capacidade de envio atual, e [Criação de templates](/docs/guides/whatsapp/authoring-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](/docs/guides/whatsapp/templates) 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](/docs/guides/whatsapp/templates): catálogo, status e variáveis no Bird
- [Envio de mensagens do WhatsApp](/docs/guides/whatsapp/sending-whatsapp): preenchendo as variáveis de um template no envio
- [A janela de atendimento ao cliente do WhatsApp](/docs/knowledge-base/whatsapp/customer-service-window): quando você precisa de um template para entrar em contato com alguém

## Related resources

- [Building and submitting a WhatsApp template](/learn/whatsapp/building-and-submitting-a-whatsapp-template) (video)
- [What is a WhatsApp message template?](/explained/whatsapp/what-is-a-whatsapp-message-template) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp templates](/products/whatsapp/templates) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp-templates)
