Limites de taxa

Os limites protegem a plataforma e a reputação do seu envio. Seus limites dependem do seu plano e aparecem no painel.

Por que existem limites

Os provedores de caixa de entrada julgam um remetente pelo histórico. Um salto repentino de volume parece abuso, então os limites e o aumento gradual protegem a reputação do seu domínio e do seu IP, além da plataforma. Limites maiores estão disponíveis sob solicitação.

Descubra seus limites

Os limites da conta dependem do seu plano e do quanto seu envio está consolidado. Consulte os valores atuais no painel ou fale com o suporte se precisar de mais folga para um lançamento ou um pico sazonal.

Como ler os cabeçalhos

As respostas podem informar sua cota restante. Ao receber um 429, aguarde o período indicado em Retry-After antes de tentar novamente.

X-RateLimit-Limit: <requests allowed>
X-RateLimit-Remaining: <requests left>
Retry-After: <seconds to wait>

Repetir com backoff

Espere mais a cada falha e adicione um pouco de aleatoriedade, para que muitos clientes não repitam no mesmo instante. Limite o número de tentativas.

async function send(payload, tries = 5) {
  for (let i = 0; i < tries; i++) {
    const res = await post(payload);
    if (res.status !== 429 && res.status < 500) return res;
    const wait = Number(res.headers.get("retry-after")) * 1000 || 2 ** i * 500;
    await new Promise((r) => setTimeout(r, wait + Math.random() * 250));
  }
  throw new Error("gave up after retries");
}

Planeje os picos

Se você espera um envio grande, como uma promoção ou o início de um período letivo, avise-nos com antecedência, distribua o envio ao longo do tempo e aqueça aos poucos qualquer domínio ou IP dedicado novo. Picos repentinos são a causa mais comum de limitação pelos provedores de caixa de entrada.