> ## 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

> Notes internes d'équipe sur les conversations et les fiches de personnes, avec @mentions

L'API Notes vous permet de créer et de gérer des **notes internes d'équipe**. Les notes ne sont visibles que par votre équipe — jamais par le contact. Il en existe deux types :

* **Notes de conversation** — des notes épinglées à une conversation (un numéro de contact sur l'une de vos lignes Allo). Elles apparaissent dans la timeline de la conversation dans les applications Allo.
* **Notes de personne** — des notes sur le profil CRM d'une personne, adressées par l'`id` `per-*` issu de l'[API Personnes](/fr/v2/api-reference/crm/people-overview). En interne, les notes sont rattachées à la fiche contact sous-jacente de la personne, ce qui permettra des notes d'entreprise sur un futur `/v2/api/crm/companies/{id}/notes`.

## Contraintes des notes

| Champ     | Contrainte                                                 |
| --------- | ---------------------------------------------------------- |
| `content` | Requis. Non vide, 4 000 caractères maximum.                |
| Mentions  | Optionnelles, inline dans `content`. 15 maximum par note.  |
| Édition   | Seul l'auteur d'une note peut la modifier ou la supprimer. |

## Mentions

Mentionnez des coéquipiers inline dans `content` avec la syntaxe `@[Display Name](usr-xxxx)` :

```json theme={null}
{
  "content": "Escalate to @[Jane Doe](usr-abc123) tomorrow"
}
```

* Récupérez les IDs utilisateur via [`GET /v2/api/users`](/fr/v2/api-reference/users/list-users) (nécessite le scope `USERS_READ`).
* Utilisez `@[all](all)` pour notifier toute l'équipe.
* Une note ou un commentaire peut contenir au maximum **15 mentions**.
* Les mentions avec un ID utilisateur inconnu sont ignorées silencieusement — elles s'affichent comme du texte brut et ne notifient personne.

Les mentions déclenchent les **mêmes notifications que les applications Allo** : les coéquipiers mentionnés reçoivent une notification push, un email et une entrée dans leur centre de notifications in-app.

<Note>
  `@[all](all)` notifie chaque membre de l'équipe. Envoyé depuis une automatisation, cela peut vite devenir bruyant — utilisez-le délibérément.
</Note>

Les réponses exposent les mentions analysées sous forme de tableau structuré :

```json theme={null}
{
  "mentions": [
    { "user_id": "usr-abc123", "name": "Jane Doe", "deleted": false }
  ]
}
```

`deleted` vaut `true` lorsque l'utilisateur mentionné a depuis été retiré de l'équipe.

Les mentions fonctionnent de la même façon dans les [commentaires de fils de discussion](/fr/v2/api-reference/threads/overview).

## Webhooks

Abonnez-vous aux événements `conversation_note.created`, `conversation_note.updated` et `conversation_note.deleted` pour les notes de conversation, et `contact_note.created`, `contact_note.updated` et `contact_note.deleted` pour les notes de personne. Voir le [Catalogue d'événements](/fr/v2/api-reference/webhooks/event-catalog#conversation_notecreated).

## Endpoints

### Notes de conversation

<CardGroup cols={1}>
  <Card title="Lister les notes de conversation" href="/fr/v2/api-reference/notes/list-conversation-notes">
    Toutes les notes d'une conversation, paginées
  </Card>

  <Card title="Créer une note de conversation" href="/fr/v2/api-reference/notes/create-conversation-note">
    Ajouter une note interne à une conversation
  </Card>

  <Card title="Obtenir une note de conversation" href="/fr/v2/api-reference/notes/get-conversation-note">
    Une note par son ID
  </Card>

  <Card title="Mettre à jour une note de conversation" href="/fr/v2/api-reference/notes/update-conversation-note">
    Modifier le contenu d'une note (auteur uniquement)
  </Card>

  <Card title="Supprimer une note de conversation" href="/fr/v2/api-reference/notes/delete-conversation-note">
    Supprimer une note (auteur uniquement)
  </Card>
</CardGroup>

### Notes de personne

<CardGroup cols={1}>
  <Card title="Lister les notes d'une personne" href="/fr/v2/api-reference/notes/list-person-notes">
    Toutes les notes du profil CRM d'une personne, paginées
  </Card>

  <Card title="Créer une note de personne" href="/fr/v2/api-reference/notes/create-person-note">
    Ajouter une note au profil CRM d'une personne
  </Card>

  <Card title="Mettre à jour une note de personne" href="/fr/v2/api-reference/notes/update-person-note">
    Modifier le contenu d'une note de personne (auteur uniquement)
  </Card>

  <Card title="Supprimer une note de personne" href="/fr/v2/api-reference/notes/delete-person-note">
    Supprimer une note de personne (auteur uniquement)
  </Card>
</CardGroup>