Événements de rappel Webhook
Conversation créée
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"
}
{
"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"
}
Afficher ce bloc de code dans la fenêtre flottante
Paramètres de l'événement de création de conversation
| Field | Type | Required | Description |
|---|---|---|---|
| account | Object | No | Informations sur le compte |
| id | Number | No | ID du projet |
| name | String | No | Nom du projet |
| additional_attributes | Object | No | Attributs supplémentaires |
| can_reply | Boolean | No | Indique s'il est possible de répondre |
| channel | String | No | Type de canal, par exemple api, email, etc. |
| contact_inbox | Object | No | Informations de contact |
| id | Number | No | ID de la table contact_inbox, qui enregistre la relation entre le contact et le canal |
| contact_id | Number | No | ID du contact |
| inbox_id | Number | No | ID du canal |
| source_id | String | No | ID source de la conversation, par exemple le user_id de Telegram |
| created_at | String | No | Heure de création |
| updated_at | String | No | Heure de mise à jour |
| hmac_verified | Boolean | No | Statut de vérification HMAC |
| 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 |
| sender | Object | No | Informations sur l'expéditeur |
| additional_attributes | Object | No | Attributs supplémentaires de l'expéditeur |
| custom_attributes | Object | No | Attributs personnalisés de l'expéditeur |
| String | No | Adresse e-mail de l'expéditeur | |
| id | Number | No | ID interne de l'expéditeur dans liveDesk |
| identifier | String | No | Identifiant de l'expéditeur |
| name | String | No | Nom de l'expéditeur |
| phone_number | String | No | Numéro de téléphone de l'expéditeur |
| thumbnail | String | No | Avatar de l'expéditeur |
| blocked | Boolean | No | Indique si l'expéditeur est bloqué |
| type | String | No | Type d'expéditeur |
| assignee | Object | No | Informations sur l'agent du service client assigné |
| team | Object | No | Informations sur l'équipe du service client assignée |
| hmac_verified | Boolean | No | Statut de vérification HMAC |
| channel | String | No | Type de canal |
| status | String | No | Statut de la conversation, par exemple open, closed, etc. |
| custom_attributes | Object | No | Attributs personnalisés |
| snoozed_until | String | No | Mise en veille jusqu'à une heure donnée |
| 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 | Heure de la dernière présence de l'agent |
| contact_last_seen_at | Number | No | Heure de la dernière présence du 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 |
Conversation mise à jour
Cet événement est déclenché lorsqu'un attribut de la 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
}
{
"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
}
Afficher ce bloc de code dans la fenêtre flottante
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 |
| field_name | Object | No | Nom du champ modifié |
| previous_value | String | No | Valeur avant modification |
| current_value | String | No | Valeur après modification |
Statut de conversation modifié
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
}
{
"event": "conversation_status_changed"
// <...Conversation Attributes> Contenu des attributs de la conversation
}
Afficher ce bloc de code dans la fenêtre flottante
Message créé
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": "Hello, what can I help you with?",
"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": "Hello, what can I help you with?",
"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": "Hello, what can I help you with?",
"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"
}
{
"account": {
"id": 17629000001207,
"name": "1112"
},
"additional_attributes": {},
"content_attributes": {},
"content_type": "text",
"content": "Hello, what can I help you with?",
"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": "Hello, what can I help you with?",
"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": "Hello, what can I help you with?",
"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"
}
Afficher ce bloc de code dans la fenêtre flottante
Paramètres de l'événement de création de message
| Field | Type | Required | Description |
|---|---|---|---|
| account | Object | No | Informations sur le compte |
| id | Number | No | ID du projet |
| 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 |
| id | Number | No | ID du canal |
| 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 |
| id | Number | No | ID de l'expéditeur |
| name | String | No | Nom de l'expéditeur |
| String | No | Adresse e-mail de l'expéditeur | |
| type | String | No | Type d'expéditeur |
| 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 |
Message mis à jour
Cet événement est déclenché lorsque le contenu du message dans la conversation est mis à jour.
{
"event": "message_updated"
// <...Message Attributes> Contenu des attributs du message
}
{
"event": "message_updated"
// <...Message Attributes> Contenu des attributs du message
}
Afficher ce bloc de code dans la fenêtre flottante
