Glossário · Erros da Meta
Erro 4 no WhatsApp Business API
Limite de chamadas do aplicativo
- Mensagem da Meta
- App has reached its API call rate limit
- Resposta HTTP
- 429
- Família
- Limites e throttling
O erro 4 é devolvido quando o aplicativo da Meta que faz as chamadas atinge o limite de requisições por período. A cota é do aplicativo, somando todas as contas que ele atende, o que explica erro em uma conta por causa do volume de outra.
Por que este erro acontece
- Um aplicativo atendendo muitas contas ao mesmo tempo.
- Rotina de sincronização em massa concentrada no mesmo horário.
- Nova tentativa agressiva depois de uma falha momentânea.
Como resolver
- Distribua as rotinas ao longo do dia em vez de concentrar.
- Adote espera crescente entre as tentativas.
- Acompanhe o cabeçalho de uso que a Graph API devolve para saber quanto da cota já foi consumido.
O que não adianta tentar
Insistir no mesmo ritmo. A cota é por janela de tempo e reinicia sozinha.
O que a Skynet.Talk mostra na tela
A Meta devolve o código cru em inglês. A plataforma traduz para uma frase que diz a causa e a ação: "O aplicativo atingiu o limite de chamadas da API da Meta. Aguarde alguns minutos e reduza a frequência das requisições." Código desconhecido cai no texto original com o número na frente, porque traduzir nunca pode engolir a informação.
Erros relacionados
Erro 80007 — Limite de chamadas da conta
A conta estourou o limite de chamadas à API no período.
Erro 130429 — Capacidade de envio atingida
A conta bateu no teto de mensagens por segundo da Cloud API.
Perguntas frequentes
O limite é por conta ou por aplicativo?
Este erro aparece no meio de um atendimento e some no log de quem integra direto com a Meta. Na Skynet.Talk ele vira uma frase em português na tela de quem atende. Veja o catálogo completo dos códigos ou entenda como a Meta cobra por mensagem.
Publicado por Skynet.Talk · catálogo revisado em 18 de agosto de 2026 · código conferido na documentação oficial da Meta.