Voer aangepaste code uit met Workers (bèta)

Notion Workers maken deel uit van ons Ontwikkelaarsplatform. Ze voeren aangepaste code uit op de infrastructuur van Notion om het volgende aan te sturen:

• Databasesynchronisatie

• Tools voor Aangepaste agenten

• Webhook-triggers

• Workers zijn beschikbaar voor Business- en Enterprise-abonnementen.

• Standaard zijn Workers ingeschakeld voor de workspace (alleen voor eigenaren).

• Workspace-eigenaren kunnen:

  • Beperk het maken van Workers tot eigenaren.

  • Sta specifieke leden of groepen toe om Workers te maken.

  • Schakel Workers uit voor de workspace.

• Als je een Worker probeert te implementeren of te beheren, volg je doorgaans onze ontwikkelaarsdocumentatie en gebruik je de Notion CLI.

• Je kunt de ontwikkelaarsmodus inschakelen om Workers in Notion te bekijken, log te lezen en Workers uit te schakelen of te verwijderen. Gebruik de Notion CLI of de coderingstool van je team om een Worker te implementeren of de code of configuratie ervan te wijzigen. Meer informatie over ontwikkelaarsmodus →

Zie dit artikel voor meer informatie over prijzen voor Workers.

Een gesynchroniseerde database (aangedreven door Workers) haalt informatie uit externe tools naar een Notion-database en houdt deze automatisch up-to-date. Zodra deze is ingesteld, blijft de gesynchroniseerde database vanzelf actueel, zodat je team en je agenten altijd de nieuwste gegevens ziet zonder dat iemand hoeft te kopiëren en plakken tussen tools.

Een paar veelvoorkomende voorbeelden:

• Synchroniseer Zendesk-supporttickets naar een gesynchroniseerde database voor triage.

• Synchroniseer Salesforce-accounts naar een pipeline-tracker.

• Synchroniseer gegevens vanuit een interne tool of database.

Zodra deze live is, gedraagt de gesynchroniseerde database zich als elke andere database in Notion. Toegang wordt beheerd via je standaard Notion-deelrechten.

Agent-tools (aangedreven door Workers) breiden de mogelijkheden van je Aangepaste agenten uit tot voorbij de ingebouwde Acties en MCP van Notion, met functies die zijn afgestemd op hoe je team werkt.

Een paar veelvoorkomende voorbeelden:

• Een datawarehouse bevragen.

• Assets genereren vanuit een Notion-document.

• Actie ondernemen in een andere app die niet standaard wordt ondersteund of beschikbaar is via MCP.

Webhook-triggers (aangedreven door Workers) laten een gebeurtenis in een andere tool een workflow in Notion of een ander gekoppeld systeem starten.

Een paar veelvoorkomende voorbeelden:

• Een taak sluiten wanneer een Pull Request wordt samengevoegd.

• Een CRM-record bijwerken wanneer een abonnement wijzigt.

• Een onboarding-document maken wanneer een aanbod is ondertekend.

Zodra dit is ingesteld, wordt de workflow automatisch uitgevoerd telkens wanneer de gebeurtenis plaatsvindt, zodat je team niet handmatig informatie tussen tools hoeft te verplaatsen.

Met Developer Mode kun je Workers openen vanuit het gedeelte voor ontwikkelaars in je zijbalk. Gebruik deze weergave voor snelle controles en basisacties. In Notion kun je:

• Alle Workers in één lijst bekijken.

• Een Worker openen en Overzicht, logs, omgevingsvariabelen en instellingen bekijken.

• Worker logs lezen.

• Een Worker uitschakelen of verwijderen.

Gebruik de Notion CLI of de coderingstool van je team om een Worker te implementeren of de code of configuratie ervan te wijzigen.

Standaard kan alleen de persoon die een Worker heeft gemaakt deze wijzigen en toevoegen als een nieuwe verbinding. Deel een Worker met teamgenoten zodat zij deze kunnen koppelen aan een Aangepaste agent of kunnen helpen bij het beheer.

Meer informatie over het delen van een Worker →

Probeer deze stappen in volgorde:

1. Zorg ervoor dat je workspace in aanmerking komt en dat een workspace-eigenaar Workers heeft ingeschakeld. Workers zijn beschikbaar op Business- en Enterprise-abonnementen en vereisen inschakeling door een workspace-beheerder.

2. Bevestig dat je het beoogde installatiepad gebruikt. Voor de meeste installaties gebruik je de Notion CLI plus de ontwikkelaarsdocumentatie.

3. Als de implementatie van je Worker mislukt, controleer dan daarna de machtigingen. Mogelijk heb je geen toegang om te implementeren in die workspace, zelfs als je pagina's erin kunt bekijken.

4. Als je Worker wordt uitgevoerd maar niets verandert in Notion, test de Actie dan eerst handmatig. Als je dezelfde wijziging niet in Notion kunt doorvoeren, is het meestal een probleem met machtigingen of workspace-instellingen.

5. Als de kosten hoger uitvallen dan verwacht, verlaag dan de uitvoeringsfrequentie. Workers die vaker worden uitgevoerd, kosten meer. Begin met een langzamer schema en verhoog dit zodra je er zeker van bent dat het werkt.

6. Nog steeds vastgelopen? Volg de ontwikkelaarsdocumentatie voor de specifieke foutmelding. Daar vind je de meest accurate oplossing.