Integrações - Visão Geral

O que é

O módulo de Integrações reúne todos os pontos onde o Viagilize conversa com sistemas externos. Em vez de uma única tela monolítica, a plataforma divide as integrações em páginas dedicadas dentro do grupo Configurações do sidebar - cada uma com seu próprio fluxo, validações e logs.

Este artigo serve como ponto de partida: ele lista o que está disponível hoje, em que página cada integração é configurada e qual artigo específico explica o passo a passo. Use-o como índice antes de procurar uma integração específica.

Como usar

1. Vá em Configurações no sidebar para ver os itens Integrações, API e Meios de pagamento de Pagamento.
2. Identifique abaixo qual categoria atende à integração desejada e abra o artigo correspondente.

Analytics, pixels e UX

Códigos de rastreamento que ficam injetados no site público da sua empresa - Google Analytics 4, Google Tag Manager, Meta Pixel, Google Ads, TikTok Pixel, Microsoft Clarity e Hotjar. Também ficam aqui os links de avaliação no Google Meu Negócio e TripAdvisor usados pelo módulo de NPS.

• Página: Configurações > Integrações (URL /admin/configuracoes/integracoes).
• Artigos: Analytics e Rastreamento e Configurações - Integrações.

Meios de pagamento de Pagamento

Credenciais dos provedores de pagamento usados pelo checkout do site público e pelas cobranças PIX e cartão. O Viagilize suporta Mercado Pago, Asaas, Pagar.me e InfinitePay.

• Página: Configurações > Meios de pagamento de Pagamento (URL /admin/configuracoes/pagamentos).
• Artigo: Meios de pagamento de Pagamento.

API REST

Tokens Bearer com escopos granulares para que sistemas externos (ERP, CRM, automações, integradores) consumam os recursos da sua empresa via API v1. A página também expõe collection do Postman e a especificação OpenAPI.

• Página: Configurações > API, aba Tokens de Acesso (URL /admin/configuracoes/api).
• Artigos: API REST e Configurações - API e Webhooks.

Webhooks

Notificações HTTP que o Viagilize dispara para um endpoint do parceiro a cada evento relevante (reserva criada, reserva confirmada, pagamento confirmado, check-in, contrato assinado etc.). Cada webhook recebe assinatura HMAC SHA256 no header X-Viagilize-Signature.

• Página: Configurações > API, aba Webhooks (URL /admin/configuracoes/api).
• Artigos: Webhooks e Configurações - API e Webhooks.

Catálogo de produtos (feeds Meta)

Feeds XML (RSS) e CSV somente leitura, gerados pelo próprio Viagilize com as excursões ativas da sua empresa. Usados para remarketing dinâmico no Meta Ads (Catálogo Meta Commerce).

• Página: Configurações > Integrações, seção Catálogo de Produtos (Feeds).
• Artigo: Configurações - Integrações.

Casos especiais

WhatsApp não fica nessa página

O WhatsApp Business é gerido como módulo próprio (whatsapp-mensagens) com sua própria tela em Comunicação > WhatsApp. Ele se conecta via Evolution API e dispara templates automáticos (confirmações, cobranças, aniversários, cartão de embarque). Não cole credenciais de WhatsApp na página de Integrações - não há campo para isso.

Gmail é uma conexão por usuário

A integração com Gmail (envio de e-mail individual da caixa do operador) é feita por usuário em Meu Perfil, via OAuth Google. Também não aparece na página de Integrações porque é credencial pessoal, não da sua empresa.

IDs da sua empresa convivem com os do Viagilize

O Viagilize injeta os próprios códigos de analytics para monitorar performance da plataforma. Eles não interferem com os IDs da sua empresa - ambos disparam em paralelo nas mesmas páginas do site público.

Erros comuns e como resolver

• "Não encontro a página de Integrações no sidebar" - Causa: o papel atual não tem permissão de ver as configurações. Solução: peça ao Proprietário para conceder a permissão em Configurações > Perfis.
• "Configurei o Google Analytics mas não aparecem dados" - Causa: o site público ainda está em domínio temporário ou o ID foi colado em formato incorreto. Solução: confirme o domínio em Configurações > Domínio e verifique o formato G-XXXXXXXXXX na página de Integrações.
• "Preciso integrar com um sistema X mas não vejo opção" - Causa: nem toda integração tem campo dedicado - sistemas externos genéricos consomem o Viagilize via API REST e webhooks. Solução: abra Configurações > API e siga os artigos de API REST e Webhooks.

Onde encontrar

• URL: /admin/configuracoes/integracoes
• Caminho no menu: Configurações > Integrações (e itens irmãos API e Meios de pagamento de Pagamento)
• Permissão necessária: ver as configurações
• Módulo necessário: nenhum (cada integração específica pode exigir módulo - ver o artigo dedicado)

Veja também

• Analytics e Rastreamento
• Meios de pagamento de Pagamento
• API REST
• Webhooks
• Configurações - Integrações
• Configurações - API e Webhooks