Eventos de conversaciones

Todo el ciclo de vida de una conversación: apertura, asignación, prioridad, etiquetas, SLA y cierre.

Todo el ciclo de vida de una conversación: apertura, asignación, prioridad, etiquetas, SLA y cierre. Son 15 eventos. Todos llegan con la envoltura estándar y su contenido propio en data.

conversation.created

Alguien abrió una conversación nueva por cualquier canal.

Disponible desde 2026-01-15. Volumen alto. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`workspace_id`	string	ID del workspace
`contact_id`	string	ID del contacto
`channel`	string	messenger \| email \| whatsapp \| instagram \| api
`subject`	string	Asunto, si el canal lo trae
`created_at`	string	Fecha ISO 8601

conversation.created

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.created",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "workspace_id": "ws_tinkay",    "contact_id": "ct_juan",    "channel": "messenger",    "subject": "Widget no carga en Shopify",    "created_at": "2026-09-02T14:03:11.000Z"  }}

conversation.assigned

La conversación pasó a una persona o a un equipo.

Disponible desde 2026-01-15. Volumen alto. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`assignee_id`	string	ID del agente o null
`team_id`	string	ID del equipo o null
`assigned_by`	string	ID de quien asignó, o 'automation'
`previous_assignee_id`	string \| null	Responsable anterior

conversation.assigned

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.assigned",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "assignee_id": "mem_tomas",    "team_id": "team_soporte",    "assigned_by": "mem_camila",    "previous_assignee_id": null  }}

conversation.unassigned

La conversación quedó sin responsable.

Disponible desde 2026-03-02. Volumen medio. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`previous_assignee_id`	string \| null	Responsable anterior
`unassigned_by`	string	ID de quien la liberó

conversation.unassigned

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.unassigned",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "previous_assignee_id": null,    "unassigned_by": "mem_camila"  }}

conversation.claimed

Un agente tomó una conversación que estaba esperando.

Disponible desde 2026-09-02. Volumen medio. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`member_id`	string	ID de quien la tomó
`waiting_seconds`	number	Cuánto esperó el cliente

conversation.claimed

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.claimed",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "member_id": "mem_tomas",    "waiting_seconds": 312  }}

conversation.status_changed

Cambió el estado: abierta, esperando, pospuesta o cerrada.

Disponible desde 2026-01-15. Volumen alto. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`status`	string	open \| waiting \| snoozed \| closed
`previous_status`	string	Estado anterior
`changed_by`	string	ID del agente, 'ai' o 'automation'

conversation.status_changed

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.status_changed",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "status": "open",    "previous_status": "waiting",    "changed_by": "mem_camila"  }}

conversation.closed

Se cerró la conversación.

Disponible desde 2026-01-15. Volumen alto. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`closed_by`	string	ID del agente, 'ai' o 'automation'
`resolution`	string	resolved \| no_response \| duplicate
`duration_seconds`	number	Desde la apertura

conversation.closed

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.closed",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "closed_by": "mem_camila",    "resolution": "resolved",    "duration_seconds": 1840  }}

conversation.reopened

El cliente volvió a escribir en una conversación cerrada.

Disponible desde 2026-01-15. Volumen medio. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`reopened_by`	string	ID del contacto o del agente
`closed_for_seconds`	number	Cuánto estuvo cerrada

conversation.reopened

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.reopened",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "reopened_by": "mem_camila",    "closed_for_seconds": 86400  }}

conversation.snoozed

Se pospuso hasta una fecha.

Disponible desde 2026-04-10. Volumen medio. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`snoozed_until`	string	Fecha ISO 8601
`snoozed_by`	string	ID del agente

conversation.snoozed

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.snoozed",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "snoozed_until": "2026-09-02T14:03:11.000Z",    "snoozed_by": "mem_camila"  }}

conversation.priority_changed

Cambió la prioridad.

Disponible desde 2026-02-01. Volumen medio. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`priority`	string	low \| normal \| high \| urgent
`previous_priority`	string	Prioridad anterior

conversation.priority_changed

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.priority_changed",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "priority": "urgent",    "previous_priority": "normal"  }}

conversation.tagged

Se agregó una etiqueta.

Disponible desde 2026-01-15. Volumen alto. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`tag`	string	Etiqueta agregada
`tags`	array	Lista completa después del cambio
`tagged_by`	string	ID del agente, 'ai' o 'automation'

conversation.tagged

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.tagged",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "tag": "instalación",    "tags": [      "instalación",      "shopify"    ],    "tagged_by": "mem_camila"  }}

conversation.untagged

Se quitó una etiqueta.

Disponible desde 2026-01-15. Volumen medio.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`tag`	string	Etiqueta quitada
`tags`	array	Lista completa después del cambio

conversation.untagged

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.untagged",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "tag": "instalación",    "tags": [      "instalación",      "shopify"    ]  }}

conversation.rated

El cliente calificó la atención (CSAT).

Disponible desde 2026-02-20. Volumen medio. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`score`	number	1 a 5
`comment`	string	Comentario libre o null
`rated_by`	string	ID del contacto
`agent_id`	string	Quién atendió

conversation.rated

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.rated",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "score": 5,    "comment": "Resolvieron todo en minutos.",    "rated_by": "mem_camila",    "agent_id": "obj_8f1c2a"  }}

conversation.merged

Dos conversaciones del mismo contacto se unieron.

Disponible desde 2026-05-06. Volumen bajo.

Campos de data

Campo	Tipo	Descripción
`id`	string	Conversación resultante
`merged_conversation_id`	string	La que se absorbió
`merged_by`	string	ID del agente

conversation.merged

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.merged",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "merged_conversation_id": "obj_8f1c2a",    "merged_by": "mem_camila"  }}

conversation.sla_breached

Se venció el tiempo de primera respuesta o de resolución.

Disponible desde 2026-03-18. Volumen medio. Se puede usar como disparador de automatizaciones. Requiere plan Avanzado.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`kind`	string	first_response \| resolution
`target_seconds`	number	Objetivo del SLA
`elapsed_seconds`	number	Tiempo transcurrido
`assignee_id`	string	Responsable

conversation.sla_breached

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.sla_breached",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "kind": "first_response",    "target_seconds": 3600,    "elapsed_seconds": 5120,    "assignee_id": "mem_tomas"  }}

conversation.participant_added

Se sumó otro agente a la conversación.

Disponible desde 2026-06-01. Volumen bajo.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`member_id`	string	Agente sumado
`added_by`	string	Quién lo sumó

conversation.participant_added

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "conversation.participant_added",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "member_id": "mem_tomas",    "added_by": "mem_camila"  }}