# 08 — GUIA DE SUBMISSÃO META BUSINESS MANAGER

Passo a passo pra colar o template no lugar certo e fazer aprovar.

---

## 8.1 ONDE SUBMETER

### Opção 1: Meta Business Manager direto (Cloud API)
1. Acesse business.facebook.com
2. Menu lateral → **WhatsApp Manager**
3. Aba **Message Templates**
4. Botão azul **Create Template**

### Opção 2: Por BSP (Botconversa, Z-API, Twilio, Gupshup, etc)
Cada BSP tem painel próprio. Procura por "Templates" ou "Message Templates" no menu. A submissão final vai pra Meta de qualquer jeito.

### Opção 3: Via API (Cloud API direto)
Endpoint: `POST /{whatsapp-business-account-id}/message_templates`

---

## 8.2 CAMPOS DA SUBMISSÃO

### Campo 1: Name (nome interno do template)
- Sem espaço, sem acento, só letras minúsculas, números e underscore
- Exemplo: `pedido_confirmado`, `lembrete_consulta_24h`, `fatura_disponivel`
- Esse nome é o que vai chamar na API ou no BSP
- Não pode duplicar com outro template existente

### Campo 2: Category
- Escolhe: **Utility**, **Marketing**, **Authentication**
- Se em dúvida entre Utility e Marketing, leia `01-fundamentos.md` seção 1.6 (4 testes)
- **Atenção:** Meta pode recategorizar no envio, mesmo que aprove a submissão

### Campo 3: Language
- Pra Brasil: **Portuguese (BR)** / `pt_BR`
- Tem que bater com o idioma escrito no body
- Submeter em pt_BR mas escrever em outro idioma reprova

### Campo 4: Header (opcional)
- Tipos: **None / Text / Image / Video / Document / Location**
- Se for Text: até 60 caracteres, 1 variável máx
- Se for mídia: precisa fazer upload de SAMPLE pra Meta avaliar

### Campo 5: Body (obrigatório)
- Até 1024 caracteres
- Variáveis `{{1}}`, `{{2}}`, etc na ordem
- Pode usar formatação: `*negrito*`, `_itálico_`, `~tachado~`, ` ```mono``` `

### Campo 6: Footer (opcional)
- Até 60 caracteres
- Texto fixo, sem variável

### Campo 7: Buttons (opcional)
- Até 10 botões totais, com regras de combinação:
  - **Quick Reply**: até 3 botões
  - **Call to Action**: 1 URL + 1 Phone
  - **Copy Code**: 1 botão
  - **Flow**: 1 botão (Flows do WhatsApp)
- Label de cada botão: até 25 caracteres

### Campo 8: Sample values (CRÍTICO)
- Pra cada variável `{{N}}`, fornece um valor de exemplo
- **Tem que ser realista, não genérico**
- Não use: "teste", "abc", "123", "exemplo"
- Use: nomes reais, números reais, datas reais, URLs reais

---

## 8.3 EXEMPLOS DE VALORES REALISTAS PARA SUBMISSÃO

### Nomes
- Maria Silva, João Pereira, Ana Costa, Carlos Oliveira
- Nunca: "Cliente", "Usuário", "Nome do Cliente"

### Números de pedido/protocolo
- "PED-89234", "#4521", "OS-2026/03842", "PROT-887421"
- Nunca: "12345", "número", "código"

### Datas
- "15/06/2026", "22 de junho", "15/06 às 14h30"
- Nunca: "data", "DD/MM/AAAA", "amanhã"

### Valores monetários
- "R$ 297,00", "R$ 1.997,00", "R$ 49,90"
- Nunca: "R$ valor", "X,XX", "valor"

### URLs (se for variável em URL)
- "abc123xyz" (hash real)
- "PED-89234" (mesmo número usado no body)
- Nunca: "link", "url", "/path"

### Códigos
- "PIX-COPIA-COLA-REAL", "CR-987654321"
- Nunca: "código aqui", "código de barras"

### Endereços
- "Rua das Flores, 123 - São Paulo/SP"
- Nunca: "endereço", "Rua X"

---

## 8.4 TEMPO DE APROVAÇÃO

