📋 Antes de Começar
Para garantir um desempenho bem-sucedido e sem bloqueios, certifique-se de atender aos seguintes requisitos em seu ambiente:
Ter permissões de Administrador tanto na plataforma Atom quanto no seu portal HubSpot.
Ter iniciado o processo de conexão a partir do Atom (acessando Configurações > Integrações > HubSpot) e ter autorizado o acesso.
Compreender a diferença estrutural das entidades entre as duas plataformas:
Sistema | Entidade Principal | Descrição |
Atom | Clientes / Conversas | Gestão operacional da interação em tempo real através de canais conversacionais. |
HubSpot | Contatos | Registro base e histórico de dados centralizado em seu CRM. |
⚙️ Etapas do Assistente de Configuração
Uma vez autorizada a conexão com sua conta HubSpot, a plataforma o redirecionará automaticamente para a tela de Integração em Um Clique. Siga essa sequência para concluir a configuração básica:
Etapa 1: Identificadores e Regras de Sincronização
Defina como o sistema buscará e salvará os números de telefone.
Selecione a Coluna de Identificação: No menu suspenso, escolha a propriedade de telefone do HubSpot que servirá como identificador principal. Quando o Atom criar um contato, o número será inserido nesta coluna.
Configure as Regras de Integração: Ative ou desative os controles deslizantes (toggles) para habilitar vinculações automáticas, exigir obrigatoriedade do e-mail, permitir criação sem telefone ou ativar sobrescrita de dados.
💡 Dica: Embora você selecione uma coluna principal para escrita, o mecanismo do Atom lerá por padrão as três colunas de telefone do HubSpot (Telefone, Celular e Telefone do WhatsApp) para procurar correspondências e detectar possíveis conflitos de duplicidade.
Etapa 2: Mapeamento de Propriedades
Vincule os dados coletados no chat com os campos de seu CRM.
Revise a lista de propriedades essenciais que o sistema emparelhou por padrão.
Clique em Adicionar mapeamento se desejar conectar variáveis adicionais (como dados coletados em Tipificações ou através do Construtor de Fluxos) para propriedades personalizadas no HubSpot.
💡 Dica: Esta etapa é opcional durante o assistente inicial. Se desejar avançar rapidamente, você pode pulá-la e configurar mais variáveis no futuro em Configurações > Integrações > HubSpot, clicando em Propriedades dos contatos.
Etapa 3: Importação de Usuários
Alinhe seu time em ambas as plataformas com um único clique.
Selecione a opção para importar a lista de usuários existentes em sua conta HubSpot.
Ao confirmar, o Atom criará automaticamente esses usuários como Agentes dentro da plataforma conversacional.
Etapa 4: Resumo e Confirmação
Valide sua configuração antes de ativar a sincronização ao vivo.
Leia atentamente o painel de resumo com todas as regras e mapeamentos selecionados.
Se detectar algum erro, use o botão de retrocesso. Se tudo estiver correto, clique em Salvar e Finalizar.
⚠️ Importante: Este fluxo foi projetado para um desempenho ágil. Configurações avançadas, como o mapeamento do Estágio do Ciclo de Vida ou as regras de atribuição a Proprietários (Owners), não estão incluídas neste assistente e devem ser ajustadas posteriormente no painel de configuração da integração.
➡️ Próximos Passos
Uma vez salva a configuração da Integração em Um Clique, sua plataforma está pronta para operar. Recomendamos realizar essas ações:
Vá para o módulo de Usuários no Atom e atribua os Agentes recém-importados aos seus respectivos Grupos de atendimento.
Execute um teste de controle: Inicie uma conversa de teste em seu canal Atom (simulando ser um cliente) e verifique se o novo registro é criado com sucesso na base de Contatos do HubSpot com as propriedades mapeadas.
Com o assistente de Integração em Um Clique, conectar seu CRM nunca foi tão intuitivo. Agora você tem uma base sólida e estruturada para que as informações fluam sem atritos, capacitando seus consultores a fornecer um atendimento hiper-personalizado com dados precisos em tempo real. ✅



