Met de Notion Integratie voor Botpress Studio kun je de volgende dingen doen: ## Migreren van versie `0.x` of `1.x` naar `2.x` Versie `2.0` van de Notion integratie voegt OAuth ondersteuning toe, wat nu de standaard configuratie optie is. Als je eerder een Notion integratie hebt gemaakt in de Notion developer portal en je wilt deze integratie blijven gebruiken, selecteer dan de handmatige configuratie optie en volg de instructies hieronder. Selecteer anders de automatische configuratie optie en klik op de autorisatie knop, volg dan de instructies op het scherm om je Botpress chatbot met Notion te verbinden. ## Configuratie ### Automatische configuratie met OAuth (aanbevolen) Dit is de eenvoudigste manier om de integratie in te stellen. Om de Notion integratie met OAuth in te stellen, klik je op de autorisatieknop en volg je de instructies op het scherm om je Botpress chatbot met Notion te verbinden. Deze methode wordt aanbevolen omdat het het configuratieproces vereenvoudigt en zorgt voor veilige communicatie tussen je chatbot en Notion. Wanneer je deze configuratiemodus gebruikt, wordt een Botpress Notion gebruikt om verbinding te maken met je Notion . Acties die worden uitgevoerd door de bot worden toegeschreven aan deze applicatie, niet aan uw persoonlijke Notion . ### Handmatige configuratie met een aangepaste Notion #### Stap 1 - Integratie aanmaken Maak een Notion [Maak een integratie - Notion ]notion #### Stap 2 - Geef toegang tot Notion Assets Geef je integratie toegang tot alle pagina's en databases die je wilt gebruiken met Botpress #### Stap 3 - Configureer je Bot Geef je integratie toegang tot alle pagina's en databases die je wilt gebruiken met Botpress. [Deel een database met je integratie - Notion Developers]notion Je hebt een token nodig om je nieuw aangemaakte Notion Integration _(niet hetzelfde als Botpress Studio's Notion Integration)_ te verbinden met Botpress Studio: - `Auth Token` - Je vindt dit door naar je integratie te gaan onder notion. Zodra je op je integratie klikt, ga je naar de sectie "Secrets" (Geheimen) en zoek je het veld "Internal Integration Secret" (Intern integratiegeheim). Klik op "Tonen" en dan op "Kopiëren". Plak het gekopieerde token onder `Auth Token` veld voor de Notion integratie onder de "Integrations" tab voor je bot. Nu hoeft u alleen nog maar uw integratie in te schakelen en u kunt beginnen met het uitbreiden van de mogelijkheden van uw Bot met Notion. ## Gebruik De volgende acties vereisen dat je de Ids kent van de Notion entiteiten waar je bot mee zal werken. Alle notion entiteiten (pagina's, databases, etc) hebben een id die kan worden gevonden in de URL wanneer u deze bezoekt in uw Notion account in een Browser, of door het verkrijgen van de link door te klikken op de "Kopieer Link" item in het (...) menu. Zie [Verkrijg een Database Id - Notion Ontwikkelaars]notion voor meer informatie. ### Commentaar toevoegen aan een discussie Met deze actie kun je een commentaar toevoegen aan een bestaande discussie. Gebruik dit om te antwoorden op een commentaar. ### Commentaar toevoegen aan een pagina Met deze actie kun je commentaar op paginaniveau toevoegen. ### Een database ophalen Hiermee kun je de details van een Database ophalen. Dit wordt ideaal gebruikt met de actie `Pagina toevoegen aan een database`. In aanvulling op het antwoord van de Notion API ([Een database ophalen - Notion Ontwikkelaars]notion), retourneert deze actie ook een geoptimaliseerde `structuur` eigenschap (technisch gezien een type decleratie) die kan worden gebruikt als invoer voor een AI-taak om deze te instrueren een payload te genereren voor het toevoegen of bijwerken van een pagina in een Notion Database op basis van een gebruikersinvoer. ### Pagina toevoegen aan een database Deze actie wordt idealiter gebruikt in combinatie met `Get a Database` die de structuur van de database teruggeeft die je kunt gebruiken om een [AI task]botpress te instrueren om een payload te genereren. Zie [Werken met databases - Notion Developers]notion voor meer informatie. ### Een blok verwijderen U kunt de volgende entiteiten verwijderen: - een pagina in een database - een pagina - een blok