Como conectar as reservas com o gestor de operações?

Este artigo explica como integrar o TourOS com o TourOS - Resource Manager. Esta ligação permite enviar automaticamente as suas reservas confirmadas para o software de gestão operacional, onde poderá gerir guias, veículos e logística.

Requisito importante: Esta integração funciona exclusivamente para experiências configuradas como "Operação Própria". Reservas de produtos de terceiros (revenda) não serão enviadas para o gestor de operações.

A configuração é feita em três fases: preparação dos produtos e parceiro no Resource Manager, criação do Webhook no TourOS e validação da segurança.

Configuração dos Produtos no Resource Manager

Antes de ativar a conexão, o TourOS - Resource Manager precisa de saber exatamente que produto corresponde a quê. Como este sistema gere a operação logística, a estrutura dos produtos é mais granular do que no TourOS.

1. Conceito: Uma Opção = Um Produto

No TourOS, pode ter uma Experiência com várias opções (ex: "Douro Tour" com opção "Regular" e "Privada"). No Resource Manager, cada opção deve ser tratada como um produto independente.

• Por exemplo, se tem uma experiência com uma opção Regular e uma Privada, terá de criar (ou editar) 2 produtos distintos no Resource Manager.

2. Preencher a Ficha de Produto

Aceda ao TourOS - Resource Manager, vá a Definições no quanto inferior esquerdo, aceda ao menu Produtos e clique em Adicionar (ou edite um existente). Preencha os campos da seguinte forma:

• Nome: O nome operacional do tour (ex: "Douro Regular").

• Tipo de produto: Selecione a categoria correta na lista.

• Meeting Point: Selecione o local de encontro predefinido.

• SKU: O seu código interno de referência.

• Bokun ID / GYG ID: Deixe estes campos vazios. Eles não são utilizados nesta integração.

• TourOS ID (O Campo Crítico): Aqui deve introduzir o identificador que combina a Experiência e a Opção, separados por um underscore (_). O formato obrigatório é: IDdaExperiência_IDdaOpção
  

  Exemplo: Se o ID da Experiência no TourOS é 104 e o ID da Opção é 5, deve escrever: 104_5

💡 Nota para utilizadores atuais: Se já utiliza o Resource Manager, apenas necessita de editar os seus produtos atuais e preencher o campo TourOS ID.

Gerar o Link de Conexão

Ainda no TourOS - Resource Manager, vamos preparar a "porta de entrada" para as reservas.

1. Vá ao menu Parceiros, dentro das Definições, e clique em Adicionar

2. Preencha o campo Nome com TourOS, por exemplo e classifique-o como Website

3. Ative a opção Ligação API.

4. No campo "Tipo de Parceiro", selecione TourOS.

5. Copie o URL que aparece no ecrã.

✋ Atenção: Não clique em "Guardar" ainda. Mantenha esta janela aberta e abra o TourOS num novo separador do navegador. Precisará de voltar aqui no final para colocar a chave secreta.

Criar o Webhook no TourOS

Agora vamos configurar o TourOS para enviar as informações para o URL que copiou.

1. Aceda à sua conta TourOS

2. Clique no seu Avatar (canto inferior esquerdo) e selecione Configurações

3. No menu, navegue até Ligações e selecione Webhooks

4. Clique em Criar Webhook

5. No campo URL, cole o link que copiou anteriormente no Resource Manager

6. No campo Versão da API seleciona sempre a versão mais recente da lista

7. Na seleção de Eventos, escolha as seguintes três opções dentro da categoria Reserva (operação interna):

   • Reserva cancelada

   • Reserva confirmada

   • Reserva atualizada

8. Clique em Adicionar.

9. Após guardar, abra novamente o Webhook que acabou de criar e copie a Secret Key (o código que começa por whsec_...).

Finalizar a ligação

Para terminar, é necessário introduzir a chave de segurança no Resource Manager para validar a comunicação.

1. Volte ao separador do TourOS - Resource Manager (onde deixou a criação do parceiro aberta).

2. No campo Api Secret Key, cole o código whsec_... que copiou do TourOS.

3. Agora sim, clique em Criar.

A partir deste momento, todas as novas reservas de experiências de "Operação Própria" serão refletidas automaticamente no seu gestor de operações.