Funnelchat APIFlujos
Un flujo es una automatización: un disparador (trigger_type, trigger_values, trigger_device_ids) inicia una cadena de nodos (nodes) que se ejecuta para un contacto.
Un flujo es una automatización: un disparador (trigger_type, trigger_values, trigger_device_ids) inicia una cadena de nodos (nodes) que se ejecuta para un contacto. Cada ejecución queda en curso, completada, invalidada o cancelada, y la podés cancelar. Los flujos se ordenan en Carpetas de flujos. Para diagnosticar por qué un contacto recibió o no una automatización, usá Listar los flujos en curso de un contacto.
Endpoints
Listar los flujos en curso de un contacto
GET /api/v1/contact-flows/{contactId} · Sirve para ver el historial de ejecuciones de flujos de un contacto, filtrable por estado (en curso, completado, invalidado, cancelado) y fechas. Útil para diagnosticar por qué recibió o no una automatización.
Cancelar un flujo en curso
PUT /api/v1/contact-flows/{contactFlowId}/cancel · Usalo para frenar un flujo que está corriendo para un contacto, por ejemplo cuando tu sistema detecta que ya compró o pidió no recibir más mensajes.
Listar flujos
GET /api/v1/flows · Sirve para listar tus flujos de automatización con filtros por carpeta, disparador, estado, número o fecha, por ejemplo para mostrarlos en tu producto o auditarlos.
Ver un flujo
GET /api/v1/flows/{flow} · Usalo para ver la configuración de un flujo: si está activo y es válido, cuántas veces se ejecutó y qué lo dispara (tipo, valores y números).
Listar los nodos de un flujo
GET /api/v1/flows/{flow}/nodes · Sirve para leer los nodos de un flujo y cómo se encadenan, por ejemplo para documentar o visualizar la automatización fuera de Funnelchat.
Contar los contactos activos de un flujo
GET /api/v1/flows/{flow}/active-contacts · Usalo para saber cuántos contactos están ahora dentro de un flujo, por ejemplo antes de editarlo o desactivarlo.
Listar los contactos activos de un flujo
GET /api/v1/flows/{flow}/active-contacts-list · Sirve para saber quiénes están ahora dentro de un flujo, con búsqueda, por ejemplo para revisar casos o cancelar ejecuciones puntuales.
Listar los contactos de un flujo
GET /api/v1/flows/{flow}/flow-contacts · Usalo para ver todos los contactos que pasaron por un flujo, filtrando por estado (en curso, completado, invalidado, cancelado) y fechas. Ideal para medir su resultado.
Responder la encuesta de desconexión POST
Usalo para registrar por qué se desconectó un número, respondiendo la encuesta de desconexión con uno de los motivos predefinidos.
Listar los flujos en curso de un contacto GET
Sirve para ver el historial de ejecuciones de flujos de un contacto, filtrable por estado (en curso, completado, invalidado, cancelado) y fechas. Útil para diagnosticar por qué recibió o no una automatización.