Códigos de erro da API do WhatsApp e o que fazer em cada um
Quando uma campanha falha, o código de erro diz exatamente o que aconteceu. Traduzi os mais frequentes para a ação prática que resolve cada um.
6 min de leitura · atualizado em
Erros de destinatário
Falhas ligadas ao número do contato, não à sua conta.
- Número não existe no WhatsApp: limpe a base e valide o formato com DDI e DDD.
- Contato bloqueou a empresa: remova da lista de campanhas para não queimar reputação.
- Número em formato inválido: exige DDI 55, DDD e nono dígito em celulares.
Erros de janela e template
Falhas ligadas à regra de conteúdo da Meta.
- Fora da janela de 24 horas: use um template aprovado em vez de texto livre.
- Template pausado por qualidade: a Meta suspendeu o modelo; reescreva e reenvie.
- Variável faltando: o número de parâmetros precisa bater exatamente com o template.
Erros de conta e limite
Falhas ligadas à sua WABA.
- Limite de faixa atingido: aguarde a virada da janela de 24 horas ou distribua entre números.
- Rate limit: reduza o ritmo; a plataforma já faz isso automaticamente nas campanhas.
- Token inválido: reconecte o número pelo login oficial da Meta.