Widgets en embeds
Widgets zijn publieksgerichte uitbreidingen van Checkmate. Je gebruikt ze om bezoekers op je website of in een gastomgeving extra hulp, informatie, feedbackmogelijkheden, aanbiedingen of social proof te geven.
Het widgetoverzicht in Manager. De zichtbare widgets hangen af van je pakket en de modules die voor je organisatie zijn ingeschakeld.
Wanneer gebruik je een widget?
Begin bij het doel dat je op je website wilt bereiken:
- service of support: gebruik een chat- of conciergewidget
- meer directe boekingen: gebruik een offer-, upsell- of bookingwidget
- meer vertrouwen: gebruik reviews of social proof
- betere feedback: gebruik een feedbackwidget
- meer inspiratie: gebruik lokale tips, events of activiteiten
Beschikbare widgettypes
| Widget | Gebruik | Typische plek op de website |
|---|---|---|
| WebConcierge Agent | AI-chat voor vragen, support en lead capture | elke pagina, vaak rechtsonder |
| Live Offer Banner | Tijdelijke aanbiedingen en directe conversie | homepage, kamers, bookingpagina |
| Event & Local Tips Feed | Lokale tips en activiteiten | locatiepagina, gastportal, pre-arrival |
| Instant Review Summary | Reviewcontext en social proof | homepage, kamerpagina, checkout |
| Group Booking Estimator | Leads voor groepen en events | groups, meetings, weddings |
| Feedback Pulse | Korte feedback over de digitale reis | bookingflow, supportpagina, gastportal |
| Upsell Recommender | Aanbevolen add-ons of services | bookingflow, bevestiging, pre-arrival |
Sommige widgets zijn direct configureerbaar. Andere widgets worden pas zichtbaar of bruikbaar nadat ze voor je organisatie zijn geactiveerd.
Configureren in Manager
- Open Checkmate Manager.
- Ga naar Widgets in de linkernavigatie.
- Kies de widget die je wilt instellen.
- Selecteer de juiste venue als je organisatie meerdere locaties heeft.
- Pas de inhoud, weergave en instellingen aan.
- Controleer de live preview in hetzelfde scherm.
- Kies Save draft om op te slaan of Publish wanneer de widget live mag.
De preview is bedoeld om snel te controleren of tekst, kleur, positie en gedrag logisch zijn. Test de widget daarna altijd ook op een staging- of testpagina van je eigen website.
Embedcode plaatsen op je website
Voor widgets die als website-embed beschikbaar zijn, toont Manager een embedcode of installatie-instructie. Kopieer altijd de code uit Manager, omdat daarin je actuele venue, configuratie en beveiligingsinstellingen verwerkt zijn.
Plaats de code meestal vlak voor de sluitende </body> tag van je website. Gebruik je een CMS of tag manager, plaats de code dan in het globale template of in een tag die alleen op de gewenste pagina's actief is.
Een voorbeeld van hoe een WebConcierge-installatie eruit kan zien:
<!-- Checkmate WebConcierge Widget -->
<script>
(function (w, d, s, o, f, js, fjs) {
w['CheckmateWebConcierge'] = o;
w[o] =
w[o] ||
function () {
(w[o].q = w[o].q || []).push(arguments);
};
js = d.createElement(s);
fjs = d.getElementsByTagName(s)[0];
js.id = o;
js.src = f;
js.async = 1;
fjs.parentNode.insertBefore(js, fjs);
})(
window,
document,
'script',
'checkmate',
'SCRIPT_URL_FROM_MANAGER'
);
checkmate('init', {
venueId: 'YOUR_VENUE_ID',
apiKey: 'YOUR_WIDGET_API_KEY',
position: 'bottom-right',
primaryColor: '#2563eb',
welcomeMessage: 'Hello! How can I help you today?',
language: 'en-US',
collectLeads: true,
trackAnalytics: true,
showBranding: true,
});
</script>
Gebruik dit voorbeeld alleen als referentie. De exacte code uit Manager is leidend.
Belangrijke instellingen
| Instelling | Wat betekent dit? |
|---|---|
| Venue | De locatie waarvoor de widget content, antwoorden of aanbiedingen toont. |
| Status | Draft is opgeslagen maar niet live; published is bedoeld voor gebruik op je website. |
| Position | Waar de widget verschijnt, bijvoorbeeld rechtsonder of als banner bovenaan. |
| Primary color | De hoofdkleur van de widget. Kies een kleur die past bij je hotelwebsite. |
| Welcome message / headline | De eerste tekst die bezoekers zien. Maak deze kort en concreet. |
| Lead capture | Of de widget contactgegevens of aanvragen mag verzamelen. |
| Analytics tracking | Of interacties gebruikt mogen worden voor rapportage en optimalisatie. |
| Allowed domains | Welke websitedomeinen de widget mogen laden, als domeinrestricties zijn ingesteld. |
Testen voordat je live gaat
Controleer minimaal:
- de widget verschijnt op desktop en mobiel
- de positie blokkeert geen boekingsknop, cookie banner of chat van een andere leverancier
- kleuren en contrast passen bij je website
- teksten zijn correct in de gewenste taal
- links en call-to-actions openen de juiste pagina
- lead capture of formulieren komen goed binnen bij het team
- analytics of conversiemeting werkt zoals afgesproken
- de widget staat alleen op pagina's waar je hem wilt tonen
Veilig en netjes implementeren
- Deel API keys of embedcodes niet in openbare tickets, screenshots of documentatie.
- Plaats per pagina maar een widget-instantie van hetzelfde type.
- Test wijzigingen eerst als draft of op staging voordat je ze publiceert.
- Gebruik domeinrestricties wanneer je widget met een API key werkt.
- Stem tracking en lead capture af op je eigen privacy- en cookiebeleid.
- Verwijder oude of handmatig aangepaste embedcodes wanneer je een nieuwe code uit Manager plaatst.
Veelvoorkomende problemen
| Probleem | Controleer dit eerst |
|---|---|
| De widget verschijnt niet | Is de widget gepubliceerd, staat de code op de juiste pagina en is het juiste domein toegestaan? |
| De widget toont oude tekst | Is de nieuwste configuratie gepubliceerd en is de websitecache geleegd? |
| De widget staat op de verkeerde plek | Controleer de position-instelling in Manager en eventuele CSS op je website. |
| Lead capture werkt niet | Controleer of lead capture aan staat en of het team weet waar nieuwe leads binnenkomen. |
| De widget botst met een cookie banner | Verplaats de widgetpositie of pas de paginaregels aan. |
| De chat geeft te algemene antwoorden | Vul de venue-informatie, faciliteiten, kamertypes en veelgestelde vragen vollediger in. |
Wat levert dit op?
- extra service of lead capture buiten de lobby en manageromgeving
- meer directe conversie via aanbiedingen of upsell
- betere aansluiting tussen websitebezoek en operationele opvolging
- sneller testen van nieuwe websiteboodschappen zonder een groot webproject
Praktische werkwijze
- Kies eerst het bedrijfsdoel van de widget.
- Selecteer daarna het juiste widgettype.
- Richt de widget inhoudelijk en visueel in.
- Controleer de preview in Manager.
- Plaats de embedcode op staging of een testpagina.
- Test desktop, mobiel, interacties en opvolging.
- Publiceer de widget en monitor de eerste dagen actief.
Let op
Widgets zijn gastgericht. Beheer ze daarom met dezelfde discipline als je boekingsflow, chat, e-mailtemplates en betaalpagina's. Een kleine tekst- of stylingwijziging kan zichtbaar zijn voor iedere websitebezoeker.