Erro 4 do WhatsApp: o app atingiu o limite de chamadas da API
O código de erro 4 significa que o app atingiu o limite de taxa de chamadas da API. A descrição da Meta é "The app has reached its API call rate limit." Ela contabiliza as chamadas feitas pelo app em uma hora móvel, não as mensagens enviadas por um número. Consulte o uso no App Dashboard, aguarde e reduza a frequência com que o app chama a API.
Código da Meta para "The app has reached its API call rate limit."
Chamadas que um app pode fazer em uma hora segundo os Graph API Platform Rate Limits.
Nome dado ao código 4 pelo guia de tratamento de erros da Graph API.
O que significa o código de erro 4 do WhatsApp?
Significa que seu app fez chamadas demais à API na janela atual, e novas chamadas são recusadas até que a contagem diminua.
A Meta lista o código 4 entre os erros de limitação de taxa, com o texto detalhado "The app has reached its API call rate limit." O guia de tratamento de erros da Graph API o chama de API Too Many Calls e o descreve como um problema temporário de limitação.
Ele aparece ao lado de outros dois códigos de limitação que podem ser confundidos com ele. O 80007 indica que a WhatsApp Business Account atingiu seu limite de taxa. O 130429 indica o throughput de mensagens da Cloud API. O código 4 não é nenhum dos dois: ele representa o orçamento de chamadas do próprio app.
Como o limite de chamadas do app é calculado?
Para requisições feitas com um app access token, o guia de limitação de taxa da Graph API da Meta apresenta uma fórmula: as chamadas em uma hora equivalem a 200 multiplicado pelo número de usuários.
O número de usuários se baseia nos usuários ativos diários únicos do app, usando os números semanais e mensais quando o uso diário cai. É um limite para o app como um todo, não por usuário, então alguns usuários muito ativos podem consumir a maior parte dele.
O guia também informa que o uso aparece no App Dashboard e, depois que chamadas suficientes forem feitas, no cabeçalho X-App-Usage das respostas. Esse cabeçalho permite ver o limite se aproximando antes que o erro 4 apareça.
O que fazer depois do erro 4?
Pare de chamar por algum tempo e depois chame com menos frequência.
O guia de limitação de taxa da Meta é direto quanto à primeira parte: quando o limite for atingido, pare de fazer chamadas à API, pois continuar aumenta a contagem e prolonga o tempo até que as chamadas funcionem novamente.
A segunda parte é uma questão de design. Distribua as requisições de forma uniforme em vez de fazê-las em rajadas, filtre as respostas para que uma chamada retorne o que você precisa e evite chamadas que busquem dados sobrepostos. O polling costuma ser o culpado. Uma integração que consulta o mesmo status da conta a cada poucos segundos gasta seu orçamento com respostas que já possui.
Erros comuns
- Repetir em um loop. Cada chamada extra aumenta a contagem e afasta a recuperação.
- Tratar isso como limite de envio. O código 4 contabiliza as chamadas do app, enquanto o throughput de mensagens é 130429.
- Consultar endpoints de status em intervalos curtos. Leituras repetidas de dados inalterados consomem o orçamento por hora.
A EasyCoexistence monitora cada número conectado 24 horas por dia, 7 dias por semana, do próprio lado. Assim, verificar a saúde da conexão não precisa ser implementado como um loop de polling que consome o orçamento de chamadas do seu app.
Perguntas frequentes
O erro 4 é igual ao erro 130429?
Não. O 130429 é o throughput de mensagens de um número. O erro 4 é o número de chamadas à API feitas pelo seu app.
Quanto tempo dura o erro 4?
Até que a contagem de chamadas na janela móvel de uma hora fique abaixo do limite. Fazer chamadas durante esse período prolonga a espera.
Onde posso ver quão perto meu app está do limite?
Na seção Application Rate Limit do App Dashboard e no cabeçalho X-App-Usage retornado nas respostas.
O erro 4 é igual ao erro 80007?
Não. A Meta usa o 80007 quando a WhatsApp Business Account atinge seu limite de taxa, enquanto o erro 4 contabiliza as chamadas do próprio app.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em