POST
/api/mod/kommo/{espacio}/sync/processProcesa los envíos ahora
Hace ya una pasada por los envíos que tocan: contesta los chats pendientes, mueve tarjetas y entrega comprobantes. Los envíos salen solos; esto los adelanta.
- PERMISOescribe
- 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. |
| forzar | bool, query | no | true: no espera a que el cliente deje de escribir ni a los reintentos programados; lo procesa todo ya. Solo para pruebas. |
RESPUESTA 200
| CAMPO | TIPO | QUÉ ES |
|---|---|---|
| procesadas | integer | Envíos que tomó. |
| conversaciones | integer | De cuántos chats. |
| done | integer | Hechos. |
| failed | integer | Fallaron; se reintentan solos. |
| deferred | integer | Aplazados por un problema de conexión con Kommo (token, subdominio). |
| liberadas | integer | Devueltos a la cola para no adelantarse a uno anterior del mismo chat. |
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. |
| 403 | La clave es de solo lectura | Tu cuenta es de solo lectura en este espacio. |
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
- Dentro de un mismo chat, los envíos salen en orden: si uno falla, los siguientes de ese chat esperan.
- Contestar un chat puede tardar decenas de segundos. Si la llamada se corta, los envíos siguen su curso: mira su estado en envíos.
- Las respuestas del chat las escribe Ventas y gastan créditos como sus conversaciones; esta ruta, por sí sola, no.