Skip to main content
Cada endpoint tem um limite próprio de requisições por minuto, contado por chave de API. Os limites são independentes entre endpoints: consumir o limite de envio não afeta o de leitura.

​
Limites por endpoint

Planeje a carga inicial. Com 30 criações de contato por minuto e uma requisição por contato, importar uma base grande pela API leva horas. Para carga inicial, use a importação de CSV no painel.

​
Cabeçalhos de limite

Toda resposta traz o estado do seu saldo: Use X-RateLimit-Remaining para desacelerar antes de bater no teto, em vez de esperar o 429.

​
Teto adicional de envio por número

Além do limite de 100 requisições por minuto do endpoint de envio, existe um segundo teto, aplicado por número de WhatsApp e derivado da capacidade que a Meta atribui à conta.
Esse teto se manifesta de forma diferente: quando ele é atingido, a resposta é 500 com código SEND_FAILED, e não 429. Não há Retry-After nesse caso.
Na prática: se o envio começar a falhar com SEND_FAILED sob volume alto, reduza a taxa de envio mesmo sem ter recebido 429.

​
Como reagir ao 429

1

Leia o Retry-After

A resposta diz quantos segundos esperar. Respeite esse valor em vez de tentar de novo imediatamente.
2

Espere e repita

Aguarde o intervalo indicado e refaça a requisição. Se ainda receber 429, aumente a espera progressivamente.
3

Distribua a carga

Se o 429 for constante, o problema é a taxa média, não o pico. Espalhe as chamadas ao longo do minuto.
Não use várias chaves para contornar o limite. Os tetos existem para proteger a entrega das suas próprias mensagens: exceder a capacidade que a Meta atribui ao seu número piora a qualidade da conta.