Skip to main content
L’API Threads vous permet de gérer les fils de discussion d’équipe. Un fil est une chaîne de commentaires attachée à un élément de conversation — un appel, un message SMS ou une note de conversation — où les coéquipiers discutent de cet élément sans que le contact ne voie quoi que ce soit.

​
Concepts clés

Un fil par élément — chaque élément de conversation peut avoir au maximum un fil. En créer un second retourne une erreur 409 avec le code THREAD_ALREADY_EXISTS ; retrouvez le fil existant et ajoutez-y un commentaire à la place. Référence d’entité — un fil pointe vers son élément via entity_type (CALL, TEXT_MESSAGE ou CONVERSATION_NOTE) et entity_id (l’ID de l’élément : cll-*, msg-* ou not-*). Commentaires — un fil est créé avec un premier commentaire et s’enrichit ensuite. Seul l’auteur d’un commentaire peut le modifier. Résolution — les fils peuvent être marqués comme résolus puis rouverts. Résoudre ne verrouille pas le fil — des commentaires peuvent toujours être ajoutés. Mentions — les commentaires prennent en charge les mêmes mentions @[Display Name](usr-xxxx) que les notes, avec les mêmes notifications push, email et in-app. Voir le guide des mentions.

​
Webhooks

Abonnez-vous aux événements thread.created, thread.comment.created, thread.comment.updated, thread.resolved et thread.unresolved. Voir le Catalogue d’événements.

​
Endpoints

Obtenir un fil de discussion

Un fil avec tous ses commentaires

Trouver un fil de discussion

Retrouver le fil d’un élément par type et ID d’entité

Créer un fil de discussion

Démarrer un fil sur un élément avec un premier commentaire

Ajouter un commentaire

Ajouter un commentaire à un fil

Mettre à jour un commentaire

Modifier le contenu d’un commentaire (auteur uniquement)

Résoudre un fil de discussion

Marquer un fil comme résolu

Rouvrir un fil de discussion

Rouvrir un fil résolu