Conversaciones

Tool	Endpoint REST	Anotaciones
`list_conversations`	`GET /v1/conversations`	lectura, idempotente
`get_conversation`	`GET /v1/conversations/{id}`	lectura, idempotente
`update_conversation`	`PATCH /v1/conversations/{id}`	escritura, no destructiva

`list_conversations`

Lista conversaciones del workspace agrupadas, con paginación y filtros por canal, etiquetas y rango de fechas.

Campo	Tipo	Default	Descripción
`limit`	`1-200`	`50`	Conversaciones por workspace.
`offset`	`≥ 0`	`0`	Para paginación.
`channelId`	`string`	—	Filtra por canal específico.
`sortBy`	`"lastUpdate" \\| "creationDate"`	`lastUpdate`
`sortDirection`	`"asc" \\| "desc"`	`desc`
`tags`	`string[]` (máx 10)	—	Filtra por etiquetas.
`dateFilter`	objeto	—	`{ type: "specific"\\|"range", date \\| startDate \\| endDate }`.

`get_conversation`

Obtiene una conversación por ID o por número de teléfono del cliente, incluyendo todo el historial de mensajes. Busca en todos los workspaces de la API Key.

Campo	Tipo	Requerido	Descripción
`conversationId`	`string`	sí	ID o teléfono del cliente.
`channelId`	`string`	no	Restringe a un canal específico.

`update_conversation`

Actualiza dueños (owners) y/o estado (status) de una conversación. Debe enviarse al menos uno.

Campo	Tipo	Requerido	Descripción
`conversationId`	`string`	sí	ID o teléfono.
`workspace`	`string`	si multi-ws	ID del workspace.
`channelId`	`string`	no	Limita a un canal.
`owners`	`string[]` (emails)	uno de	Nueva lista de dueños.
`status`	`"active" \\| "finished" \\| "expired" \\| "spam"`	uno de	Nuevo estado.

Ejemplo

{
  "name": "update_conversation",
  "arguments": {
    "conversationId": "+521234567890",
    "status": "finished",
    "owners": ["ana@miempresa.com"]
  }
}

Anterior Mensajes Siguiente Clientes