Eventos de devolución de llamada del webhook
Creación de conversaciones
Cuando un usuario crea correctamente una nueva conversación llamando a la API, la URL del webhook configurada para el canal API recibe un evento de devolución de llamada de creación de conversación.
{
"account": {
"id": 17629000001207,
"name": "1112"
},
"additional_attributes": {},
"can_reply": true,
"channel": "Channel::Api",
"contact_inbox": {
"id": 42213404,
"contact_id": 42218348,
"inbox_id": 523,
"source_id": "1d484823-da29-4086-a7ba-d65ad0ebb588",
"created_at": "2026-01-21T03:26:49.012Z",
"updated_at": "2026-01-21T03:26:49.012Z",
"hmac_verified": false,
"pubsub_token": "4Urn7N5A974k6C2H7Xeva8Ni"
},
"id": 89,
"inbox_id": 523,
"messages": [],
"labels": [],
"meta": {
"sender": {
"additional_attributes": {},
"custom_attributes": {},
"email": "alice@acme.inc",
"id": 42218348,
"identifier": null,
"name": "Test",
"phone_number": "+123456789",
"thumbnail": "",
"blocked": false,
"type": "contact"
},
"assignee": null,
"team": null,
"hmac_verified": false,
"channel": "Channel::Api"
},
"status": "open",
"custom_attributes": {},
"snoozed_until": null,
"unread_count": 0,
"first_reply_created_at": null,
"priority": null,
"waiting_since": 1768967324,
"conversation_category": "chat",
"chat_mode": "private_chat",
"ticket_info": null,
"agent_last_seen_at": 0,
"contact_last_seen_at": 0,
"last_activity_at": 1768967324,
"timestamp": 1768967324,
"created_at": 1768967324,
"updated_at": 1768967324.268219,
"event": "conversation_created"
}
Tabla de parámetros del evento de creación de conversaciones
| Field | Type | Required | Description |
|---|---|---|---|
| account | Object | No | Información del proyecto de la cuenta |
| account.id | Number | No | ID del proyecto |
| account.name | String | No | Nombre del proyecto |
| additional_attributes | Object | No | Atributos adicionales |
| can_reply | Boolean | No | Indica si se permiten respuestas |
| channel | String | No | Tipo de canal, como api o email |
| contact_inbox | Object | No | Información del contacto |
| contact_inbox.id | Number | No | ID de la tabla contact_inbox, que registra la relación entre el contacto y el canal |
| contact_inbox.contact_id | Number | No | ID del contacto |
| contact_inbox.inbox_id | Number | No | ID del canal |
| contact_inbox.source_id | String | No | ID de origen de la conversación, como el user_id de Telegram |
| contact_inbox.created_at | String | No | Hora de creación |
| contact_inbox.updated_at | String | No | Hora de actualización |
| contact_inbox.hmac_verified | Boolean | No | Estado de verificación HMAC |
| contact_inbox.pubsub_token | String | No | Token de publicación-suscripción |
| id | Number | No | ID de la conversación |
| inbox_id | Number | No | ID del canal |
| messages | Array | No | Lista de mensajes |
| labels | Array | No | Lista de etiquetas |
| meta | Object | No | Metadatos |
| meta.sender | Object | No | Información del remitente |
| meta.sender.additional_attributes | Object | No | Atributos adicionales del remitente |
| meta.sender.custom_attributes | Object | No | Atributos personalizados del remitente |
| meta.sender.email | String | No | Correo electrónico del remitente |
| meta.sender.id | Number | No | ID interno del remitente en liveDesk |
| meta.sender.identifier | String | No | Identificador del remitente |
| meta.sender.name | String | No | Nombre del remitente |
| meta.sender.phone_number | String | No | Número de teléfono del remitente |
| meta.sender.thumbnail | String | No | Avatar del remitente |
| meta.sender.blocked | Boolean | No | Indica si el remitente está bloqueado |
| meta.sender.type | String | No | Tipo de remitente |
| meta.assignee | Object | No | Información del agente de atención al cliente asignado |
| meta.team | Object | No | Información del equipo de atención al cliente asignado |
| meta.hmac_verified | Boolean | No | Estado de verificación HMAC |
| meta.channel | String | No | Tipo de canal |
| status | String | No | Estado de la conversación, como open o closed |
| custom_attributes | Object | No | Atributos personalizados |
| snoozed_until | String | No | Pospuesta hasta una hora específica |
| unread_count | Number | No | Número de mensajes no leídos |
| first_reply_created_at | String | No | Hora de creación de la primera respuesta |
| priority | String | No | Prioridad |
| waiting_since | Number | No | Hora de inicio de la espera |
| conversation_category | String | No | Categoría de la conversación |
| chat_mode | String | No | Modo de chat |
| ticket_info | Object | No | Información del ticket |
| agent_last_seen_at | Number | No | Última vez que el agente vio la conversación |
| contact_last_seen_at | Number | No | Última vez que el contacto vio la conversación |
| last_activity_at | Number | No | Hora de la última actividad |
| timestamp | Number | No | Marca temporal |
| created_at | Number | No | Hora de creación |
| updated_at | Number | No | Hora de actualización |
| event | String | No | Tipo de evento |
Actualización de conversaciones
Este evento se activa cuando se actualiza cualquier atributo de una conversación.
{
"event": "conversation_updated",
"changed_attributes": [
{
"updated_at": {
"previous_value": "2026-01-21T04:04:56.548Z",
"current_value": "2026-01-21T04:04:56.601Z"
}
},
{
"first_reply_created_at": {
"previous_value": null,
"current_value": "2026-01-21T04:04:56.544Z"
}
},
{
"waiting_since": {
"previous_value": "2026-01-21T03:48:44.268Z",
"current_value": null
}
}
]
// <...Conversation Attributes> Contenido de los atributos de la conversación
}
Parámetros del evento de actualización de conversaciones
| Field | Type | Required | Description |
|---|---|---|---|
| event | String | No | Tipo de evento |
| changed_attributes | Array | No | Lista de atributos modificados |
| changed_attributes.field_name | Object | No | Nombre del campo modificado |
| changed_attributes.field_name.previous_value | String | No | Valor antes del cambio |
| changed_attributes.field_name.current_value | String | No | Valor después del cambio |
Cambio de estado de la conversación
Este evento se activa cuando cambia el estado de la conversación.
{
"event": "conversation_status_changed"
// <...Conversation Attributes> Contenido de los atributos de la conversación
}
Creación de mensajes
Este evento se activa cuando un usuario o un agente de atención al cliente envía un mensaje.
{
"account": {
"id": 17629000001207,
"name": "1112"
},
"additional_attributes": {},
"content_attributes": {},
"content_type": "text",
"content": "How can I help you?",
"conversation": {
"account": {
"id": 17629000001207,
"name": "1112"
},
"additional_attributes": {},
"can_reply": true,
"channel": "Channel::Api",
"contact_inbox": {
"id": 42213404,
"contact_id": 42218348,
"inbox_id": 523,
"source_id": "1d484823-da29-4086-a7ba-d65ad0ebb588",
"created_at": "2026-01-21T03:26:49.012Z",
"updated_at": "2026-01-21T03:26:49.012Z",
"hmac_verified": false,
"pubsub_token": "4Urn7N5A974k6C2H7Xeva8Ni"
},
"id": 89,
"inbox_id": 523,
"messages": [
{
"id": 2187685,
"content": "How can I help you?",
"account_id": 17629000001207,
"inbox_id": 523,
"conversation_id": 89,
"message_type": 1,
"created_at": 1768968296,
"updated_at": "2026-01-21T04:04:56.544Z",
"private": false,
"status": "sent",
"source_id": null,
"content_type": "text",
"content_attributes": {},
"sender_type": "User",
"sender_id": 41,
"external_source_ids": {},
"additional_attributes": {},
"processed_message_content": "How can I help you?",
"sentiment": {},
"sorting_id": null,
"original_message_id": null,
"conversation_topic_id": null,
"topic_id": null,
"conversation": {
"assignee_id": null,
"unread_count": 0,
"last_activity_at": 1768968296,
"contact_inbox": {
"source_id": "1d484823-da29-4086-a7ba-d65ad0ebb588"
}
},
"sender": {
"id": 41,
"name": "support",
"available_name": "support",
"avatar_url": "",
"type": "user",
"availability_status": null,
"thumbnail": ""
}
}
],
"labels": [],
"meta": {
"sender": {
"additional_attributes": {},
"custom_attributes": {},
"email": "alice@acme.inc",
"id": 42218348,
"identifier": null,
"name": "Test",
"phone_number": "+123456789",
"thumbnail": "",
"blocked": false,
"type": "contact"
},
"assignee": null,
"team": null,
"hmac_verified": false,
"channel": "Channel::Api"
},
"status": "open",
"custom_attributes": {},
"snoozed_until": null,
"unread_count": 0,
"first_reply_created_at": null,
"priority": null,
"waiting_since": 1768967324,
"conversation_category": "chat",
"chat_mode": "private_chat",
"ticket_info": null,
"agent_last_seen_at": 0,
"contact_last_seen_at": 0,
"last_activity_at": 1768968296,
"timestamp": 1768968296,
"created_at": 1768967324,
"updated_at": 1768968296.5483441
},
"created_at": "2026-01-21T04:04:56.544Z",
"id": 2187685,
"inbox": {
"id": 523,
"name": "Test01"
},
"message_type": "outgoing",
"conversation_topic_id": null,
"private": false,
"sender": {
"id": 41,
"name": "support",
"email": "support@jiguang.cn",
"type": "user",
"availability": "online"
},
"source_id": null,
"user_id": 42213404,
"contact_id": 42218348,
"participants": null,
"event": "message_created"
}
Tabla de parámetros del evento de creación de mensajes
| Field | Type | Required | Description |
|---|---|---|---|
| account | Object | No | Información de la cuenta |
| account.id | Number | No | ID del proyecto |
| account.name | String | No | Nombre del proyecto |
| additional_attributes | Object | No | Atributos adicionales |
| content_attributes | Object | No | Atributos del contenido |
| content_type | String | No | Tipo de contenido |
| content | String | No | Contenido del mensaje |
| conversation | Object | No | Información de la conversación |
| created_at | String | No | Hora de creación |
| id | Number | No | ID del mensaje |
| inbox | Object | No | Información del canal |
| inbox.id | Number | No | ID del canal |
| inbox.name | String | No | Nombre del canal |
| message_type | String | No | Tipo de mensaje |
| conversation_topic_id | String | No | ID del tema de la conversación |
| private | Boolean | No | Indica si el mensaje es privado |
| sender | Object | No | Información del remitente |
| sender.id | Number | No | ID del remitente |
| sender.name | String | No | Nombre del remitente |
| sender.email | String | No | Correo electrónico del remitente |
| sender.type | String | No | Tipo de remitente |
| sender.availability | String | No | Estado de disponibilidad del remitente |
| source_id | String | No | ID de origen |
| participants | Object | No | Información de los participantes |
| event | String | No | Tipo de evento |
Actualización de mensajes
Este evento se activa cuando se actualiza el contenido del mensaje en una conversación.
{
"event": "message_updated"
// <...Message Attributes> Contenido de los atributos del mensaje
}
Fijación de mensajes
Este evento se activa cuando un agente de atención al cliente fija o desfija un mensaje.
{
"event": "message_pinned",
"id": 15680158,
"content": "hello11111 ",
"content_type": "text",
"message_type": "outgoing",
"private": false,
"source_type": "realtime",
"source_id": null,
"created_at": "2026-07-02T09:03:53.316Z",
"edited_at": "2026-07-02T09:04:02.791Z",
"pinned": true,
"pinned_at": "2026-07-02T09:04:23.748Z",
"pinned_by_id": 30,
"account": {
"id": 17829000004772,
"name": "11"
},
"inbox": {
"id": 228,
"name": "Test",
"channel_type": "Channel::Api"
},
"sender": {
"id": 30,
"name": "support",
"email": "TEST@support.cn",
"type": "user",
"availability": "online"
},
"conversation": {
"id": 202607000000002,
"inbox_id": 228,
"status": "open",
"channel_type": "Channel::Api",
"conversation_category": "chat",
"chat_mode": "private_chat",
"can_reply": true,
"unread_count": 0,
"last_activity_at": 1782983033,
"created_at": 1782982998,
"updated_at": 1782983063.750411,
"contact_inbox": {
"contact_id": 3939794,
"source_id": "5a6dbe3f-e7a7-4938-8364-1c3fe084e4a3"
},
"meta": {
"sender": {
"id": 3939794,
"name": "support11",
"email": "support11@engagelab.com",
"phone_number": "+123456111789",
"type": "contact"
},
"assignee": {
"id": 30,
"name": "TEST",
"type": "user"
}
}
}
}
Tabla de parámetros del evento de fijación de mensajes
| Field | Type | Required | Description |
|---|---|---|---|
| pinned | Boolean | No | Indica si el mensaje está fijado; true significa fijado y false significa desfijado |
| pinned_at | String | No | Hora a la que se fijó el mensaje; puede estar vacía cuando el mensaje no está fijado |
| pinned_by_id | Number | No | ID del agente de atención al cliente que realizó la acción de fijación |
| additional_attributes | Object | No | Atributos adicionales |
| source_id | String | No | ID de origen |
| participants | Object | No | Información de los participantes |
| event | String | No | Tipo de evento |
Edición de mensajes
Este evento se activa cuando se edita el contenido del mensaje. Ten en cuenta que solo se puede editar el contenido de los mensajes enviados por el agente de atención al cliente.
{
"event": "message_updated",
"id": 15680162,
"content": "Hello. How can I help you? ",
"content_type": "text",
"message_type": "outgoing",
"private": false,
"source_type": "realtime",
"source_id": null,
"created_at": "2026-07-02T10:32:51.420Z",
"edited_at": "2026-07-02T10:33:27.004Z",
"content_attributes": {
"edited_at": "2026-07-02T10:33:27.004Z"
},
"account": {
"id": 17829000004772,
"name": "11"
},
"inbox": {
"id": 228,
"name": "Test",
"channel_type": "Channel::Api"
},
"sender": {
"id": 30,
"name": "ye 88",
"type": "user"
},
"conversation": {
"id": 202607000000001,
"inbox_id": 228,
"status": "open",
"channel_type": "Channel::Api",
"conversation_category": "chat",
"chat_mode": "private_chat",
"can_reply": true,
"unread_count": 0,
"last_activity_at": 1782988371,
"created_at": 1782972594,
"updated_at": 1782988407.015933,
"contact_inbox": {
"contact_id": 3939794,
"source_id": "73e836b0-a893-41c2-b7e9-09a26a7332c8"
},
"messages": [
{
"id": 15680162,
"content": "Hello. How can I help you? ",
"inbox_id": 228,
"conversation_id": 202607000000001,
"message_type": 1,
"created_at": 1782988371,
"updated_at": "2026-07-02T10:33:27.013Z",
"private": false,
"status": "sent",
"source_id": null,
"content_type": "text",
"content_attributes": {
"edited_at": "2026-07-02T10:33:27.004Z"
},
"sender_type": "User",
"sender_id": 30,
"processed_message_content": "Hello. How can I help you? ",
"original_content": "Hello. ",
"source_type": "realtime",
"sender": {
"id": 30,
"name": "ye 88",
"type": "user"
}
}
]
}
}
Tabla de parámetros del evento de edición de mensajes
| Field | Type | Required | Description |
|---|---|---|---|
| edited_at | String | No | Hora de edición del contenido |
| original_content | String | No | Contenido original antes de la edición |
| processed_message_content | String | No | Contenido del mensaje procesado |
Revocación de mensajes
Este evento se activa cuando un agente de atención al cliente revoca un mensaje.
{
"event": "message_revoked",
"id": 15680158,
"content": "hello11111 ",
"content_type": "text",
"message_type": "outgoing",
"private": false,
"source_type": "realtime",
"source_id": null,
"created_at": "2026-07-02T09:03:53.316Z",
"edited_at": "2026-07-02T09:04:02.791Z",
"revoked_at": "2026-07-02T09:05:10.918Z",
"revoked_by_id": 30,
"account": {
"id": 17829000004772,
"name": "11"
},
"inbox": {
"id": 228,
"name": "Test",
"channel_type": "Channel::Api"
},
"sender": {
"id": 30,
"name": "support",
"email": "TEST@Support.cn",
"type": "user",
"availability": "online"
},
"conversation": {
"id": 202607000000002,
"inbox_id": 228,
"status": "open",
"channel_type": "Channel::Api",
"conversation_category": "chat",
"chat_mode": "private_chat",
"can_reply": true,
"unread_count": 0,
"last_activity_at": 1782983033,
"created_at": 1782982998,
"updated_at": 1782983110.928425,
"contact_inbox": {
"contact_id": 3939794,
"source_id": "5a6dbe3f-e7a7-4938-8364-1c3fe084e4a3"
},
"meta": {
"sender": {
"id": 3939794,
"name": "support11",
"email": "support11@engagelab.com",
"phone_number": "+123456111789",
"type": "contact"
},
"assignee": {
"id": 30,
"name": "TEST",
"type": "user"
}
}
}
}
Tabla de parámetros del evento de revocación de mensajes
| Field | Type | Required | Description |
|---|---|---|---|
| revoked_at | String | No | Hora de revocación |
| revoked_by_id | String | No | ID del agente de atención al cliente que realizó la acción de revocación |










