> ## Documentation Index
> Fetch the complete documentation index at: https://help.withallo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vue d'ensemble

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

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](/fr/v2/api-reference/notes/overview#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](/fr/v2/api-reference/webhooks/event-catalog#threadcreated).

## Endpoints

<CardGroup cols={1}>
  <Card title="Obtenir un fil de discussion" href="/fr/v2/api-reference/threads/get-thread">
    Un fil avec tous ses commentaires
  </Card>

  <Card title="Trouver un fil de discussion" href="/fr/v2/api-reference/threads/find-thread">
    Retrouver le fil d'un élément par type et ID d'entité
  </Card>

  <Card title="Créer un fil de discussion" href="/fr/v2/api-reference/threads/create-thread">
    Démarrer un fil sur un élément avec un premier commentaire
  </Card>

  <Card title="Ajouter un commentaire" href="/fr/v2/api-reference/threads/create-comment">
    Ajouter un commentaire à un fil
  </Card>

  <Card title="Mettre à jour un commentaire" href="/fr/v2/api-reference/threads/update-comment">
    Modifier le contenu d'un commentaire (auteur uniquement)
  </Card>

  <Card title="Résoudre un fil de discussion" href="/fr/v2/api-reference/threads/resolve-thread">
    Marquer un fil comme résolu
  </Card>

  <Card title="Rouvrir un fil de discussion" href="/fr/v2/api-reference/threads/unresolve-thread">
    Rouvrir un fil résolu
  </Card>
</CardGroup>