> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Notion La tua receptionist può cercare nel tuo workspace Notion, leggere una pagina e consultare un database, ad esempio un listino prezzi, una tabella di prodotti o un elenco di posizioni aperte, per rispondere a chi chiama. La lettura avviene tramite gli [strumenti webhook](/docs/it/reception-ai/integrations/webhooks) con una connessione interna a Notion, che funziona con tutti i piani Notion e vede solo le pagine che condividi con essa. Anche l'aggiunta di voci a un database funziona con uno strumento webhook, tramite una seconda connessione che può solo aggiungere contenuti. Puoi invece usare [Zapier](/docs/it/reception-ai/integrations/zapier), ma consigliamo lo strumento webhook: non richiede un account Zapier né usa le tue attività Zapier, e ogni richiesta viene inviata direttamente a Notion. Tuttavia, lo strumento webhook non può compilare la proprietà del titolo, quindi se le tue voci necessitano di un titolo effettivo, usa Zapier. > **Note** > > Se i tuoi contenuti Notion cambiano raramente, potresti non aver bisogno di un'integrazione. Esporta la pagina da > Notion e [caricala nella tua knowledge base](#use-the-knowledge-base-instead). > **Warning** > > La tua receptionist può leggere tutto ciò che condividi con la connessione e riferirlo a chi chiama. > Condividi solo le pagine di cui chi chiama può venire a conoscenza e aggiungi una > [regola](/docs/it/reception-ai/receptionist/rules-and-procedures) affinché la tua receptionist non legga mai > a chi chiama dati privati, come i dettagli dei clienti. ## Configurazione ### Crea una connessione interna Devi essere proprietario del workspace. Vai su [app.notion.com/developers/connections](https://app.notion.com/developers/connections), seleziona **Internal connections**, quindi **Create a new connection**. Chiamala `Reception.ai` e scegli il tuo workspace. Nella scheda **Configuration**, consenti solo la lettura dei contenuti e copia l'**API token**. ### Condividi le pagine con la connessione Apri la scheda **Content access** della connessione, seleziona **Edit access** e scegli le pagine e i database che la tua receptionist deve leggere. Puoi anche aprire una pagina in Notion, selezionare **•••** → **Connections** → **+ Add connection** e scegliere `Reception.ai`. Verranno condivise anche le pagine figlie. ### Trova l'ID della sorgente dati Per consentire alla tua receptionist di leggere un database, apri le impostazioni del database in Notion, seleziona **Manage data sources**, apri il menu **•••** accanto alla sorgente dati e seleziona **Copy data source ID**. ### Crea gli strumenti webhook Crea gli [strumenti indicati sotto](#tools). Per ciascuno, vai su **Integrations**, seleziona **Add integration** e scegli **Webhook Tool**. ### Testalo [Testa la tua receptionist](/docs/it/reception-ai/receptionist/testing) ponendo una domanda a cui risponde una delle pagine condivise. ## Strumenti Ogni strumento invia questi header della richiesta: | Header | Tipo | Valore | | ---------------- | ------ | --------------------------------------------- | | `Authorization` | Secret | `Bearer ` seguito dal token della connessione | | `Notion-Version` | Valore | `2026-03-11` | Per ogni strumento, imposta **Assign to agents** su **Receptionist** e seleziona **Enable**. ### Cerca pagine | Campo | Valore | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `search_notion` | | **Descrizione** | "Cerca nelle nostre pagine Notion in base al titolo. Usalo quando chi chiama chiede qualcosa a cui potrebbero rispondere i nostri documenti, quindi leggi il risultato più pertinente con `read_notion_page`." | | **Metodo** | POST | | **URL** | `https://api.notion.com/v1/search` | | **Parametri body** | `query` (stringa, obbligatorio): "Un breve titolo da cercare, come `pricing` o `opening hours`." `page_size` (numero, valore fisso): `10` | ### Leggi una pagina | Campo | Valore | | ------------------- | ---------------------------------------------------------------------------------------- | | **Nome** | `read_notion_page` | | **Descrizione** | "Leggi il testo completo di una pagina Notion trovata con `search_notion`." | | **Metodo** | GET | | **URL** | `https://api.notion.com/v1/pages/{page_id}/markdown` | | **Parametri path** | `page_id` (stringa, obbligatorio): "L'`id` di una pagina restituita da `search_notion`." | | **Parametri query** | `markdown_version` (stringa, valore fisso): `v2` | ### Leggi un database | Campo | Valore | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `read_notion_table` | | **Descrizione** | "Elenca le righe del nostro listino prezzi. Usalo quando chi chiama chiede informazioni sui prezzi o su ciò che offriamo." Descrivi qui la tua tabella. | | **Metodo** | POST | | **URL** | `https://api.notion.com/v1/data_sources/DATA_SOURCE_ID/query` | | **Parametri body** | `page_size` (numero, valore fisso): `100` | Sostituisci `DATA_SOURCE_ID` con l'ID che hai copiato. Crea uno strumento per ogni database, ciascuno con il proprio nome e la propria descrizione. ## Aggiungi voci al database con uno strumento webhook (consigliato) Per salvare in un database Notion qualcosa emerso durante una chiamata, come un potenziale cliente o una richiesta di richiamata, crea uno strumento che aggiunga una voce. ### Crea una connessione per le nuove voci Crea una seconda connessione interna, ad esempio `Reception.ai entries`, allo stesso modo della prima. Nella scheda **Configuration**, consenti solo l'inserimento di contenuti e copia il suo **API token**. In **Content access**, condividi solo il database in cui aggiunge le voci. Questa connessione non può leggere nulla, quindi le voci rimangono private. ### Prepara il database Copia l'ID della sorgente dati del database, come indicato in [Configurazione](#set-up). Ogni proprietà compilata dallo strumento è una chiave nella richiesta e le chiavi non possono contenere spazi, quindi assegna a tali proprietà nomi di una sola parola, come `Phone`, `Email` e `Status`. ### Crea lo strumento webhook Vai su **Integrations**, seleziona **Add integration** e scegli **Webhook Tool**. | Campo | Valore | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `add_notion_entry` | | **Descrizione** | "Salva un nuovo potenziale cliente nel nostro database di lead quando chi chiama desidera un preventivo o una richiamata." Descrivi qui il tuo database. | | **Metodo** | POST | | **URL** | `https://api.notion.com/v1/pages` | | **Header della richiesta** | `Authorization` (Secret): `Bearer ` seguito dal token della nuova connessione `Notion-Version` (Valore): `2026-03-11` | | **Parametri body** | `parent` (oggetto, obbligatorio) `markdown` (stringa, obbligatorio) `markdown_version` (stringa) `properties` (oggetto, obbligatorio) | | **Assign to agents** | **Receptionist** | Configura i parametri body in questo modo: * `parent`: un campo, `data_source_id` (stringa, valore fisso): l'ID della tua sorgente dati. * `markdown` (dalla conversazione): "La voce in formato Markdown. Inizia con una riga `# ` seguita dal nome di chi chiama e da ciò di cui ha bisogno, ad esempio `# Jane Doe: quote for a new boiler`. Poi aggiungi una riga vuota e i dettagli della richiesta." * `markdown_version` (valore fisso): `v2` * `properties`: seleziona **Add field** una volta per ogni proprietà da compilare. Ciascuna è un oggetto con il nome esatto della proprietà e un campo per il relativo valore: * `Phone` (oggetto): `phone_number` (stringa, dalla conversazione): "Il numero di telefono di chi chiama." * `Email` (oggetto): `email` (stringa, dalla conversazione): "L'indirizzo email di chi chiama, confermato lettera per lettera. Omettilo se non ne ha fornito uno." * `Status` (oggetto, obbligatorio): `select` (oggetto, obbligatorio), con un campo, `name` (stringa, valore fisso): `New` Notion documenta che, quando la proprietà del titolo viene omessa, il primo titolo `#` diventa il titolo della pagina; la documentazione lo mostra solo per le pagine create all'interno di una pagina, quindi verifica che funzioni con il tuo database. In ogni caso, il titolo e i dettagli vengono salvati come contenuto della voce e vengono compilate le proprietà telefono, email e stato. Ometti la proprietà del titolo da `properties`: Notion annida i valori di titolo e testo a sei livelli di profondità, uno in più di quanti ne consentano gli strumenti webhook. Le proprietà numero di telefono, email, URL, numero, casella di controllo, selezione e data sono supportate. Una proprietà di tipo Status usa `status` invece di `select`. Seleziona **Enable**, quindi [testa la tua receptionist](/docs/it/reception-ai/receptionist/testing) chiedendo una richiamata. La voce apparirà nel database. ## Aggiungi voci al database con Zapier Per aggiungere invece voci tramite Zapier, connetti [Zapier](/docs/it/reception-ai/integrations/zapier). Nel tuo server MCP Zapier su [mcp.zapier.com](https://mcp.zapier.com), aggiungi l'azione Notion **Create Data Source Item**, imposta il database su un valore fisso e lascia che l'IA compili i campi. In Reception.ai, apri la scheda **Tools** dell'integrazione Zapier, seleziona **Refresh tools** e assegna l'azione al **Client** (receptionist). ## Usa invece la knowledge base Per i contenuti che non cambiano spesso, la [knowledge base](/docs/it/reception-ai/knowledge-base/overview) è più semplice e veloce delle ricerche in tempo reale. In Notion, apri il menu **•••** della pagina, scegli **More** → **Export** e seleziona **PDF**, **HTML** o **Markdown & CSV**. Le esportazioni HTML e Markdown vengono scaricate come file zip, quindi prima estrailo. Poi [carica il file](/docs/it/reception-ai/knowledge-base/file-uploads). I database vengono esportati in CSV, che la knowledge base non accetta, quindi esportali in PDF. Esporta e carica di nuovo quando il contenuto cambia. ## Limitazioni * La ricerca di Notion trova corrispondenze nei titoli delle pagine e dei database, non nel testo all'interno delle pagine. Assegna alle pagine titoli chiari, come "Politica di cancellazione". * `read_notion_table` restituisce le prime 100 righe e solo le relative proprietà, non il contenuto all'interno della pagina di ogni riga. Mantieni piccole le tabelle lette dalla tua receptionist. * Il server MCP ospitato da Notion richiede l'accesso tramite browser, tranne nei piani Business ed Enterprise, in cui il proprietario del workspace può creare un token MCP. Gli strumenti webhook sopra descritti funzionano con tutti i piani. * `add_notion_entry` non può compilare le proprietà di titolo o testo. Inserisci invece nomi e note nel titolo e nel contenuto. * Se aggiungi voci tramite Zapier, ogni azione Zapier eseguita dalla tua receptionist usa attività del tuo piano Zapier. Attualmente Zapier conta due attività per ogni chiamata riuscita. ## Risoluzione dei problemi | Problema | Cosa verificare | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 da Notion | L'header `Authorization` deve essere `Bearer ` seguito dal token della connessione. | | 400 relativo alla versione | Imposta `Notion-Version` su `2026-03-11`. | | 404 o `object_not_found` | Condividi la pagina o il database con la connessione e usa l'ID della sorgente dati, non l'ID del database. | | 403 su `read_notion_page` | La connessione necessita dell'autorizzazione a leggere i contenuti. | | 403 su `add_notion_entry` | La connessione per le voci necessita dell'autorizzazione a inserire contenuti e dell'accesso al database. | | 400 `validation_error` su `add_notion_entry` | Ogni chiave in `properties` deve corrispondere esattamente al nome di una proprietà e il suo campo deve corrispondere al tipo della proprietà. | | Le nuove voci vengono visualizzate come **Senza titolo** | Notion non ha usato il titolo `#` come titolo del tuo database. Il titolo rimane comunque nella parte superiore della pagina di ogni voce e puoi trovare le voci tramite il telefono o lo stato. Per ottenere un titolo, usa l'opzione Zapier. | | La ricerca non trova nulla | La ricerca trova corrispondenze solo nei titoli e solo delle pagine condivise con la connessione. | | La receptionist è lenta con una tabella grande | Le tabelle grandi restituiscono molti dati. Dividi la tabella o sposta il contenuto nella knowledge base. |