Allo

Vue d'ensemble

Fils de discussion d'équipe attachés aux appels, SMS et notes de conversation

Mis à jour le

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