U kunt Belbo op verschillende manieren met andere softwareproducten koppelen. Naast kant-en-klare integraties die u eenvoudig via de functielijst kunt activeren, zoals kalenders synchroniseren met Google, kunt u ook programmatisch boekingen maken en gegevens opvragen.
We onderscheiden daarbij twee soorten gegevens:
Openingstijden, diensten en beschikbaarheid van diensten en medewerkers. U kunt deze gegevens zonder sleutel via REST-API opvragen.
Kalender- en klantgegevens. Om deze op te vragen hebt u een API-sleutel nodig.
Deze maakt u aan in uw kalender onder de globale instellingen als API-toegang.
Nadat u een API-toegang hebt gemaakt, kunt u met behulp van het token verzoeken indienen. In principe bevinden alle interfaces zich onder de URL met de volgende opbouw:
https://<UwBedrijf>.belbo.com/office/api/<Naam>?token=<Token>
Webhooks
Naast het actief opvragen van gegevens kunt u in de API-functie ook webhooks instellen. Een webhook draait de richting om: uw systeem hoeft niet regelmatig te controleren of er iets nieuws is – Belbo meldt zich zelf.
Een webhook stelt u direct in in de API-functie. Voor de definitie zijn drie gegevens nodig:
Een selectievak met de API-toegangen die in uw kalender zijn gemaakt. De gekozen sleutel bepaalt met welke rechten de webhook wordt geactiveerd.
Een vrij te kiezen naam om meerdere webhooks van elkaar te onderscheiden. Deze wordt alleen intern weergegeven.
Het volledige doeladres inclusief https:// waar Belbo de gebeurtenissen naar toe stuurt. Relatieve adressen zijn niet mogelijk.
Welke gebeurtenissen activeren een webhook:
Elk verzoek draagt een gebeurtenistype (event_type). Het type bepaalt wanneer Belbo verzendt – en welke gegevens in de payload staan. Er zijn drie payload-typen: afspraak, klant en wachtlijst. Dezelfde gebeurtenissen liggen ook aan de Zapier-app ten grondslag.
| Payload | event_type | Wordt geactiveerd |
|---|---|---|
| Afspraak | new_appointment | Een afspraak is geboekt. |
new_course_booking | Een cursus is geboekt. | |
voucher_bought | Een voucher is gekocht. | |
product_bought | Een product is verkocht. | |
customer_registered | De klant heeft zich aangemeld voor de afspraak. | |
customer_checked_in | De klant is ingecheckt voor de afspraak. | |
appointment_reminder | De afspraakherindering vervalt. | |
| Klant | new_customer | Een nieuwe klant is aangemaakt. |
updated_customer | Klantgegevens zijn gewijzigd. | |
| Wachtlijst | new_waitlist | Een nieuw wachtlijstitem is ontstaan. |
Alle afspraakgerelateerde gebeurtenissen – dus ook cursus-, voucher- en productverkopen – leveren dezelfde structuur. Wat gekocht of geboekt is, staat in services:
{
"booking_id": 53429371,
"appointment_start": "2026-10-17T07:00:00+0000",
"appointment_end": "2026-10-17T07:30:00+0000",
"services": [
"Paket A (Haarschnitt & Föhnen)"
],
"gender_type": "MALE",
"first_name": "Max",
"last_name": "Mustermann",
"email": "max.mustermann@example.com",
"mobile": "123123123"
}
De tijdsaanduidingen zijn in de indeling JJJJ-MM-DD'T'uu:mm:ss+0000, services is altijd een lijst (bij meerdere geboekte diensten bevat deze meerdere items). De gebeurtenissen new_customer en updated_customer verzenden in plaats van de afspraakgegevens alleen de klantrecord, new_waitlist het wachtlijstitem.
Automatisering met Zapier
Naast direct gebruik van de API biedt Belbo ook de mogelijkheid om via een Zapier-app events van Belbo te gebruiken en geautomatiseerd verder te verwerken. Via Zapier kunt u typische gebeurtenissen abonneren en in meer dan 6.000 andere applicaties integreren, om workflows te automatiseren.
Deze gebeurtenissen zijn beschikbaar als trigger:
- nieuwe afspraakboekingen
- wachtlijstitems
- afspraakwijzigingen of -annuleringen
- nieuwe klanten of updates aan klantgegevens
Hiermee kunt u acties in andere tools triggeren:
- Verstuur e-mails of SMS
- Invoer in CRM-systemen
- Creëren van taken in projectmanagement-tools
- Synchronisatie met marketing- of reporting-tools
Zapier fungeert als brug tussen Belbo en andere systemen en maakt automatisering mogelijk zonder eigen ontwikkeling. Technisch is dit gebaseerd op zogenaamde triggers en acties, die via integraties of webhooks kunnen worden geïmplementeerd.