Criação de Atom para HubSpot
Quando um cliente entra em contato com você pela primeira vez através do WhatsApp, a criação de seu perfil no HubSpot não ocorre instantaneamente apenas pela mensagem, mas obedece a acionadores específicos para manter sua base de dados limpa.
O contato é enviado ao HubSpot apenas quando ocorre um destes eventos:
Passa por um nó de HubSpot no Flowbuilder (ex. Criar contato, Criar Deal, ou Alterar Lifecycle Stage).
A conversa é atribuída a um consultor humano na caixa de entrada.
Ao disparar a criação, Atom executa uma Verificação de Duplicados consultando o número de telefone no HubSpot:
Cenário no HubSpot | Ação Automática do Sistema |
O número não existe | Atom cria um contato completamente novo no HubSpot e o vincula. |
Existe um único contato | Atom não cria duplicados; vincula o perfil de Atom com o de HubSpot e atualiza seus dados. |
Existem vários contatos | É gerado um Conflito. O sistema detém a automação e solicita ao consultor que selecione manualmente na caixa de entrada de Atom com qual perfil de HubSpot deve ser vinculado. |
⚠️ Importante: Neste processo de criação e vinculação, Atom enviará ao HubSpot apenas as informações dos campos que foram explicitamente "mapeados" na configuração da integração. Os dados não mapeados serão ignorados.
Atualização de Informações em Contatos Vinculados
Uma vez que o cliente está corretamente vinculado entre ambas as plataformas, a sincronização de seus dados flui de maneira bidirecional para manter tudo atualizado em tempo real.
A. Modificações originadas no HubSpot
Se sua equipe de marketing ou vendas atualiza uma propriedade do contato diretamente no HubSpot (por exemplo, altera seu produto de interesse):
HubSpot notifica imediatamente Atom sobre a alteração.
Atom audita que o dado recebido corresponda ao tipo de campo configurado (ex. que um campo numérico não receba texto).
Se a validação é bem-sucedida, Atom atualiza o perfil do cliente. Se o dado é incompatível, a alteração é ignorada para proteger suas informações.
B. Modificações originadas em Atom
Se um consultor atualiza um dado a partir do painel lateral da conversa, ou se o Flowbuilder coleta novas informações automaticamente:
Atom verifica que o contato esteja vinculado e livre de conflitos de duplicação.
O valor atualizado é enviado para HubSpot.
HubSpot sobrescreve a propriedade imediatamente, refletindo a alteração no perfil do contato.
Criação de HubSpot para Atom
A integração também funciona de forma inversa. Se sua equipe prospera e cria um contato diretamente a partir da interface do HubSpot, este é o fluxo de sincronização:
Aviso ao sistema: HubSpot notifica Atom sobre a existência deste novo registro.
Busca inteligente: Atom rastrea em sua base de dados se já existe um perfil associado a esse número de telefone.
Se já existia em Atom (Pré-integração): O sistema simplesmente os vincula e enriquece o perfil de Atom com as informações baixadas do HubSpot.
Se não existia em Atom: Atom cria um perfil de cliente do zero e o deixa vinculado silenciosamente, preparado para quando inicie uma conversa.
Contatos Pré-existentes no HubSpot
É vital compreender como o sistema lida com sua base de dados antiga no momento de ativar a integração pela primeira vez. Atom não realiza uma importação em massa automática de todos os seus contatos.
O comportamento é dividido da seguinte forma:
Contatos Ativos (Novos ou Modificados): Atom integrará apenas os contatos que forem criados no HubSpot após ativar a integração, ou aqueles contatos antigos que sofram alguma edição em suas propriedades mapeadas.
Contatos Inativos: Se um contato antigo no HubSpot não sofrer modificações nem alterações, Atom o considerará inativo. Este perfil não será visível em Atom até que o cliente lhe escreva pelo WhatsApp ou alguém edite seus dados no HubSpot.
💡 Dica: Se você precisar forçar a sincronização de uma lista de contatos antigos do HubSpot para Atom, pode realizar uma atualização em massa no HubSpot de alguma das propriedades que você tenha mapeadas. Isto disparará a notificação de atualização e Atom os absorverá.
Manter sua base de dados centralizada nunca foi tão fácil! Ao compreender como Atom e HubSpot interagem, você garante que sua equipe tenha sempre o contexto atualizado do cliente e evita a criação de perfis duplicados. Você tem o controle total para que a informação de valor flua de maneira impecável. ✅