Limites & Cotas

Limites de Taxa por Endpoint

SMS

Caracteres Especiais

O uso de caracteres especiais (emojis, acentos em GSM-7) pode reduzir o limite de caracteres para 70 por segmento.

WhatsApp Business

Limites por Tier (Qualidade do Número)

RCS (Rich Communication Services)

Sistema de Créditos

A API Nexus utiliza um sistema de créditos para contabilizar o uso dos serviços:

Recomendações para Respeitar os Limites

1. Implementar Retry com Backoff Exponencial

async function sendWithRetry(data, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await sendMessage(data);
    } catch (error) {
      if (error.status === 429) {
        const waitTime = Math.pow(2, i) * 1000; // Backoff exponencial
        await sleep(waitTime);
      } else {
        throw error;
      }
    }
  }
  throw new Error('Max retries exceeded');
}

2. Implementar Queue para Envios em Massa

Para grandes volumes, utilize um sistema de filas que respeite os rate limits automaticamente.

3. Monitorar Headers de Rate Limit

Sempre verifique os headers X-RateLimit-* para ajustar o ritmo de suas requisições dinamicamente.

4. Usar Batch Endpoints Quando Disponível

Para envio de múltiplas mensagens, prefira endpoints de batch que permitem enviar vários destinatários em uma única requisição.

5. Cache de Dados Estáticos

Evite consultar repetidamente informações que não mudam frequentemente (como listas de templates aprovados).

Se seus limites atuais não atendem suas necessidades, você pode solicitar um aumento:

1. Acesse o Painel de Controle da sua conta
2. Navegue até Configurações → Limites & Cotas
3. Clique em "Solicitar Aumento"
4. Preencha o formulário com:
   • Volume estimado de mensagens/mês
   • Tipo de uso (transacional, marketing, etc.)
   • Justificativa técnica