Ir para conteúdo principal

Conexões e parceiros explicados

Conheça a diferença entre parceiros e conexões, como utilizar a Partner Gallery, como gerir as suas conexões e criar Your Custom Connections.

A conectividade API é uma parte essencial da Ventrata e uma das principais razões pelas quais os operadores nos escolhem. A missão do nosso produto de conectividade é acelerar o crescimento dos nossos clientes através de um amplo ecossistema das conexões API e parcerias mais fiáveis e completas do setor. Continuamos a adicionar novos parceiros e estamos sempre abertos a novas parcerias que tragam valor aos nossos clientes.


Parceiros e conexões

Um parceiro é uma empresa listada na galeria de parceiros da Ventrata, como uma OTA, um sistema de reservas, uma app ou uma agência. É a empresa que disponibiliza e gere a conexão API (integração) do outro lado. Consulte a Lista de conexões e parceiros suportados para um resumo de todos os nossos parceiros.

Uma conexão é a sua própria integração com um parceiro. A conexão é criada por si a partir da ficha do parceiro e pertence apenas à sua conta, ficando sob o seu controlo as respetivas definições, os produtos a que o parceiro pode aceder e a chave API. As conexões de operador também se designam backends de operador e são geridas a partir do formulário do operador e do formulário de mapeamento do produto.


Categorias de parceiros Ventrata

Com mais de 350 conexões suportadas, agrupamos os parceiros nas seguintes categorias, de acordo com o que permitem fazer:

  • Reseller Connections - OTAs, marketplaces, revendedores, passes multiatrações e outros canais que vendem os seus produtos.

  • Operator Backends & Connections - sistemas de reservas de outros operadores, para que possa revender, fazer venda cruzada e criar pacotes com os seus produtos.

  • Apps & Software - ferramentas de comunicação, CRM, avaliações, operações, preços e muito mais.

  • Agencies and Consultants - parceiros de serviços, como programadores web, agências de marketing e consultores de travel trade. Listamos parceiros de serviços que nos foram recomendados por clientes Ventrata. A maioria trabalha diretamente consigo e pode não ter uma conexão API, pelo que a respetiva ficha não tem o botão + New Connection.

  • Your Custom Connections - integrações internas que cria com a nossa API, visíveis apenas para a sua conta.

📗 DICA

Veja todos os parceiros por categoria na nossa Lista de conexões e parceiros suportados.


Como utilizar a galeria de parceiros

A galeria de parceiros lista todos os parceiros disponíveis para a sua conta. É sempre o local mais atualizado para verificar se trabalhamos com um parceiro.

  1. No seu Ventrata Dashboard, aceda a Connections → Connections.

  2. Prima o botão + New Connection.

  3. Pesquise pelo nome ou filtre por categoria, estado, etiquetas e mercados e, em seguida, prima Search Partners.

Galeria de parceiros

Cada ficha mostra a descrição do parceiro, o website, as funcionalidades suportadas (✓/✗) e os mercados, além de um ícone de ajuda que abre o artigo do Centro de ajuda do parceiro. Mostra também Not Connected ou quantas conexões já tem com o parceiro.

Os parceiros que não estão em produção apresentam um estado:

  • Coming Soon - em desenvolvimento ou em testes, por vezes disponível primeiro para contas selecionadas.

  • Request - ainda não integrado. Informe-nos se precisar dele.

📒 NOTA

Algumas conexões têm de ser ativadas pela nossa equipa, ou requerem passos adicionais, antes de as poder ver. Pesquise no Centro de ajuda o artigo do parceiro para saber como começar.


Como criar uma conexão

  1. Na galeria de parceiros, encontre o parceiro e prima + New Connection.

  2. Preencha os detalhes da conexão. Consoante o parceiro, poderá ter de selecionar um revendedor, um checkout ou um operador. Uma conexão de revendedor utiliza os produtos, os preços e os destinos desse revendedor.

  3. (Opcional) Permita ou exclua destinos, produtos ou itens.

  4. Guarde e siga os Next steps na página da conexão, por exemplo, partilhar a chave API com o parceiro.

  5. Teste a conexão, por exemplo, pedindo ao parceiro que faça uma reserva de teste, e depois verifique-a na sua tabela de reservas.

📗 DICA

