Apartado 8 de 12 · Referencia

Límites y errores

600 peticiones y 60 envíos por minuto, y qué significa cada 401, 403, 404, 422 y 429 de la API de Chatendo, con lo que hay que hacer en cada caso.

Revisado el 22 de septiembre de 2026 API 1.11.9 1 min de lectura

600 peticiones por minuto por usuario del token.
60 envíos por minuto para los mensajes salientes.
Al pasarse: 429 con Retry-After, X-RateLimit-Limit y X-RateLimit-Remaining. Respeta Retry-After; reintentar antes solo alarga el castigo.

Los errores vienen siempre con la misma forma:

JSON

{"message": "Insufficient token scope.", "code": "TOKEN_SCOPE_DENIED", "required": ["conversations:read"]}

No te dejan pasar — es cosa del token o del id:

Código	Qué pasó	Qué hacer
`401 UNAUTHENTICATED`	Falta el token, está mal escrito o fue revocado	Revisar la cabecera; si sigue, crear otro
`401 TOKEN_EXPIRED`	El token tenía fecha de caducidad y ya pasó	Crear otro en el panel y cambiarlo en la integración
`403 TOKEN_SCOPE_DENIED`	Al token le falta el permiso de esa ruta, o la ruta es solo del panel	Crear un token con el permiso que dice `required`; si `required` viene vacío, no tiene vuelta por API
`403 FORBIDDEN`	El usuario dueño del token no tiene el rol necesario	Usar un usuario `owner` o `admin`
`403 REQUIRES_SESSION_AUTH`	Eso solo se hace desde el panel	No tiene vuelta por API
`404`	No existe o es de otro inquilino	Comprobar que el id es de tu cuenta

Te dejan pasar pero el dato o el momento no valen:

Código	Qué pasó	Qué hacer
`422 VALIDATION_ERROR`	Falta un campo o está mal	El cuerpo trae `errors` campo por campo
`422 WINDOW_EXPIRED`	Texto libre fuera de las 24 h	Mandar plantilla aprobada
`422 PHONE_INVALID` / `PHONE_TAKEN`	Teléfono inválido, o ya existe	Buscar y enlazar, no crear
`422 SSRF_BLOCKED`	La URL del webhook no es pública	Usar una dirección accesible desde fuera
`429`	Te pasaste del límite	Esperar lo que diga `Retry-After`