Configurações - Integrações

O que é

A página Integrações centraliza, em um único formulário, todos os códigos de rastreamento e links de plataformas externas que você quer conectar ao seu site público: ferramentas de analytics, pixels de marketing, ferramentas de análise de UX (mapas de calor, gravação de sessão), links de solicitação de avaliação e os feeds de catálogo de produtos para remarketing dinâmico.

O usuário normalmente chega aqui depois de criar a conta nas plataformas externas (Google Analytics, Meta Business, TikTok Ads, Microsoft Clarity, etc.) e precisa colar os identificadores no Viagilize para que o site público passe a disparar os eventos automaticamente. Diferente da página de API e Webhooks, aqui não há geração de chaves nem callbacks: você apenas informa IDs e URLs que já existem em sistemas de terceiros.

Como usar

1. Vá em Configurações > Integrações no sidebar (URL /admin/configuracoes/integracoes).
2. Localize a seção da plataforma que deseja conectar - a página é dividida em cinco blocos brancos empilhados.
3. Cole o ID ou a URL no campo correspondente. Cada campo aceita o formato exibido como placeholder.
4. Clique em Salvar Integrações no rodapé fixo. O botão só fica habilitado quando há alterações detectadas. Após salvar aparece o toast "Integrações salvas com sucesso!" e a página recarrega com os valores persistidos.

Analytics e Rastreamento

• Google Analytics 4 - ID de Medição (GA4): formato G-XXXXXXXXXX. Encontre em Google Analytics → Admin → Fluxos de dados → ID de medição.
• Google Tag Manager - ID do Contêiner: formato GTM-XXXXXXX. Se usar GTM, o GA4, o Meta Pixel e o Google Ads podem ser gerenciados de dentro dele e os campos abaixo se tornam opcionais.

Marketing e Conversões

• Meta Pixel (Facebook/Instagram) - ID do Pixel: número de 15 dígitos. Encontre em Meta Events Manager → Fontes de dados → Pixel.
• Google Ads - ID de Conversão (AW-123456789) e Rótulo de Conversão (opcional). Os dois aparecem juntos em Google Ads → Ferramentas → Conversões → Detalhes da tag.
• TikTok Pixel - ID do Pixel: formato CXXXXXXXXXXXXXXXXX. Encontre no TikTok Events Manager.

Ferramentas de Análise UX

• Microsoft Clarity - ID do Projeto: gratuito, gera mapas de calor e gravação de sessão. Crie a conta em clarity.microsoft.com.
• Hotjar - Site ID: número numérico (ex.: 1234567).

Avaliações Online

• Google Meu Negócio - Link de Avaliação do Google: URL completa começando com https://g.page/r/.../review. Quando preenchida, clientes que dão nota 9 ou 10 na pesquisa NPS recebem automaticamente um convite para avaliar no Google.
• TripAdvisor - Link de Avaliação do TripAdvisor: URL completa da página UserReviewEdit do estabelecimento.

Catálogo de Produtos (Feeds)

A seção Catálogo Meta Ads (Facebook/Instagram) mostra dois feeds somente leitura gerados pelo próprio Viagilize com as excursões ativas da sua empresa:

• Feed XML (RSS) - formato recomendado pela Meta. Use Visualizar para abrir em nova aba ou o botão de prancheta para copiar a URL.
• Feed CSV - alternativo, caso o XML não funcione. Use Baixar para gerar o arquivo.

As imagens são convertidas para JPG automaticamente porque a Meta não aceita WEBP. O feed é atualizado a cada 30 minutos.

Para colocar o feed em produção:

1. Acesse o Meta Commerce Manager.
2. Crie um catálogo do tipo "Outros" ou "Viagens".
3. Escolha Feed de dados como fonte.
4. Cole a URL copiada e configure a atualização a cada hora.
5. Vincule o catálogo à conta de anúncios.
6. Crie campanhas de remarketing dinâmico usando esse catálogo.

Casos especiais

Limpar uma integração já configurada

Apague o conteúdo do campo e clique em Salvar Integrações. O controlador roda array_filter no payload e remove as chaves vazias da configuração, então você pode desligar uma plataforma simplesmente esvaziando o campo - não precisa de botão "Remover".

Usar apenas o Google Tag Manager

Se você prefere gerenciar tudo via GTM, basta preencher o ID do Contêiner (GTM-XXXXXXX) e deixar GA4, Meta Pixel e Google Ads em branco. Dentro do GTM você configura as tags por conta própria. A página informa essa recomendação no texto auxiliar do bloco do GTM.

NPS integrado à avaliação do Google

O Link de Avaliação do Google não é um simples link decorativo: o módulo de pesquisa NPS usa essa URL para enviar automaticamente ao cliente promotor (nota 9 ou 10) um convite para avaliar a empresa no Google Meu Negócio. Sem o link preenchido, o convite não é enviado.

Feed Meta sempre disponível

Os links Feed XML (RSS) e Feed CSV ficam expostos independentemente de ter ou não Meta Pixel configurado - eles consomem as excursões ativas da sua empresa e funcionam mesmo sem nenhum campo de marketing preenchido.

Códigos do Viagilize coexistem

O bloco informativo azul ao final da página avisa que o Viagilize pode incluir os próprios códigos de analytics para monitoramento de performance da plataforma. Eles convivem com os códigos da sua empresa e não interferem nos dados das contas externas.

Erros comuns e como resolver

• Campo "ID de Medição (GA4)" recusado pelo Google Analytics - Causa: o ID foi colado com espaços ou com o prefixo errado. Solução: garanta o formato G- seguido de letras e números maiúsculos, sem aspas.
• "The integrações.google_review_link must be a valid URL." - Causa: a regra de validação url rejeitou um valor que não começa com http(s)://. Solução: cole a URL completa, incluindo o protocolo.
• "The integrações.* may not be greater than 50 characters." - Causa: o ID colado excedeu 50 caracteres (limite dos campos de ID) ou 500 caracteres (limite dos campos de link de avaliação). Solução: confira se copiou apenas o identificador, sem texto extra.
• Toast "URL copiada!" não aparece ao clicar no ícone de prancheta do feed - Causa: o navegador bloqueou o acesso à clipboard em conexão sem HTTPS. Solução: acesse a página pelo domínio HTTPS da sua empresa.
• Catálogo Meta importou feed vazio - Causa: você não tem excursões ativas que atendem aos critérios do feed. Solução: publique pelo menos uma excursão e aguarde até 30 minutos para o feed regenerar.

Onde encontrar

• URL: /admin/configuracoes/integracoes
• Caminho no menu: Configurações > Integrações
• Permissão necessária: ver as configurações para abrir a página; editar as configurações para salvar alterações
• Módulo necessário: nenhum

Veja também

• Configurações - API e Webhooks
• Meios de pagamento de Pagamento
• Domínio personalizado