La API tiene dos tipos de límites:
  • Topes por minuto: frenan ráfagas, por ejemplo un script en un bucle. Se liberan solos en un minuto.
  • Cupos mensuales: cuánto puedes usar en el mes. Se renuevan el día 1 de cada mes, a las 00:00 de Argentina.
Los dos se cuentan por cuenta: todas tus claves de API suman juntas.

Por plan

La API y los webhooks están en los planes Escala y Enterprise. Mira Planes y facturación.

Topes por minuto

El tope de mensajes es además del general: un POST /messages cuenta para los dos.

Cupos mensuales y máximos

  • Llamadas a la API: cada solicitud a https://app.eltick.com/api/v1 con una clave válida, salga bien o mal. Las que se rechazan por el tope por minuto no cuentan. Las llamadas al webhook entrante de una automatización también cuentan y comparten el tope por minuto.
  • Entregas de webhooks: cada evento que te mandamos a cada URL. Si un evento va a dos URLs, cuenta dos. Los reintentos de una misma entrega no suman.
  • Las claves revocadas no cuentan. Si llegas al máximo de claves o de URLs, crear una nueva responde 402: revoca o borra las que no uses.
Cuánto usaste de cada cupo lo ves en Ajustes › Plan y uso. El contador puede ir hasta medio minuto atrasado.

Automatizaciones y MCP

Las automatizaciones y la conexión con Claude y ChatGPT tienen sus propios límites: El detalle de las automatizaciones está en Automatizaciones › Planes y límites.

Qué pasa al llegar al límite

La API responde 429 Too Many Requests. Hay tres casos:
Con POST /messages, si lo que se pasó es el tope de mensajes:
  • Retry-After: cuántos segundos esperar antes de volver a intentar.
  • X-RateLimit-Limit: el tope por minuto que se aplicó.
Qué hacer: espera y reintenta. No se pierde nada: la solicitud rechazada no hizo nada.

Webhooks

Cuando se usan todas las entregas de webhooks del mes, los eventos siguientes no se encolan y no se mandan, ni siquiera después, cuando se renueva el cupo. Si dependes de los webhooks, revisa el uso en Ajustes › Plan y uso y cambia de plan antes de llegar al límite. Un evento cuyo data pesa más de 256 KB llega recortado, con esta forma:
Si te pasa, consulta lo que necesites con la API.

MCP

Si una app de IA conectada se pasa de su tope por minuto, el servidor MCP responde 429 con un error JSON-RPC (code: -32000) y el mismo Retry-After: 60.

Buenas prácticas

Ante un 429 por tope por minuto (o un 500), espera lo que diga Retry-After y, si vuelve a pasar, cada vez un poco más.
No reintentes a ciegas un POST /messages que falló por timeout o error de red: el mensaje pudo haber salido. Mira Reintentos seguros.
Si tienes que mandar muchos mensajes por la API, no los mandes todos juntos: mantente debajo del tope (por ejemplo, 1 por segundo en Escala). Para envíos masivos a una lista, usa una campaña: va en tandas que cuidan la calidad de tu número y no cuenta en los límites de la API.
  • Usa limit=200 al paginar: son menos llamadas que con páginas chicas.
  • Guarda en tu sistema lo que casi no cambia, como las plantillas (GET /templates) o los datos de la cuenta (GET /me).
  • No uses la API para preguntar cada tanto si algo cambió: suscríbete a los webhooks.
Los topes son por cuenta, no por clave. Si varios sistemas usan la API de la misma cuenta, reparte el tope entre ellos, o manda todo por una cola en común.
Los topes por minuto son aproximados: se cuentan por región y en ventanas de un minuto. No calcules al límite exacto; deja margen.