Requisitos Prévios
Antes de que a sincronização funcione corretamente, certifique-se de atender a estes parâmetros estruturais em sua plataforma:
A integração do HubSpot deve estar configurada e ativa em seu ambiente Atom.
Os campos do Atom devem estar corretamente mapeados com as propriedades do HubSpot.
O cliente deve contar com uma chave de identificação válida (número de telefone sob o formato internacional E.164 ou um e-mail estruturado corretamente).
Estratégias de Criação e Vinculação
Para que os dados trafeguem em ambas as direções, primeiro deve existir um vínculo sólido entre o Cliente (o perfil operativo no Atom) e o Contato (o registro hospedado no HubSpot). Este link é estabelecido por duas vias:
Estratégia | Como funciona? | Ação Operativa |
Sincronização Automática | Ocorre de forma transparente. Se a regra está ativa em sua configuração, o Cliente do Atom é gerado como Contato no HubSpot assim que é atendido. | Nenhuma, o sistema trabalha em segundo plano. |
Sincronização Manual | É usada se a regra automática está desativada ou se o sistema detecta conflitos de dados (ex. perfis duplicados). | Vá para o Painel Lateral no Atom e clique em Adicionar contato ou em Criar novo contato. |
Comportamento no Flowbuilder (Fase de Bot)
É crucial compreender que um Cliente do Atom que está interagindo com um bot no Flowbuilder não será criado nem sincronizado imediatamente no HubSpot.
Para que os dados capturados pelo bot trafeguem para o HubSpot, deve ser cumprida pelo menos uma das seguintes condições:
Atribuição a um Agente: O fluxo do bot termina e o Cliente é transferido para a caixa de entrada para atendimento humano.
Uso de Nós Nativos: O Cliente passa por um nó de Criar contato, Criar deal ou Estágio de ciclo de vida dentro da estrutura de seu Flowbuilder.
Envio Personalizado: A informação é enviada proativamente para o HubSpot usando um Componente HTTP dentro do fluxo.
⚠️ Importante: A criação a partir do Flowbuilder falhará se existirem conflitos por contatos duplicados no HubSpot ou se a chave fornecida contiver um formato inválido. Certifique-se de capturar os números de WhatsApp usando estritamente o padrão E.164.
Regras de Atualização Bidirecional
Uma vez que o Cliente e o Contato estão vinculados, a atualização dos campos mapeados segue lógicas distintas dependendo da origem da mudança:
Do Atom para o HubSpot
Fase de Bot: As respostas que o Cliente dá ao bot não trafegam para o HubSpot imediatamente. Permanecem no Atom até que a conversa seja atribuída a um Agente ou os nós de atualização direta sejam executados.
Fase de Agente: Uma vez que a conversa é atribuída a um humano, todos os campos capturados trafegam e atualizam o HubSpot.
Visualização de Dados: Embora os dados do Atom trafeguem de forma imediata, seu navegador web não os exibirá magicamente na tela do HubSpot. É obrigatório atualizar a página (F5 ou botão de recarregar) para ver as alterações refletidas.
Do HubSpot para o Atom
Qualquer modificação realizada diretamente em uma propriedade do HubSpot (que esteja previamente mapeada) será refletida em tempo real e de forma automática no ambiente Atom, sem necessidade de que o Agente recarregue sua tela.
Auditoria e Resolução de Conflitos
Se como administrador você notar que a informação de um Cliente não está trafegando ou as atualizações não se refletem, execute esta estratégia de verificação:
Abra a conversa afetada dentro da caixa de entrada do Atom.
Expanda o Painel Lateral localizado à direita da tela.
Revise o status da integração e verifique que o Cliente não esteja desvinculado.
Procure por alertas de Conflitos. Se há múltiplos contatos no HubSpot compartilhando o mesmo e-mail ou telefone, o Atom pausará a sincronização para evitar sobrescrever dados críticos.
Se existe um conflito, o Agente deve resolvê-lo manualmente a partir do Painel Lateral selecionando com qual Contato exato do HubSpot a conversa deve ser unida.
💡 Dica: Instrua seus Agentes para que sempre revise o status do Painel Lateral ao iniciar uma interação. Um painel sem erros garante que todo o trabalho de tipificação e captura de dados aterrar de forma segura no HubSpot.
Compreender as regras de sincronização lhe dá controle absoluto sobre o fluxo de suas informações. Ao padronizar a captura de dados e dominar a vinculação entre plataformas, você assegura que sua equipe sempre tenha o contexto exato do cliente para fornecer um serviço omnicanal de excelência. ✅