GET
/api/mod/kommo/{espacio}/outbox/Los envíos a Kommo
Los envíos uno a uno, el más reciente primero. Con estado=dead, los que fallaron y se descartaron.
- PERMISOlee (vale cualquier clave)
- CRÉDITOSno gasta
- AUTENTICACIÓNBearer bth_…
PARÁMETROS
| CAMPO | TIPO | REQUERIDO | QUÉ ES |
|---|---|---|---|
| espacio | string | SÍ | El id del espacio (sale en GET /api/companies). Tiene que tener el módulo Kommo. |
| estado | string, query | no | pending, processing, failed, dead o done. Sin él, todos. |
| limit | int, query | no | Cuántos. Por defecto 200. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| entries | array | El más reciente primero. Cada uno, con los campos de un envío. |
UN ENVÍO
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| id | string | 32 caracteres hexadecimales: para reintentarlo. |
| tipo | string | turno (contestar un mensaje del chat), enviar_mensaje, mover_etapa, crear_lead o adjunto (un comprobante). |
| estado | string | Ver estados. |
| intentos | integer | Las veces que se intentó. |
| max_intentos | integer | El tope: 5. |
| motivo_error | string | null | Por qué falló la última vez. null si no falló. |
| next_attempt_at | number | null | Cuándo se vuelve a intentar, en segundos desde 1970. null si no queda nada. |
| payload_json · resultado_json | string | null | Lo que se envía y lo que salió, como texto JSON. Llevan mensajes de tus clientes; su forma interna puede cambiar. |
| created_at · updated_at | number | Segundos desde 1970, con decimales. |
ESTADOS DE UN ENVÍO
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| pending | en cola | Esperando su turno. |
| processing | en proceso | Se está enviando ahora. |
| done | sincronizado | Hecho. |
| failed | con reintento | Falló, pero se volverá a intentar solo (next_attempt_at). |
| dead | descartado | Agotó sus 5 intentos. Mira motivo_error y reinténtalo cuando lo arregles. |
ERRORES DE ESTA RUTA · SIEMPRE {"detail": …}
| STATUS | CUÁNDO | DETAIL LITERAL |
|---|---|---|
| 403 | El espacio no tiene el módulo Kommo | módulo no habilitado para este espacio. |
| 422 | limit no es un número | — |
Y los de cualquier ruta —clave inválida, cuenta no al día, IP, límites—, en Errores, límites y créditos.
CONVIENE SABER
- La ruta acaba en barra:
…/outbox/. Sin ella no llega. - Cada envío trae más campos de uso interno: no te apoyes en ellos.