📋 Antes de Começar
Para garantir um mapeamento bem-sucedido, verifique se você atende aos seguintes requisitos em seu ambiente de trabalho:
Ter uma conta com função de Administrador na plataforma Atom.
Contar com a integração do HubSpot previamente conectada.
Identificar as propriedades no HubSpot que deseja sincronizar e confirmar que sejam de um tipo compatível (verifique a matriz de compatibilidade abaixo).
⚙️ Configuração Passo a Passo
Você pode configurar suas propriedades durante a conexão inicial (One Click Integration) ou a qualquer momento no painel geral.
Vá para Configurações > Integrações no menu lateral esquerdo do Atom.
Selecione sua integração ativa do HubSpot e navegue até a seção de Configuração de Propriedades.
Selecione a propriedade do HubSpot que deseja sincronizar.
No menu suspenso ao lado, escolha o campo do Atom com o qual deseja associá-lo.
Clique em Salvar para ativar a assinatura bidirecional.
💡 Dica: Se o campo que você precisa não existir no Atom, o seletor oferecerá a opção de criá-lo naquele momento usando o mesmo nome que tem no HubSpot. Isso agiliza a configuração e mantém a uniformidade de seu banco de dados.
Uma vez salvo, os dados viajarão de forma bidirecional: se um Agente atualizar um dado no Painel Lateral do Atom ou por meio do Flowbuilder, a mudança será refletida instantaneamente no HubSpot, e vice-versa. O Atom se encarregará automaticamente das conversões de formato necessárias.
🧩 Regras de Compatibilidade de Propriedades
Para que as informações fluam sem erros, é fundamental conhecer quais tipos de dados a integração suporta:
Status | Tipos de Propriedades no HubSpot |
Suportadas | Texto (uma/várias linhas), texto enriquecido, email, telefone, número, seletor de data/hora, caselas de seleção (única/múltipla), botões de seleção (Radio buttons) e listas suspensas (Dropdown). |
Não Suportadas | Propriedades com cálculos internos ou dependências externas (Cálculo, Acúmulo, Sincronização de propriedades, Arquivo, Usuário ou URL). |
🔒 Campos do Sistema e Dados Unidirecionais
Existem propriedades estratégicas que o sistema gerencia automaticamente. Essas não requerem configuração manual neste módulo:
Campos padrão: Propriedades-chave, como o telefone (em Formato E.164), já estão mapeadas internamente para garantir a criação do registro.
Campos unidirecionais: Informações operacionais como o link da conversa, a Tipificação, o Agente atribuído ou os dados de captura do Meta (campanhas CTWA) viajam exclusivamente do Atom para o HubSpot automaticamente.
⚠️ Notas Técnicas e Gestão de Mapeamentos
Para propriedades de opções fechadas (listas suspensas, botões de seleção ou caselas), o valor enviado do Atom deve corresponder exatamente ao configurado no HubSpot (respeitando maiúsculas, minúsculas e espaços). Enviar um dado discrepante causará um conflito e a sincronização falhará.
Se você modificar as regras ou valores de uma propriedade no HubSpot (por exemplo, adicionando uma nova opção a um menu suspenso), deve entrar no Atom e realizar novamente o mapeamento para que o sistema atualize e reconheça as novas regras.
Gestão de Mapeamentos Existentes
Se você precisar fazer ajustes em uma propriedade que já está operacional, tem dois caminhos:
Desativar o mapeamento (Recomendado): Ao desativar a chave, as informações deixarão de viajar temporariamente para o CRM, mas sua configuração será preservada intacta.
Excluir o mapeamento: Se você deletar o mapeamento, a assinatura das alterações será perdida e as informações deixarão de sincronizar de forma definitiva.
🧪 Auditoria e Verificação
Para confirmar que sua configuração está sendo executada perfeitamente, realize este teste cruzado:
Acesse o módulo de Conversas no Atom e abra o chat de um cliente de teste.
No Painel Lateral direito, modifique o valor de um dos campos que acabou de mapear.
Acesse sua conta do HubSpot, procure o registro do Contato e verifique se a propriedade foi atualizada instantaneamente.
Realize o processo inverso: modifique o dado diretamente no HubSpot e valide que, ao recarregar o Painel Lateral no Atom, o campo reflita a nova informação.
Manter seu ecossistema sincronizado elimina o trabalho manual e garante a integridade absoluta de suas informações. Ao dominar o mapeamento de propriedades, você capacita sua equipe com dados precisos em tempo real, prontos para fechar mais vendas e oferecer uma experiência do usuário impecável. ✅