Vai alla navigazione
IntegrazioniGuide alla configurazionePianificazione

Hostaway

Verifica se i tuoi alloggi sono disponibili nelle date del chiamante, con prezzi per notte e soggiorni minimi.

Con lo strumento webhook qui sotto, la tua receptionist può controllare il calendario di un annuncio Hostaway per le date richieste da un chiamante e comunicargli se la baita o l’unità è disponibile, il prezzo per notte e il soggiorno minimo. L’API pubblica di Hostaway emette un token di accesso valido 24 mesi, quindi lo strumento chiama Hostaway direttamente.

La tua receptionist non può creare prenotazioni né cercare quelle esistenti. Controlla il calendario e raccoglie la richiesta di prenotazione, quindi il tuo team conferma il soggiorno dal riepilogo post-chiamata.

Prima di iniziare

1

Crea una chiave API

Nella dashboard di Hostaway, apri Settings → Hostaway API e crea una nuova chiave API. Assegnale il nome Reception.ai e scegli Hostaway Public API come partner. Copia la chiave: Hostaway la mostra una sola volta. Annota anche il tuo Account ID, mostrato nelle Settings.

2

Ottieni un token di accesso

Scambia la chiave con un token di accesso in un terminale, sostituendo ACCOUNT_ID e API_KEY:

curl -X POST 'https://api.hostaway.com/v1/accessTokens' \
  -H 'Content-type: application/x-www-form-urlencoded' \
  -d 'grant_type=client_credentials&client_id=ACCOUNT_ID&client_secret=API_KEY&scope=general'

Copia il valore access_token dalla risposta. È valido per 24 mesi.

Il token di accesso può leggere e modificare tutto nel tuo account Hostaway, inclusi i dati degli ospiti e i codici delle porte. Non incollarlo in documenti condivisi o strumenti online. Se viene divulgato, revocalo ed elimina la chiave API in Hostaway.

3

Trova gli ID dei tuoi annunci

Elenca i tuoi annunci con il token, sostituendo YOUR_TOKEN:

curl 'https://api.hostaway.com/v1/listings?limit=100' \
  -H 'Authorization: Bearer YOUR_TOKEN'

Ogni annuncio nella risposta ha un id e un name. Annota l’ID di ogni annuncio che la tua receptionist deve controllare.

Crea lo strumento

Vai a Integrazioni, seleziona Aggiungi integrazione e scegli Webhook Tool.

CampoValore
Nomecheck_hostaway_calendar
Descrizione”Verifica se uno dei nostri alloggi è disponibile nelle date del chiamante, nonché il prezzo per notte e il soggiorno minimo. Usalo prima di dire al chiamante che un alloggio è disponibile.”
MetodoGET
URLhttps://api.hostaway.com/v1/listings/{listing_id}/calendar
Header della richiestaAuthorization: Bearer seguito dal tuo token di accesso, con Tipo impostato su Secret
Parametri del pathlisting_id (stringa, obbligatorio): “Usa 11111 per la baita Cedar e 22222 per la baita Lakeside.”
Parametri della querystartDate (stringa, obbligatorio): “La data di arrivo, nel formato AAAA-MM-GG.”
endDate (stringa, obbligatorio): “L’ultima notte del soggiorno, nel formato AAAA-MM-GG.”
includeResources (stringa, valore fisso): 0
Assegna agli agentiReceptionist

Sostituisci i nomi e gli ID delle baite con i tuoi e aggiungi una riga per ogni annuncio. Seleziona Abilita.

Hostaway restituisce una voce per ogni notte. Una notte è disponibile quando status è available. Ogni notte ha anche price e minimumStay.

Mantieni includeResources fisso su 0. Con 1, Hostaway aggiunge le prenotazioni di ogni notte, inclusi nomi, numeri di telefono ed email degli ospiti, a ciò che vede la tua receptionist.

Provalo

Testa la tua receptionist chiedendo una baita in date che sai essere prenotate, poi in date che sai essere disponibili. Confronta le risposte con il tuo calendario Hostaway.

Aggiungi una procedura per le richieste di soggiorno: chiedi l’alloggio, le date di arrivo e partenza e il numero di ospiti, controlla il calendario, poi raccogli nome, numero di telefono ed email del chiamante per il tuo team. Aggiungi una regola secondo cui la tua receptionist non promette mai che un soggiorno sia prenotato.

Limitazioni

  • La tua receptionist non può creare, modificare o annullare prenotazioni. Il tuo team conferma ogni soggiorno.
  • Controlla un annuncio alla volta. Per suggerire un’altra baita, li controlla uno per uno.
  • I prezzi per notte non includono costi di pulizia, tasse o sconti, quindi la tua receptionist deve comunicarli solo come indicazione.
  • Lo strumento non cerca prenotazioni esistenti. I record di prenotazioni e annunci di Hostaway includono codici delle porte e password Wi-Fi, quindi questa guida non li mette a disposizione della tua receptionist. L’app Hostaway di Zapier restituisce gli stessi record e non include azioni di prenotazione o disponibilità.
  • Il token di accesso smette di funzionare dopo 24 mesi. Creane uno nuovo e aggiorna l’header prima di allora.

Risoluzione dei problemi

ProblemaCosa verificare
401 o 403 da HostawayIl valore dell’header deve essere Bearer, uno spazio e il token di accesso, non la chiave API. Verifica che non sia scaduto.
Viene controllata la baita sbagliataVerifica che gli ID degli annunci nella descrizione di listing_id corrispondano ai tuoi annunci.
Una notte prenotata risulta disponibileControlla il calendario in Hostaway. Le notti bloccate e prenotate hanno un valore status diverso da available.
La receptionist propone un soggiorno troppo breveIndicale nella descrizione dello strumento di controllare minimumStay nella notte di arrivo.