Requisitos Prévios
Para visualizar ou modificar o estado da sua integração, certifique-se de cumprir com os seguintes parâmetros operacionais:
Contar com um usuário com papel de Administrador dentro da plataforma Atom.
Ter credenciais de acesso com privilégios de Administrador na conta do HubSpot que deseja vincular.
Conhecer a rota de navegação principal: Vá para Configurações > Integrações.
🎥 Sugestão Visual: [Inserir um GIF navegando desde o menu principal do Atom até o cartão do HubSpot no módulo de Integrações, mostrando os diferentes estados]
Identificação dos Estados de Integração
Ao ingressar no módulo de integrações e localizar o cartão do HubSpot, você visualizará um dos seguintes estados. Cada um representa o nível de progresso, a saúde ou as possíveis interrupções da sua implementação.
🔌 Estado Inicial: Conectar
Este é o cenário padrão. Significa que a integração ainda não foi iniciada e não existe nenhuma troca de dados entre Atom e HubSpot.
Ação sugerida: Clique no botão CONECTAR para abrir a janela de autenticação e autorizar o acesso entre ambas as contas.
⚙️ Estado de Transição: Configuração pendente
O processo de autorização (login e permissões) foi realizado com sucesso, mas faltam os ajustes operacionais finais, conhecidos como One Click Integration.
Ação sugerida: Clique no cartão para ingressar na configuração e completar o mapeamento de campos. Este passo é fundamental, pois define exatamente quais informações dos seus clientes serão sincronizadas.
🟢 Estado Ótimo: Conectado
A integração está 100% ativa e funcionando perfeitamente. Todas as permissões foram concedidas e a configuração inicial está salva.
Ação sugerida: Comece a operar! Neste ponto você já pode utilizar todas as funcionalidades nativas: visualizar informações no Painel Lateral, executar Tarefas Automáticas ou projetar fluxos no Flowbuilder para trocar dados com seu CRM.
⏸️ Estado Estratégico: Pausada
Este estado interrompe temporariamente a sincronização de dados entre ambas as plataformas.
Ação sugerida: Para reativar o fluxo de dados, clique no menu de opções (três pontos
⋮) localizado no canto superior direito do cartão do HubSpot e selecione Reativar.
💡 Dica: É uma excelente prática pausar a integração quando você precisar realizar modificações estruturais em massa no HubSpot ou no Atom (ex. limpeza de bases de dados ou mudança de propriedades), evitando assim enviar informações desatualizadas ou gerar erros durante a sua manutenção.
🔴 Estado Crítico: Com erro
Este indicador alerta que a integração quebrou devido a um problema de permissões ou um conflito de autenticação. Geralmente ocorre se o usuário no HubSpot perdeu seus privilégios administrativos ou se o token de segurança foi revogado pelo CRM.
Ação sugerida: Clique no menu de opções (três pontos
⋮) para Reconectar a conta e renovar as permissões do zero.
⚠️ Importante: Se você experientar quedas recorrentes para o estado "Com erro", valide rigorosamente que o usuário do HubSpot que realizou a conexão inicial mantenha intactos seus privilégios de superadministrador e que sua conta não tenha sido desativada ou suspensa.
⚠️ Estado de Interrupção: Conexão falhada
Diferentemente do estado crítico, esta mensagem aparece exclusivamente quando se tentou estabelecer a conexão inicial (ou uma reconexão) e o processo falhou por um problema de comunicação de rede (timeout) entre os servidores da Atom e HubSpot.
Ação sugerida: Verifique sua conexão de internet, certifique-se de que não existem bloqueios de rede corporativa ou VPNs restritivas, e clique no botão TENTAR NOVAMENTE para lançar novamente o fluxo de autenticação.
Identificar e interpretar corretamente o estado da sua integração lhe proporciona autonomia total sobre sua plataforma. Com este conhecimento, você poderá diagnosticar rapidamente qualquer eventualidade, assegurar a continuidade operacional do seu time e manter seu ecossistema de dados perfeitamente sincronizado. ✅