| Cenário | Tempo médio |
|---|---|
| Template simples, conta antiga e em boa qualidade | 1-30 minutos |
| Template com mídia ou botão URL | 30 minutos a 4 horas |
| Conta nova, primeira submissão | 2-24 horas |
| Volume alto de submissões no mesmo dia | Pode ir pra 24-48h |
| Submissão de madrugada/fim de semana | 2-24h |

Meta NÃO tem suporte humano via chat pra acelerar. Submeteu, esperou.

---

## 8.5 MOTIVOS COMUNS DE REJEIÇÃO (e como evitar)

### REJEIÇÃO: "CATEGORY_MISMATCH"
**O que significa:** Conteúdo do template não bate com a categoria escolhida.
**Causa típica:** Submeteu como Utility um conteúdo promocional.
**Como evitar:** Aplica os 4 testes (01-fundamentos.md seção 1.6) antes de submeter.

### REJEIÇÃO: "INVALID_FORMAT"
**O que significa:** Algum componente tá fora da regra técnica.
**Causa típica:**
- Variável no começo ou fim de parágrafo
- Variáveis em sequência (`{{1}} {{2}}`)
- Label de botão > 25 chars
- Body > 1024 chars
- Header de texto > 60 chars

**Como evitar:** Rode o checklist 15 pontos de `05-validadores.md`.

### REJEIÇÃO: "POLICY_VIOLATION"
**O que significa:** Linguagem viola política Meta.
**Causa típica:**
- Palavra promocional em utility
- Promessa enganosa
- Conteúdo sensível mal contextualizado
- Personificação enganosa (se passar por outra empresa)

**Como evitar:** Consulta lista de palavras que matam em `02-vocabulario-completo.md` seção 2.5.

### REJEIÇÃO: "SAMPLE_MISMATCH" ou "INCOMPLETE_SAMPLE"
**O que significa:** Exemplos das variáveis não batem com o uso real ou faltou exemplo.
**Causa típica:** Submeteu "teste" em vez de "Maria Silva", ou não preencheu o sample.
**Como evitar:** Use sempre valores realistas (seção 8.3 acima).

### REJEIÇÃO: "URL_INVALID" ou "URL_SUSPICIOUS"
**O que significa:** URL do botão não passa na verificação.
**Causa típica:**
- Encurtador (bit.ly, tinyurl, etc)
- Domínio diferente da empresa
- HTTP em vez de HTTPS
- Domínio recém-registrado sem reputação

**Como evitar:** Use sempre seu próprio domínio HTTPS estável.

### REJEIÇÃO: "TEMPLATE_PARAM_MISSING" ou "TOO_MANY_VARIABLES"
**O que significa:** Quantidade de variáveis ou samples não bate.
**Causa típica:** Body tem `{{1}}, {{2}}, {{3}}` mas você preencheu só 2 samples.
**Como evitar:** Garanta que para cada `{{N}}` existe um sample preenchido.

---

## 8.6 O QUE FAZER SE REPROVAR

### Passo 1: Lê o motivo da rejeição
Meta sempre informa o motivo (código de erro + breve descrição).

### Passo 2: Não cria template novo
Edita o template existente (mantém histórico, contador de submissões).

### Passo 3: Corrige a causa raiz
Não maquila. Se o problema é linguagem promocional, reescreve com vocabulário operacional. Se é variável mal posicionada, reposiciona.

### Passo 4: Resubmete
Aprovação geralmente vem em poucas horas pra correções.

### Passo 5: Se reprovar 3+ vezes
Provavelmente a intenção da mensagem não é utility de verdade. Reformula como marketing ou abandona o template.

---

## 8.7 BOAS PRÁTICAS DE SUBMISSÃO

### Frequência de submissões
- Conta nova: 1-2 templates por dia
- Conta estabelecida: até 5-10 por dia
- Submeter 20 templates no mesmo dia gera flag e pode retardar aprovação

### Ordem recomendada (conta nova)
1. Primeiro 1 template utility simples (confirmação de pedido)
2. Esperar aprovar
3. Submeter próximos 2-3 utilities
4. Depois de ter histórico bom, submete marketing

