Dex è l'app di audioguide di Headout, basata su tour cinematografici e narrativi con colonne sonore originali in cui i viaggiatori scelgono il proprio narratore presso luoghi come il Louvre, la Torre Eiffel, il British Museum, la Statua della Libertà, la Sagrada Família e Angkor Wat. La sua guida IA integrata risponde alle domande e riconosce le opere d'arte sul posto, in sette lingue e offline, così le attrazioni possono offrire una guida Dex insieme all'ingresso.
Collegare Dex a Ventrata ti permette di rivendere i prodotti di operatori che usano Dex come sistema di prenotazione. Ventrata legge da Dex la loro disponibilità in tempo reale e ogni prenotazione che ricevi viene creata direttamente nell'account Dex dell'operatore.
Per saperne di più su Dex, visita dex.headout.com.
‼️ IMPORTANTE
L'email è obbligatoria. Headout consegna l'audioguida Dex al cliente via email. Ogni prodotto Dex in Ventrata deve avere Email impostato come campo di contatto obbligatorio, altrimenti il cliente non riceverà la sua guida.
📒 NOTA
Se vuoi che Headout rivenda i tuoi prodotti, consulta invece l'articolo sulla connessione rivenditore di Headout.
Sito web principale | |
Tag | Custom / Proprietary Operator System |
Funzionalità della connessione | Availability Sync · Bookings Sync |
Sviluppato da | Ventrata (tramite Dex OCTO API) |
Questa connessione operatore (detta anche backend) ti permette di rivendere i prodotti di operatori che usano Dex come sistema di prenotazione principale, e ogni prenotazione viene creata direttamente in Dex. Le funzionalità di questa connessione includono:
Availability Sync – la disponibilità in tempo reale proviene dall'account Dex dell'operatore.
Bookings Sync – prenotazioni, modifiche e cancellazioni vengono inviate da Ventrata a Dex e Dex emette i biglietti o i voucher.
Creare la connessione con Dex
🔐 Autorizzazioni di ruolo richieste: See Operators, Modify Operators, See Products, Modify Products
Prima di iniziare:
Devi avere un accordo commerciale con l'operatore per le sue tariffe e condizioni.
Devi avere la OCTO API Key per l'operatore. Vedi i passaggi seguenti.
Hai un accordo commerciale con Headout per offrire le audioguide Dex. In caso contrario, contatta il tuo account manager di Headout.
Devi ricreare i prodotti dell'operatore in Ventrata. Scopri come creare i prodotti. La connessione sincronizza disponibilità, prezzi e prenotazioni, ma non crea i prodotti in Ventrata.
Passaggio 1: configurare l'operatore in Ventrata
Il tuo referente di Headout ti fornisce la chiave API OCTO.
Nella Ventrata Dashboard, vai su Products → Operators e apri l'operatore. Se non esiste ancora, crealo prima come operatore.
Nella sezione Backend Partner, seleziona Dex e inserisci la chiave API OCTO.
Lascia il campo OCTO Endpoint sul valore predefinito precompilato, a meno che Headout non ti indichi diversamente. L'articolo non riporta il valore.
Fai clic su Update Operator.
📒 NOTA – Ogni chiave API OCTO ti collega a un solo operatore. Configura ciascun operatore Dex separatamente.
Passaggio 2: collega ogni prodotto
Apri il prodotto dell'operatore in Products → Products e modificalo. Verifica che Operator sia impostato su questo operatore.
Seleziona Backend Connected. Seleziona Backend Availability per usare la disponibilità di Dex.
Fai clic su Update Product.
Crea in Ventrata i prodotti Dex con prezzi impostati secondo il tuo accordo con Headout. La connessione invia le prenotazioni, ma non crea i prodotti né sincronizza automaticamente i prezzi.
Seleziona Backend Connected. Backend Availability è facoltativo: le audioguide Dex hanno di solito disponibilità illimitata, quindi puoi attivarlo o disattivarlo.
Lascia deselezionato Backend Pricing, perché i prezzi non sono supportati tramite l'API.
Nelle impostazioni dei campi di contatto del prodotto, imposta Email come obbligatorio, quindi fai clic su Update Product.
Mappare i prodotti su Dex
‼️ IMPORTANTE
La mappatura indica a Ventrata per quali prodotto, opzione e unità di Dex controllare la disponibilità e prenotare. Se un prodotto collegato al backend non è mappato correttamente, le sue prenotazioni non vanno a buon fine. Un'evidenziazione rossa sull'intera riga del prodotto indica un prodotto mappato in modo errato.
Nella Ventrata Dashboard, vai su Products → Products e apri il prodotto.
Apri la scheda Mappings. Compare dopo che il prodotto è stato impostato come Backend Connected.
Per ogni opzione e unità Ventrata, seleziona dai menu a tendina, che Ventrata carica da Dex, il prodotto, l'opzione e le unità corrispondenti di Dex. Non lasciare nessun campo vuoto.
Fai clic su Save Changes.
📗 SUGGERIMENTO
Dopo la mappatura effettua una prenotazione di test e chiedi all'operatore di confermare che sia arrivata nel suo account Dex.
Gestire la connessione con Dex
Aggiorna la mappatura quando l'operatore modifica prodotti, opzioni o unità in Dex.
Sostituisci la chiave sull'operatore se Dex o l'operatore ne emettono una nuova.
Disattiva Backend Availability o Backend Pricing su un prodotto per usare invece la disponibilità o i prezzi di Ventrata. Le prenotazioni vengono comunque inviate a Dex.
Funzionalità della connessione in dettaglio
Questa sezione è per chi vuole sapere esattamente come funziona la connessione con Dex. Qui la direzione è opposta a quella di una connessione rivenditore: è Ventrata a chiamare Dex, tramite Dex OCTO API. Per ogni funzionalità spiega quali chiamate effettua Ventrata, quando e cosa significa per te.
In breve: Ventrata chiede a Dex la disponibilità ogni volta che qualcuno visualizza un prodotto collegato al backend e crea ogni prenotazione nell'account Dex dell'operatore. Dex non rinvia modifiche a Ventrata.
Le tempistiche sono quelle tipiche di Dex, arrotondate, e possono cambiare.
Product Mapping | ✅ |
Mappi ogni prodotto, opzione e unità Ventrata al prodotto Dex dell'operatore nella Ventrata Dashboard. Il funzionamento è il seguente:
Cosa significa per te: se qualcosa manca nel menu a tendina, l'operatore non te l'ha reso disponibile in Dex. Chiedigli di farlo. |
Content Sync | ❌ |
Ventrata non importa i contenuti dei prodotti da Dex. Ventrata non importa i contenuti dei prodotti da Dex. Crei e descrivi tu stesso i prodotti in Ventrata. |
Availability Sync | ✅ |
Con Backend Availability attivo, Ventrata controlla la disponibilità in tempo reale dell'operatore in Dex. Il funzionamento è il seguente:
Cosa significa per te: i clienti prenotano sulla disponibilità in tempo reale dell'operatore in Dex, quindi non puoi vendere in eccesso una fascia oraria che l'operatore ha già venduto altrove. |
Pricing Sync | ❌ |
Ventrata non legge i prezzi da Dex. Ventrata non legge i prezzi da Dex. I prodotti usano i prezzi che imposti in Ventrata e le prenotazioni vengono comunque inviate a Dex. |
Promotions Sync | ❌ |
Le promozioni non vengono inviate a Dex. Le promozioni non vengono inviate a Dex. Le tue promozioni Ventrata si applicano comunque al prezzo che il cliente paga in Ventrata. |
Bookings Sync | ✅ |
Le prenotazioni effettuate in Ventrata per un prodotto collegato al backend vengono create nell'account Dex dell'operatore. Il funzionamento è il seguente:
Le prenotazioni, le modifiche alle prenotazioni e le cancellazioni effettuate in Ventrata per il prodotto Backend Connected vengono inviate a Dex by Headout, compreso l'indirizzo email del cliente.
‼️ IMPORTANTE – Le prenotazioni si sincronizzano in una sola direzione, da Ventrata a Dex. Se l'operatore modifica o cancella una prenotazione in Dex, Ventrata non riceve alcuna notifica. Chiedi all'operatore di informarti di eventuali modifiche. |
Pickups/Dropoff Sync | ❌ |
I dettagli di pick-up e drop-off non vengono trasmessi a Dex. I dettagli di pick-up e drop-off non vengono trasmessi a Dex. Se un prodotto li richiede, comunicali all'operatore in un altro modo. |
Custom Questions Sync | ❌ |
Le risposte alle tue domande di prenotazione non vengono trasmesse a Dex. Le risposte alle tue domande di prenotazione non vengono trasmesse a Dex. Se l'operatore ne ha bisogno, comunicagliele in un altro modo. |
Extras Sync | ❌ |
Extra e servizi aggiuntivi non vengono prenotati in Dex. Extra e servizi aggiuntivi non vengono prenotati in Dex. Vengono prenotati solo prodotto, opzione e unità principali. |
Redemption Sync | ❌ |
I riscatti e le altre modifiche di stato in Dex non vengono rinviati a Ventrata dopo la conferma di una prenotazione. I riscatti e le altre modifiche di stato in Dex non vengono rinviati a Ventrata dopo la conferma di una prenotazione. Non supportato. Lo stato del riscatto non viene rinviato a Ventrata. |
Pass Walkup Scanning Sync | ❌ |
La scansione dei pass walk-up non è disponibile con Dex. La scansione dei pass walk-up non è disponibile con Dex. |
Gift Card Sync | ❌ |
Le carte regalo Ventrata non vengono trasmesse a Dex. Le carte regalo Ventrata non vengono trasmesse a Dex. I pagamenti con carta regalo restano in Ventrata. |
✅ supportato · ❌ non supportato
Buono a sapersi: limiti e dettagli della connessione Dex
Buono a sapersi: limiti e dettagli della connessione Dex
Disponibilità in tempo reale: la disponibilità arriva da Dex mentre gli utenti navigano.
Prenotazioni in una sola direzione: le modifiche che l'operatore apporta in Dex non arrivano a Ventrata.
Consegna della guida: Headout invia l'audioguida Dex direttamente al cliente via email. L'email deve essere un campo di contatto obbligatorio sul prodotto.
La guida viene fornita ed erogata da Headout.
Gli operatori possono offrire le audioguide Dex come prodotto autonomo, all'interno di un pacchetto o come upsell o cross-sell.
FAQ
Ricevo un errore quando salvo la configurazione del backend dell'operatore.
Ricevo un errore quando salvo la configurazione del backend dell'operatore.
Molto probabilmente la OCTO API Key o l'endpoint non sono corretti. Verificali con il tuo operatore. Se il problema persiste, contatta il nostro supporto tecnico.
Nelle impostazioni del prodotto non c'è la casella Backend Connected.
Nelle impostazioni del prodotto non c'è la casella Backend Connected.
Molto probabilmente l'operatore impostato sul prodotto non ha un backend configurato. Controlla le impostazioni Backend Partner dell'operatore e riprova. Se il problema persiste, contatta il nostro supporto tecnico.
Il prodotto, l'opzione o l'unità che voglio mappare non compare nel menu a tendina.
Il prodotto, l'opzione o l'unità che voglio mappare non compare nel menu a tendina.
I menu a tendina elencano ciò che l'operatore ti ha reso disponibile in Dex. Chiedi all'operatore. Se il problema persiste, contatta il nostro supporto tecnico.
Le prenotazioni non vanno a buon fine per un prodotto collegato al backend.
Le prenotazioni non vanno a buon fine per un prodotto collegato al backend.
Controlla prima la mappatura del prodotto: ogni opzione e unità deve essere mappata. Poi verifica che la fascia oraria sia ancora disponibile in Dex. Se il problema persiste, contatta il nostro supporto tecnico.
Errore durante la creazione dell'operatore.
Errore durante la creazione dell'operatore.
Probabilmente la chiave API OCTO non è corretta. Ricontrollala con il tuo referente di Headout. Se il problema persiste, contatta l'assistenza.
Il cliente non ha ricevuto l'audioguida.
Il cliente non ha ricevuto l'audioguida.
Verifica che l'email sia un campo di contatto obbligatorio sul prodotto e che la prenotazione abbia un indirizzo email valido. Se è così, contatta il tuo referente di Headout indicando il riferimento della prenotazione.
Il prodotto/l'opzione/l'unità che voglio mappare non è nel menu a tendina.
Il prodotto/l'opzione/l'unità che voglio mappare non è nel menu a tendina.
Il menu a tendina viene caricato da Dex by Headout in base ai prodotti che Headout ha reso disponibili per te. Ricontrolla con il tuo referente di Headout. Se il problema persiste, contatta l'assistenza.
Risorse utili
📚 Altro sulle connessioni Ventrata
Informazioni sul partner
Headout Inc.
82 Nassau Street, #60351
New York, NY 10038, USA
Ventrata Partner ID: 01a0d78e-2b7c-7d13-b753-d831c9ff6b78