Eventos de mensajes

Cada mensaje que entra o sale, incluidas notas internas, entregas y lecturas.

Cada mensaje que entra o sale, incluidas notas internas, entregas y lecturas. Son 8 eventos. Todos llegan con la envoltura estándar y su contenido propio en data.

message.created

Se envió o se recibió un mensaje.

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
`conversation_id`	string	ID de la conversación
`author_type`	string	contact \| member \| ai \| system
`author_id`	string	ID del autor o null
`body`	string	Texto del mensaje
`attachments`	array	Lista de adjuntos
`created_at`	string	Fecha ISO 8601

message.created

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "message.created",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "conversation_id": "cv_1832",    "author_type": "contact",    "author_id": "obj_8f1c2a",    "body": "Hola, puse el script pero el widget no aparece.",    "attachments": [      {        "id": "att_1",        "name": "captura.png",        "size": 184320,        "type": "image"      }    ],    "created_at": "2026-09-02T14:03:11.000Z"  }}

message.received

Mensaje entrante de un cliente.

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
`conversation_id`	string	ID de la conversación
`contact_id`	string	Quién escribió
`body`	string	Texto del mensaje
`channel`	string	Canal de origen

message.received

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "message.received",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "conversation_id": "cv_1832",    "contact_id": "ct_juan",    "body": "Hola, puse el script pero el widget no aparece.",    "channel": "messenger"  }}

message.sent

Mensaje saliente de tu equipo o de la IA.

Disponible desde 2026-01-15. Volumen alto.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`conversation_id`	string	ID de la conversación
`author_type`	string	member \| ai
`author_id`	string	ID del autor

message.sent

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "message.sent",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "conversation_id": "cv_1832",    "author_type": "member",    "author_id": "obj_8f1c2a"  }}

message.delivered

El canal confirmó la entrega.

Disponible desde 2026-04-02. Volumen alto.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`channel`	string	Canal
`delivered_at`	string	Fecha ISO 8601

message.delivered

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "message.delivered",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "channel": "messenger",    "delivered_at": "2026-09-02T14:03:11.000Z"  }}

message.read

El cliente leyó el mensaje.

Disponible desde 2026-04-02. Volumen alto.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`read_at`	string	Fecha ISO 8601

message.read

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "message.read",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "read_at": "2026-09-02T14:03:11.000Z"  }}

message.failed

El canal rechazó el envío.

Disponible desde 2026-04-02. Volumen bajo. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`channel`	string	Canal
`error_code`	string	Código del proveedor
`error_message`	string	Detalle

message.failed

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "message.failed",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "channel": "messenger",    "error_code": "131047",    "error_message": "Message failed to send because more than 24 hours have passed."  }}

message.note_created

Se agregó una nota interna, invisible para el cliente.

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
`conversation_id`	string	ID de la conversación
`author_id`	string	Quién la escribió
`mentions`	array	IDs mencionados

message.note_created

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "message.note_created",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "conversation_id": "cv_1832",    "author_id": "obj_8f1c2a",    "mentions": [      "mem_nico"    ]  }}

message.reaction_added

Alguien reaccionó a un mensaje.

Disponible desde 2026-05-20. Volumen medio.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`emoji`	string	Emoji
`member_id`	string	Quién reaccionó

message.reaction_added

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "message.reaction_added",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "emoji": "👍",    "member_id": "mem_tomas"  }}