Dex est l'application d'audioguides de Headout, conçue autour de visites cinématographiques et narratives avec des bandes originales, où les voyageurs choisissent leur conteur sur des sites comme le Louvre, la tour Eiffel, le British Museum, la statue de la Liberté, la Sagrada Família et Angkor Vat. Son guide IA intégré répond aux questions et identifie les œuvres sur place, en sept langues et hors ligne, afin que les attractions puissent proposer un guide Dex en complément du billet d'entrée.
Connecter Dex à Ventrata vous permet de revendre les produits d'opérateurs qui utilisent Dex comme système de réservation. Ventrata lit leurs disponibilités en temps réel dans Dex, et chaque réservation que vous prenez est créée directement dans le compte Dex de l'opérateur.
Pour en savoir plus sur Dex, consultez dex.headout.com.
‼️ IMPORTANT
L'e-mail est obligatoire. Headout envoie l'audioguide Dex au client par e-mail. Chaque produit Dex dans Ventrata doit avoir l'e-mail (Email) défini comme champ de contact obligatoire, faute de quoi le client ne recevra pas son guide.
📒 REMARQUE
Si vous souhaitez que Headout revende vos propres produits, consultez plutôt l'article Headout : connexion revendeur.
Site web principal | |
Tags | Custom / Proprietary Operator System |
Fonctionnalités de la connexion | Availability Sync · Bookings Sync |
Développé par | Ventrata (via l'API OCTO de Dex) |
Cette connexion opérateur (aussi appelée backend) vous permet de revendre les produits d'opérateurs qui utilisent Dex comme système de réservation principal, chaque réservation étant créée directement dans Dex. Les fonctionnalités de cette connexion comprennent :
Availability Sync – les disponibilités en temps réel proviennent du compte Dex de l'opérateur.
Bookings Sync – les réservations, modifications et annulations sont transmises de Ventrata à Dex, et Dex émet les billets ou les bons.
Créer la connexion Dex
🔐 Autorisations de rôle requises : See Operators, Modify Operators, See Products, Modify Products
Avant de commencer :
Vous devez disposer d'un accord commercial avec l'opérateur définissant ses tarifs et ses conditions.
Vous devez disposer de la clé API OCTO (OCTO API Key) pour l'opérateur. Consultez les étapes ci-dessous.
Vous avez un accord commercial avec Headout pour proposer les audioguides Dex. Si ce n'est pas le cas, contactez votre gestionnaire de compte chez Headout.
Vous devez recréer les produits de l'opérateur dans Ventrata. Découvrez comment créer des produits. La connexion synchronise les disponibilités, les prix et les réservations, mais ne crée pas les produits dans Ventrata.
Étape 1 : configurer l'opérateur dans Ventrata
Votre contact chez Headout vous fournit la clé API OCTO.
Dans le Ventrata Dashboard, accédez à Produits → Les opérateurs (Products → Operators) et ouvrez l'opérateur. S'il n'existe pas encore, créez-le d'abord en tant qu'opérateur.
Dans la section Partenaire backend (Backend Partner), sélectionnez Dex et saisissez la clé API OCTO.
Laissez le champ Point de terminaison OCTO (OCTO Endpoint) à sa valeur par défaut pré-remplie, sauf indication contraire de Headout. L'article n'indique pas cette valeur.
Press Update Operator.
📒 REMARQUE – Chaque clé API OCTO vous connecte à un seul opérateur. Configurez chaque opérateur Dex séparément.
Étape 2 : connectez chaque produit
Ouvrez le produit de l'opérateur dans Produits → Produits (Products → Products) et modifiez-le. Vérifiez que le champ Opérateur (Operator) est bien défini sur cet opérateur.
Cochez Backend connecté (Backend Connected). Cochez Disponibilité du backend (Backend Availability) pour utiliser les disponibilités de Dex.
Press Update Product.
Créez les produits Dex dans Ventrata avec une tarification conforme à votre accord avec Headout. La connexion transmet les réservations, mais elle ne crée pas les produits et ne synchronise pas les prix automatiquement.
Cochez Backend connecté (Backend Connected). La Disponibilité du backend (Backend Availability) est facultative : les audioguides Dex ayant généralement une disponibilité illimitée, vous pouvez l'activer ou la désactiver.
Laissez Tarification backend (Backend Pricing) décoché, car la tarification n'est pas prise en charge via l'API.
Dans les paramètres des champs de contact du produit, définissez l'e-mail (Email) comme obligatoire, puis cliquez sur Modifier ce(tte) Produit (Update Product).
Mapper les produits vers Dex
‼️ IMPORTANT
Le mappage indique à Ventrata pour quels produit, option et unités Dex il doit vérifier les disponibilités et réserver. Si un produit connecté au backend n'est pas correctement mappé, ses réservations échouent. Une ligne de produit surlignée en rouge signale un produit mal mappé.
Dans le Ventrata Dashboard, accédez à Produits → Produits (Products → Products) et ouvrez le produit.
Ouvrez l'onglet Mappages (Mappings). Il apparaît dès que le produit est défini sur Backend connecté (Backend Connected).
Pour chaque option et unité Ventrata, sélectionnez le produit, l'option et les unités Dex correspondants dans les listes déroulantes, que Ventrata charge depuis Dex. Ne laissez aucun champ vide.
Press Save Changes.
📗 ASTUCE
Effectuez une réservation test après le mappage, et demandez à l'opérateur de confirmer qu'elle est bien arrivée dans son compte Dex.
Gérer la connexion Dex
Mettez à jour le mappage lorsque l'opérateur modifie des produits, options ou unités dans Dex.
Remplacez la clé dans la fiche de l'opérateur si Dex ou l'opérateur en émet une nouvelle.
Désactivez l'option Disponibilité du backend (Backend Availability) ou Tarification backend (Backend Pricing) sur un produit pour utiliser à la place les disponibilités ou les prix de Ventrata. Les réservations sont toujours transmises à Dex.
Fonctionnalités de la connexion en détail
Cette section s'adresse à toute personne qui souhaite savoir précisément comment fonctionne la connexion Dex. Ici, le sens est l'inverse de celui d'une connexion revendeur : Ventrata appelle Dex, via l'API OCTO de Dex. Pour chaque fonctionnalité, cette section explique quels appels Ventrata effectue, à quel moment, et ce que cela signifie pour vous.
En bref : Ventrata demande à Dex les disponibilités chaque fois que quelqu'un consulte un produit connecté au backend, et crée chaque réservation dans le compte Dex de l'opérateur. Dex ne renvoie pas les modifications à Ventrata.
Les délais indiqués sont ceux généralement observés avec Dex ; ils sont arrondis et peuvent évoluer.
Product Mapping | ✅ |
Vous mappez chaque produit, option et unité Ventrata au produit Dex de l'opérateur dans le Ventrata Dashboard. Le fonctionnement est le suivant :
Ce que cela signifie pour vous : si un élément manque dans la liste déroulante, c'est que l'opérateur ne l'a pas mis à votre disposition dans Dex. Demandez-lui de le faire. |
Content Sync | ❌ |
Ventrata n'importe pas le contenu des produits depuis Dex. Ventrata n'importe pas le contenu des produits depuis Dex. Vous créez et décrivez vous-même les produits dans Ventrata. |
Availability Sync | ✅ |
Lorsque l'option Disponibilité du backend (Backend Availability) est activée, Ventrata vérifie les disponibilités en temps réel de l'opérateur dans Dex. Le fonctionnement est le suivant :
Ce que cela signifie pour vous : les clients réservent sur la base des disponibilités Dex en temps réel de l'opérateur : vous ne pouvez donc pas survendre un créneau que l'opérateur a déjà vendu ailleurs. |
Pricing Sync | ❌ |
Ventrata ne lit pas les prix dans Dex. Ventrata ne lit pas les prix dans Dex. Les produits utilisent les prix que vous définissez dans Ventrata, et les réservations sont toujours transmises à Dex. |
Promotions Sync | ❌ |
Les promotions ne sont pas transmises à Dex. Les promotions ne sont pas transmises à Dex. Vos promotions Ventrata s'appliquent toujours au prix que votre client paie dans Ventrata. |
Bookings Sync | ✅ |
Les réservations effectuées dans Ventrata pour un produit connecté au backend sont créées dans le compte Dex de l'opérateur. Le fonctionnement est le suivant :
Les réservations, modifications de réservation et annulations effectuées dans Ventrata pour le produit connecté au backend (Backend Connected) sont transmises à Dex by Headout, y compris l'adresse e-mail du client.
‼️ IMPORTANT – Les réservations sont synchronisées dans un seul sens, de Ventrata vers Dex. Si l'opérateur modifie ou annule une réservation dans Dex, Ventrata n'en est pas informé. Demandez à l'opérateur de vous signaler toute modification qu'il effectue. |
Pickups/Dropoff Sync | ❌ |
Les informations de prise en charge et de dépose ne sont pas transmises à Dex. Les informations de prise en charge et de dépose ne sont pas transmises à Dex. Communiquez-les à l'opérateur par un autre moyen si un produit en a besoin. |
Custom Questions Sync | ❌ |
Les réponses à vos questions de réservation ne sont pas transmises à Dex. Les réponses à vos questions de réservation ne sont pas transmises à Dex. Communiquez-les à l'opérateur par un autre moyen s'il en a besoin. |
Extras Sync | ❌ |
Les extras et options supplémentaires ne sont pas réservés dans Dex. Les extras et options supplémentaires ne sont pas réservés dans Dex. Seuls le produit principal, l'option et les unités le sont. |
Redemption Sync | ❌ |
Les validations et autres changements de statut dans Dex ne sont pas renvoyés à Ventrata une fois la réservation confirmée. Les validations et autres changements de statut dans Dex ne sont pas renvoyés à Ventrata une fois la réservation confirmée. Non pris en charge. Le statut de validation n'est pas renvoyé à Ventrata. |
Pass Walkup Scanning Sync | ❌ |
Le scan des pass sur place (walk-up) n'est pas disponible avec Dex. Le scan des pass sur place (walk-up) n'est pas disponible avec Dex. |
Gift Card Sync | ❌ |
Les cartes cadeaux Ventrata ne sont pas transmises à Dex. Les cartes cadeaux Ventrata ne sont pas transmises à Dex. Les paiements par carte cadeau restent dans Ventrata. |
✅ pris en charge · ❌ non pris en charge
Bon à savoir : limites et détails de la connexion Dex
Bon à savoir : limites et détails de la connexion Dex
Disponibilités en temps réel : les disponibilités proviennent de Dex pendant que les clients consultent l'offre.
Réservations à sens unique : les modifications que l'opérateur effectue dans Dex ne parviennent pas à Ventrata.
Remise du guide : Headout envoie l'audioguide Dex directement au client par e-mail. L'e-mail doit être un champ de contact obligatoire sur le produit.
Le guide est fourni et délivré par Headout.
Les opérateurs peuvent proposer les audioguides Dex comme produit autonome, dans un forfait, ou en vente additionnelle ou croisée.
FAQ
J'obtiens une erreur lorsque j'enregistre la configuration du backend de l'opérateur.
J'obtiens une erreur lorsque j'enregistre la configuration du backend de l'opérateur.
La clé API OCTO (OCTO API Key) ou le point de terminaison sont très probablement incorrects. Vérifiez-les avec votre opérateur. Si le problème persiste, contactez notre support technique.
Il n'y a pas de case Backend connecté (Backend Connected) dans les paramètres du produit.
Il n'y a pas de case Backend connecté (Backend Connected) dans les paramètres du produit.
L'opérateur défini sur le produit n'a très probablement pas de backend configuré. Vérifiez les paramètres Partenaire backend (Backend Partner) de l'opérateur et réessayez. Si le problème persiste, contactez notre support technique.
Le produit, l'option ou l'unité que je veux mapper n'apparaît pas dans la liste déroulante.
Le produit, l'option ou l'unité que je veux mapper n'apparaît pas dans la liste déroulante.
Les listes déroulantes affichent ce que l'opérateur a mis à votre disposition dans Dex. Adressez-vous à l'opérateur. Si le problème persiste, contactez notre Support technique.
Les réservations échouent pour un produit connecté au backend.
Les réservations échouent pour un produit connecté au backend.
Vérifiez d'abord le mappage du produit : chaque option et chaque unité doivent être mappées. Vérifiez ensuite que le créneau est toujours disponible dans Dex. Si le problème persiste, contactez notre Support technique.
Erreur lors de la création de l'opérateur.
Erreur lors de la création de l'opérateur.
La clé API OCTO est probablement incorrecte. Vérifiez-la auprès de votre contact chez Headout. Si le problème persiste, contactez le support.
Le client n'a pas reçu l'audioguide.
Le client n'a pas reçu l'audioguide.
Vérifiez que l'e-mail est un champ de contact obligatoire sur le produit et que la réservation comporte une adresse e-mail valide. Si c'est le cas, contactez votre interlocuteur chez Headout en indiquant la référence de la réservation.
Le produit/l'option/l'unité que je souhaite mapper ne figure pas dans la liste déroulante.
Le produit/l'option/l'unité que je souhaite mapper ne figure pas dans la liste déroulante.
La liste déroulante est récupérée depuis Dex by Headout en fonction des produits que Headout a mis à votre disposition. Vérifiez auprès de votre contact chez Headout. Si le problème persiste, contactez le support.
Ressources utiles
📚 En savoir plus sur les connexions Ventrata
Informations sur le partenaire
Headout Inc.
82 Nassau Street, #60351
New York, NY 10038, États-Unis
ID partenaire Ventrata : 01a0d78e-2b7c-7d13-b753-d831c9ff6b78