Requisitos Prévios
Antes de começar com a configuração, certifique-se de cumprir com os seguintes pontos em seu ambiente de trabalho:
Ter a integração nativa de HubSpot ativa e autenticada no Atom.
Possuir rol de Administrador na plataforma para gerenciar campos de informação.
Garantir que as propriedades que deseja importar já estejam criadas e com opções configuradas dentro de sua conta do HubSpot.
1. Iniciar a Criação do Campo
Para começar a extrair a informação, siga esta rota de ação:
Vá para Configuração > Campos de informação no Atom.
Clique no botão azul para criar um novo campo.
Escolha o tipo de campo: Seletor Simples ou Seletor Múltiplo.
Na área de opções, localize e clique no botão Importar (identificado com o ícone característico do HubSpot).
2. Selecionar a Propriedade Compatível
Ao abrir o modal de importação, o Atom filtrará automaticamente as propriedades de seu CRM para mostrar apenas aquelas que são compatíveis com o tipo de seletor que você escolheu ao criar seu campo.
Para garantir um fluxo de informação exato, o sistema utiliza a seguinte matriz de equivalências estruturais:
Propriedade no HubSpot | Tipo de Seletor Compatível no Atom |
| Seletor Simples |
| Seletor Simples |
| Seletor Simples |
| Seletor Múltiplo |
💡 Dica: Se ao tentar fazer o mapeamento notar que um campo no Atom aparece em cinza claro (não disponível), significa que seu tipo de dado estruturalmente não é compatível com a propriedade selecionada no HubSpot.
⚠️ Importante: A importação estática não suporta propriedades dinâmicas. Se uma propriedade do HubSpot se alimenta de outras fontes externas, aparecerá desabilitada no Atom.
Lógica de Sincronização de Opções
Ao salvar a configuração, o Atom avaliará se as opções da propriedade do HubSpot e seu campo no Atom coincidem 100%. Se existirem diferenças, o sistema exibirá um modal explicativo detalhando as ações de sincronização automática.
Uma vez que confirmar a ação, a plataforma aplicará as seguintes regras para homogeneizar os dados:
Opções em ambas as plataformas: Serão mantidas intactas e vinculadas.
Opções exclusivas do HubSpot: Serão criadas automaticamente (ou reativadas) no Atom para que a estrutura coincida exatamente com a de seu CRM.
Opções exclusivas do Atom: Serão desativadas automaticamente em sua base de dados, já que não existem no HubSpot. No entanto, o sistema mantém a capacidade de reativá-las no futuro se voltarem a ser necessárias para fazer match com uma nova configuração.
3. Executar a Importação e Configurar o Mapeamento
Dependendo da quantidade e comprimento dos dados que você trazer do HubSpot, o sistema processará a importação em um destes dois cenários:
Cenário A: Importação com Mapeamento Automático
Este cenário ocorre quando sua propriedade do HubSpot cumpre com o padrão de plataforma: menos de 50 opções no total e nenhum valor excede 50 caracteres.
Ao cumprir a regra, habilite o mapeamento automático e clique em Salvar.
Restrição de segurança: Para garantir que a sincronização bidirecional funcione sem falhas, a edição local será bloqueada. Você não poderá modificar, adicionar nem reordenar estas opções dentro do Atom. Se precisar fazer alterações, deverá eliminar o mapeamento primeiro.
Cenário B: Importação Simples (Limites Excedidos)
Se ativa quando a propriedade no HubSpot supera a capacidade (mais de 50 opções ou textos de mais de 50 caracteres).
O mapeamento automático será desabilitado.
O Atom realizará uma importação parcial: extrairá apenas as primeiras 50 opções e truncará os textos a um máximo de 50 caracteres.
Uma vez salvo, o campo se desconecta do HubSpot e se comporta como um campo nativo do Atom, oferecendo total liberdade para editar, adicionar ou desativar opções ao seu gosto.
💡 Dica: Se seu objetivo é manter um mapeamento bidirecional ativo (Cenário A), audite as propriedades no HubSpot antes de importá-las para garantir que não ultrapassem os limites de 50 opções/50 caracteres.
Auditoria e Verificação
Para confirmar que sua configuração foi bem-sucedida, revise como o campo se comporta em sua plataforma:
Se o mapeamento automático foi bem-sucedido: Na tabela principal de campos você verá o ícone do HubSpot. Além disso, se for para Configurações > Integrações > HubSpot (aba Propriedades dos Contatos), verá o campo listado e confirmando sua sincronização. Seus controles de edição no Atom estarão bloqueados.
Se ocorreu uma importação simples: O campo não terá o ícone do HubSpot na tabela principal e, ao acessar sua configuração, você terá os controles habilitados para modificar qualquer opção.
Com esta ferramenta você tem o controle total para garantir que a informação flua de maneira impecável entre suas plataformas. Manter seu ecossistema sincronizado e livre de erros tipográficos permite que você escale suas automações e fluxos de trabalho com absoluta confiança. ✅