Événements de rappel Webhook
Création de conversation
Lorsqu'un utilisateur crée avec succès une nouvelle conversation en appelant l'API, l'URL de webhook configurée pour le canal API reçoit un événement de rappel de création de 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": [],
"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"
}
Tableau des paramètres de l'événement de création de conversation
| Field | Type | Required | Description |
|---|---|---|---|
| account | Object | No | Informations sur le compte |
| account.id | Number | No | ID du projet |
| account.name | String | No | Nom du projet |
| additional_attributes | Object | No | Attributs supplémentaires |
| can_reply | Boolean | No | Indique si les réponses sont autorisées |
| channel | String | No | Type de canal, tel que api ou email |
| contact_inbox | Object | No | Informations sur le contact |
| contact_inbox.id | Number | No | ID de la table contact_inbox, qui enregistre la relation entre le contact et le canal |
| contact_inbox.contact_id | Number | No | ID du contact |
| contact_inbox.inbox_id | Number | No | ID du canal |
| contact_inbox.source_id | String | No | ID source de la conversation, tel qu'un user_id Telegram |
| contact_inbox.created_at | String | No | Heure de création |
| contact_inbox.updated_at | String | No | Heure de mise à jour |
| contact_inbox.hmac_verified | Boolean | No | Statut de vérification HMAC |
| contact_inbox.pubsub_token | String | No | Jeton de publication/abonnement |
| id | Number | No | ID de la conversation |
| inbox_id | Number | No | ID du canal |
| messages | Array | No | Liste des messages |
| labels | Array | No | Liste des libellés |
| meta | Object | No | Métadonnées |
| meta.sender | Object | No | Informations sur l'expéditeur |
| meta.sender.additional_attributes | Object | No | Attributs supplémentaires de l'expéditeur |
| meta.sender.custom_attributes | Object | No | Attributs personnalisés de l'expéditeur |
| meta.sender.email | String | No | Adresse e-mail de l'expéditeur |
| meta.sender.id | Number | No | ID interne de l'expéditeur dans liveDesk |
| meta.sender.identifier | String | No | Identifiant de l'expéditeur |
| meta.sender.name | String | No | Nom de l'expéditeur |
| meta.sender.phone_number | String | No | Numéro de téléphone de l'expéditeur |
| meta.sender.thumbnail | String | No | Avatar de l'expéditeur |
| meta.sender.blocked | Boolean | No | Indique si l'expéditeur est bloqué |
| meta.sender.type | String | No | Type d'expéditeur |
| meta.assignee | Object | No | Informations sur l'agent du service client assigné |
| meta.team | Object | No | Informations sur l'équipe du service client assignée |
| meta.hmac_verified | Boolean | No | Statut de vérification HMAC |
| meta.channel | String | No | Type de canal |
| status | String | No | Statut de la conversation, tel que open ou closed |
| custom_attributes | Object | No | Attributs personnalisés |
| snoozed_until | String | No | Mise en veille jusqu'à une heure spécifique |
| unread_count | Number | No | Nombre de messages non lus |
| first_reply_created_at | String | No | Heure de création de la première réponse |
| priority | String | No | Priorité |
| waiting_since | Number | No | Heure de début de l'attente |
| conversation_category | String | No | Catégorie de la conversation |
| chat_mode | String | No | Mode de chat |
| ticket_info | Object | No | Informations sur le ticket |
| agent_last_seen_at | Number | No | Dernière consultation de la conversation par l'agent |
| contact_last_seen_at | Number | No | Dernière consultation de la conversation par le contact |
| last_activity_at | Number | No | Heure de la dernière activité |
| timestamp | Number | No | Horodatage |
| created_at | Number | No | Heure de création |
| updated_at | Number | No | Heure de mise à jour |
| event | String | No | Type d'événement |
Mise à jour de conversation
Cet événement est déclenché lorsqu'un attribut d'une conversation est mis à jour.
{
"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> Contenu des attributs de la conversation
}
Paramètres de l'événement de mise à jour de conversation
| Field | Type | Required | Description |
|---|---|---|---|
| event | String | No | Type d'événement |
| changed_attributes | Array | No | Liste des attributs modifiés |
| changed_attributes.field_name | Object | No | Nom du champ modifié |
| changed_attributes.field_name.previous_value | String | No | Valeur avant la modification |
| changed_attributes.field_name.current_value | String | No | Valeur après la modification |
Changement de statut de conversation
Cet événement est déclenché lorsque le statut de la conversation change.
{
"event": "conversation_status_changed"
// <...Conversation Attributes> Contenu des attributs de la conversation
}
Création de message
Cet événement est déclenché lorsqu'un utilisateur ou un agent du service client envoie un message.
{
"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"
}
Tableau des paramètres de l'événement de création de message
| Field | Type | Required | Description |
|---|---|---|---|
| account | Object | No | Informations sur le compte |
| account.id | Number | No | ID du projet |
| account.name | String | No | Nom du projet |
| additional_attributes | Object | No | Attributs supplémentaires |
| content_attributes | Object | No | Attributs du contenu |
| content_type | String | No | Type de contenu |
| content | String | No | Contenu du message |
| conversation | Object | No | Informations sur la conversation |
| created_at | String | No | Heure de création |
| id | Number | No | ID du message |
| inbox | Object | No | Informations sur le canal |
| inbox.id | Number | No | ID du canal |
| inbox.name | String | No | Nom du canal |
| message_type | String | No | Type de message |
| conversation_topic_id | String | No | ID du sujet de conversation |
| private | Boolean | No | Indique si le message est privé |
| sender | Object | No | Informations sur l'expéditeur |
| sender.id | Number | No | ID de l'expéditeur |
| sender.name | String | No | Nom de l'expéditeur |
| sender.email | String | No | Adresse e-mail de l'expéditeur |
| sender.type | String | No | Type d'expéditeur |
| sender.availability | String | No | Statut de disponibilité de l'expéditeur |
| source_id | String | No | ID source |
| participants | Object | No | Informations sur les participants |
| event | String | No | Type d'événement |
Mise à jour de message
Cet événement est déclenché lorsque le contenu du message dans une conversation est mis à jour.
{
"event": "message_updated"
// <...Message Attributes> Contenu des attributs du message
}
Épinglage de message
Cet événement est déclenché lorsqu'un agent du service client épingle ou désépingle un message.
{
"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"
}
}
}
}
Tableau des paramètres de l'événement d'épinglage de message
| Field | Type | Required | Description |
|---|---|---|---|
| pinned | Boolean | No | Indique si le message est épinglé ; true signifie épinglé et false signifie désépinglé |
| pinned_at | String | No | Heure à laquelle le message a été épinglé ; peut être vide lorsque le message n'est pas épinglé |
| pinned_by_id | Number | No | ID de l'agent du service client ayant effectué l'action d'épinglage |
| additional_attributes | Object | No | Attributs supplémentaires |
| source_id | String | No | ID source |
| participants | Object | No | Informations sur les participants |
| event | String | No | Type d'événement |
Modification de message
Cet événement est déclenché lorsque le contenu du message est modifié. Notez que seul le contenu des messages envoyés par l'agent du service client peut être modifié.
{
"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"
}
}
]
}
}
Tableau des paramètres de l'événement de modification de message
| Field | Type | Required | Description |
|---|---|---|---|
| edited_at | String | No | Heure de modification du contenu |
| original_content | String | No | Contenu d'origine avant modification |
| processed_message_content | String | No | Contenu du message traité |
Révocation de message
Cet événement est déclenché lorsqu'un agent du service client révoque un message.
{
"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"
}
}
}
}
Tableau des paramètres de l'événement de révocation de message
| Field | Type | Required | Description |
|---|---|---|---|
| revoked_at | String | No | Heure de révocation |
| revoked_by_id | String | No | ID de l'agent du service client ayant effectué l'action de révocation |










