Logo Site EngageLab Mark Colored TransparentDocumentation
LiveDesk
Accueil de la Documentation
Vue d’ensembleConversationsCanauxAgentsAnalysesParamètresAPINotes de version
Rechercher
Connexion
Canaux/API/Événements webhook
CanauxAPIÉvénements webhook...

Événements webhook

Dernière Mise à jour：il y a 3 jours

Création d'une conversation

Lorsqu'un utilisateur crée une conversation via l'API, l'URL webhook configurée pour le canal API reçoit un événement 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 d'une conversation

Champ Type Requis Description
account Object Non Informations sur le compte et le projet
id Number Non ID du projet
name String Non Nom du projet
additional_attributes Object Non Attributs supplémentaires
can_reply Boolean Non Indique si une réponse peut être envoyée
channel String Non Type de canal, tel que api ou email
contact_inbox Object Non Informations sur le contact
id Number Non ID de l'enregistrement contact_inbox, qui indique la relation entre le contact et le canal
contact_id Number Non ID du contact
inbox_id Number Non ID du canal
source_id String Non ID source de la conversation, tel que l'ID utilisateur Telegram
created_at String Non Heure de création
updated_at String Non Heure de mise à jour
hmac_verified Boolean Non État de la vérification HMAC
pubsub_token String Non Jeton de publication-abonnement
id Number Non ID de la conversation
inbox_id Number Non ID du canal
messages Array Non Liste des messages
labels Array Non Liste des libellés
meta Object Non Métadonnées
sender Object Non Informations sur l'expéditeur
additional_attributes Object Non Attributs supplémentaires de l'expéditeur
custom_attributes Object Non Attributs personnalisés de l'expéditeur
email String Non Adresse e-mail de l'expéditeur
id Number Non ID LiveDesk interne de l'expéditeur
identifier String Non Identifiant de l'expéditeur
name String Non Nom de l'expéditeur
phone_number String Non Numéro de téléphone de l'expéditeur
thumbnail String Non Avatar de l'expéditeur
blocked Boolean Non Indique si l'expéditeur est bloqué
type String Non Type d'expéditeur
assignee Object Non Informations sur l'agent du service client assigné
team Object Non Informations sur l'équipe du service client assignée
hmac_verified Boolean Non État de la vérification HMAC
channel String Non Type de canal
status String Non Statut de la conversation, tel que open ou closed
custom_attributes Object Non Attributs personnalisés
snoozed_until String Non Heure jusqu'à laquelle la conversation est suspendue
unread_count Number Non Nombre de messages non lus
first_reply_created_at String Non Heure de création de la première réponse
priority String Non Priorité
waiting_since Number Non Heure à laquelle l'attente a commencé
conversation_category String Non Catégorie de la conversation
chat_mode String Non Mode de discussion
ticket_info Object Non Informations sur le ticket
agent_last_seen_at Number Non Heure à laquelle l'agent a consulté la conversation pour la dernière fois
contact_last_seen_at Number Non Heure à laquelle le contact a consulté la conversation pour la dernière fois
last_activity_at Number Non Heure de la dernière activité
timestamp Number Non Horodatage
created_at Number Non Heure de création
updated_at Number Non Heure de mise à jour
event String Non Type d'événement

Mise à jour d'une 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 }
              
              {
  "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 d'une conversation

Champ Type Requis Description
event String Non Type d'événement
changed_attributes Array Non Liste des attributs modifiés
field_name Object Non Nom du champ modifié
previous_value String Non Valeur avant la modification
current_value String Non Valeur après la modification

Changement de statut d'une conversation

Cet événement est déclenché lorsque le statut d'une 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

Création d'un message

Cet événement est déclenché lorsqu'un utilisateur ou un agent du service client envoie un message.

Paramètres de l'événement de création d'un message

Champ Type Requis Description
account Object Non Informations sur le compte
id Number Non ID du projet
name String Non Nom du projet
additional_attributes Object Non Attributs supplémentaires
content_attributes Object Non Attributs du contenu
content_type String Non Type de contenu
content String Non Contenu du message
conversation Object Non Informations sur la conversation
created_at String Non Heure de création
id Number Non ID du message
inbox Object Non Informations sur le canal
id Number Non ID du canal
name String Non Nom du canal
message_type String Non Type de message
conversation_topic_id String Non ID du sujet de la conversation
private Boolean Non Indique si le message est privé
sender Object Non Informations sur l'expéditeur
id Number Non ID de l'expéditeur
name String Non Nom de l'expéditeur
email String Non Adresse e-mail de l'expéditeur
type String Non Type d'expéditeur
availability String Non Statut de disponibilité de l'expéditeur
source_id String Non ID source
participants Object Non Informations sur les participants
event String Non Type d'événement

Mise à jour d'un message

Cet événement est déclenché lorsque le contenu d'un message d'une 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

Épinglage d'un message

Cet événement est déclenché lorsqu'un agent du service client épingle ou désépingle un message.

Paramètres de l'événement d'épinglage d'un message

Champ Type Requis Description
pinned Boolean Non Indique si le message est épinglé. true signifie qu'il est épinglé et false qu'il est désépinglé
pinned_at String Non Heure de l'épinglage ; peut être vide lorsque le message n'est pas épinglé
pinned_by_id Number Non ID de l'agent du service client ayant effectué l'opération d'épinglage
additional_attributes Object Non Attributs supplémentaires
source_id String Non ID source
participants Object Non Informations sur les participants
event String Non Type d'événement

Modification d'un message

Cet événement est déclenché lorsque le contenu d'un message est modifié. Notez que seuls les messages envoyés par l'agent du service client lui-même peuvent être modifiés.

Révocation d'un message

Cet événement est déclenché lorsqu'un agent du service client révoque un message.

Paramètres de l'événement de révocation d'un message

Champ Type Requis Description
revoked_at String Non Heure de révocation
revoked_by_id String Non ID de l'agent du service client ayant effectué l'opération de révocation
Icon Solid Transparent White Qiyu
Contactez-nous