> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Notion Votre réceptionniste peut rechercher dans votre Workspace Notion, lire une page et consulter une base de données, comme une liste de prix, un tableau de produits ou une liste de postes vacants, pour répondre aux appelants. La lecture passe par des [outils webhook](/docs/fr/reception-ai/integrations/webhooks) avec une connexion interne Notion, qui fonctionne avec tous les forfaits Notion et n'accède qu'aux pages que vous partagez avec elle. L'ajout d'entrées à une base de données fonctionne aussi avec un outil webhook, via une deuxième connexion qui peut uniquement ajouter du contenu. Vous pouvez aussi utiliser [Zapier](/docs/fr/reception-ai/integrations/zapier), mais l'outil webhook est recommandé : il ne nécessite pas de compte Zapier, n'utilise pas vos tâches Zapier et chaque requête est envoyée directement à Notion. L'outil webhook ne peut toutefois pas renseigner la propriété de titre. Si vos entrées nécessitent un véritable titre, utilisez Zapier. > **Note** > > Si votre contenu Notion change rarement, vous n'avez peut-être pas besoin d'intégration. Exportez la page depuis > Notion et [importez-la dans votre base de connaissances](#use-the-knowledge-base-instead). > **Warning** > > Votre réceptionniste peut lire tout ce que vous partagez avec la connexion et le répéter aux appelants. > Ne partagez que les pages dont les appelants peuvent entendre parler et ajoutez une > [règle](/docs/fr/reception-ai/receptionist/rules-and-procedures) indiquant que votre réceptionniste ne lit jamais > aux appelants des informations privées, telles que les coordonnées des clients. ## Configuration ### Créer une connexion interne Vous devez être propriétaire du Workspace. Accédez à [app.notion.com/developers/connections](https://app.notion.com/developers/connections), sélectionnez **Internal connections**, puis **Create a new connection**. Nommez-la `Reception.ai` et choisissez votre Workspace. Dans l'onglet **Configuration**, autorisez uniquement la lecture de contenu, puis copiez l'**API token**. ### Partager des pages avec la connexion Ouvrez l'onglet **Content access** de la connexion, sélectionnez **Edit access**, puis choisissez les pages et bases de données que votre réceptionniste doit lire. Vous pouvez également ouvrir une page dans Notion, sélectionner **•••** → **Connections** → **+ Add connection**, puis choisir `Reception.ai`. Les pages enfants sont également partagées. ### Trouver l'ID de la source de données Pour permettre à votre réceptionniste de lire une base de données, ouvrez les paramètres de la base dans Notion, sélectionnez **Manage data sources**, ouvrez le menu **•••** à côté de la source de données, puis sélectionnez **Copy data source ID**. ### Créer les outils webhook Créez les [outils ci-dessous](#tools). Pour chacun, accédez à **Integrations**, sélectionnez **Add integration**, puis choisissez **Webhook Tool**. ### Tester la configuration [Testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) en posant une question à laquelle l'une de vos pages partagées répond. ## Outils Chaque outil envoie les en-têtes de requête suivants : | En-tête | Type | Valeur | | ---------------- | ------ | ------------------------------------------- | | `Authorization` | Secret | `Bearer ` suivi du jeton de votre connexion | | `Notion-Version` | Valeur | `2026-03-11` | Pour chaque outil, définissez **Assign to agents** sur **Receptionist**, puis sélectionnez **Enable**. ### Rechercher des pages | Champ | Valeur | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | `search_notion` | | **Description** | "Recherchez nos pages Notion par titre. Utilisez cet outil lorsqu'un appelant pose une question à laquelle nos documents pourraient répondre, puis lisez le meilleur résultat avec `read_notion_page`." | | **Method** | POST | | **URL** | `https://api.notion.com/v1/search` | | **Body Parameters** | `query` (chaîne, obligatoire) : "Un titre court à rechercher, tel que `pricing` ou `opening hours`." `page_size` (nombre, valeur fixe) : `10` | ### Lire une page | Champ | Valeur | | -------------------- | ----------------------------------------------------------------------------------- | | **Name** | `read_notion_page` | | **Description** | "Lisez le texte complet d'une page Notion trouvée avec `search_notion`." | | **Method** | GET | | **URL** | `https://api.notion.com/v1/pages/{page_id}/markdown` | | **Path Parameters** | `page_id` (chaîne, obligatoire) : "L'`id` d'une page renvoyée par `search_notion`." | | **Query Parameters** | `markdown_version` (chaîne, valeur fixe) : `v2` | ### Lire une base de données | Champ | Valeur | | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | `read_notion_table` | | **Description** | "Listez les lignes de notre liste de prix. Utilisez cet outil lorsqu'un appelant pose une question sur les prix ou sur ce que nous proposons." Décrivez plutôt votre propre tableau ici. | | **Method** | POST | | **URL** | `https://api.notion.com/v1/data_sources/DATA_SOURCE_ID/query` | | **Body Parameters** | `page_size` (nombre, valeur fixe) : `100` | Remplacez `DATA_SOURCE_ID` par l'ID que vous avez copié. Créez un outil par base de données, chacun avec son propre nom et sa propre description. ## Ajouter des entrées à une base de données avec un outil webhook (recommandé) Pour enregistrer dans une base de données Notion un élément issu d'un appel, comme un prospect ou une demande de rappel, créez un outil qui ajoute une entrée. ### Créer une connexion pour les nouvelles entrées Créez une deuxième connexion interne, par exemple `Reception.ai entries`, de la même manière que la première. Dans l'onglet **Configuration**, autorisez uniquement l'insertion de contenu, puis copiez son **API token**. Dans **Content access**, partagez uniquement la base de données à laquelle elle ajoute des entrées. Cette connexion ne peut rien relire, les entrées restent donc privées. ### Préparer la base de données Copiez l'ID de la source de données de la base, comme indiqué dans [Configuration](#set-up). Chaque propriété renseignée par l'outil est une clé dans la requête, et les clés ne peuvent pas contenir d'espaces. Donnez donc à ces propriétés des noms composés d'un seul mot, tels que `Phone`, `Email` et `Status`. ### Créer l'outil webhook Accédez à **Integrations**, sélectionnez **Add integration**, puis choisissez **Webhook Tool**. | Champ | Valeur | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Name** | `add_notion_entry` | | **Description** | "Enregistrez un nouveau prospect dans notre base de données de prospects lorsqu'un appelant souhaite un devis ou un rappel." Décrivez plutôt votre propre base de données ici. | | **Method** | POST | | **URL** | `https://api.notion.com/v1/pages` | | **Request Headers** | `Authorization` (Secret) : `Bearer ` suivi du jeton de la nouvelle connexion `Notion-Version` (Valeur) : `2026-03-11` | | **Body Parameters** | `parent` (objet, obligatoire) `markdown` (chaîne, obligatoire) `markdown_version` (chaîne) `properties` (objet, obligatoire) | | **Assign to agents** | **Receptionist** | Configurez les paramètres du corps comme suit : * `parent` : un champ, `data_source_id` (chaîne, valeur fixe) : l'ID de votre source de données. * `markdown` (issu de la conversation) : "L'entrée au format Markdown. Commencez par une ligne `# ` suivie du nom de l'appelant et de son besoin, par exemple `# Jane Doe: quote for a new boiler`. Ajoutez ensuite une ligne vide et les détails de la demande." * `markdown_version` (valeur fixe) : `v2` * `properties` : sélectionnez **Add field** une fois pour chaque propriété à renseigner. Chacune est un objet nommé exactement comme la propriété, avec un champ correspondant à sa valeur : * `Phone` (objet) : `phone_number` (chaîne, issu de la conversation) : "Le numéro de téléphone de l'appelant." * `Email` (objet) : `email` (chaîne, issu de la conversation) : "L'adresse email de l'appelant, répétée pour confirmation. Ne l'incluez pas s'il ne vous en a pas donné." * `Status` (objet, obligatoire) : `select` (objet, obligatoire), avec un champ, `name` (chaîne, valeur fixe) : `New` Notion indique que lorsque la propriété de titre est omise, le premier titre `#` devient le titre de la page. Sa documentation ne le montre que pour les pages créées à l'intérieur d'une page, vérifiez donc que cela fonctionne pour votre base de données. Dans tous les cas, le titre et les détails sont enregistrés comme contenu de l'entrée, et les propriétés de téléphone, d'email et de statut sont renseignées. Omettez la propriété de titre de `properties` : Notion imbrique les valeurs de titre et de texte sur six niveaux, soit un de plus que ce que les outils webhook autorisent. Les propriétés de numéro de téléphone, d'email, d'URL, de nombre, de case à cocher, de sélection et de date sont compatibles. Une propriété de type Status utilise `status` au lieu de `select`. Sélectionnez **Enable**, puis [testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) en demandant un rappel. L'entrée apparaît dans la base de données. ## Ajouter des entrées à une base de données avec Zapier Pour ajouter des entrées via Zapier, connectez [Zapier](/docs/fr/reception-ai/integrations/zapier). Dans votre serveur MCP Zapier sur [mcp.zapier.com](https://mcp.zapier.com), ajoutez l'action Notion **Create Data Source Item**, définissez la base de données sur une valeur fixe et laissez l'IA renseigner les champs. Dans Reception.ai, ouvrez l'onglet **Tools** de l'intégration Zapier, sélectionnez **Refresh tools**, puis attribuez l'action au **Client** (réceptionniste). ## Utiliser plutôt la base de connaissances Pour les contenus qui changent peu, la [base de connaissances](/docs/fr/reception-ai/knowledge-base/overview) est plus simple et plus rapide que les recherches en temps réel. Dans Notion, ouvrez le menu **•••** de la page, choisissez **More** → **Export**, puis sélectionnez **PDF**, **HTML** ou **Markdown & CSV**. Les exportations HTML et Markdown sont téléchargées sous forme de fichier zip, décompressez-le d'abord. Ensuite, [importez le fichier](/docs/fr/reception-ai/knowledge-base/file-uploads). Les bases de données sont exportées au format CSV, que la base de connaissances n'accepte pas. Exportez donc les bases de données au format PDF. Exportez et importez de nouveau le contenu lorsqu'il change. ## Limites * La recherche Notion correspond aux titres des pages et des bases de données, pas au texte à l'intérieur des pages. Donnez aux pages des titres explicites, tels que « Politique d'annulation ». * `read_notion_table` renvoie les 100 premières lignes et uniquement leurs propriétés, pas le contenu de la page de chaque ligne. Gardez les tableaux lus par votre réceptionniste de taille réduite. * Le serveur MCP hébergé de Notion nécessite une connexion dans le navigateur, sauf avec les forfaits Business et Enterprise, où un propriétaire du Workspace peut créer un jeton MCP. Les outils webhook ci-dessus fonctionnent avec tous les forfaits. * `add_notion_entry` ne peut pas renseigner les propriétés de titre ou de texte. Indiquez plutôt les noms et les notes dans le titre et le contenu. * Si vous ajoutez des entrées via Zapier, chaque action Zapier exécutée par votre réceptionniste utilise des tâches de votre forfait Zapier. Zapier compte actuellement deux tâches par appel réussi. ## Résolution des problèmes | Problème | Vérification à effectuer | | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 de Notion | L'en-tête `Authorization` doit être `Bearer ` suivi du jeton de la connexion. | | 400 concernant la version | Définissez `Notion-Version` sur `2026-03-11`. | | 404 ou `object_not_found` | Partagez la page ou la base de données avec la connexion et utilisez l'ID de la source de données, pas l'ID de la base de données. | | 403 sur `read_notion_page` | La connexion doit disposer de l'autorisation de lire le contenu. | | 403 sur `add_notion_entry` | La connexion des entrées doit disposer de l'autorisation d'insérer du contenu et d'accéder à la base de données. | | 400 `validation_error` sur `add_notion_entry` | Chaque clé de `properties` doit correspondre exactement à un nom de propriété et son champ doit correspondre au type de la propriété. | | Les nouvelles entrées affichent **Untitled** | Notion n'a pas utilisé le titre `#` comme titre pour votre base de données. Le titre reste en haut de la page de chaque entrée et vous pouvez trouver les entrées grâce à leur téléphone ou leur statut. Pour obtenir un titre, utilisez l'option Zapier. | | La recherche ne trouve rien | La recherche correspond uniquement aux titres, et seulement à ceux des pages partagées avec la connexion. | | Le réceptionniste est lent avec un grand tableau | Les grands tableaux renvoient beaucoup de données. Scindez le tableau ou déplacez le contenu vers la base de connaissances. |