> ## Documentation Index
> Fetch the complete documentation index at: https://docs.switchbord.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Templates

> Templates de mensagem do WhatsApp — categorias, aprovação e onde criá-los no Switchbord.

O WhatsApp exige que toda mensagem iniciada pela empresa e enviada fora de uma janela de atendimento ao cliente aberta use um **template** pré-aprovado. Os templates são a forma como o Switchbord envia confirmações de reserva, ofertas de marketing, OTPs e qualquer outra mensagem de saída que não seja uma resposta direta a uma mensagem recebida. A Meta revisa e aprova (ou rejeita) cada template antes que ele possa ser usado.

Esta página é o ponto de entrada. Para as regras exatas do validador, as regras de categoria e o editor visual, veja as páginas de aprofundamento linkadas ao longo do texto.

## Categorias

Todo template pertence a exatamente uma categoria atribuída pela Meta, e a categoria determina tanto o conteúdo permitido quanto o valor que a Meta cobra por mensagem entregue:

<CardGroup cols={3}>
  <Card title="Utilidade" icon="receipt">
    Atualizações transacionais sobre algo que o cliente já solicitou — confirmações de pedido, recibos, lembretes de agendamento.
  </Card>

  <Card title="Marketing" icon="bullhorn">
    Conteúdo promocional — ofertas, campanhas, reengajamento. Maior nível de escrutínio e maior custo.
  </Card>

  <Card title="Autenticação" icon="key">
    Códigos de uso único, OTPs e mensagens de MFA. Categoria mais barata, com formato rigidamente restrito.
  </Card>
</CardGroup>

Escolher a categoria errada não gera apenas risco de rejeição — a Meta pode reclassificar silenciosamente um template já aprovado mais tarde, o que altera o valor cobrado. Veja [Templates de marketing](/pt-BR/whatsapp/marketing-templates) para a árvore de decisão, as diferenças de cobrança e como o Switchbord exibe os eventos de migração de categoria.

## Onde os templates ficam armazenados

Os templates são armazenados por workspace com um `status` de `draft`, `pending`, `approved` ou `rejected`, e são versionados por idioma — o mesmo nome de template pode ter uma variante em italiano e outra em inglês, cada uma revisada de forma independente pela Meta.

A criação acontece no **Template Studio** — um construtor visual de 3 painéis com uma prévia fiel em pixels para iOS/Android, para que você veja exatamente como o cabeçalho, o corpo, o rodapé e os botões vão ser exibidos antes de enviar. Veja [Construtor visual de templates](/pt-BR/whatsapp/visual-builder) para o passo a passo completo do editor, incluindo mapeamento de variáveis e upload de mídia.

## Regras de variáveis e estrutura

Os templates usam placeholders `{{1}}`, `{{2}}`, … no cabeçalho e no corpo, preenchidos no momento do envio com dados reais de contato ou de pedido. A Meta aplica regras estruturais rígidas — os placeholders não podem estar no início ou no fim do corpo, não podem ficar um ao lado do outro, e cada placeholder precisa de um valor de exemplo realista. O validador do lado do cliente do Switchbord verifica tudo isso antes do envio, então a maioria das rejeições é detectada no editor, e não pela fila de revisão da Meta.

O conjunto completo de regras — com exemplos do que fazer e do que não fazer para cada verificação do validador — está em [Referência de regras de template](/pt-BR/whatsapp/template-rules).

## Fluxo de aprovação

1. Rascunhe o template no Template Studio.
2. Envie-o — o Switchbord executa o validador do lado do cliente e, em seguida, encaminha o envio para a Meta.
3. A Meta revisa (geralmente entre minutos e algumas horas) e retorna `APPROVED` ou `REJECTED` com um motivo.
4. Templates aprovados ficam disponíveis imediatamente nas Campaigns, Journeys e na API de envio transacional.

<Info>
  Templates aprovados podem ser reclassificados pela Meta depois do fato (um template `UTILITY` reclassificado posteriormente como `MARKETING`, por exemplo). O Switchbord registra toda migração no log de auditoria para reconciliação de cobrança — veja [Migração de categoria](/pt-BR/whatsapp/marketing-templates#migração-de-categoria).
</Info>

## Usando templates

* **Broadcasts / [Campaigns](/pt-BR/features/campaigns)** — mapeie as variáveis do template para os campos do contato para toda uma audiência.
* **[Journeys](/pt-BR/features/journeys)** — envie um template como uma etapa dentro de um fluxo automatizado.
* **API** — envie um template aprovado de forma programática; veja [Endpoints da API de templates](/pt-BR/api-reference/template-endpoints).
* **Margaret** — peça à Margaret para rascunhar um novo template a partir de uma descrição em linguagem natural; ela propõe um rascunho que você revisa antes de criá-lo (veja [Margaret](/pt-BR/features/margaret)).

## Veja também

* [Referência de regras de template](/pt-BR/whatsapp/template-rules) — todas as regras estruturais do validador com exemplos.
* [Templates de marketing](/pt-BR/whatsapp/marketing-templates) — árvore de decisão de categoria, requisitos de opt-out e cobrança.
* [Construtor visual de templates](/pt-BR/whatsapp/visual-builder) — o editor de 3 painéis e a prévia.
* [Seu primeiro template](/pt-BR/getting-started/first-template) — passo a passo completo para um novo workspace.