Dex es la app de audioguías de Headout, basada en recorridos cinematográficos y narrativos con bandas sonoras originales en los que los viajeros eligen a su narrador en lugares como el Louvre, la Torre Eiffel, el British Museum, la Estatua de la Libertad, la Sagrada Família y Angkor Wat. Su guía con IA integrada responde preguntas e identifica obras de arte en el momento, en siete idiomas y sin conexión, de modo que las atracciones pueden ofrecer una guía de Dex junto con la entrada.
Conectar Dex con Ventrata le permite revender productos de operadores que utilizan Dex como sistema de reservas. Ventrata lee su disponibilidad en tiempo real desde Dex, y cada reserva que recibe se crea directamente en la cuenta de Dex del operador.
Para obtener más información sobre Dex, visite dex.headout.com.
‼️ IMPORTANTE
El correo electrónico es obligatorio. Headout entrega la audioguía de Dex al cliente por correo electrónico. Todos los productos de Dex en Ventrata deben tener el correo electrónico configurado como campo de contacto obligatorio; de lo contrario, el cliente no recibirá su guía.
📒 NOTA
Si quiere que Headout revenda sus propios productos, consulte en su lugar el artículo de conexión de revendedor de Headout.
Sitio web principal | |
Etiquetas | Custom / Proprietary Operator System |
Funciones de la conexión | Availability Sync · Bookings Sync |
Desarrollado por | Ventrata (mediante la API OCTO de Dex) |
Esta conexión de operador (también llamada backend) le permite revender productos de operadores que utilizan Dex como sistema de reservas principal, y cada reserva se crea directamente en Dex. Las funciones de esta conexión incluyen:
Availability Sync: la disponibilidad en tiempo real procede de la cuenta de Dex del operador.
Bookings Sync: las reservas, modificaciones y cancelaciones se envían de Ventrata a Dex, y Dex emite las entradas o los vouchers.
Crear la conexión con Dex
🔐 Permisos de rol necesarios: See Operators, Modify Operators, See Products, Modify Products
Antes de empezar:
Debe tener un acuerdo comercial con el operador sobre sus tarifas y condiciones.
Debe tener la OCTO API Key para el operador. Consulte los pasos que se indican a continuación.
Tiene un acuerdo comercial con Headout para ofrecer audioguías de Dex. Si no es así, póngase en contacto con su gestor de cuenta en Headout.
Debe volver a crear los productos del operador en Ventrata. Consulte cómo crear productos. La conexión sincroniza la disponibilidad, los precios y las reservas, pero no crea productos en Ventrata.
Paso 1: Configurar el operador en Ventrata
Su contacto en Headout le facilita la clave API de OCTO (OCTO API Key).
En el Ventrata Dashboard, vaya a Productos → Operadores (Products → Operators) y abra el operador. Si todavía no existe, primero créelo como operador.
En la sección Socio de backend (Backend Partner), seleccione Dex e introduzca la OCTO API Key.
Deje el campo OCTO Endpoint con su valor predeterminado, salvo que Headout le indique lo contrario. El artículo no especifica el valor.
Haga clic en Actualizar Operador (Update Operator).
📒 NOTA: cada OCTO API Key le conecta con un operador. Configure cada operador de Dex por separado.
Paso 2: conecte cada producto
Abra el producto del operador en Productos → Productos (Products → Products) y edítelo. Compruebe que el Operador sea este operador.
Marque Backend conectado (Backend Connected). Marque Disponibilidad del backend (Backend Availability) para usar la disponibilidad de Dex.
Haga clic en Actualizar Producto (Update Product).
Cree los productos de Dex en Ventrata con los precios definidos según su acuerdo con Headout. La conexión envía las reservas, pero no crea productos ni sincroniza los precios automáticamente.
Marque Backend conectado (Backend Connected). Disponibilidad del backend (Backend Availability) es opcional: las audioguías de Dex suelen tener disponibilidad ilimitada, por lo que puede activarla o desactivarla.
Deje sin marcar Precios del backend (Backend Pricing), porque los precios no se admiten mediante la API.
En la configuración de los campos de contacto del producto, marque el correo electrónico como obligatorio y, a continuación, haga clic en Actualizar producto (Update Product).
Mapear productos con Dex
‼️ IMPORTANTE
El mapeo indica a Ventrata para qué producto, opción y unidades de Dex debe consultar la disponibilidad y realizar la reserva. Si un producto conectado al backend no está bien mapeado, sus reservas fallan. Un resaltado en rojo en toda la fila del producto indica que el producto está mal mapeado.
En el Ventrata Dashboard, vaya a Productos → Productos (Products → Products) y abra el producto.
Abra la pestaña Mapeos (Mappings). Aparece una vez que el producto tiene marcado Backend conectado (Backend Connected).
Para cada opción y unidad de Ventrata, seleccione el producto, la opción y las unidades correspondientes de Dex en las listas desplegables, que Ventrata carga desde Dex. No deje ningún campo vacío.
Haga clic en Save Changes.
📗 CONSEJO
Haga una reserva de prueba después del mapeo y pida al operador que confirme que ha llegado a su cuenta de Dex.
Gestionar la conexión con Dex
Actualice el mapeo cuando el operador cambie productos, opciones o unidades en Dex.
Sustituya la clave en el operador si Dex o el operador emiten una nueva.
Desactive Disponibilidad del backend o Precios del backend (Backend Availability / Backend Pricing) en un producto para usar la disponibilidad o los precios propios de Ventrata. Las reservas se siguen enviando a Dex.
Funciones de la conexión en detalle
Esta sección es para quien quiera saber exactamente cómo funciona la conexión con Dex. Aquí el sentido es el contrario al de una conexión de revendedor: Ventrata llama a Dex mediante la API OCTO de Dex. Para cada funcionalidad, se explica qué llamadas realiza Ventrata, cuándo y qué significa para usted.
En resumen: Ventrata solicita a Dex la disponibilidad cada vez que alguien consulta un producto conectado al backend, y crea cada reserva en la cuenta de Dex del operador. Dex no envía cambios de vuelta a Ventrata.
Los tiempos son los habituales en Dex, están redondeados y pueden cambiar.
Product Mapping | ✅ |
Usted mapea cada producto, opción y unidad de Ventrata con el producto de Dex del operador en el Ventrata Dashboard. Funciona así:
Qué significa esto para usted: si falta algo en la lista desplegable, el operador no se lo ha puesto a su disposición en Dex. Pídale que lo haga. |
Content Sync | ❌ |
Ventrata no importa el contenido de los productos desde Dex. Ventrata no importa el contenido de los productos desde Dex. Usted mismo crea y describe los productos en Ventrata. |
Availability Sync | ✅ |
Con Disponibilidad del backend (Backend Availability) activada, Ventrata consulta la disponibilidad en tiempo real del operador en Dex. Funciona así:
Qué significa esto para usted: los clientes reservan sobre la disponibilidad en tiempo real del operador en Dex, por lo que no puede vender de más una franja que el operador ya ha vendido en otro canal. |
Pricing Sync | ❌ |
Ventrata no lee los precios desde Dex. Ventrata no lee los precios desde Dex. Los productos usan los precios que usted establece en Ventrata, y las reservas se siguen enviando a Dex. |
Promotions Sync | ❌ |
Las promociones no se envían a Dex. Las promociones no se envían a Dex. Sus promociones de Ventrata siguen aplicándose al precio que paga su cliente en Ventrata. |
Bookings Sync | ✅ |
Las reservas realizadas en Ventrata para un producto conectado al backend se crean en la cuenta de Dex del operador. Funciona así:
Las reservas, los cambios en las reservas y las cancelaciones realizados en Ventrata para el producto con Backend conectado (Backend Connected) se envían a Dex by Headout, incluida la dirección de correo electrónico del cliente.
‼️ IMPORTANTE: las reservas se sincronizan en un solo sentido, de Ventrata a Dex. Si el operador modifica o cancela una reserva en Dex, Ventrata no recibe ningún aviso. Pida al operador que le informe de cualquier cambio que haga. |
Pickups/Dropoff Sync | ❌ |
Los datos de recogida y bajada no se transmiten a Dex. Los datos de recogida y bajada no se transmiten a Dex. Compártalos con el operador por otra vía si un producto los necesita. |
Custom Questions Sync | ❌ |
Las respuestas a sus preguntas de reserva no se transmiten a Dex. Las respuestas a sus preguntas de reserva no se transmiten a Dex. Compártalas con el operador por otra vía si las necesita. |
Extras Sync | ❌ |
Los extras y complementos no se reservan en Dex. Los extras y complementos no se reservan en Dex. Solo se reservan el producto principal, la opción y las unidades. |
Redemption Sync | ❌ |
Los canjes y otros cambios de estado en Dex no se envían de vuelta a Ventrata una vez confirmada la reserva. Los canjes y otros cambios de estado en Dex no se envían de vuelta a Ventrata una vez confirmada la reserva. No se admite. El estado de canje no se envía de vuelta a Ventrata. |
Pass Walkup Scanning Sync | ❌ |
El escaneo de pases sin reserva previa no está disponible con Dex. El escaneo de pases sin reserva previa no está disponible con Dex. |
Gift Card Sync | ❌ |
Las tarjetas regalo de Ventrata no se transmiten a Dex. Las tarjetas regalo de Ventrata no se transmiten a Dex. Los pagos con tarjeta regalo se quedan en Ventrata. |
✅ compatible · ❌ no compatible
Conviene saber: límites y detalles de la conexión con Dex
Conviene saber: límites y detalles de la conexión con Dex
Disponibilidad en tiempo real: la disponibilidad se obtiene de Dex mientras los clientes navegan.
Reservas en un solo sentido: los cambios que el operador hace en Dex no llegan a Ventrata.
Entrega de la guía: Headout envía la audioguía de Dex directamente al cliente por correo electrónico. El correo electrónico debe ser un campo de contacto obligatorio en el producto.
Headout proporciona y entrega la guía.
Los operadores pueden ofrecer las audioguías de Dex como producto independiente, como parte de un paquete o como venta adicional o cruzada.
Preguntas frecuentes
Recibo un error al guardar la configuración del backend del operador.
Recibo un error al guardar la configuración del backend del operador.
Lo más probable es que la OCTO API Key o el endpoint sean incorrectos. Compruébelos con su operador. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.
No aparece la casilla Backend conectado (Backend Connected) en la configuración del producto.
No aparece la casilla Backend conectado (Backend Connected) en la configuración del producto.
Lo más probable es que el operador asignado al producto no tenga un backend configurado. Revise la configuración de Socio de backend (Backend Partner) del operador y vuelva a intentarlo. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.
El producto, la opción o la unidad que quiero mapear no aparece en la lista desplegable.
El producto, la opción o la unidad que quiero mapear no aparece en la lista desplegable.
Las listas desplegables muestran lo que el operador le ha puesto a su disposición en Dex. Consulte al operador. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.
Las reservas de un producto conectado al backend fallan.
Las reservas de un producto conectado al backend fallan.
Compruebe primero el mapeo del producto: todas las opciones y unidades deben estar mapeadas. Después, compruebe que la franja horaria sigue disponible en Dex. Si el problema persiste, póngase en contacto con nuestro Soporte técnico.
Error al crear el operador.
Error al crear el operador.
Es probable que la clave API de OCTO (OCTO API Key) sea incorrecta. Compruébela con su contacto en Headout. Si el problema persiste, póngase en contacto con el Soporte técnico.
El cliente no ha recibido la audioguía.
El cliente no ha recibido la audioguía.
Compruebe que el correo electrónico es un campo de contacto obligatorio en el producto y que la reserva tiene una dirección de correo electrónico válida. Si es así, póngase en contacto con su contacto en Headout indicando la referencia de la reserva.
El producto, la opción o la unidad que quiero mapear no aparece en la lista desplegable.
El producto, la opción o la unidad que quiero mapear no aparece en la lista desplegable.
La lista desplegable se obtiene de Dex by Headout según los productos que Headout ha puesto a su disposición. Compruébelo con su contacto en Headout. Si el problema persiste, póngase en contacto con el Soporte técnico.
Recursos útiles
📚 Más sobre las conexiones de Ventrata
Información del partner
Headout Inc.
82 Nassau Street, #60351
New York, NY 10038, EE. UU.
ID de partner de Ventrata: 01a0d78e-2b7c-7d13-b753-d831c9ff6b78