Limites de taxa da Graph API do Facebook: erros 4, 17, 32, 613 e 80001
A Graph API do Facebook dá a um token de Page ou de usuário do sistema 4,800 chamadas à API de Pages por usuário engajado em 24 horas corridas. Acima de um limite, ela retorna 4, Application request limit reached; 17, User request limit reached; 32, Page request limit reached; 613, Calls to this api have exceeded the rate limit; ou 80001, There have been too many calls to this Page account. Pare de chamar e retome aos poucos.
A easyCoexistence chama cada Page conectada com o próprio token da Page e recebe sua atividade do feed, menções e mensagens pelos webhooks da Meta, encaminhando-os ao seu endpoint se quiser, então ninguém precisa consultar a Page.
O código quando o app cujo token é usado na requisição atingiu seu limite de taxa.
O código quando o usuário cujo token é usado na requisição atingiu seu limite de taxa.
O código quando o usuário ou app cujo token é usado em uma requisição à API de Pages atingiu seu limite de taxa.
O código para um limite de taxa personalizado; com o subcódigo 1996, a Meta notou comportamento inconsistente no volume de requisições do app.
O código de Business Use Case para chamadas a Pages feitas com token de acesso de Page ou de usuário do sistema.
Chamadas à API de Pages permitidas em 24 horas corridas com token de Page ou de usuário do sistema.
O que significa cada código de limite de taxa?
Cada código indica qual limite foi atingido, e o token na requisição decide qual se aplica. O guia de limitação de taxa da Meta explica o que cada código indica, e suas referências de erro trazem a mensagem que o acompanha. Veja-os lado a lado, com a mensagem como a Meta a escreve:
| Meta's message | What reached its limit | |
|---|---|---|
| 4 | Application request limit reached | The app whose token made the request |
| 17 | User request limit reached | The user whose token made the request |
| 32 | (#32) Page request limit reached | The user or app token used in a Pages API request |
| 613 | (#613) Calls to this api have exceeded the rate limit. | A custom limit set by the API being called |
| 80001 | (#80001) There have been too many calls to this Page account. Wait a bit and try again. | Calls made on that Page with a Page or system user token |
Qual limite se aplica a uma Page?
Depende do token. A Meta diz que os limites de Page podem usar a lógica da Platform ou a do Business Use Case, conforme o tipo de token usado. Chamadas à API de Pages feitas com token de Page ou de usuário do sistema seguem o limite de Business Use Case para Pages, enquanto chamadas feitas com token de usuário ou de app estão sujeitas aos limites de Platform do usuário ou do app. Quando as duas lógicas podem valer para uma requisição, a Meta aplica o limite de Business Use Case.
Quão grandes são os limites?
A Meta publica fórmulas em vez de números fixos, então cada cota cresce com o uso:
- Apps: 200 chamadas por hora para cada usuário ativo diário, contadas somando todas as chamadas do app, e não por usuário.
- Pages, com token de Page ou de usuário do sistema: 4,800 chamadas por 24 horas corridas para cada usuário que interagiu com a Page em 24 horas.
- Send API do Messenger: 300 chamadas por segundo por Page para texto, links, reações e stickers, e 10 para áudio ou vídeo.
- As chamadas do Messenger também têm um tipo de Business Use Case próprio, reportado como erro 80006.
Como ver um limite se aproximando?
Leia os cabeçalhos de uso. Endpoints que recebem requisições suficientes de um app incluem X-App-Usage, cujos call_count, total_cputime e total_time são porcentagens dos limites de Platform do app. Respostas limitadas pela lógica de Business Use Case incluem X-Business-Use-Case-Usage no lugar, com as mesmas porcentagens para cada objeto de negócio, o tipo de limite, como pages, e estimated_time_to_regain_access.
X-App-Usage: {"call_count": 28, "total_time": 25, "total_cputime": 25}
X-Business-Use-Case-Usage: {
"{business-object-id}": [
{
"type": "pages",
"call_count": 100,
"total_cputime": 34,
"total_time": 41,
"estimated_time_to_regain_access": 12
}
]
}Quanto tempo você espera?
Até o uso cair, o que os cabeçalhos mostram. Para um limite de Business Use Case como 80001, estimated_time_to_regain_access informa os minutos até que as chamadas deixem de ser limitadas. Para limites de Platform, o call_count do app cobre um período corrido de uma hora, então ele cai conforme as chamadas mais antigas expiram. A orientação da Meta é a mesma para os dois: pare de fazer chamadas assim que um limite for atingido, porque continuar chamando faz aumentar a contagem de chamadas e o tempo até que as chamadas voltem a funcionar.
Como ficar abaixo dos limites?
Faça menos chamadas, mais leves, e espalhe-as no tempo. As melhores práticas da Meta são distribuir as consultas de forma uniforme para evitar picos de tráfego, usar filtros para limitar o tamanho das respostas e evitar chamadas que pedem dados sobrepostos e, quando usuários estão sendo limitados, garantir que o app não seja a causa. Webhooks também ajudam: a Meta entrega a atividade do feed e as mensagens de uma Page conforme acontecem, então um app não precisa gastar chamadas para procurá-las.
Erros comuns
- Repetir de imediato. A Meta alerta que continuar fazendo chamadas aumenta a contagem de chamadas e o tempo até que elas voltem a funcionar.
- Tratar todos os códigos da mesma forma. 4 é o limite do app, 17 é o de um usuário e 80001 é o de uma Page, então desacelerar o chamador errado não muda nada.
- Ler X-App-Usage em chamadas feitas com token de Page. Elas contam para o limite de Business Use Case e são reportadas em X-Business-Use-Case-Usage.
- Consultar com frequência uma Page pouco ativa. Sua cota cresce com os usuários que interagiram com ela, então uma Page com pouco engajamento tem menos chamadas para gastar.
Quando a Meta limita uma chamada, a ferramenta devolve o código e a mensagem da Meta ao Claude, ao ChatGPT ou ao seu próprio código, para que sua IA possa esperar antes de repetir, e um post que a Meta limita é repetido automaticamente após 5 minutos, 30 minutos e 2 horas. De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
O que significa Application request limit reached?
É o erro 4: o app cujo token fez a chamada atingiu seu limite de taxa. Pare de fazer chamadas e retome aos poucos conforme o uso dele cair.
Qual a diferença entre o erro 32 e o erro 80001?
O token. O erro 32 é o limite de Platform de um token de usuário ou de app chamando a API de Pages; o 80001 é o limite por Page para chamadas feitas com token de Page ou de usuário do sistema.
Quanto tempo dura um limite de taxa do Facebook?
A Meta não define um tempo fixo. Para o 80001, o cabeçalho X-Business-Use-Case-Usage informa os minutos até que as chamadas deixem de ser limitadas; o uso de um app é medido em uma hora corrida.
O que significa o erro 613?
Um limite de taxa personalizado, definido pela API chamada. Com o subcódigo 1996, a Meta notou comportamento inconsistente no volume de requisições do app, por exemplo após uma recente mudança na quantidade de requisições que ele envia.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em