Nextcloud-gebeurtenissen die automatiseringen starten
· Door Bee Flow · 3 min. lezen
Een nieuw bestand, een tag, een gewijzigde afspraak of een ingevuld formulier kan in Bee Flow een automatisering starten. Welke gebeurtenissen er zijn, wat ze meesturen, wat Nextcloud nodig heeft, en drie verzonnen voorbeelden.

De meeste automatiseringen starten op een vast tijdstip. Elke ochtend om negen uur kijken wat er veranderd is. Dat werkt, maar je wacht, en er wordt veel gelezen dat niet veranderd is. Draait Bee Flow via de Bee Flow-app in Nextcloud, dan kan Nextcloud zelf melden dat er iets gebeurd is.
Daar gaat dit stuk over. Wat de assistent in Nextcloud doet als je hem direct iets vraagt, staat in een eerder stuk.
Welke gebeurtenissen er zijn
Zodra een beheerder Bee Flow heeft verbonden, meldt de connector zich in Nextcloud aan voor deze gebeurtenissen:
- Bestanden en mappen: aangemaakt, gewijzigd, hernoemd, gekopieerd, verwijderd, en teruggezet als je Nextcloud die gebeurtenis kent.
- Tags: een tag op een bestand gezet of er weer afgehaald.
- Agenda: een afspraak aangemaakt, gewijzigd, verplaatst of verwijderd.
- Formulieren: een ingevuld formulier, als de app Formulieren geïnstalleerd is.
- Tables: een rij toegevoegd, gewijzigd of verwijderd, als Tables geïnstalleerd is.
- Deck: een kaart aangemaakt, gewijzigd of verwijderd, als Deck geïnstalleerd is.
Elk daarvan kan de trigger zijn van een automatisering die je in Bee Flow bouwt. Gebruikers en groepen komen op een andere manier binnen, via de gewone synchronisatie.
Wat een gebeurtenis meestuurt
Minder dan je misschien denkt, en dat is met opzet. Een bestandsgebeurtenis bevat het id en het pad van het bestand, of het om een bestand of een map gaat, en wie het deed. Een agendagebeurtenis bevat de kenmerken van de afspraak en de agenda, de eigenaar en met wie de agenda gedeeld is. Titel, tijd en tekst zitten er niet in. Bij een ingevuld formulier zie je welk formulier het is en wie het invulde, maar niet de antwoorden. Rijen uit Tables en Deck-kaarten komen wel met hun waarden binnen.
Heeft een automatisering meer nodig, dan haalt een stap dat op, als de gebruiker en met diens rechten.
Drie voorbeelden
Deze zijn verzonnen, om te laten zien hoe het eruitziet.
Facturen in een map
Een klein kantoor heeft een gedeelde map Inkoop/Binnen. Elke nieuwe pdf daarin start een automatisering. Een AI-stap leest leverancier, factuurnummer, bedrag en vervaldatum. Die waarden komen als rij in Nextcloud Tables, en de pdf gaat naar Inkoop/2026. Kan de stap het bedrag niet lezen, dan blijft het bestand staan en krijgt de boekhouder een bericht in Talk met een link ernaartoe.
Een tag als schakelaar
Een projectteam zet in Bestanden de tag review op een contract. Een eerste stap controleert of het echt die tag is, zodat andere tags niets doen. Daarna leest de automatisering het document, zet er een samenvatting van één pagina met voorwaarden en termijnen naast, en maakt een Deck-kaart op het bord van het team met die samenvatting als beschrijving.
Een formulier voor aanvragen
Een intern formulier om apparatuur aan te vragen. Elke inzending start een automatisering die de antwoorden ophaalt, het gevraagde apparaat opzoekt in een tabel met wat er op voorraad is, en de aanvraag in het Talk-gesprek van de IT-afdeling zet, met een voorstel voor een antwoord.
Wat je Nextcloud nodig heeft
De gebeurtenissen lopen via de app Webhook Listeners van Nextcloud. Die zit standaard bij Nextcloud, maar staat uit:
sudo -u www-data php occ app:enable webhook_listeners
De connector meldt zijn abonnementen binnen een minuut aan. Met occ webhook_listeners:list zie je daarna regels met de uri /hooks/nextcloud.
Nextcloud verstuurt deze meldingen vanuit achtergrondtaken. Met het standaardinterval van cron kan een gebeurtenis tot vijf minuten onderweg zijn. Voor facturen maakt dat weinig uit. Voor iets waar iemand op zit te wachten wel. Met aparte workers gaat het binnen seconden:
sudo -E -u www-data php occ background-job:worker -v -t 60 \
"OCA\WebhookListeners\BackgroundJobs\WebhookCall"
Voor een vaste opzet draai je er een paar als systemd-service. In de documentatie van Nextcloud over Webhook Listeners staat een voorbeeld.
Nextcloud levert de meldingen via AppAPI af bij de connector. Je Nextcloud hoeft zijn eigen publieke adres dus niet te kunnen bereiken. Triggers voor Formulieren en Tables verschijnen pas als die apps geïnstalleerd zijn.
Waar je ze bouwt
Automatiseringen maak je in de automatiseringsbouwer van Bee Flow. Kies de Nextcloud-gebeurtenis als trigger en zet er stappen achter. Voordat je een automatisering aanzet, draai je een test. Tijdens die test wordt er niets verstuurd of weggeschreven. Automatiseringen bouwen voor eigen gebruik zit in elke licentie. Wat er nodig is om ze met je team te delen, zie je op de prijspagina.
Werkt jullie opzet anders dan hier beschreven, vertel het ons.