📋 Antes de Começar
Para garantir que a criação automática funcione sem problemas, verifique se você atende aos seguintes requisitos em seu ambiente do Atom:
Papel de Administrador: Necessário para editar fluxos e configurações.
Integração Ativa: A conexão com HubSpot deve estar ativada em Configurações > Integrações.
Mapeamento de Propriedades: Você deve ter configurado quais variáveis do Atom (ex. nome, e-mail) alimentarão quais campos no HubSpot.
Formato de Telefone: O número do cliente deve estar rigorosamente em padrão internacional Formato E.164 (código do país + número, sem espaços ou símbolos adicionais).
⚠️ Importante: O Formato E.164 é um requisito estrutural obrigatório do HubSpot. Se o número não atender a essa regra, a criação do contato falhará. Além disso, a plataforma exige enviar pelo menos o número de telefone para processar a criação.
🧩 Componentes do Flowbuilder para HubSpot
Dentro da tela de design do seu Flowbuilder, o Atom oferece vários nós dedicados a interagir com o HubSpot. A seguir, explicamos a lógica de negócios dos componentes que têm a capacidade de criar registros em seu banco de dados:
1. Componente "Criar Contato"
Este é o nó principal e direto para a captura de novos leads.
Como funciona: Ao arrastar e conectá-lo em seu fluxo, o sistema validará automaticamente se o número telefônico do cliente já está registrado no HubSpot.
Ação: Se não existir, o Atom criará um novo contato instantaneamente usando as propriedades que você mapeou anteriormente.
2. Componente "Criar Oportunidade"
Embora seu objetivo principal seja abrir uma nova oportunidade de negócio (Deal), também funciona como um criador de contatos de backup.
Como funciona: O sistema busca primeiro o cliente no HubSpot.
Ação: Se não existir, o Atom criará o contato do zero e, no mesmo instante, criará a Oportunidade associada a esse novo perfil.
3. Componente "Atualizar Estágio do Ciclo de Vida"
Utilizado para mover um prospecto através de seu funil (ex. de Lead para Cliente ou MQL).
Como funciona: Executa uma busca prévia do cliente.
Ação: Se a busca for negativa, o Atom criará o contato primeiro e depois lhe atribuirá o estágio do ciclo de vida que você configurou no componente.
💡 Dica: Esses três componentes nativos cobrem 90% das necessidades padrão. Se você precisar de criações mais especializadas ou injetar propriedades que não estão em seu mapeamento geral, recomendamos usar o Componente HTTP para fazer a solicitação direta via API.
🛑 Precaução: Componente "Contato Existente"
É vital não confundir este nó com os anteriores. O componente Contato Existente tem uma função puramente de validação e roteamento.
Para que serve: Serve para buscar informações e decidir qual caminho o fluxo segue (Exemplo: Se existe no HubSpot, transfira-o para um Consultor; se não existe, peça seu nome e e-mail).
Restrição: Este componente NÃO cria nenhum contato se a busca resultar negativa. Apenas avalia a condição.
🧪 Verificação da Configuração
Para confirmar que seu fluxo está injetando os dados corretamente em seu CRM, execute este protocolo de testes:
Envie uma mensagem para sua linha de teste do WhatsApp simulando ser um cliente completamente novo.
Interaja com as opções de seu bot até ter certeza de que passou pelo nó que você configurou (Criar Contato, Criar Oportunidade ou Atualizar Estágio do Ciclo de Vida).
Acesse sua conta do HubSpot e vá para Contatos > Contatos no menu superior.
Procure seu número de telefone de teste; você deverá visualizar um novo registro criado automaticamente com os dados exatos capturados pelo Atom.
Automatizar sua captura de leads é o primeiro passo para escalar suas vendas! Ao dominar esses componentes do Flowbuilder, você garante que cada pessoa que interagir com seu negócio seja registrada de forma estruturada no HubSpot, permitindo que sua equipe comercial se concentre em fechar negócios em vez de digitar dados. ✅