Dex é a aplicação de audioguias de Headout, assente em visitas cinematográficas e narrativas com bandas sonoras originais, em que os viajantes escolhem o seu narrador em locais emblemáticos como o Louvre, a Torre Eiffel, o British Museum, a Estátua da Liberdade, a Sagrada Família e Angkor Wat. O seu guia com IA integrado responde a perguntas e identifica obras de arte no local, em sete línguas e offline, para que as atrações possam oferecer um guia Dex a par da entrada.
Ligar Dex à Ventrata permite-lhe revender produtos de operadores que utilizam Dex como sistema de reservas. A Ventrata lê a disponibilidade em tempo real a partir de Dex, e cada reserva que recebe é criada diretamente na conta do operador em Dex.
Para saber mais sobre Dex, visite dex.headout.com.
‼️ IMPORTANTE
O email é obrigatório. Headout entrega o audioguia Dex ao cliente por email. Todos os produtos Dex na Ventrata têm de ter o Email definido como campo de contacto obrigatório; caso contrário, o cliente não receberá o seu guia.
📒 NOTA
Se pretende que Headout revenda os seus próprios produtos, consulte antes o artigo sobre a conexão de revendedor de Headout.
Website principal | |
Etiquetas | Custom / Proprietary Operator System |
Funcionalidades da conexão | Availability Sync · Bookings Sync |
Desenvolvido por | Ventrata (através da API OCTO de Dex) |
Esta conexão de operador (também chamada backend) permite-lhe revender produtos de operadores que utilizam Dex como sistema de reservas principal, com cada reserva criada diretamente em Dex. As funcionalidades desta conexão incluem:
Availability Sync – a disponibilidade em tempo real vem da conta do operador em Dex.
Bookings Sync – as reservas, atualizações e cancelamentos são enviados da Ventrata para Dex, e Dex emite os bilhetes ou vouchers.
Criar a conexão com Dex
🔐 Permissões de função necessárias: See Operators, Modify Operators, See Products, Modify Products
Antes de começar:
Tem de ter um acordo comercial com o operador relativo às respetivas tarifas e condições.
Tem de ter a OCTO API Key do operador. Veja os passos abaixo.
Tem um acordo comercial com Headout para oferecer audioguias Dex. Se não tiver, contacte o seu gestor de conta em Headout.
Tem de recriar os produtos do operador na Ventrata. Veja como criar produtos. A conexão sincroniza a disponibilidade, os preços e as reservas, mas não cria produtos na Ventrata.
Passo 1: configurar o operador na Ventrata
O seu contacto em Headout fornece-lhe a OCTO API Key.
No Ventrata Dashboard, aceda a Products → Operators e abra o operador. Se ainda não existir, crie-o primeiro como operador.
Na secção Backend Partner, selecione Dex e introduza a OCTO API Key.
Deixe o campo OCTO Endpoint com o valor predefinido pré-preenchido, a menos que Headout lhe indique o contrário. O artigo não indica o valor.
Clique em Update Operator.
📒 NOTA – Cada OCTO API Key liga-o a um operador. Configure cada operador de Dex separadamente.
Passo 2: conecte cada produto
Abra o produto do operador em Products → Products e edite-o. Verifique se Operator está definido como este operador.
Marque Backend Connected. Marque Backend Availability para utilizar a disponibilidade de Dex.
Clique em Update Product.
Crie os produtos Dex na Ventrata com os preços definidos de acordo com o seu acordo com Headout. A conexão envia as reservas, mas não cria produtos nem sincroniza preços automaticamente.
Assinale Backend Connected. Backend Availability é opcional: os audioguias Dex têm normalmente disponibilidade ilimitada, pelo que pode ativá-la ou desativá-la.
Deixe Backend Pricing desassinalado, porque os preços não são suportados através da API.
Nas definições dos campos de contacto do produto, defina o Email como obrigatório e, em seguida, clique em Update Product.
Mapear produtos para Dex
‼️ IMPORTANTE
O mapeamento indica à Ventrata o produto, a opção e as unidades de Dex cuja disponibilidade deve consultar e que deve reservar. Se um produto ligado ao backend não estiver corretamente mapeado, as respetivas reservas falham. Um destaque a vermelho em toda a linha do produto indica um produto mal mapeado.
No Ventrata Dashboard, aceda a Products → Products e abra o produto.
Abra o separador Mappings. Este aparece quando o produto está definido como Backend Connected.
Para cada opção e unidade Ventrata, selecione o produto, a opção e as unidades correspondentes de Dex nas listas pendentes, que a Ventrata carrega a partir de Dex. Não deixe nenhum campo vazio.
Clique em Save Changes.
📗 DICA
Faça uma reserva de teste depois do mapeamento e peça ao operador que confirme que esta chegou à sua conta em Dex.
Gerir a conexão com Dex
Atualize o mapeamento quando o operador alterar produtos, opções ou unidades em Dex.
Substitua a chave no operador se Dex ou o operador emitirem uma nova.
Desative Backend Availability ou Backend Pricing num produto para utilizar a disponibilidade ou os preços da própria Ventrata. As reservas continuam a ser enviadas para Dex.
Funcionalidades da conexão em detalhe
Esta secção destina-se a quem quer saber exatamente como funciona a conexão com Dex. Aqui, o sentido é o inverso de uma conexão de revendedor: é a Ventrata que chama Dex, através da API OCTO de Dex. Para cada funcionalidade, explica que chamadas a Ventrata faz, quando as faz e o que isso significa para si.
Em resumo: a Ventrata pede a Dex a disponibilidade sempre que alguém consulta um produto ligado ao backend, e cria cada reserva na conta do operador em Dex. Dex não envia alterações de volta para a Ventrata.
Os tempos indicados são os habituais para Dex, estão arredondados e podem mudar.
Product Mapping | ✅ |
No Ventrata Dashboard, cada produto, opção e unidade Ventrata é mapeado para o produto do operador em Dex. Funciona da seguinte forma:
O que isto significa para si: se faltar algo na lista pendente, o operador não o disponibilizou para si em Dex. Peça-lhe que o faça. |
Content Sync | ❌ |
A Ventrata não importa o conteúdo dos produtos de Dex. A Ventrata não importa o conteúdo dos produtos de Dex. É o próprio utilizador que cria e descreve os produtos na Ventrata. |
Availability Sync | ✅ |
Com Backend Availability ativado, a Ventrata consulta a disponibilidade do operador em tempo real em Dex. Funciona da seguinte forma:
O que isto significa para si: os clientes reservam com base na disponibilidade do operador em tempo real em Dex, pelo que não pode vender em excesso um horário que o operador já vendeu noutro lado. |
Pricing Sync | ❌ |
A Ventrata não lê os preços de Dex. A Ventrata não lê os preços de Dex. Os produtos utilizam os preços que definiu na Ventrata, e as reservas continuam a ser enviadas para Dex. |
Promotions Sync | ❌ |
As promoções não são enviadas para Dex. As promoções não são enviadas para Dex. As suas promoções Ventrata continuam a aplicar-se ao preço que o seu cliente paga na Ventrata. |
Bookings Sync | ✅ |
As reservas feitas na Ventrata para um produto ligado ao backend são criadas na conta do operador em Dex. Funciona da seguinte forma:
As reservas, alterações de reservas e cancelamentos efetuados na Ventrata para o produto com Backend Connected são enviados para Dex by Headout, incluindo o endereço de email do cliente.
‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, da Ventrata para Dex. Se o operador alterar ou cancelar uma reserva em Dex, a Ventrata não é notificada. Peça ao operador que o informe de quaisquer alterações que faça. |
Pickups/Dropoff Sync | ❌ |
Os dados de recolha e largada não são transmitidos a Dex. Os dados de recolha e largada não são transmitidos a Dex. Partilhe-os com o operador por outra via se um produto precisar deles. |
Custom Questions Sync | ❌ |
As respostas às suas perguntas de reserva não são transmitidas a Dex. As respostas às suas perguntas de reserva não são transmitidas a Dex. Partilhe-as com o operador por outra via se este precisar delas. |
Extras Sync | ❌ |
Os extras e complementos não são reservados em Dex. Os extras e complementos não são reservados em Dex. Apenas o produto, a opção e as unidades principais o são. |
Redemption Sync | ❌ |
Os resgates e outras alterações de estado em Dex não são enviados de volta para a Ventrata depois de uma reserva ser confirmada. Os resgates e outras alterações de estado em Dex não são enviados de volta para a Ventrata depois de uma reserva ser confirmada. Não suportado. O estado de resgate não é enviado de volta para a Ventrata. |
Pass Walkup Scanning Sync | ❌ |
A leitura de passes sem reserva (walk-up) não está disponível com Dex. A leitura de passes sem reserva (walk-up) não está disponível com Dex. |
Gift Card Sync | ❌ |
Os cartões-oferta Ventrata não são transmitidos a Dex. Os cartões-oferta Ventrata não são transmitidos a Dex. Os pagamentos com cartão-oferta ficam na Ventrata. |
✅ suportado · ❌ não suportado
Bom saber: limites e detalhes da conexão com Dex
Bom saber: limites e detalhes da conexão com Dex
Disponibilidade em tempo real: a disponibilidade vem de Dex à medida que as pessoas navegam.
Reservas num só sentido: as alterações que o operador faz em Dex não chegam à Ventrata.
Entrega do guia: Headout envia o audioguia Dex diretamente ao cliente por email. O Email tem de ser um campo de contacto obrigatório no produto.
O guia é fornecido e disponibilizado por Headout.
Os operadores podem oferecer audioguias Dex como produto autónomo, como parte de um pacote ou como venda adicional ou cruzada.
Perguntas frequentes
Recebo um erro quando guardo a configuração do backend do operador.
Recebo um erro quando guardo a configuração do backend do operador.
O mais provável é que a OCTO API Key ou o endpoint estejam incorretos. Confirme-os com o seu operador. Se o problema persistir, contacte o nosso Suporte técnico.
Não existe a caixa Backend Connected nas definições do produto.
Não existe a caixa Backend Connected nas definições do produto.
O mais provável é que o operador definido no produto não tenha um backend configurado. Verifique as definições de Backend Partner do operador e tente novamente. Se o problema persistir, contacte o nosso Suporte técnico.
O produto, a opção ou a unidade que pretendo mapear não aparece na lista pendente.
O produto, a opção ou a unidade que pretendo mapear não aparece na lista pendente.
As listas pendentes mostram o que o operador disponibilizou para si em Dex. Fale com o operador. Se o problema persistir, contacte o nosso Suporte técnico.
As reservas de um produto ligado ao backend falham.
As reservas de um produto ligado ao backend falham.
Verifique primeiro o mapeamento do produto: todas as opções e unidades têm de estar mapeadas. Depois, verifique se o horário ainda está disponível em Dex. Se o problema persistir, contacte o nosso Suporte técnico.
Erro ao criar o operador.
Erro ao criar o operador.
Provavelmente, a OCTO API Key está incorreta. Confirme-a com o seu contacto em Headout. Se o problema persistir, contacte o suporte.
O cliente não recebeu o audioguia.
O cliente não recebeu o audioguia.
Verifique se o Email é um campo de contacto obrigatório no produto e se a reserva tem um endereço de email válido. Se for o caso, contacte o seu contacto em Headout com a referência da reserva.
O produto/opção/unidade que pretendo mapear não aparece na lista pendente.
O produto/opção/unidade que pretendo mapear não aparece na lista pendente.
A lista pendente é obtida de Dex by Headout com base nos produtos que Headout disponibilizou para si. Confirme com o seu contacto em Headout. Se o problema persistir, contacte o suporte.
Recursos úteis
📚 Mais sobre as conexões Ventrata
Informações do parceiro
Headout Inc.
82 Nassau Street, #60351
New York, NY 10038, USA
ID de parceiro Ventrata: 01a0d78e-2b7c-7d13-b753-d831c9ff6b78