### Versionamento
- Cada vez que edita um template aprovado, ele volta pra análise
- Faça mudanças significativas em lotes, não micro-edições constantes
- Quality rating é cumulativo: template muito editado vira suspeito

### Nomenclatura
- Use prefixos: `utility_*`, `mkt_*`, `auth_*`
- Inclua versão se relevante: `utility_pedido_confirmado_v2`
- Documente o nome interno em planilha pra equipe

---

## 8.8 GERENCIAMENTO DE QUALITY RATING

Cada template aprovado tem rating individual baseado em block rate:

### Como manter GREEN
- Opt-in claro antes de enviar
- Não saturar (no máximo 1-2 utilities/dia por contato)
- Mensagem genuinamente útil
- Fácil identificar a empresa

### Se cair pra YELLOW
- Para de enviar esse template
- Investiga: qual público recebeu? Quantos bloquearam?
- Corrige o público ou o conteúdo
- Espera 24-48h pra rating recuperar

### Se cair pra RED
- Template foi pausado por Meta automaticamente
- Não envia mais
- Crie versão V2 com problemas corrigidos
- Submeta de novo (vai pra fila normal de aprovação)

---

## 8.9 TIER DE ENVIO

| Tier | Limite |
|---|---|
| 250 | 250 contatos únicos/24h |
| 1.000 | 1k contatos únicos/24h |
| 10.000 | 10k contatos únicos/24h |
| 100.000 | 100k contatos únicos/24h |
| Unlimited | Sem limite |

**Como subir:**
- Sustentar HIGH quality rating geral da conta
- Usar mais de 50% do tier atual em volume real
- Tempo: subida pra próximo tier rola em alguns dias se condições batem

---

## 8.10 SUBMISSÃO POR BSP (especificidades)

### Botconversa
- Menu → Configurações → WhatsApp → Templates
- Edição visual, mas envia pra Meta normalmente
- Limitação: alguns recursos avançados (Flow Button) podem não estar disponíveis

### Z-API
- Painel → Templates HSM
- Aceita criação por API e por painel
- Tempo de aprovação igual ao Cloud API direto

### Evolution API
- **Não suporta templates oficiais**
- Só serve pra atendimento livre dentro da janela 24h
- Não é solução pra envio em massa fora da janela

### Twilio
- Console → Programmable Messaging → Content Templates
- Sintaxe um pouco diferente, mas mesmas regras Meta
- Approval mais demorado em alguns casos

### Gupshup
- Dashboard → WhatsApp → Manage Templates
- Suporta upload em batch (CSV)
- Bom pra empresas que vão submeter 20+ templates de uma vez

---

## 8.11 DESPESAS E FATURAMENTO

### Como funciona o pagamento
- Conta no Meta Business Manager precisa ter forma de pagamento configurada
- Mesma BM da conta de anúncios
- Cobrança automática conforme uso
- Faturamento mensal ou por limite atingido

### Como monitorar gastos
- Business Manager → WhatsApp Manager → Insights
- Filtra por categoria (utility/marketing/auth)
- Identifica template que tá recategorizando (utility virando marketing)

### Bandeiras vermelhas no faturamento
- Aumento súbito de gasto em marketing sem campanha nova → recategorização
- Volume alto de utility cobrado → janela 24h não tá sendo aproveitada (clientes não abrem conversa)
- Custo médio por mensagem subindo → templates estão recategorizando

---

## 8.12 CHECKLIST FINAL ANTES DE APERTAR "SUBMIT"

- [ ] Categoria correta selecionada (Utility/Marketing/Auth)
- [ ] Idioma correto (pt_BR pra Brasil)
- [ ] Header dentro do limite
- [ ] Body dentro de 1024 chars
- [ ] Footer dentro de 60 chars
- [ ] Botões dentro do limite por tipo
- [ ] Labels de botão até 25 chars
- [ ] Sample values realistas pra cada variável
- [ ] URL com domínio próprio HTTPS
- [ ] Nome interno seguindo convenção
- [ ] Conteúdo passou no checklist 15 pontos
- [ ] Análise de risco rodada (BAIXO/MÉDIO/ALTO)

Tudo OK? Submete.
