Passar para o conteúdo principal

Regras de vinculação de contatos Atom <> HubSpot

Sincronize seu banco de dados com perfeição. Compreenda as regras de vinculação entre Atom e HubSpot para garantir que as informações de seus clientes estejam sempre atualizadas, evite duplicados e gerencie seu histórico sem problemas. 🚀

🔄 1. Criação de Contatos: De Atom para HubSpot

Quando um cliente te escreve pela primeira vez através do WhatsApp, Atom não envia a informação para HubSpot imediatamente para não saturar seu CRM com chats irrelevantes. O envio ocorre sob condições específicas.

🎯 Disparadores de envio

O cliente será enviado e criado no HubSpot apenas quando uma destas duas ações ocorrer:

  • O usuário passa pelos componentes do HubSpot dentro do FlowBuilder (Criar contato, Criar Deal, Mudar Lifecycle Stage).

  • A conversa é atribuída a um assessor humano (a atribuição dispara a vinculação automaticamente).

🔍 Gestão de Duplicados

Antes de criar qualquer coisa, Atom verifica se o número de telefone já existe no seu HubSpot para manter a ordem:

  • Se não existe: Atom cria um contato completamente novo e o vincula.

  • Se já existe um: Atom não cria um novo; simplesmente vincula o cliente de Atom com esse contato existente do HubSpot e atualiza suas informações.

  • Se existem vários (Conflito): O sistema para. Um alerta de "Conflito" será gerado e o assessor deve selecionar manualmente na bandeja de Atom com qual dos contatos do HubSpot deseja unificá-lo.

⚠️ Regra importante de mapeamento: Apenas as informações dos campos (propriedades) que foram configurados previamente na sua integração serão compartilhadas. Se um dado não estiver "mapeado" nas configurações, não viajará de Atom para HubSpot nem vice-versa.


🔁 2. Atualização de Contatos Vinculados

Uma vez que o contato já está unido entre ambas as plataformas pelo primeiro cruzamento, a informação se mantém viva e sincronizada em tempo real sob as seguintes regras:

Origem da Mudança

Processo de Sincronização Automática

Mudanças no HubSpot

HubSpot avisa a Atom sobre a mudança. Atom valida que o formato esteja correto (ex. que um campo numérico não receba letras). Se tudo estiver em ordem, Atom atualiza o perfil do cliente; se for inválido, ignora a mudança para proteger a base.

Mudanças em Atom

Seja por edição manual de um assessor ou por captura do FlowBuilder, Atom verifica que não haja conflitos de duplicados e envia o novo valor. HubSpot atualiza suas propriedades imediatamente.


📥 3. Criação de Contatos: De HubSpot para Atom

Se sua equipe comercial cria um contato diretamente a partir do CRM do HubSpot, a integração flui no sentido inverso para preparar o terreno:

  • Aviso inicial: HubSpot informa a Atom que nasceu um novo contato.

  • Validação de número: Atom procura em sua própria base se já existe alguém com esse número de telefone.

  • Se já existe em Atom: O sistema simplesmente os vincula e atualiza o perfil com a informação fresca que vem do HubSpot (isto é muito comum com contatos que você tinha antes de ligar a integração).

  • Se não existe em Atom: Atom o cria do zero em sua plataforma e o deixa vinculado, pronto para quando esse cliente escrever ou se lhe enviar uma campanha.


🕰️ 4. Contatos Antigos (Pré-existentes)

É vital entender que ao conectar Atom com HubSpot pela primeira vez, não será importada toda sua base de dados histórica de forma em massa para evitar sobrecargas. A sincronização é progressiva:

  • Contatos Ativos: Atom apenas trará para sua plataforma os contatos do HubSpot criados depois da conexão, ou bem, os contatos antigos que sofram alguma edição ou mudança em suas propriedades mapeadas a partir de hoje.

  • Contatos Inativos: Se você tem clientes no HubSpot que não tiveram nenhuma atualização desde que ativou a integração, Atom os considerará em repouso. Não aparecerão em sua plataforma de mensageria até que suas informações mudem no CRM ou até que o cliente decida lhe escrever.


Suas plataformas agora falam o mesmo idioma! 🚀

Ao compreender como os dados viajam entre Atom e HubSpot, você garante que sua equipe comercial e de suporte sempre tenha o contexto correto. Certifique-se de mapear bem suas propriedades e deixe que a sincronização trabalhe para você. ✅

Respondeu à sua pergunta?