Requisitos Prévios
Antes de configurar seus mapeamentos, certifique-se de ter o seguinte:
Acesso com função de Administrador na plataforma Atom.
Acesso à configuração de propriedades de Contatos dentro de sua conta do HubSpot.
As propriedades e opções que deseja mapear devem estar previamente criadas no HubSpot.
1. Regras de Compatibilidade de Tipos
Para garantir a integridade dos dados, o Atom aplica regras rigorosas ao conectar plataformas. Não é mais possível mapear seletores do HubSpot com campos de texto livre no Atom; o sistema exige uma correspondência exata de formatos.
Use esta matriz de equivalências para garantir um mapeamento bem-sucedido:
Propriedade no HubSpot | Tipo de Campo Compatível no Atom |
Caixa de seleção única | Seletor Simples |
Opções suspensas | Seletor Simples |
Botão de seleção (Rádio) | Seletor Simples |
Caixa de seleção múltipla | Seletor Múltiplo |
💡 Dica: Se ao tentar fazer o mapeamento notar que um campo no Atom aparece em cinza claro (indisponível), significa que seu tipo de dado estruturalmente não é compatível com a propriedade selecionada no HubSpot.
2. Lógica de Sincronização Automática
Ao salvar sua configuração, o Atom auditará que as opções entre ambas as plataformas correspondam 100% (incluindo caracteres exatos). Se detectar discrepâncias, você verá um modal explicativo; ao clicar em Aceitar, o sistema executará as seguintes regras de homologação:
Opções presentes em ambas as plataformas: Serão mantidas intactas.
Opções exclusivas do HubSpot: Serão criadas automaticamente ou reativadas no Atom para replicar exatamente a estrutura do seu CRM.
Opções exclusivas do Atom: Serão desativadas automaticamente em seu banco de dados do Atom, já que não existem em seu CRM.
⚠️ Importante: A sincronização automática será bloqueada se você exceder os limites do sistema. Isso ocorrerá se a propriedade no HubSpot tiver mais de 50 opções, se alguma dessas opções ultrapassar os 50 caracteres, ou se o campo no Atom atingiu seu limite máximo de armazenamento.
3. Gestão de Mapeamentos Existentes (Legacy)
Se você atualmente tem propriedades do tipo seletor no HubSpot mapeadas com campos de texto antigos no Atom, não se preocupe: continuarão funcionando sem alterações.
No entanto, se decidir editar um mapeamento Legacy, o sistema solicitará obrigatoriamente que você o atualize para um campo do tipo seletor compatível (ou manter o campo de texto antigo sem fazer modificações).
💡 Dica: Recomendamos planejar a migração de seus campos antigos para o novo formato de seletores. Isso padroniza a coleta de variáveis em seus Flows e elimina definitivamente os erros de digitação dos usuários.
Verificação do Mapeamento
Para auditar que sua configuração foi bem-sucedida e os dados estão fluindo, realize estas etapas:
Vá para Configuração > Conversas > Campos de informação.
Localize na lista o campo que acabou de configurar.
Observe a coluna de associações: você deve visualizar o ícone representativo do HubSpot. Isso confirma que o vínculo bidirecional está 100% ativo.
Você deu um grande passo na limpeza e proteção de seus dados!
Ao dominar essas regras de compatibilidade, você garante que as informações viajem de forma segura e estruturada entre o Atom e o HubSpot. Você tem controle total para criar automações mais robustas e manter seu CRM impecável. ✅