Use este guia quando uma mensagem de WhatsApp com template não envia, falha fora da janela de 24 horas ou volta com erro de variável, idioma ou status do template.

## O que conferir primeiro

- A conversa está dentro ou fora da janela de atendimento permitida?
- A mensagem é texto livre ou template oficial?
- O template está aprovado e ativo no provedor/canal?
- O nome técnico e o idioma batem exatamente com o template cadastrado?
- A quantidade de variáveis enviada é igual à quantidade de placeholders?
- Cada variável está no formato esperado: texto, moeda, data, mídia ou botão?
- O template foi pausado, rejeitado, desabilitado ou teve qualidade reduzida?

## Fluxo de decisão

1. Se a pessoa atendida falou com a empresa recentemente, teste uma resposta curta de texto livre.
2. Se texto livre falhar fora da janela, troque para template aprovado.
3. Se o template falhar, copie o nome técnico, idioma e categoria do template.
4. Compare cada placeholder com os valores enviados.
5. Remova mídia, botões e variáveis opcionais para testar uma versão mínima.
6. Se a versão mínima funcionar, adicione cada componente de volta até achar o ponto de falha.

## Erros mais comuns

| Erro | Causa provável | Correção |
|---|---|---|
| 131047 ou 63016 | Tentativa de enviar texto livre fora da janela. | Use template aprovado para iniciar ou retomar a conversa. |
| 132001 | Template não existe, não está aprovado, está em outro idioma ou não sincronizou. | Corrija nome técnico, idioma e status do template. |
| 132000 | Quantidade de parâmetros diferente do template. | Envie todos os placeholders exigidos, na ordem correta. |
| 132012 | Formato de parâmetro incompatível. | Ajuste data, moeda, mídia, botão ou estrutura do componente. |
| 132005 | Texto final ficou grande demais. | Reduza variáveis longas e conteúdo dinâmico. |
| 132007 | Caracteres ou formatação violam política. | Remova excesso de quebra de linha, símbolos ou conteúdo sensível. |
| 63040, 63041 ou 63042 | Template rejeitado, pausado ou desabilitado. | Use outro template ativo ou corrija e submeta novamente. |

## Boas práticas para evitar falhas

- Padronize nomes técnicos em minúsculas e sem espaços.
- Use idiomas exatamente como aprovados no canal.
- Evite variáveis muito longas em cabeçalho, corpo e botões.
- Não coloque link, preço, cupom ou promessa comercial em variável sem validar a política.
- Faça teste com contato interno antes de usar em campanha.
- Mantenha um template transacional de fallback para casos urgentes.

## Checklist Antes de pedir ajuda à Digi2B

- [ ] Nome técnico do template.
- [ ] Idioma do template.
- [ ] Print do status do template no provedor/canal.
- [ ] Link da conversa na IAra.
- [ ] Horário da tentativa.
- [ ] Print do erro ou código retornado.
- [ ] Valores enviados em cada variável.
- [ ] Confirmação se o envio era dentro ou fora da janela permitida.