Hoe koppel ik de AI-medehost aan Smoobu?

Gebruik je Smoobu om je vakantieverhuur te beheren? Dan kun je de Nowistay AI-medehost activeren op je advertenties, of de boekingen nu van Airbnb, Booking.com, VRBO, Expedia of een ander platform komen dat met je PMS is verbonden. Zo doe je dat, stap voor stap.

Smoobu vereist nu een API-sleutel en een secret

Smoobu heeft de beveiliging van zijn API gewijzigd. Elk verzoek moet nu worden ondertekend met een secret die samen met de API-sleutel wordt uitgegeven, en een verzoek dat alleen met de sleutel wordt verstuurd, wordt geweigerd. Dat heeft twee gevolgen:

• Nieuwe koppelingen: kopieer zowel de sleutel als de secret wanneer je ze in Smoobu aanmaakt. Nowistay vraagt om beide.
• Koppelingen van vóór deze wijziging: de sleutel die in Nowistay is opgeslagen heeft geen secret en werkt daarom niet meer. Maak een nieuwe sleutel aan in Smoobu en sla die samen met de secret op, volgens de laatste sectie van dit artikel.

Smoobu toont de secret maar één keer, in het venster dat direct na het aanmaken van de sleutel verschijnt. Als je dat venster sluit zonder de secret te kopiëren, kan die niet opnieuw worden getoond en moet je een nieuwe sleutel aanmaken.

Voordat je begint

• Een actief Smoobu-account met een betaald abonnement, waarin je accommodaties al zijn ingesteld. API-sleutels kunnen niet worden aangemaakt tijdens een gratis proefperiode.
• Je advertenties moeten in Smoobu correct gesynchroniseerd zijn met je boekingsplatforms (Airbnb, Booking.com, VRBO, Expedia).
• Een actief AI Channel Manager-abonnement op Nowistay.

Stap 1: maak je API-sleutel en secret aan in Smoobu

1. Log in op smoobu.com.
2. Ga naar Advanced settings (Geavanceerde instellingen) en daarna naar API Keys (API-sleutels).
3. Klik op Create (Aanmaken), geef de sleutel een naam en verstuur.
4. Het venster Token created toont de sleutel en de secret. Kopieer beide en bewaar ze op een veilige plek voordat je het sluit.

Laat deze Smoobu-pagina openstaan, je komt er in stap 2 op terug om de webhook-URL te plakken.

Stap 2: verbind Smoobu met Nowistay

1. Open in Nowistay de pagina Accommodaties en klik rechtsboven op PMS-integraties.

2. Zoek in de sectie Ondersteunde PMS de kaart Smoobu en klik op Verbinden met Smoobu.

3. Plak je sleutel in API-sleutel en je secret in API-secret.
4. Klik nog niet op Bevestigen. Kopieer de inhoud van het veld Webhook-URL die in Smoobu moet worden gekopieerd onderaan het venster.

5. Plak dat adres in Smoobu, op dezelfde pagina Advanced settings (Geavanceerde instellingen) en API Keys (API-sleutels), in het veld Webhook URL en klik op Save (Opslaan). Als een andere tool dat veld al gebruikt, voeg dan ons adres toe naast het bestaande adres in plaats van het te vervangen.
6. Ga terug naar Nowistay en klik op Bevestigen.

De webhook is wat Nowistay op de hoogte brengt van je nieuwe boekingen en de nieuwe berichten van je gasten. Zonder webhook lijkt de koppeling te werken, maar komt er niets binnen in je dashboard. Sla stap 5 dus niet over.

Je gegevens worden bij Smoobu gecontroleerd voordat ze worden opgeslagen. Als de sleutel of de secret niet klopt, zie je meteen de fout, in plaats van een koppeling die zogenaamd werkt maar leeg blijft.

Stap 3: koppel elke accommodatie

De connector geeft Nowistay toegang tot je Smoobu-account. Elke Nowistay-accommodatie moet nog steeds aan de juiste Smoobu-accommodatie worden gekoppeld.

1. Open op de pagina Accommodaties het menu … van een accommodatie en kies Synchronisatie.
2. Als de korte vragenlijst verschijnt, antwoord dan dat je een PMS gebruikt, dat je het wilt behouden en dat het een van de vermelde platforms is.
3. Selecteer Smoobu in het veld PMS, daarna de bijbehorende accommodatie in het veld Accommodatie, en sla op.
4. Herhaal dit voor elke accommodatie die de AI-medehost moet beheren.

Zodra een accommodatie is gekoppeld, stromen de boekingen en gastenberichten naar Nowistay en beantwoordt de AI-medehost je gasten vóór, tijdens en na hun verblijf.

Je Smoobu API-sleutel bijwerken

Gebruik dit wanneer je je sleutel vervangt, en wanneer je een koppeling vervangt die is aangemaakt voordat de secret verplicht werd.

1. Maak een nieuwe sleutel aan in Smoobu zoals beschreven in stap 1 en kopieer de sleutel en de secret.
2. Open in Nowistay Accommodaties, daarna PMS-integraties, en klik op de Smoobu-kaart op API-sleutel bijwerken.
3. Plak de nieuwe sleutel en de nieuwe secret en klik op Bevestigen.
4. Controleer of je accommodaties nog gesynchroniseerd zijn en trek daarna de oude sleutel in bij Smoobu in.

Gebruik altijd API-sleutel bijwerken in plaats van Connector opnieuw instellen. Opnieuw instellen ontkoppelt alle accommodaties die met Smoobu zijn verbonden en je zou ze één voor één opnieuw moeten koppelen.