Vai al contenuto

Documentazione tecnica

Collega StayParity ai tuoi sistemi: webhook firmati, il widget per le prenotazioni dirette sul sito dell’hotel e la verifica dei prezzi per i chatbot.

StayParity ti offre tre strumenti su cui costruire: i webhook, che avvisano il tuo server quando un’OTA vende a meno dell’hotel; un widget che mostra agli ospiti, sul sito dell’hotel, che prenotare direttamente conviene; e una verifica dei prezzi che dà a un chatbot o a un tuo widget la stessa risposta del widget.

Webhook

StayParity invia ogni nuova discrepanza tariffaria al tuo URL come JSON firmato: un portale nei risultati di ricerca degli hotel che vende la stessa camera dell’hotel, entrambe abbinate a una delle tipologie di camera dell’hotel, a un prezzo più basso della tariffa diretta. Usalo per aprire un ticket, avvisare il revenue manager o alimentare i tuoi report.

Gli invii seguono Standard Webhooks, quindi una libreria pronta li verifica in poche righe. Consulta Webhook per l’evento, le firme, i nuovi tentativi e i test.

Widget prenotazioni

Un solo tag <script> nella pagina di prenotazione dell’hotel mostra agli ospiti la tariffa diretta accanto ai prezzi delle OTA, quando l’hotel è il più economico o allo stesso prezzo. Quando un’OTA costa meno, mostra solo la tariffa diretta. Consulta Widget prenotazioni per il codice, i suoi attributi e cosa mostra, e Misura il widget nei tuoi strumenti di analisi per contare in GA4 le prenotazioni che porta.

Verifica dei prezzi

Una sola richiesta GET con la chiave dell’hotel restituisce in JSON la risposta del widget per una notte: la tariffa diretta dell’hotel e, quando l’hotel è il più economico o allo stesso prezzo, i prezzi delle OTA accanto. Usala per indicare la tariffa diretta in un bot WhatsApp, in un assistente di chat o in un tuo widget. Consulta l’API di verifica dei prezzi per la richiesta, le risposte e un bot di esempio.

Chiavi

I webhook e il widget hanno ciascuno la propria chiave, e la verifica dei prezzi usa quella del widget. Funzionano in modo diverso:

ChiaveFormatoDoveSegreta?
Chiave di firmawhsec_…Impostazioni → Webhook, una per accountSì. Tienila sul tuo server.
Chiave dell’hotelwk_…Impostazioni → Widget prenotazioni, una per hotel, per il widget e la verifica dei prezziNo. È nell’HTML pubblico dell’hotel.

La chiave di firma prova che un webhook arriva da StayParity. Viene mostrata una sola volta, e solo gli amministratori dell’account possono crearla o sostituirla.

La chiave dell’hotel mostra solo il widget di quell’hotel e risponde alla sua verifica dei prezzi, e nessuno dei due dice più di quanto qualsiasi ospite potrebbe vedere comunque. Chiunque può copiarla dal codice sorgente della pagina. Se per te è un problema, sostituisci il codice nell’applicazione e la vecchia chiave smette di funzionare. Il browser di un ospite può continuare a mostrare un widget caricato negli ultimi cinque minuti.

Non esiste un’API per leggere o modificare i dati dell’account. I webhook inviano al tuo server, e il widget e la verifica dei prezzi leggono lo stesso confronto pubblico. Nessuno dei tre richiede un token API.

Per strumenti e agenti

  • La verifica dei prezzi e il webhook in OpenAPI 3.1: la verifica dei prezzi sotto paths, l’evento sotto webhooks.
  • Questa documentazione in testo semplice per i modelli linguistici: llms.txt elenca le pagine, llms-full.txt le raccoglie tutte in un unico file, in inglese.
  • Ogni pagina in Markdown: aggiungi .md al suo indirizzo, come in /it/developers/webhooks.md. La panoramica è in /it/developers/index.md.

In questa pagina