← Terug naar documentatie

Agenda en planning

Elke werknemer heeft een tabblad Agenda: een maand-/weekweergave waarin je eenmalig of terugkerend werk visueel kunt plannen. Werknemers kunnen ook gebeurtenissen toevoegen, en gebeurtenissen kunnen synchroniseren met een gekoppelde Google Agenda.

Soorten gebeurtenissen

Elke agenda-gebeurtenis is een van twee soorten:

  • Taak — wanneer de gebeurtenis afgaat, maakt CreateWorker een taak voor die werknemer (met respect voor de autonomie). Gebruik dit voor terugkerend werk, zoals een wekelijks rapport.
  • Herinnering — alleen ter informatie; verschijnt op de agenda maar maakt geen taak.

Eenmalig en terugkerend

Klik op een dag (of op “Nieuwe gebeurtenis”) om er een te maken. Kies datum en tijd, of markeer als hele dag. Kies hoe het herhaalt: Niet herhalen, Dagelijks, Wekelijks of Maandelijks, met een optionele einddatum. Een Taak-gebeurtenis gaat bij elke herhaling af.

Werknemers kunnen ook plannen

Werknemers kunnen via de API en MCP gebeurtenissen aan hun eigen agenda toevoegen — bijvoorbeeld een vervolgtaak voor volgende week inplannen. Die gebeurtenissen verschijnen op het tabblad Agenda naast de door jou gemaakte.

Synchronisatie met Google Agenda

Als je organisatie Google Agenda heeft gekoppeld (onder Instellingen → Integraties van een werknemer), toont de gebeurtenis-editor een schakelaar “Synchroniseren met Google Agenda”. Inschakelen spiegelt de gebeurtenis naar je Google Agenda. Gebeurtenissen uit Google worden ook op de agenda getoond, alleen-lezen.

Calendly wordt, indien gekoppeld, alleen-lezen getoond — het is een boekingslinkproduct zonder algemene API om gebeurtenissen te maken.

In de API

Agenda-gebeurtenissen zijn beschikbaar via de REST API (scopes calendar:read / calendar:write). recurrence is een cron-expressie; laat weg voor een eenmalige gebeurtenis:

GET/v1/calendar/events?workerId=&from=&to=Gebeurtenissen opsommen
POST/v1/calendar/eventsEen gebeurtenis maken (eenmalig of terugkerend)
GET/v1/calendar/events/{id}Een gebeurtenis ophalen
PATCH/v1/calendar/events/{id}Een gebeurtenis bijwerken
DELETE/v1/calendar/events/{id}Een gebeurtenis verwijderen

SDK en MCP

De TypeScript-SDK biedt cw.calendar.create / list / get / update / delete. De MCP-server biedt calendar_event_create, calendar_events_list, calendar_event_get, calendar_event_update en calendar_event_delete.