> ## 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.
# Configurar mensagens de marketing
> Abra o editor de templates, popule o pacote inicial GB Viaggi, defina expectativas de aprovação e resolva rejeições.
Este guia conduz um owner ou admin do workspace pela configuração de ponta a ponta de mensagens de marketing: abrir o editor de templates, popular o pacote inicial GB Viaggi, definir expectativas para o cronograma de revisão da Meta e resolver rejeições comuns.
## Pré-requisitos
Antes de começar:
* Um workspace com uma WhatsApp Business Account (WABA) da Meta conectada. Veja [Conectar o WhatsApp](/pt-BR/platform/connect-whatsapp).
* Um access token de system user da Meta armazenado no vault do workspace sob `meta-access-token`. Veja [Configuração de credenciais Meta](/pt-BR/operations/meta-credential-setup).
* Papel de `owner` ou `admin` no workspace (o pacote inicial é exclusivo para admins).
## Como acessar o editor de templates
Na barra lateral esquerda, clique em **Templates**. Você verá sua biblioteca de templates agrupada por status. Workspaces novos exibem um card de estado vazio com um botão de início rápido.
Três pontos de entrada:
* **New template** — editor em branco, para rascunhos pontuais.
* **From library** — clone um template aprovado de outro idioma.
* **Seed starter pack** (exclusivo para admins) — carregue em massa o pacote GB Viaggi com um clique.
O editor tem quatro painéis: metadados (nome, idioma, categoria), componentes (cabeçalho, corpo, rodapé, botões), preview em tempo real que reflete a renderização do WhatsApp, e resultados de validação.
Cada campo tem um ícone de informação que leva à regra exata em [Regras de templates](/pt-BR/whatsapp/template-rules).
## Popule o pacote inicial GB Viaggi
O pacote inicial é uma biblioteca curada de 13 templates de qualidade produtiva (8 `UTILITY` + 5 `MARKETING`, em italiano e inglês) que cobre os fluxos mais comuns da GB Viaggi: confirmação de reserva, fatura, cancelamento, winback, oferta sazonal, indicação, venda-relâmpago, e mais. O carregamento é idempotente — seguro para reexecutar se um subconjunto falhar na primeira tentativa.
Vá em **Settings → Channel** e verifique que `waba_id` está preenchido. Se não estiver, o carregamento falhará com `no_waba`.
Na página **Templates**, clique em **Seed starter pack** (visível apenas para owner/admin). Um modal resume o que será enviado e solicita confirmação.
O carregador envia cada template à Meta sequencialmente. Cada linha na tabela de resultados reporta `submitted`, `pending_approval` ou `error` com a mensagem da Meta. Erros também são armazenados na linha de `templates` como `rejection_reason` para nova tentativa posterior.
Por baixo dos panos, a interface chama `POST /api/templates/seed-starter-pack` — veja [Endpoints de templates](/pt-BR/api-reference/template-endpoints) se você quiser disparar isso a partir de um script.
## Expectativas de cronograma de aprovação
O pipeline de revisão da Meta é quase sempre rápido, mas "rápido" varia por categoria e por carga:
| Categoria | Tempo de revisão típico | Casos atípicos |
| ---------------- | ----------------------- | --------------------------- |
| `AUTHENTICATION` | Menos de 5 minutos | Até 1 hora |
| `UTILITY` | 5–30 minutos | 1–2 horas sob carga elevada |
| `MARKETING` | 15 minutos – 2 horas | Até 24 horas |
Regras práticas:
* **Templates limpos e bem formados são aprovados em minutos.** Se o seu está pendente há mais de 2 horas, um revisor o marcou para revisão manual.
* **Fins de semana e feriados nos EUA (onde a Meta está sediada) atrasam as revisões.** Envie em dias de semana se sua campanha for crítica.
* **Envios em burst sofrem throttling.** A Meta limita a 100 templates/hora por WABA. Popular o pacote inicial de 13 templates usa menos de 15% desse orçamento.
Você não precisa fazer polling na API da Meta. O worker de webhook do Switchbord escuta `message_template_status_update` e atualiza a linha do template em tempo real. A interface se atualiza via Supabase Realtime.
## Resolvendo rejeições
Quando um template é rejeitado, o Switchbord armazena a mensagem legível da Meta em `rejection_reason` e a exibe no topo do editor e na linha do template.
### Mapa de rejeição comum → correção
| Mensagem da Meta (paráfrase) | Regra | Correção |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| Variable parameters cannot be next to each other | [adjacent-variables](/pt-BR/whatsapp/template-rules#adjacent-variables) | Adicione uma palavra entre os placeholders |
| Body text cannot begin with a variable parameter | [leading-variable](/pt-BR/whatsapp/template-rules#leading-variable) | Adicione uma saudação antes de `{{1}}` |
| Body text cannot end with a variable parameter | [trailing-variable](/pt-BR/whatsapp/template-rules#trailing-variable) | Adicione texto fixo depois do último placeholder |
| Number of parameter examples does not match variables | [example-count-mismatch](/pt-BR/whatsapp/template-rules#example-count-mismatch) | Forneça um exemplo por `{{n}}` |
| Examples must be representative — numeric/symbol not allowed | [numeric-only-example](/pt-BR/whatsapp/template-rules#numeric-only-example) | Use exemplos alfanuméricos realistas (incorpore unidades nos valores) |
| Template name must contain only lowercase letters… | [name-regex](/pt-BR/whatsapp/template-rules#name-regex) | Renomeie para `snake_case` |
| Body text exceeds the 1024 character limit | [length-caps](/pt-BR/whatsapp/template-rules#length-caps) | Reduza o corpo para ≤ 1024 caracteres |
| Template cannot have more than 3 quick reply buttons | [button-limits](/pt-BR/whatsapp/template-rules#button-limits) | Limite as respostas rápidas a 3 |
### Fluxo de reenvio
O original fica bloqueado. Clique em **Duplicate** para obter um novo rascunho com o mesmo corpo e componentes.
O painel de validação destaca cada regra que o rascunho viola. Corrija-as até que o painel fique verde.
Clique em **Validate** para reexecutar apenas o linter do lado do cliente. Diferente de **Submit for approval**, isso não consome uma cota do seu orçamento de rate-limit da Meta.
Clique em **Submit for approval**. O webhook atualiza o status do template em segundo plano.
### Quando escalar
Se um template for rejeitado com uma mensagem da Meta que você não reconhece, ou se o mesmo template for rejeitado por motivos diferentes em cada tentativa:
1. Capture o JSON completo do erro da Meta na linha `rejection_reason` do template (ele inclui `fbtrace_id`).
2. Abra um issue no Linear com a tag `whatsapp-templates`, incluindo o nome do template, o corpo e o erro.
3. Se o problema estiver bloqueando uma campanha, abra um caso no Meta Business Support com o `fbtrace_id` — o tempo de resposta costuma ser de 24 a 48 horas.
## Veja também
* [Seu primeiro template](/pt-BR/getting-started/first-template) — passo a passo completo.
* [Referência de regras de templates](/pt-BR/whatsapp/template-rules) — todas as regras do validador.
* [Templates de marketing](/pt-BR/whatsapp/marketing-templates) — árvore de decisão de categoria e opt-out.
* [Endpoints de templates](/pt-BR/api-reference/template-endpoints) — automatize a partir de scripts.