Widget documentatie

Een boek-knop op je eigen website in een paar minuten

Een lichte JavaScript-loader (~5 KB) die op elke website werkt. Vier modes, volledige branding-controle en geen impact op de laadsnelheid van je site.

Werkt op elke website
5 KB script, async geladen
Geen iframe-tracking
Live styling-updates
Quick start

Werkend in drie stappen

Geen developer nodig. De code wordt automatisch gegenereerd als je een widget aanmaakt; je hoeft hem alleen op je website te plakken.

1

Maak een API-sleutel

Eén keer per website: een sleutel koppelt je SalonBird-account aan je domein. Te vinden onder Instellingen, tabblad Widget.

2

Kopieer de code

Per widget krijg je een script-tag plus eventueel een button-snippet. Kopieer met één klik.

3

Plak op je website

Het script gaat in de site-header (één keer per site). Klant klikt, widget opent, klaar.

Meteen aan de slag?

Open je widget-instellingen, kies een mode en kopieer de code. Je bent in twee minuten live.

Open instellingen
De vier modes

Kies de stijl die bij je website past

Elke mode start dezelfde boek-flow, maar gedraagt zich anders op je site. Je kunt meerdere modes tegelijk gebruiken.

Badge

Floating boek-knop

Een vaste knop rechtsonder (of in een andere hoek) op elke pagina van je site. Klant klikt, modal opent met de boek-flow. Geen extra HTML nodig, alleen het script in je header.

Gebruik voor: Aanbevolen voor de meeste salons. Maximale zichtbaarheid op elke pagina.

Popup

Knop op specifieke plekken

Plaats een Boek nu-knop precies waar jij wilt: in je menu, naast een dienst-omschrijving, onderaan een blogpost. Klant klikt, modal opent. Volledig stylebaar.

Gebruik voor: Salons met een eigen design-systeem die zelf bepalen waar de knop staat.

Inline

Boek-formulier in de pagina

Het volledige boek-formulier wordt direct in je pagina ingebed, geen popup. Past zich aan de breedte van de container aan.

Gebruik voor: Een dedicated boekingspagina op je site (bijvoorbeeld /afspraak).

Link

Pure hyperlink

Een gewone HTML-link, geen JavaScript. Werkt overal: in een menu, e-mail-handtekening, Instagram-bio, QR-code op een flyer.

Gebruik voor: Plekken waar geen JavaScript kan, of voor links buiten je eigen site.
Platform-gidsen

Stappen voor jouw website-platform

Klik op je platform om de exacte stappen te zien. Voor de meeste platforms ben je in minder dan twee minuten klaar.

  1. 1Installeer de gratis plugin WPCode (of Insert Headers and Footers).
  2. 2Open Code Snippets, ga naar Header & Footer.
  3. 3Plak de SalonBird scriptcode in het Body-vak en klik Opslaan.
  4. 4Voor een knop op een specifieke pagina: gebruik een Custom HTML-block en plak het button-snippet.
Werkt op alle WordPress-themes. Je hoeft je theme niet te bewerken, dus theme-updates breken niets.
Branding

Past automatisch bij je huisstijl

Stel het één keer in, geldt voor alle widgets. Wijzigingen zijn binnen ongeveer 5 minuten zichtbaar zonder dat je iets hoeft te updaten op je website.

Hoofdkleur

Eén kleur voor alle accenten: knoppen, focus-state, geselecteerde tijdsloten. Pak je primaire merkkleur.

Hoek-radius

Van scherp (0px) tot pill-vormig. Knoppen, kaarten en input-velden volgen automatisch.

Live preview

Zie meteen hoe wijzigingen eruit zien voordat je opslaat. Geen rare verrassingen voor je klanten.

Per-widget overrides

Wil je voor één campagne een afwijkende kleur of positie? Override per widget zonder de basis te raken.

Deep-linking

Stuur klanten direct naar de juiste stap

