Gerenciando Erros de API Oficial
Quando falamos em integração de sistemas e automatização de processos, o uso de APIs oficiais é essencial para garantir uma operação estável, segura e eficiente. Ainda assim, como qualquer tecnologia, podem ocorrer situações pontuais que impactam o envio de mensagens e a continuidade dos fluxos automatizados.
Este artigo foi desenvolvido como um guia prático para ajudar na identificação dos cenários mais recorrentes relacionados ao envio pela API oficial, explicando seus possíveis motivos e apresentando um caminho claro para análise e ajustes, garantindo maior previsibilidade e performance nas operações.
Identificando o erro
Para verificar o erro, basta passar o mouse no ícone de ❕ cinza, que irá ser exibido a mensagem de erro ao lado do ícone.
Principais Erros
Spam rate limit
O número de conversas diárias permitidas pela Meta foi excedido.
👉SOLUÇÃO: Acese o Gerenciador do WhatsApp para verificar os limites da conta.
The user number is part of an experiment
A Meta seleciona aleatoriamente 1% dos usuários para testes internos.
👉SOLUÇÃO: Para esses leads, não é possível enviar mensagens de marketing. Sugerido enviar mensagens através de dispositivo não-oficial ou enviar templates de utilidades
Business payment issue
Problema com o método de pagamento da conta.
👉SOLUÇÃO: Verifique se há um método de pagamento cadastrado e se os pagamentos estão em dia no Gerenciador da Meta.
Business account blocked
A conta de WhatsApp Business foi bloqueada.
👉SOLUÇÃO: Acesse o Gerenciador do WhatsApp, vá até a seção de Números de telefone, identifique o motivo do bloqueio e solicite revisão à Meta
Re-engagement message
A tentativa de mensagem ocorreu fora da janela de 24h desde o último contato do lead.
👉SOLUÇÃO: Envie um template de mensagem, aguarde a resposta do lead para reabrir a janela de conversa.
Message undeliverable
A Meta optou por não entregar a mensagem.
👉SOLUÇÃO: Nesses casos, a decisão de não entrega parte da própria Meta e foge do controle da plataforma. As causas mais comuns incluem:
O lead bloqueou o número ou a conta da empresa no WhatsApp;
O aplicativo do WhatsApp do lead está desatualizado;
Instabilidades momentâneas nos servidores da Meta.
Ao identificar corretamente cada cenário, analisar suas causas e aplicar os ajustes necessários, é possível reduzir falhas, evitar interrupções nos fluxos e garantir uma comunicação mais previsível com os clientes. Utilize este guia como apoio contínuo no monitoramento das integrações e, sempre que necessário, revise configurações e boas práticas para assegurar a melhor performance das suas operações automatizadas.