Erros comuns da API Oficial
Por Equipe BotConversa · Atualizado em 17 de setembro de 2026
Recebo mensagens mas não consigo responder
Se aparece "O WhatsApp deve estar aprovado para contatar assinantes", o caminho é atualizar os dados da conexão:
- Vá em Configurações → WhatsApp, na tela de status da conexão.
- Clique em Atualizar dados, no canto superior direito.
Isso força o BotConversa a reler o estado da conta na Meta, e costuma resolver na hora.
Quais são os erros mais comuns?
| Erro | Por que acontece | O que fazer |
|---|---|---|
| Error 400 — Template not approved | O modelo de mensagem não foi aprovado, ou foi rejeitado pela Meta | Revise o texto e reenvie o modelo para aprovação |
| User's number is part of an experiment | A Meta está fazendo teste A/B naquele número | Aguardar. É temporário e do lado da Meta |
| This message was not delivered to maintain healthy ecosystem engagement | Bloqueio antispam da Meta | Aguardar. É limitação temporária — e um sinal para revisar a frequência dos seus envios |
| Telefone não qualificado | O número não atende aos requisitos da Meta | Converter o número para WhatsApp Business |
| A conexão é recusada e o número vem de outra plataforma | O vínculo da coexistência com o provedor anterior continua registrado na Meta | Desvincular o número pelo aplicativo do celular: Trazendo um número de outra ferramenta |
Repare que dois dos quatro se resolvem esperando. Isso não é evasiva: quando a Meta aplica uma limitação temporária, não existe configuração do lado do BotConversa que a remova.
Não consigo conectar a linha de crédito
Esse erro tem duas causas conhecidas:
- O fuso horário da WABA está incorreto ou inconsistente.
- O compartilhamento da linha de crédito falhou — normalmente por incompatibilidade de moeda entre a linha de crédito e a WABA.
Se for a moeda, o procedimento completo está em Erro de moeda na conexão com a Meta.
Nos demais casos, e por limitações do lado da Meta, a solução recomendada é refazer a conta:
- Crie uma nova conta do WhatsApp Business. O passo a passo está em Criando uma conta do WhatsApp Business.
- Se precisar, vincule um método de pagamento à nova conta — veja Método de pagamento da conta WABA.
- Remova a conta antiga do BotConversa em Configurações → WhatsApp, na seção de conexões.
- Conecte a conta nova seguindo Conectando o WhatsApp por coexistência.
Por que meu envio foi cobrado?
Na API Oficial, mensagem enviada fora da janela de 24 horas é cobrada por envio, em dólar, com valor variando pela cotação:
| Tipo | Custo aproximado por envio |
|---|---|
| Utilidade | ~R$ 0,05 |
| Marketing | ~R$ 0,50 |
- Dentro da janela de 24 horas não há custo adicional por mensagem.
- Não existe envio gratuito fora da janela na API Oficial.
- Em coexistência, a mensagem enviada diretamente pelo aplicativo do celular não gera cobrança de modelo — a cobrança vale para o envio via API, ou seja, pelo BotConversa.
Como a diferença entre Utilidade e Marketing é de dez vezes, vale conferir em que categoria seus modelos foram classificados — e contestar quando a Meta recategoriza. Veja Solicitando análise de categoria na Meta.