A configuração é diferente para cada parceiro e alguns passos são feitos do lado do parceiro, por isso consulte primeiro o artigo do parceiro. Para ver a chave API, a sua função precisa da permissão See Connection Key.

❗️IMPORTANTE

Alguns parceiros podem aceder à sua conta através do respetivo Partner Admin assim que cria a conexão, mesmo antes de partilhar a chave API. Crie conexões apenas com parceiros em quem confia.


Ver e gerir as suas conexões

No seu Ventrata Dashboard, aceda a Connections → Connections para ver todas as suas conexões. Abra uma conexão para editar as respetivas definições ou encontrar as credenciais.

  • As conexões de teste estão destacadas a amarelo.

  • As conexões com fichas ainda por mapear estão destacadas a vermelho.

  • As conexões eliminadas são arquivadas e podem ser restauradas.

Connections


Your Custom Connections

Se tiver as competências e as ferramentas de desenvolvimento, pode utilizar a nossa OCTO API para criar as suas próprias integrações internas, por exemplo, para enviar relatórios para a sua ferramenta de BI, sincronizar revendedores a partir do seu CRM ou alimentar o seu próprio fluxo de reservas.

Cada conexão personalizada tem um modo e permissões de leitura/escrita (Read/Write):

  • Backoffice - os dados do seu Dashboard, como relatórios, revendedores, agentes e artigos de retalho

  • Reseller - venda os seus produtos através do seu próprio canal, como revendedor

  • Web Checkout - o seu próprio fluxo de reservas, com as definições de um web checkout

Para criar uma, abra a galeria de parceiros, prima a ligação + New Connection no canto direito sem selecionar um parceiro, escolha o modo e as permissões e prima Create Octo Connection. A sua chave API encontra-se na página da conexão. Se não vir a ligação, contacte-nos pelo chat e ativamo-la para a sua conta.

❗️IMPORTANTE

A sua chave API dá acesso à sua conta Ventrata. Partilhe-a apenas com as pessoas que estão a desenvolver a sua integração.

📗 DICA

Leia os nossos artigos sobre Reporting and Export API, Reseller & Agent Management API, Retail Items via API e Webhooks. A referência completa da API está em docs.ventrata.com.


O que é o OCTO

A OCTO (Open Connectivity for Tours, Activities and Attractions) é a API de norma aberta do nosso setor, gerida por uma organização sem fins lucrativos de base associativa. Em vez de desenvolver uma integração personalizada para cada sistema, um parceiro desenvolve uma vez para a OCTO e pode conectar-se a qualquer sistema que a suporte. As conexões entram em produção mais depressa, com menos erros e menos manutenção.

A Ventrata é membro fundador da OCTO e a nossa API é construída sobre ela. É por isso que preferimos integrar novos parceiros através da OCTO e de forma direta, sem middleware.

📗 DICA

A OCTO é financiada pelos seus membros. Recomendamos vivamente a adesão como OCTO Industry Member para apoiar a norma. Saiba mais na nossa Expert Discussion: OCTO Explained.


Perguntas frequentes

A Ventrata tem integração com um parceiro específico?

Pesquise-o na galeria de parceiros ou na Lista de conexões e parceiros suportados, ou pergunte à Venny no chat. Se não estiver listado, consulte Como pedir uma nova conexão API ou um novo parceiro.

Não encontro um parceiro que esperava ver. Porquê?

Pesquise na galeria de parceiros e no Centro de ajuda, ou pergunte à Venny. Se mesmo assim não o encontrar, contacte-nos pelo chat.

A minha ferramenta (por exemplo, de contabilidade, CRM ou marketing) não está listada. Posso conectá-la na mesma?

Muitas vezes, sim. A nossa conexão Zapier permite enviar dados da Ventrata para muitas outras apps sem código. Também pode utilizar webhooks, criar uma das Your Custom Connections ou pedir ajuda a um parceiro de serviços em Agencies and Consultants.

Posso criar a minha própria conexão?

Sim. Pode criar Your Custom Connections por si próprio ou encontrar um programador em Agencies and Consultants. Consulte Como pedir uma nova conexão API ou um novo parceiro para conhecer o processo completo.

Tenho de ser membro da OCTO?

Não. Enquanto cliente Ventrata, já beneficia da OCTO, mas incentivamo-lo vivamente a aderir como membro para apoiar a iniciativa.

Isto respondeu à sua pergunta?