Skip to main content
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.
  • Um access token de system user da Meta armazenado no vault do workspace sob meta-access-token. Veja Configuração de credenciais Meta.
  • Papel de owner ou admin no workspace (o pacote inicial é exclusivo para admins).

​
Como acessar o editor de templates

1

Abrir 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.
2

Escolher um modo de início

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.
3

Compor

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.

​
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.
1

Confirmar que a WABA está conectada

Vá em Settings → Channel e verifique que waba_id está preenchido. Se não estiver, o carregamento falhará com no_waba.
2

Clicar em Seed starter pack

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.
3

Revisar os resultados por template

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 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: 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

​
Fluxo de reenvio

1

Duplicar o template rejeitado

O original fica bloqueado. Clique em Duplicate para obter um novo rascunho com o mesmo corpo e componentes.
2

Aplicar a correção

O painel de validação destaca cada regra que o rascunho viola. Corrija-as até que o painel fique verde.
3

Validar (opcional, chamada sem efeito)

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.
4

Enviar para aprovação

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