Vai al contenuto principale

Connessioni e partner: guida

Scopri la differenza tra partner e connessioni, come usare la Partner Gallery, come gestire le tue connessioni e creare le Your Custom Connections.

La connettività API è una parte fondamentale di Ventrata e uno dei motivi principali per cui gli operatori ci scelgono. La missione del nostro prodotto di connettività è accelerare la crescita dei nostri clienti attraverso un ampio ecosistema delle connessioni API e partnership più affidabili e ricche di funzionalità del settore. Continuiamo ad aggiungere nuovi partner e siamo sempre aperti a nuove partnership che portino valore ai nostri clienti.


Partner e connessioni

Un partner è un'azienda presente nella galleria dei partner di Ventrata, come una OTA, un sistema di prenotazione, un'app o un'agenzia. È l'azienda che fornisce e gestisce la connessione API (integrazione) dall'altra parte. Consulta l'Elenco delle connessioni e dei partner supportati per un riepilogo di tutti i nostri partner.

Una connessione è la tua integrazione con un partner. La crei dalla scheda del partner, appartiene solo al tuo account e ne controlli le impostazioni, i prodotti a cui il partner può accedere e la chiave API. Le connessioni operatore sono chiamate anche backend operatore e si gestiscono dal modulo dell'operatore e dal modulo di mappatura del prodotto.


Categorie di partner Ventrata

Con oltre 350 connessioni supportate, raggruppiamo i partner nelle seguenti categorie in base a ciò che ti permettono di fare:

  • Reseller Connections - OTA, marketplace, rivenditori, pass multi-attrazione e altri canali che vendono i tuoi prodotti.

  • Operator Backends & Connections - sistemi di prenotazione di altri operatori, per rivendere, fare cross-selling e creare pacchetti con i loro prodotti.

  • Apps & Software - strumenti per comunicazioni, CRM, recensioni, operazioni, prezzi e altro.

  • Agencies and Consultants - partner di servizi come sviluppatori web, agenzie di marketing e consulenti per il travel trade. Elenchiamo i partner di servizi che i clienti Ventrata ci hanno consigliato. La maggior parte lavora direttamente con te e potrebbe non avere una connessione API, quindi la loro scheda non ha il pulsante + New Connection.

  • Your Custom Connections - integrazioni interne che sviluppi sulla nostra API, visibili solo al tuo account.

📗 SUGGERIMENTO

Consulta tutti i partner per categoria nel nostro Elenco delle connessioni e dei partner supportati.


Come usare la galleria dei partner

La galleria dei partner elenca tutti i partner disponibili per il tuo account. È sempre il luogo più aggiornato per verificare se lavoriamo con un partner.

  1. Nella tua Ventrata Dashboard, vai su Connections → Connections.

  2. Premi il pulsante + New Connection.

  3. Cerca per nome oppure filtra per categoria, stato, tag e mercati, quindi premi Search Partners.

Galleria dei partner

Ogni scheda mostra la descrizione del partner, il sito web, le funzionalità supportate (✓/✗) e i mercati, oltre a un'icona di aiuto che apre l'articolo del Centro assistenza dedicato al partner. Mostra anche Not Connected oppure quante connessioni hai già con il partner.

I partner non ancora attivi mostrano uno stato:

  • Coming Soon - in fase di sviluppo o test, a volte disponibile prima per account selezionati.

  • Request - non ancora integrato. Facci sapere se ti serve.

📒 NOTA

Alcune connessioni devono essere abilitate dal nostro team, o richiedono passaggi aggiuntivi, prima che tu possa vederle. Cerca nel Centro assistenza l'articolo del partner per sapere come iniziare.


Come creare una connessione

  1. Nella galleria dei partner, trova il partner e premi + New Connection.

  2. Compila i dettagli della connessione. A seconda del partner, potresti dover selezionare un rivenditore, un checkout o un operatore. Una connessione rivenditore utilizza i prodotti, i prezzi e le destinazioni di quel rivenditore.

  3. (Facoltativo) Consenti o escludi destinazioni, prodotti o elementi.

  4. Salva e segui i Next steps nella pagina della connessione, ad esempio condividere la chiave API con il partner.

  5. Testa la connessione, ad esempio chiedendo al partner di effettuare una prenotazione di test, quindi verificala nella tabella Bookings.

📗 SUGGERIMENTO

