Skip to main content

Dex by Headout Operator Backend

How to connect your products in Ventrata to Dex by Headout to offer Dex audio guides to your customers

Dex by Headoutpowered by Headout
​
​Dex by Headout is a cinematic audio guide app from Headout, one of the leading online marketplaces for tours and attractions. Dex tours are fully produced, with narration, original soundtracks, and sound effects. Travelers can choose who tells the story, ask questions of a built-in AI guide, and listen offline in seven languages at landmarks such as the Louvre, the Colosseum, the Met, and the Uffizi.

This operator connection (also referred to as backend) allows tour and attraction operators using Ventrata to offer Dex audio guides to their customers as a standalone product, as part of a package, or as an upsell or cross-sell. The guide itself is provided and fulfilled by Headout.

The capabilities of this connection include:

  • Posting bookings, updates, and cancellations from Ventrata to Dex by Headout.

  • Delivering the Dex audio guide to your customers by email, directly from Headout.

If you want Headout to resell your own products, see Headout Reseller Connection instead.

🔐 Required Role Permissions: See Connections, Modify Connections, See Operators, Modify Operators, See Products, Modify Products

Configuring Operator Backend

Before You Begin:

  • You must have a commercial agreement with Headout to offer Dex audio guides. If you don't have one yet, contact your Headout account manager.

  • Obtain your OCTO API Key from your Headout contact.

  1. In the Ventrata Dashboard, navigate to Connections → Connections.
    ​

  2. Scroll down to Operator Connections & Backends, find Dex by Headout, and click + New Operator.
    ​
    ​


    ​

  3. Complete the operator details and enter the OCTO API Key provided by your Headout contact. Unless Headout instructs otherwise, leave the OCTO Endpoint field with its default pre-filled value.
    ​
    ​


    ​

  4. Click Create Operator to save the configuration.
    ​

Creating & Mapping Products

Email is required. Headout delivers the Dex audio guide to the customer by email. Every Dex product in Ventrata must have Email set as a required contact field, otherwise the customer will not receive their guide.

Once the operator has been created, create your Dex products in Ventrata and map them to the corresponding Dex products and options:

  1. Create the Dex products you want to offer in Ventrata, with pricing set according to your agreement with Headout. The connection posts bookings, but it does not automatically create products or sync pricing.
    ​

  2. Edit the product and ensure the Operator is set to the Dex by Headout operator you created earlier.
    ​

  3. Check Backend Connected for this product to use the API connection (backend). Backend Availability is optional: Dex audio guides typically have unlimited availability, so you can enable or disable it as needed. Leave Backend Pricing unchecked, as pricing is not supported over the API.
    ​
    ​


    ​

  4. In the product's contact field settings, set Email as required. Click Update Product to save.
    ​

  5. The product page will now display a Mappings tab. Navigate to this tab and map your Ventrata product, option(s), and units by selecting the corresponding products, options, and units from the dropdown lists as received from Dex by Headout. Ensure that no fields are left empty (unmapped), and click Save Changes.
    ​


    ​

  6. Make a test booking and ask your Headout contact to confirm it was received and the audio guide email was delivered.
    ​

Supported Capabilities

Availability

✅

When Backend Availability is enabled, Ventrata will pull availability from Dex by Headout. Since Dex audio guides typically have unlimited availability, you can enable or disable this as needed.

Pricing

❌

Pricing is not supported over the API. Configure product pricing manually in Ventrata based on your agreement with Headout.

Booking

✅

Bookings, booking changes, and cancellations made in Ventrata for the Backend Connected product are automatically sent to Dex by Headout, including the customer's email address.

Guide Delivery

✅

Headout emails the Dex audio guide directly to the customer. Email must be a required contact field on the product.

Redemption

❌

Redemption status is not currently communicated back to Ventrata.

​

Troubleshooting

Issue

Possible Solutions

Error when creating the operator.

Likely the OCTO API Key is incorrect. Double-check it with your Headout contact. If the issue persists, contact us for support.

Customer did not receive the audio guide.

Check that Email is a required contact field on the product and that the booking has a valid email address. If it does, contact your Headout contact with the booking reference.

No Backend Connected checkbox in product settings.

Likely the operator selected for the product is not the Dex by Headout operator created from Connections. Check the product's operator and try again. If the issue persists, contact us for support.

The product/option/unit I want to map is not on the dropdown.

The dropdown list is pulled from Dex by Headout based on the products Headout has made available to you. Double-check with your Headout contact. If the issue persists, contact us for support.

Partner Information

Dex is provided by Headout.

Headout Inc.
82 Nassau Street, #60351
New York, NY 10038
USA

Partner ID 01a0d78e-2b7c-7d13-b753-d831c9ff6b78

Related Articles
Did this answer your question?