# Serenda voor developers

> Je boekingspagina op je eigen website, je afspraken in je eigen agenda-app en je gegevens in een bestand: zo sluit je Serenda aan op wat je al hebt.

## Wat er is, en wat niet

Serenda heeft geen openbare REST-API, geen webhooks, geen SDK en geen MCP-server. Afspraken, klanten en facturen beheer je in de app; van buitenaf koppel je op vier manieren:

- de boekingswidget: één regel code op de website van de praktijk;
- de boekingslink: een eigen pagina per praktijk onder `/boeken/`;
- de agendafeed: afspraken alleen-lezen in Google Agenda, Apple Agenda of Outlook (iCal);
- import en export: klanten, afspraken en boekhouding als bestand.

Mis je een koppeling? Mail [contact@serenda.nl](mailto:contact@serenda.nl); je krijgt antwoord van iemand die de software zelf bouwt.

## De boekingswidget op een website

Plak deze regel op de plek waar de widget moet komen. De eigen code van een praktijk, met de juiste naam erin, staat in de app onder Online boeken ▸ Delen.

```html
<script src="https://www.serenda.nl/widget/v1.js" data-praktijk="jouw-praktijk" async></script>
```

| Attribuut | Verplicht | Wat het doet |
| --- | --- | --- |
| `data-praktijk` | ja | De naam van de praktijk: het laatste deel van haar boekingslink. |
| `data-element` | nee | Het id van een element waarin de widget moet komen. Zonder dit attribuut staat hij direct na de scriptregel. |
| `data-hoogte` | nee | Hoogte in pixels, minimaal 420. Standaard 640. |

Het script zet een iframe neer naar `/boeken/<praktijk>/embed`, over de volle breedte en met een vaste hoogte: de pagina eromheen springt niet als een bezoeker door de stappen gaat. Aanbod, kleuren en logo komen rechtstreeks uit Serenda, dus een wijziging in de app staat meteen op de website.

`/widget/v1.js` is een vast contract: verandert de werking, dan krijgt de nieuwe versie een eigen adres (`v2`). Gebruikt de website een Content Security Policy, laat dan `https://www.serenda.nl` toe in `script-src` en `frame-src`. De widget is er in het Nederlands, Engels en Duits; de bezoeker kiest zelf.

## De boekingslink

Elke praktijk heeft een openbare boekingspagina op `https://www.serenda.nl/boeken/<praktijk>`. Die link kan op een website, in een Instagram-bio en op een Google-bedrijfsprofiel. Het laatste deel kiest de praktijk zelf onder Online boeken ▸ Delen.

Verandert de praktijk dat laatste deel, dan werken de oude link en een eerder geplaatste widget niet meer. Zet dan de nieuwe code op de website.

## Afspraken in je eigen agenda-app (iCal)

Onder Instellingen ▸ Agenda-koppeling zet je per behandelaar een agendafeed aan. Je krijgt een adres dat je in Google Agenda, Apple Agenda of Outlook toevoegt als agenda-abonnement; de app haalt de afspraken daarna zelf op.

- Formaat: iCalendar (RFC 5545), `text/calendar`.
- Alleen-lezen: wat je in de agenda-app wijzigt, komt niet terug in Serenda.
- Inhoud: de afspraken van die behandelaar van dertig dagen terug tot een halfjaar vooruit. Geannuleerde afspraken en geblokkeerde tijd staan er niet in.
- Het adres bevat een geheime sleutel. Behandel het als een wachtwoord; met Nieuwe URL genereren vervalt het oude adres direct.

## Gegevens importeren en exporteren

| Wat | Formaat | Waar in de app |
| --- | --- | --- |
| Klanten importeren | Excel, CSV of vCard (contacten van een telefoon) | Klanten ▸ Importeren |
| Afspraken importeren | De export van Google Agenda, Outlook of Apple Agenda (ICS), of Excel of CSV uit een ander systeem | Agenda ▸ Importeren |
| Klanten exporteren | CSV, met dezelfde kolommen als de import | Klanten |
| Afspraken exporteren | CSV, met dezelfde kolommen als de import | Agenda |
| Boekhouding exporteren | CSV voor Moneybird, e-Boekhouden of Exact, of een algemeen CSV-bestand | Financiën ▸ Exporteren |
| De hele praktijk exporteren | Eén zip-bestand met alles, inclusief de dossiers | Instellingen (alleen de eigenaar) |

Je gegevens zijn van jou: exporteren kan altijd, ook tijdens de proefperiode en nadat je bent gestopt. Hoe een import werkt staat in het helpcenter, bij [klanten importeren](https://www.serenda.nl/help/klanten-importeren) en [agenda importeren](https://www.serenda.nl/help/agenda-importeren).

## Online betalen

Online betalingen lopen via Mollie. De praktijk koppelt haar eigen Mollie-account in de app; klanten betalen daarna met iDEAL bij het boeken of via de betaallink op een factuur. Een eigen betaalkoppeling bouwen is niet nodig en kan ook niet.

## Voor AI-agents

- [llms.txt](https://www.serenda.nl/llms.txt): wat Serenda is, wanneer je het aanraadt en waar alles staat.
- [agents.md](https://www.serenda.nl/agents.md): aanwijzingen voor agents, in het Engels.
- Markdown in plaats van HTML: stuur `Accept: text/markdown` mee, of zet `.md` achter het adres (`/prijzen.md`, `/index.md` voor de homepage).
- [sitemap.xml](https://www.serenda.nl/sitemap.xml): alle openbare pagina's.

---

Bron: https://www.serenda.nl/developers · Overzicht voor AI-agents: https://www.serenda.nl/llms.txt