📋 Antes de Comenzar
Para asegurar que la creación automática funcione sin fricciones, verifica que cumples con los siguientes requisitos en tu entorno de Atom:
Rol de Administrador: Necesario para editar flujos y configuraciones.
Integración Activa: La conexión con HubSpot debe estar encendida en Configuraciones > Integraciones.
Mapeo de Propiedades: Debes haber configurado qué variables de Atom (ej. nombre, correo) alimentarán qué campos en HubSpot.
Formato de Teléfono: El número del cliente debe estar estrictamente en estándar internacional Formato E.164 (código de país + número, sin espacios ni símbolos adicionales).
⚠️ Importante: El Formato E.164 es un requisito estructural obligatorio de HubSpot. Si el número no cumple esta regla, la creación del contacto fallará. Además, la plataforma exige enviar al menos el número de teléfono para procesar la creación.
🧩 Componentes del Flowbuilder para HubSpot
Dentro del lienzo de diseño de tu Flowbuilder, Atom ofrece varios nodos dedicados a interactuar con HubSpot. A continuación, te explicamos la lógica de negocio de los componentes que tienen la capacidad de crear registros en tu base de datos:
1. Componente "Crear Contacto"
Este es el nodo principal y directo para la captación de nuevos leads.
Cómo funciona: Al arrastrarlo y conectarlo en tu flujo, el sistema validará automáticamente si el número telefónico del cliente ya está registrado en HubSpot.
Acción: Si no existe, Atom creará un contacto nuevo instantáneamente utilizando las propiedades que hayas mapeado previamente.
2. Componente "Crear Deal"
Aunque su objetivo principal es abrir una nueva oportunidad de negocio (Deal), también funciona como un creador de contactos de respaldo.
Cómo funciona: El sistema busca primero al cliente en HubSpot.
Acción: Si no existe, Atom creará el contacto desde cero y, en el mismo instante, creará el Deal asociado a ese nuevo perfil.
3. Componente "Actualizar Lifecycle Stage"
Utilizado para mover a un prospecto a través de tu embudo (ej. de Lead a Cliente o MQL).
Cómo funciona: Ejecuta una búsqueda previa del cliente.
Acción: Si la búsqueda es negativa, Atom creará el contacto primero y luego le asignará la etapa del ciclo de vida que configuraste en el componente.
💡 Tip: Estos tres componentes nativos cubren el 90% de las necesidades estándar. Si requieres creaciones más especializadas o necesitas inyectar propiedades que no están en tu mapeo general, te recomendamos utilizar el Componente HTTP para realizar la petición directa vía API.
🛑 Precaución: Componente "Contacto Existente"
Es vital no confundir este nodo con los anteriores. El componente Contacto Existente tiene una función puramente de validación y enrutamiento.
Para qué sirve: Sirve para buscar información y decidir qué camino toma el flujo (Ejemplo: Si existe en HubSpot, transfiérelo a un Asesor; si no existe, pídele su nombre y correo).
Restricción: Este componente NO crea ningún contacto si la búsqueda resulta negativa. Solo evalúa la condición.
🧪 Verificación de la Configuración
Para confirmar que tu flujo está inyectando los datos correctamente en tu CRM, ejecuta este protocolo de pruebas:
Escribe a tu línea de prueba de WhatsApp simulando ser un cliente completamente nuevo.
Interactúa con las opciones de tu bot hasta asegurarte de haber atravesado el nodo que configuraste (Crear Contacto, Crear Deal o Actualizar Lifecycle Stage).
Ingresa a tu cuenta de HubSpot y dirígete a Contactos > Contactos en el menú superior.
Busca tu número de teléfono de prueba; deberás visualizar un registro nuevo creado automáticamente con los datos exactos capturados por Atom.
¡Automatizar tu captación de leads es el primer paso para escalar tus ventas! Al dominar estos componentes de Flowbuilder, garantizas que cada persona que interactúe con tu negocio sea registrada de forma estructurada en HubSpot, permitiendo a tu equipo comercial enfocarse en cerrar tratos en lugar de digitar datos. ✅



