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
Un fil avec tous ses commentaires
Retrouver le fil d'un élément par type et ID d'entité
Démarrer un fil sur un élément avec un premier commentaire
Ajouter un commentaire à un fil
Modifier le contenu d'un commentaire (auteur uniquement)
Marquer un fil comme résolu
Rouvrir un fil résolu