> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Hostaway Con lo [strumento webhook](/docs/it/reception-ai/integrations/webhooks) 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. > **Note** > > 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](/docs/it/reception-ai/features/notifications). ## Prima di iniziare ### 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**. ### Ottieni un token di accesso Scambia la chiave con un token di accesso in un terminale, sostituendo `ACCOUNT_ID` e `API_KEY`: ```bash 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. > **Warning** > > 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. ### Trova gli ID dei tuoi annunci Elenca i tuoi annunci con il token, sostituendo `YOUR_TOKEN`: ```bash 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**. | Campo | Valore | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Nome** | `check_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." | | **Metodo** | GET | | **URL** | `https://api.hostaway.com/v1/listings/{listing_id}/calendar` | | **Header della richiesta** | `Authorization`: `Bearer ` seguito dal tuo token di accesso, con **Tipo** impostato su **Secret** | | **Parametri del path** | `listing_id` (stringa, obbligatorio): "Usa `11111` per la baita Cedar e `22222` per la baita Lakeside." | | **Parametri della query** | `startDate` (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 agenti** | **Receptionist** | 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`. > **Warning** > > 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](/docs/it/reception-ai/receptionist/testing) chiedendo una baita in date che sai essere prenotate, poi in date che sai essere disponibili. Confronta le risposte con il tuo calendario Hostaway. > **Tip** > > Aggiungi una [procedura](/docs/it/reception-ai/receptionist/rules-and-procedures) 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 | Problema | Cosa verificare | | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | 401 o 403 da Hostaway | Il 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 sbagliata | Verifica che gli ID degli annunci nella descrizione di `listing_id` corrispondano ai tuoi annunci. | | Una notte prenotata risulta disponibile | Controlla il calendario in Hostaway. Le notti bloccate e prenotate hanno un valore `status` diverso da `available`. | | La receptionist propone un soggiorno troppo breve | Indicale nella descrizione dello strumento di controllare `minimumStay` nella notte di arrivo. |