Ingresar
DocumentaciónGuíasReferenciaWebhooksRecursos
Etapas de tableros

Listar los contactos de una etapa

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.

GET
/kanban-settings/{kanbanSetting}/stages/{stage}/contacts

Permiso requerido: conversations:read

Autorización

http
headerAuthorizationBearer <clave>

Parámetros de la ruta

kanbanSetting*integer
stage*integer

Parámetros de consulta

name?string
search?string
messages?string
Valor en"all""read""unread"
dateFrom?string
Formatodate-time
dateTo?string
Formatodate-time
dateBasis?string
Valor en"board_entry""created""last_activity"
adviserId?string
valueMin?number
valueMax?number
stagnant?boolean
tagIds[]?array<integer>
leadScoreCategories[]?array<>
Valor en"insufficient_data""hot""warm""cold"
leadScoreMin?integer
Rango0 <= value <= 100
leadScoreMax?integer
Rango0 <= value <= 100
leadScoreDisqualified?|
Valor en"include""exclude""only"null
page?integer
Rango1 <= value
perPage?integer
Rango1 <= value <= 100
Por defecto25
orderBy?string
Valor en"name""last_message_time""stage_since"
orderByMethod?string
Valor en"asc""desc"

Cuerpo de la respuesta

OK

application/json
  1. response
data*array<string>
links*
meta*
curl -X GET "https://example.com/kanban-settings/0/stages/0/contacts"
{  "data": [    "string"  ],  "links": {    "first": "string",    "last": "string",    "prev": "string",    "next": "string"  },  "meta": {    "current_page": 0,    "from": 0,    "last_page": 0,    "links": [      {        "url": "string",        "label": "string",        "active": true      }    ],    "path": "string",    "per_page": 0,    "to": 0,    "total": 0  }}

Actualizar una etapa PUT

Usalo para renombrar una etapa de un tablero.

Configuración del lead score

Define cómo se calcula el lead score de la cuenta: los umbrales de caliente y tibio (hot_threshold, warm_threshold), las señales mínimas (min_signals), la histéresis, el decaimiento de puntos con los días (decay_steps) y las reglas.