Voeg URL-parameters toe om de boek-flow voor te bereiden: dienst, medewerker, datum of zelfs branding. Werkt voor alle vier de modes.

?service=Pre-selecteer een dienst op slug. Klant slaat de keuze-stap over.
?staff=Pre-selecteer een medewerker. Bij solo-salons gaat dit automatisch.
?date=Open op een specifieke dag (formaat YYYY-MM-DD). Handig voor evenementen of last-minute-slots.
?color=Override de hoofdkleur per link. Gebruik bijvoorbeeld voor seizoenscampagnes.
?radius=Override de hoek-radius (in pixels). Match een specifieke landingspagina.
?lang=Forceer een taal (nl of en) als je tweetalige klanten hebt.
Voorbeeld
https://widget.salonbird.com/jouw-salon
  ?service=knippen-volwassenen
  &staff=lisa
  &date=2026-05-20
  &color=%23E91E63
Security en analytics

Veilig op je domein, transparant in de cijfers

API-sleutels zijn gekoppeld aan je domein, sleutels roteer je zonder downtime, en alle activiteit wordt zichtbaar in je dashboard.

API-sleutels per domein

Elke sleutel is gekoppeld aan een vaste lijst domeinen. Wordt de sleutel gestolen, dan werkt hij nergens anders.

Domein-whitelist

Alleen pagina's op de toegestane domeinen kunnen de widget laden. Lokale dev-omgevingen krijgen een 24-uurs grace-period.

Sleutel rotatie

Roteer een sleutel met één klik. De oude blijft 7 dagen werken zodat je tijd hebt om sites te updaten.

Privacy-vriendelijk

Geen cookies, geen tracking-pixels. IP-adressen worden gehasht met dagelijks roterend salt.

Volledige funnel-analytics

Zie precies waar klanten afhaken: van eerste view tot bevestigde betaling. Per widget en per domein.

WIDGET_LOADEDWIDGET_OPENEDSERVICE_SELECTEDSTAFF_SELECTEDDATETIME_SELECTEDBOOKING_STARTEDBOOKING_CONFIRMED
Veelgestelde vragen

Wat klanten vaak vragen

Vind je het antwoord niet? Neem contact op met support, we reageren meestal binnen 24 uur.

Nee. De loader is ongeveer 5 KB en wordt asynchroon geladen, dus je site rendert eerst. We meten geen meetbare impact op LCP of FID.

Ja, automatisch. De widget is volledig responsive en werkt op telefoons en tablets, zelfs met de native iOS/Android-keyboards.

Ja. Wijzigingen aan kleur, radius en positie worden binnen ongeveer 5 minuten live op alle sites met je widget. Je hoeft de plakcode op je website nooit meer te updaten.

De widget blijft werken. Het is een onafhankelijk script, je kunt vrij refactoren zonder de widget aan te raken. Wijzig je domein? Voeg het nieuwe domein toe aan de sleutel.

Ja. Bijvoorbeeld een Badge op alle pagina's plus een Inline-formulier op /afspraak. Of een aparte Popup-knop voor je premium-diensten met een eigen kleur.

Ja. We detecteren de context automatisch en passen het gedrag aan (bijvoorbeeld Stripe Checkout opent in de top-window in plaats van in de iframe).

Sleutel maken plus code plakken plus eventueel publiceren: ongeveer 2 minuten op WordPress, Wix en Squarespace. Webflow en Shopify nemen iets meer omdat je site moet republiceren.

Iedere widget-instellingen-pagina heeft een E-mail naar webdesigner-knop met een kant-en-klare instructie. Of stuur ons een ticket via support, we kijken graag mee.

SalonBird
SalonBird

Klaar om je boek-knop live te zetten?

Open je dashboard, maak een widget aan en kopieer de code. Geen technische kennis nodig.

Open dashboard

Geen creditcard nodig · Altijd opzegbaar