Notion | ElevenLabs Documentation

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 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, 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.

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.

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 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, 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. Pour chacun, accédez à Integrations, sélectionnez Add integration, puis choisissez Webhook Tool.

Tester la configuration

Testez votre réceptionniste 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. 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 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. Dans votre serveur MCP Zapier sur 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 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. 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.