Funnelchat APIEtapas de tableros
Las etapas son los pasos de un tablero (name, position, contacts_count), y en cada tablero un contacto tiene una etapa actual (current_stage_id).
Las etapas son los pasos de un tablero (name, position, contacts_count), y en cada tablero un contacto tiene una etapa actual (current_stage_id). Acá creás, reordenás y eliminás etapas, y movés o sacás contactos, de a uno o en bloque. Para reflejar el avance de un lead cuando algo pasa en tu sistema, usá Mover un contacto de etapa.
Endpoints
Ver las etapas de un contacto en los tableros
GET /api/v1/contacts/{contact}/kanban-stages · Sirve para saber en qué etapa está un contacto en cada tablero, útil para reflejar su avance en el embudo dentro de tu CRM.
Mover un contacto de etapa
POST /api/v1/kanban-settings/{kanbanSetting}/move-contact · Usalo para mover un contacto a otra etapa del tablero cuando algo pasa en tu sistema, por ejemplo al recibir un pago o agendar una demo.
Mover contactos de etapa en bloque
POST /api/v1/kanban-settings/{kanbanSetting}/bulk-move · Sirve para mover muchos contactos a una misma etapa de una sola vez, por ejemplo al cerrar una campaña o importar resultados.
Sacar un contacto del tablero
POST /api/v1/kanban-settings/{kanbanSetting}/remove-contact · Usalo para sacar a un contacto de un tablero cuando deja de estar en ese proceso, por ejemplo si se perdió o se descartó.
Sacar contactos del tablero en bloque
POST /api/v1/kanban-settings/{kanbanSetting}/bulk-remove · Sirve para sacar varios contactos de un tablero en una sola llamada.
Crear una etapa
POST /api/v1/kanban-settings/{kanbanSetting}/stages · Usalo para agregar una etapa nueva a un tablero, ubicándola después de una etapa existente.
Reordenar las etapas
POST /api/v1/kanban-settings/{kanbanSetting}/stages/reorder · Sirve para cambiar el orden de las etapas de un tablero enviando la lista de IDs en el orden que querés.
Eliminar una etapa
DELETE /api/v1/kanban-settings/{kanbanSetting}/stages/{stage} · Sirve para eliminar una etapa de un tablero; con reassign_to_stage_id podés pasar sus contactos a otra etapa.
Actualizar una etapa
PUT /api/v1/kanban-settings/{kanbanSetting}/stages/{stage} · Usalo para renombrar una etapa de un tablero.
Listar los contactos de una etapa
GET /api/v1/kanban-settings/{kanbanSetting}/stages/{stage}/contacts · Usalo para traer los contactos de una etapa con filtros (asesor, valor, estancados, etiquetas, lead score, fechas), por ejemplo para armar seguimientos o reportes del embudo.
Ver los miembros de un tablero GET
Usalo para chequear en una sola llamada cuáles de un conjunto de contactos están en un tablero, por ejemplo antes de moverlos o agregarlos.
Ver las etapas de un contacto en los tableros GET
Sirve para saber en qué etapa está un contacto en cada tablero, útil para reflejar su avance en el embudo dentro de tu CRM.