GET/api/mod/kommo/{espacio}/pipelines

Los embudos y etapas de Kommo

Los embudos de tu cuenta con sus etapas, tal como los da Kommo. De aquí salen los pipeline_id y status_id de mapeo_estados.

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.

RESPUESTA 200

CAMPO	TIPO	QUÉ ES
ok	boolean	true si Kommo respondió.
pipelines	array	Los embudos, con la forma de Kommo. Vacío si ok es false.
pipelines[].id · name	integer · string	El embudo.
pipelines[]._embedded.statuses	[{ id, name, … }]	Sus etapas: id es el status_id.
error	string	Sin ok: por qué.
status	integer	Sin ok, si Kommo llegó a contestar: su status.

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.

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

Sin conectar, responde 200 con ok: false y pipelines vacío.
Las etapas 142 (ganada) y 143 (perdida) existen en todos los embudos de Kommo. Si no mapeas ganado y cerrado, van ahí, en el embudo de tus otros estados.

{ "ok": true, "pipelines": [ { "id": 7012345, "name": "Ventas", "is_main": true, "_embedded": { "statuses": [ { "id": 58210001, "name": "Contacto inicial", "pipeline_id": 7012345, … }, { "id": 58210002, "name": "En conversación", "pipeline_id": 7012345, … }, { "id": 58210003, "name": "Atender en persona", "pipeline_id": 7012345, … }, { "id": 142, "name": "Venta ganada", "pipeline_id": 7012345, … }, { "id": 143, "name": "Venta perdida", "pipeline_id": 7012345, … } ] }, … } ] }