📋 Antes de Comenzar
Para asegurar un despliegue exitoso y sin bloqueos, asegúrate de cumplir con los siguientes requisitos en tu entorno:
Contar con permisos de Administrador tanto en la plataforma Atom como en tu portal de HubSpot.
Haber iniciado el proceso de conexión desde Atom (yendo a Configuraciones > Integraciones > HubSpot) y haber autorizado el acceso.
Comprender la diferencia estructural de las entidades entre ambas plataformas:
Sistema | Entidad Principal | Descripción |
Atom | Clientes / Conversaciones | Gestión operativa de la interacción en tiempo real mediante canales conversacionales. |
HubSpot | Contactos | Registro base e histórico de datos centralizado en tu CRM. |
⚙️ Pasos del Asistente de Configuración
Una vez autorizada la conexión con tu cuenta de HubSpot, la plataforma te redirigirá automáticamente a la pantalla de One-Click Integration. Sigue esta secuencia para completar la configuración base:
Paso 1: Identificadores y Reglas de Sincronización
Define cómo el sistema buscará y guardará los números telefónicos.
Selecciona la Columna de Identificación: En el menú desplegable, elige la propiedad de teléfono de HubSpot que servirá como identificador principal. Cuando Atom cree un contacto, el número se inyectará en esta columna.
Configura las Reglas de Integración: Enciende o apaga los interruptores (toggles) para habilitar vinculaciones automáticas, exigir la obligatoriedad del correo electrónico, permitir la creación sin teléfono o activar la sobrescritura de datos.
💡 Tip: Aunque selecciones una columna principal para la escritura, el motor de Atom leerá de forma predeterminada las tres columnas telefónicas de HubSpot (Teléfono, Móvil y Teléfono de WhatsApp) para buscar coincidencias y detectar posibles conflictos de duplicidad.
Paso 2: Mapeo de Propiedades
Vincula los datos recopilados en el chat con los campos de tu CRM.
Revisa la lista de propiedades esenciales que el sistema ha emparejado por defecto.
Haz clic en Agregar mapeo si deseas conectar variables adicionales (como datos recolectados en Tipificaciones o mediante el Flowbuilder) hacia propiedades personalizadas en HubSpot.
💡 Tip: Este paso es opcional durante el asistente inicial. Si deseas avanzar rápido, puedes omitirlo y configurar más variables en el futuro desde Configuraciones > Integraciones > HubSpot, haciendo clic en Propiedades de los contactos.
Paso 3: Importación de Usuarios
Alinea a tu equipo de trabajo en ambas plataformas con un solo clic.
Selecciona la opción para importar la lista de usuarios existentes en tu cuenta de HubSpot.
Al confirmar, Atom creará automáticamente a estos usuarios como Agentes dentro de la plataforma conversacional.
Paso 4: Resumen y Confirmación
Valida tu configuración antes de encender la sincronización en vivo.
Lee detenidamente el panel de resumen con todas las reglas y mapeos seleccionados.
Si detectas algún error, utiliza el botón de retroceso. Si todo está correcto, haz clic en Guardar y Finalizar.}
⚠️ Importante: Este flujo está diseñado para un despliegue ágil. Configuraciones avanzadas, como el mapeo del Lifecycle Stage (Etapa del ciclo de vida) o las reglas de asignación a Propietarios (Owners), no se incluyen en este asistente y deben ajustarse posteriormente desde el panel de configuración de la integración.
➡️ Próximos Pasos
Una vez guardada la configuración del One-Click Integration, tu plataforma está lista para operar. Te recomendamos realizar estas acciones:
Ve al módulo de Usuarios en Atom y asigna a los Agentes recién importados a sus respectivos Grupos de atención.
Ejecuta una prueba de control: Inicia una conversación de prueba en tu canal de Atom (simulando ser un cliente) y verifica que el nuevo registro se cree exitosamente en la base de Contactos de HubSpot con las propiedades mapeadas.
Con el asistente de One-Click Integration, conectar tu CRM nunca fue tan intuitivo. Ahora cuentas con una base sólida y estructurada para que la información fluya sin fricciones, empoderando a tus asesores para brindar una atención hiper-personalizada con datos exactos en tiempo real. ✅



