Acties
      Terug naar start
      1. Help Center
      2. Pulse
      3. Acties

      Hoe gebruik je het Notion Action sjabloon?

      Dit artikel zal je begeleiden bij het gebruik van het Notion Actie sjabloon.

      Door deze template te gebruiken, kun je eenvoudig verbinding maken met je Notion-database om informatie op te halen. Deze template is vooraf ingevuld met alle noodzakelijke informatie, waardoor je naadloos gesprekken kunt automatiseren. Je zult echter zelf enkele details moeten invullen om verbinding te maken met je specifieke database. Volg de onderstaande stappen om je Notion Actie-template in te stellen.

      Let op Deze template haalt geen geschreven data uit Notion op. Alleen URL's en koppen worden opgehaald. De Notion API staat niet toe dat er geschreven data uit Notion opgehaald wordt.

      1. Toegang tot de template

      Ga in je chatbot in Pulse naar Acties. Selecteer de Notion-template. Deze template bevat vooraf ingevulde informatie die nodig is om de bestelstatus uit je Notion-database op te halen.

      2. Informatie toevoegen

      Vul de vereiste naam- en beschrijvingsvelden in. De BaseURL is al voor je ingevuld.

      • Authenticatie: Voeg je API-sleutel toe onder Token. Volg de onderstaande stappen om de API-sleutel te verkrijgen:
        • Ga naar Instellingen in Notion.
        • Klik op Verbindingen.
        • Klik op Ontwikkelen of Beheren van Integraties.
        • Klik op de knop + Nieuwe Integratie.
        • Geef je integratie een naam en selecteer optioneel een bijbehorende werkruimte.
        • Kies de volgende machtigingen:
          d31311f77dff8301ea8ffa0cd9663bccca45125dac1ab4af34d3908fd008aac6-Schermafbeelding_2024-09-25_om_10.29.38Zodra de integratie is gemaakt, krijg je een API-sleutel (ook wel een "geheim token" genoemd). Dit is je Notion API-sleutel.
           
      • Health check URL en instructie:
        • Health Check URL: Definieer een health check URL om de status van de externe server te monitoren. Deze URL controleert of de server online is.
          De Health Check URL is vergelijkbaar met de BaseURL en kan worden geconstrueerd door het health check-endpoint toe te voegen aan je base URL. Voorbeeld van een Health Check URL: https://example.com/api/v1/health_check 
        • Health Check Instructie: Voeg een instructie toe voor de chatbot om te volgen als de server niet online is. Bijvoorbeeld, je kunt de chatbot instrueren om te reageren met: "Sorry, er is iets misgegaan aan onze kant. Kan ik je ergens anders mee helpen?"

      3. Verbind verschillende pagina’s

      Elke Notion-pagina moet verbonden worden met de API om de gegevens te verzamelen. Subpagina's worden automatisch opgenomen in de verbinding. Volg de onderstaande stappen om de verschillende pagina's te verbinden:

      • Ga naar de pagina die je wilt verbinden.
      • Klik op het menu met 3 stippen in de rechterbovenhoek.
      • Scroll naar beneden naar Verbindingen.
      • Zoek Watermelon en klik op Verbinden.
      • Klik op Bevestigen om de verbinding te bevestigen.
      • Herhaal deze stappen voor alle pagina's die je wilt verbinden.

      e9c9f80f31d815b080522d24dba3415df0d16986cdc7a59b00353b06aec0f6a9-Schermafbeelding_2024-09-25_om_10.41.16

      4. Optioneel: Werk het schema bij


      De template wordt geleverd met een vooraf ingevuld schema als voorbeeld. Mogelijk heb je een ontwikkelaar nodig om het aan te passen aan jouw specifieke vereisten. Zorg ervoor dat het schema in .YML-indeling is en voldoet aan ten minste OpenAPI versie 3.0.0.

      5. Valideer je actie

      Nadat je de vereiste details en het schema hebt ingevuld:

      • Valideren: Klik op Valideren om eventuele fouten in je schema te controleren. Corrigeer eventuele problemen die worden geïdentificeerd.
      • Beschikbare Acties: Zodra het gevalideerd is, worden de beschikbare acties weergegeven.