La configurazione è diversa per ogni partner e alcuni passaggi vengono eseguiti dal lato del partner, quindi consulta prima l'articolo del partner. Per vedere la chiave API, il tuo ruolo deve avere l'autorizzazione See Connection Key.

❗️IMPORTANTE

Alcuni partner possono accedere al tuo account tramite il loro Partner Admin non appena crei la connessione, anche prima che tu condivida la chiave API. Crea connessioni solo con partner di cui ti fidi.


Visualizzare e gestire le tue connessioni

Nella tua Ventrata Dashboard, vai su Connections → Connections per vedere tutte le tue connessioni. Apri una connessione per modificarne le impostazioni o trovarne le credenziali.

  • Le connessioni di test sono evidenziate in giallo.

  • Le connessioni con schede ancora da mappare sono evidenziate in rosso.

  • Le connessioni eliminate vengono archiviate e possono essere ripristinate.

Connections


Your Custom Connections

Se disponi delle competenze e degli strumenti di sviluppo, puoi usare la nostra OCTO API per creare integrazioni interne, ad esempio per inviare report al tuo strumento di BI, sincronizzare i rivenditori dal tuo CRM o gestire il tuo flusso di prenotazione.

Ogni connessione personalizzata ha una modalità e autorizzazioni di lettura/scrittura (Read/Write):

  • Backoffice - i dati della tua Dashboard, come report, rivenditori, agenti e articoli retail

  • Reseller - vendi i tuoi prodotti tramite il tuo canale come rivenditore

  • Web Checkout - il tuo flusso di prenotazione, con le impostazioni di un web checkout

Per crearne una, apri la galleria dei partner, premi il link + New Connection all'estrema destra senza selezionare un partner, scegli la modalità e le autorizzazioni e premi Create Octo Connection. La tua chiave API si trova nella pagina della connessione. Se non vedi il link, contattaci tramite chat e lo abiliteremo per il tuo account.

❗️IMPORTANTE

La tua chiave API dà accesso al tuo account Ventrata. Condividila solo con le persone che sviluppano la tua integrazione.

📗 SUGGERIMENTO

Leggi i nostri articoli su Reporting and Export API, Reseller & Agent Management API, Retail Items via API e Webhooks. Il riferimento API completo è su docs.ventrata.com.


Cos'è OCTO

OCTO (Open Connectivity for Tours, Activities and Attractions) è l'API standard aperta del nostro settore, gestita da un'organizzazione no-profit associativa. Invece di sviluppare un'integrazione personalizzata per ogni sistema, un partner si integra con OCTO una sola volta e può connettersi a qualsiasi sistema che lo supporti. Le connessioni vanno live più velocemente, con meno errori e meno manutenzione.

Ventrata è membro fondatore di OCTO e la nostra API è costruita su questo standard. Per questo preferiamo integrare i nuovi partner tramite OCTO e in modo diretto, senza middleware.

📗 SUGGERIMENTO

OCTO è finanziato dai suoi membri. Ti consigliamo vivamente di aderire come OCTO Industry Member per sostenere lo standard. Scopri di più nella nostra Expert Discussion: OCTO Explained.


FAQ

Ventrata è integrata con un partner specifico?

Cercalo nella galleria dei partner o nell'Elenco delle connessioni e dei partner supportati, oppure chiedi a Venny nella chat. Se non è presente, consulta Come richiedere una nuova connessione API o un nuovo partner.

Non trovo un partner che mi aspettavo di vedere. Perché?

Cerca nella galleria dei partner e nel Centro assistenza, oppure chiedi a Venny. Se ancora non lo trovi, contattaci tramite chat.

Il mio strumento (ad es. contabilità, CRM o marketing) non è in elenco. Posso comunque connetterlo?

Spesso sì. La nostra connessione Zapier ti permette di inviare i dati Ventrata a molte altre app senza codice. Puoi anche usare i webhook, creare una delle Your Custom Connections oppure chiedere aiuto a un partner di servizi nella categoria Agencies and Consultants.

Posso creare una mia connessione?

Sì. Puoi creare tu stesso le Your Custom Connections oppure trovare uno sviluppatore nella categoria Agencies and Consultants. Consulta Come richiedere una nuova connessione API o un nuovo partner per l'intero processo.

Devo essere membro di OCTO?

No. Come cliente Ventrata benefici già di OCTO, ma ti incoraggiamo vivamente ad aderire come membro per sostenere l'iniziativa.

Hai ricevuto la risposta alla tua domanda?