Como configurar integrações avançadas e rastreamento na Área do Cliente

Visão geral

A Área do Cliente possui configurações e recursos de rastreamento para equipes de desenvolvimento e marketing. Essas opções permitem integrar sistemas de autenticação externa, definir o redirecionamento ao sair do ambiente, receber dados de cadastro por webhook e acompanhar as interações por meio de scripts de análise.

Quando usar este artigo

Utilize este artigo para implementar autenticação externa via API, configurar a URL de saída (logout), capturar dados de usuários no checkout via webhook ou adicionar scripts de acompanhamento de marketing na Área do Cliente.

Sintoma ou cenário

A equipe técnica ou de marketing precisa integrar a Área do Cliente a um provedor de login próprio, direcionar o usuário para uma página específica após o encerramento da sessão ou monitorar métricas de conversão e tráfego.

Benefício para o usuário ou operação

Permite autenticar o cliente em um site ou portal próprio antes de liberar o acesso à Área do Cliente;
Redireciona o usuário automaticamente para a página definida após o logout;
Envia os dados preenchidos no checkout para um banco de dados externo;
Permite acompanhar os acessos e o comportamento dos usuários com ferramentas como Google Analytics e Facebook Pixel.

Onde acessar / contexto de uso

Acesse o menu de Cliente > Área do Cliente e navegue entre as abas Avançado e Tracking.

Pré-requisitos (Antes de começar)

Perfil Exato: Usuário com a permissão Configurações - Alteração (1061) ou Acesso Administrativo (1000).
Recursos Sistêmicos: Módulo de Área do Cliente ativo, acesso à API da plataforma (disponível em todos os planos) e plano Pro (caso vá utilizar o webhook complementar de status do cliente).
Insumos e Dados Técnicos: URLs de autenticação e logout, endpoint de destino para o webhook e scripts de rastreamento (tags de monitoramento).

Causas prováveis

Necessidade operacional e técnica de alinhar a experiência de acesso e o acompanhamento de métricas da Área do Cliente com a infraestrutura e estratégias digitais da empresa.

Como fazer ou corrigir

A realização destas configurações exige conhecimentos técnicos de desenvolvimento e acesso à estrutura do site da empresa. O webhook de criação de usuário é acionado antes da aprovação do pagamento no Superlógica, podendo disparar dados mesmo em transações cujo cartão não seja aprovado.

Configurar autenticação externa, logout e webhooks (Aba Avançado)

Acesse as configurações da Área do Cliente e clique na aba Avançado.
No campo de autenticação externa, insira a URL do site responsável por autenticar o cliente antes de direcioná-lo à Área do Cliente.
No campo de redirecionamento de logout, informe a URL para onde o usuário deve ser enviado ao clicar em Sair (página de logout, página inicial do site ou outro destino).
No campo do webhook de criação de usuário, informe a URL da aplicação externa que capturará os dados e senhas informados no checkout.
Clique no botão de confirmação para salvar as alterações.

Configurar scripts de acompanhamento (Aba Tracking)

Na mesma tela de configurações da Área do Cliente, acesse a aba Tracking.
Insira os scripts de acompanhamento fornecidos pelas ferramentas de marketing (como Google Analytics e Facebook Pixel).
Clique em Salvar para ativar o monitoramento no ambiente.

Resultado esperado

Redirecionamento correto dos clientes nos fluxos de autenticação e logout, recebimento das requisições do webhook na aplicação externa e carregamento dos scripts de rastreamento nas páginas da Área do Cliente.

Quando escalar

Escale o suporte técnico caso o redirecionamento de login ou logout falhe mesmo com as URLs válidas, se os disparos do webhook não forem entregues ao endpoint configurado ou se os scripts da aba Tracking não forem carregados na página.

Informações que devem ser reunidas antes do escalonamento

Nome da licença;
URLs cadastradas nas abas Avançado e Tracking;
Scripts inseridos na aba Tracking;
Captura de tela do console do navegador ou logs do servidor demonstrando a falha no carregamento/redirecionamento.

Regras importantes / Observações

A URL do webhook de criação de usuário é chamada antes da confirmação do cadastro no Superlógica. Se a transação de cartão não for aprovada, o cliente pode não ser criado no sistema.
Para confirmar se a assinatura foi concluída com sucesso, é recomendável utilizar em conjunto o webhook Cliente status (disponível a partir do plano Pro).
A integração de autenticação externa requer o uso da API da plataforma, funcionalidade liberada em todos os planos.

Problemas comuns e como resolver

Problema: O cliente é direcionado para a URL de autenticação, mas não consegue acessar a Área do Cliente.
Causa provável: O sistema externo não está gerando ou retornando o token de acesso no formato esperado pela API.
Ação recomendada: Verifique a documentação da API e confirme se o retorno da autenticação externa está gerando o token corretamente.
Problema: O webhook dispara dados de novos usuários, mas a assinatura não consta no sistema.
Causa provável: A requisição do webhook ocorreu no checkout, mas a transação do cartão de crédito foi recusada.
Ação recomendada: Implemente o webhook Cliente status (plano Pro) para validar apenas os cadastros com pagamentos aprovados.

Dúvidas relacionadas

P: Quais opções de destino podem ser configuradas para a ação de logout? R: É possível definir o redirecionamento para a sua própria página de logout, a home do seu site ou qualquer outra URL desejada.

P: É necessário contratar um plano específico para utilizar a autenticação externa via API? R: Não, a API necessária para a integração de autenticação externa está disponível em todos os planos do sistema.

P: Como garantir que o cliente recebido via webhook teve o pagamento aprovado no checkout? R: Recomenda-se combinar o uso do webhook de criação de usuário com o webhook Cliente status, disponível a partir do plano Pro.

Palavras-chave de busca

autenticação externa area do cliente, redirecionamento logout, webhook criação usuário, tracking google analytics, facebook pixel area do cliente, configurações avançadas area do cliente