Vai al contenuto principale
Accedi
English (US) Español Français
Menu

Utilizzo dei Webhook di Hostaway

Robert
  • Aggiornato

Webhooks

  • Il webhook è uno strumento potente per far sì che il software Hostaway invii dati di prenotazione a fornitori di software di terze parti con supporto webhook
  • Quando configuri il webhook per il tuo software di terze parti, alcuni richiederanno un esempio dei dati di prenotazione per completare la configurazione. Puoi creare il webhook in Hostaway e impostare l'URL in questo software di terze parti
  • Dopo di ciò, puoi effettuare una prenotazione diretta "fittizia" in Hostaway nel menu delle prenotazioni. Questo invierà i dati circa 5-10 minuti dopo al terzo per completare la configurazione
  • Per testare i webhooks e come appaiono nel payload puoi utilizzare questo sito web.

 

Webhook Unificato

Prima del 1° aprile 2022, avevamo due webhooks - uno per le prenotazioni e un altro per i messaggi degli ospiti. Abbiamo rilasciato una nuova versione nota come webhook unificato che presenta i seguenti vantaggi:

  1. È necessario iscriversi a un solo webhook per ricevere aggiornamenti.

  2. Il webhook unificato attiva più eventi rispetto al precedente webhook delle prenotazioni.

 

Il webhook unificato si attiverà nei seguenti casi

  1. Messaggio ricevuto dall'ospite

    • I webhooks di messaggistica vengono attivati solo per i messaggi degli ospiti, non per i messaggi degli host

  2. Stato della prenotazione cambiato (Nuovo, Modificato, Annullato, ecc.)

  3. Stato del pagamento cambiato. Gli addebiti pagati che non aggiornano lo stato del pagamento non attivano il webhook. Se l'addebito cambia lo stato del pagamento (ad es. da non pagato a parzialmente pagato, o da parzialmente pagato a pagato) il webhook viene attivato

  4. Date/ore della prenotazione cambiate

  5. Prezzo totale cambiato

  6. Codice della porta cambiato

 

Se le seguenti condizioni non sono soddisfatte, il webhook non funzionerà

Hostaway controlla 4 cose negli URL quando aggiungi/aggiorni l'URL dei webhooks unificati in questo ordine:

  1. Se l'URL è valido. I vincoli sono qui
  2. Se l'host dell'URL è in una rete interna per motivi di sicurezza, per prevenire l'accesso a qualsiasi applicazione interna
  3. Se lo schema dell'URL è uno di questi schemi supportati:
    1. HTTP
    2. HTTPS (consigliato)
  4. Se la porta (se fornita) dell'URL è una di queste porte supportate:
    80 (porta http predefinita)
    443 (porta https predefinita)

 

Utilizzo del webhook unificato

  1. Accedi come proprietario dell'account amministratore al tuo Dashboard Hostaway
  2. Vai al menu impostazioni > Integrazioni
  3. Aggiungi l'URL del Webhook per il webhook che deve essere indirizzato.
  4. Opzionalmente seleziona annunci, canali, e se necessario proteggili con un nome utente e una password

mceclip0.png

 

Note importanti da considerare:

  • Il webhook si attiverà non appena i dati più rilevanti saranno pronti; in alcuni casi, potresti notare che campi complessi e dati che arrivano successivamente non sono forniti in quel momento. Continuiamo a migliorare il webhook per fornire più dati nei payload nel tempo.
  • Quando si utilizzano i webhook universali in combinazione con l'API pubblica, considera di chiamare l'API successivamente per recuperare i dettagli aggiornati non inclusi nel webhook dove necessario.
  • Abbiamo in programma di rilasciare un endpoint API pubblico per creare e aggiornare la creazione di webhook entro la fine del 2022.

Da deprecare durante l'anno 2024:

  • Al momento Hostaway supporta anche le 2 versioni più vecchie dei webhook nei moduli specifici per le prenotazioni e specifici per i messaggi, così come nella documentazione API
  • Questi sistemi di webhook sono programmati per essere rimossi nel 2024, quando a tutti i clienti verrà chiesto di migrare al nuovo sistema di webhook universale
  • Raccomandiamo di iniziare a utilizzare il sistema di webhook universale in qualsiasi nuova applicazione costruita o connessa.


Cosa fare quando ricevi una notifica di errore di un webhook:

1. Vai su "Impostazioni > Integrazioni", scorri la pagina fino alla sezione webhook e clicca su "Log":


2. Clicca sul pulsante per esportare il CSV

3. Apri il file CSV sul tuo computer e filtra per ID Oggetto (che è l'ID della prenotazione) e verifica cosa è indicato nel campo "Corpo della risposta".
Se tutto va bene, dirà "200", altrimenti è un errore fornito dal software di terze parti che stai integrando tramite webhook e dovrai contattare il software di terze parti per chiedere perché si è verificato tale errore

Articoli correlati