L'integrazione di Notion per Botpress Studio consente di eseguire le seguenti operazioni: ## Migrare dalla versione `0.x` o `1.x` alla `2.x`. La versione `2.0` dell'integrazione Notion aggiunge il supporto OAuth, che ora è l'opzione di configurazione predefinita. Se in precedenza si è creata un'integrazione Notion nel portale degli sviluppatori Notion e si desidera continuare a utilizzare questa integrazione, selezionare l'opzione di configurazione manuale e seguire le istruzioni riportate di seguito. Altrimenti, selezionare l'opzione di configurazione automatica e fare clic sul pulsante di autorizzazione, quindi seguire le istruzioni su schermo per collegare il chatbot Botpress a Notion. ## Configurazione ### Configurazione automatica con OAuth (consigliata) Questo è il modo più semplice per configurare l'integrazione. Per configurare l'integrazione con Notion utilizzando OAuth, fare clic sul pulsante di autorizzazione e seguire le istruzioni sullo schermo per collegare il chatbot Botpress a Notion. Questo metodo è consigliato perché semplifica il processo di configurazione e garantisce una comunicazione sicura tra il chatbot e Notion. Quando si utilizza questa modalità di configurazione, un'applicazione Notion Botpress verrà utilizzata per connettersi al proprio account Notion . Le azioni intraprese dal bot saranno attribuite a questa applicazione e non all'account Notion personale. ### Configurazione manuale con un'integrazione Notion personalizzata #### Passo 1 - Creare l'integrazione Creare un'integrazione Notion [Creare un'integrazione - Sviluppatori Notion ]notion #### Passo 2 - Dare accesso alle risorse Notion Dare alla propria integrazione l'accesso a tutte le pagine e i database che si desidera utilizzare con Botpress #### Passo 3 - Configurare il Bot Date alla vostra integrazione l'accesso a tutte le pagine e i database che volete utilizzare con Botpress. [Condividi un database con la tua integrazione - Sviluppatori Notion ]notion È necessario un token per far sì che la Notion Integration appena creata _(non è la stessa Notion Integration di Botpress Studio)_ si colleghi a Botpress Studio: - `Auth Token` - Lo si trova andando alla propria integrazione sotto notion. Una volta cliccato sulla vostra integrazione, andate alla sezione "Segreti" e trovate il campo "Segreto interno all'integrazione". Fare clic su "Mostra" e poi su "Copia". Incollare il token copiato nel campo `Auth Token` dell'integrazione Notion nella scheda "Integrazioni" del bot. A questo punto è sufficiente abilitare l'integrazione e si può iniziare a espandere le capacità del bot con Notion. ## Utilizzo Le azioni seguenti richiedono la conoscenza degli id delle entità Notion con cui il bot lavorerà. Tutte le entità notion (pagine, database, ecc.) hanno un id che si può trovare nell'URL quando si visitano nel proprio account Notion in un browser, oppure ottenendo il link facendo clic sulla voce "Copia link" nel menu (...). Per ulteriori informazioni, vedere [Ottenere l'id di un database - Sviluppatori Notion ]notion ### Aggiungere un commento a una discussione Questa azione consente di aggiungere un commento a una discussione esistente. Si usa per rispondere a un commento. ### Aggiungi un commento a una pagina Con questa azione è possibile aggiungere commenti a livello di pagina. ### Ottenere un database Consente di ottenere i dettagli di un database. È ideale da usare con l'azione `Aggiungi una pagina a un database`. Oltre alla risposta dell'API Notion ([Retreive a Database - Notion Developers]notion), questa azione restituisce anche una proprietà `structure` ottimizzata (tecnicamente una declerazione di tipo) che può essere usata come input per un task dell'intelligenza artificiale per istruirlo a generare un payload per l'aggiunta o l'aggiornamento di una pagina in un database Notion in base a un input dell'utente. ### Aggiungere una pagina a un database Questa azione dovrebbe idealmente essere usata in tandem con `Get a Database`, che restituisce la struttura del database che si può usare per istruire un [task AI]botpress a generare un payload. Per maggiori informazioni, vedere [Lavorare con i database - Sviluppatori Notion ]notion. ### Cancellare un blocco È possibile eliminare le seguenti entità: - una pagina in un database - una pagina - un blocco
Creare incredibili esperienze di agenti AI.
