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

# Notion

> Répondre aux @mentions dans les commentaires Notion

Notion permet à l'assistant de répondre dans les commentaires de pages et de blocs. Un collègue saisit le nom du bot dans un commentaire, et la réponse revient dans le même fil.

## Quand l'utiliser

Utilisez-le pour un wiki, un brief client ou une page de projet dont la discussion est déjà dans les commentaires. L'assistant ne modifie pas le contenu des pages et ne voit l'espace que pour les pages partagées avec la connexion.

## Ce que l'assistant entend

L'assistant entend les commentaires des pages partagées avec la connexion. Les bots de connexion Notion ne figurent pas dans le menu @ : les gens saisissent `@` puis le nom à la main. Seul un abonnement **Comment created** est nécessaire.

## Où trouver les clés

Le guide du fournisseur lié montre les écrans de ces clics. Suivez les clics ci-dessous avec ces images.

Un propriétaire d'espace ouvre [Notion Settings → Connections](https://www.notion.com/help/create-integrations-with-the-notion-api), active le mode développeur et crée une connexion. Le jeton commence par `ntn_` ou `secret_` et ne s'affiche qu'une fois. Le jeton de vérification du webhook n'existe pas encore : Notion l'envoie seulement quand l'URL publique existe. Les écrans sont dans [Notion webhooks](https://developers.notion.com/reference/webhooks).

## Le créer chez le fournisseur

1. Dans Notion, ouvrez **Settings → Connections**. Il faut être propriétaire de l'espace.
2. Activez l'accès développeur des connexions internes et choisissez **New connection**.
3. Nommez-la, choisissez l'espace et activez **Read comments** et **Insert comments**.
4. Ouvrez le menu de la connexion et copiez le jeton d'intégration. Il ne s'affiche qu'une fois.
5. Sur chaque page que l'assistant doit voir, ouvrez **••• → Connections** et ajoutez cette connexion.
6. Laissez le webhook pour l'étape suivante. Notion demande une URL HTTPS publique avant de créer le jeton de vérification.

## Le connecter dans Famulor

Votre forfait inclut ce canal. Ouvrez **Settings → Channels**, choisissez la carte, nommez la connexion, sélectionnez un assistant et enregistrez. Les paramètres de conversation communs — délai de réponse (5 secondes par défaut) et délai d'inactivité (30 minutes par défaut) — sont décrits sur la page [canaux de messagerie](https://docs.famulor.io/fr/channels/messaging.md).

Sur la carte **Notion**, collez **Notion integration token**. Laissez **Webhook verification token** vide. **Bot @mention name** est le nom saisi après `@`.

Après l'enregistrement, ouvrez le menu de la connexion et choisissez **Copy webhook URL**. Collez cette adresse exacte chez le fournisseur. Un domaine personnalisé vérifié fait déjà partie de l'adresse affichée.

## Pointer le fournisseur vers Famulor

1. Copiez l'URL de webhook. Elle apparaît aussi quand vous modifiez la connexion.
2. Dans la connexion Notion, ouvrez **Webhooks → Create a subscription** et choisissez **Comment created**. Collez l'URL Famulor.
3. Notion envoie le jeton de vérification une fois. Rouvrez la connexion Famulor. Le jeton s'affiche comme **Notion verification token**, et le menu propose **Copy verification token**.
4. Collez ce jeton dans l'étape **Verify** de Notion. Si le premier envoi a été manqué, renvoyez le jeton depuis Notion.
5. Après vérification, Notion verrouille l'URL. Un nouveau commentaire qui mentionne le nom du bot apparaît dans l'historique.

## Historique

Ouvrez l'[historique](https://docs.famulor.io/fr/monitoring/history.md) et filtrez par **Notion**. Le fil, la réponse de l'assistant et l'analyse éventuelle y apparaissent. Vous pouvez mettre l'assistant en pause et répondre vous-même.

## API, MCP et ligne de commande

La même connexion se crée avec l'API publique, l'outil MCP `create_messaging_connector` ou la ligne de commande. Remplacez les exemples par vos propres valeurs.

```bash theme={null}
famulor create-messaging-connector --platform notion --name "Support" \
  --assistant-id ASSISTANT_UUID --token ntn_… --bot-username notion-bot
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.