Requisitos Previos
Antes de comenzar con la configuración, asegúrate de cumplir con los siguientes puntos en tu entorno de trabajo:
Tener la integración nativa de HubSpot activa y autenticada en Atom.
Poseer rol de Administrador en la plataforma para gestionar campos de información.
Asegurar que las propiedades que deseas importar ya estén creadas y con opciones configuradas dentro de tu cuenta de HubSpot.
1. Iniciar la Creación del Campo
Para comenzar a extraer la información, sigue esta ruta de acción:
Ve a Configuración > Campos de información en Atom.
Haz clic en el botón azul para crear un nuevo campo.
Elige el tipo de campo: Selector Simple o Selector Múltiple.
En el área de opciones, localiza y haz clic en el botón Importar (identificado con el icono característico de HubSpot).
2. Seleccionar la Propiedad Compatible
Al abrir el modal de importación, Atom filtrará automáticamente las propiedades de tu CRM para mostrarte únicamente aquellas que son compatibles con el tipo de selector que elegiste al crear tu campo.
Para garantizar un flujo de información exacto, el sistema utiliza la siguiente matriz de equivalencias estructurales:
Propiedad en HubSpot | Tipo de Selector Compatible en Atom |
| Selector Simple |
| Selector Simple |
| Selector Simple |
| Selector Múltiple |
💡 Tip: Si al intentar realizar el mapeo notas que un campo en Atom aparece en color gris claro (no disponible), significa que su tipo de dato estructuralmente no es compatible con la propiedad seleccionada en HubSpot.
⚠️ Importante: La importación estática no soporta propiedades dinámicas. Si una propiedad de HubSpot se alimenta de otras fuentes externas, aparecerá deshabilitada en Atom.
Lógica de Sincronización de Opciones
Al guardar la configuración, Atom evaluará si las opciones de la propiedad de HubSpot y tu campo en Atom coinciden al 100%. Si existen diferencias, el sistema desplegará un modal explicativo detallando las acciones de sincronización automática.
Una vez que confirmes la acción, la plataforma aplicará las siguientes reglas para homologar los datos:
Opciones en ambas plataformas: Se conservarán intactas y vinculadas.
Opciones exclusivas de HubSpot: Se crearán de forma automática (o se reactivarán) en Atom para que la estructura coincida exactamente con la de tu CRM.
Opciones exclusivas de Atom: Se desactivarán automáticamente en tu base de datos, ya que no existen en HubSpot. Sin embargo, el sistema mantiene la capacidad de reactivarlas en el futuro si vuelven a ser necesarias para hacer match con una nueva configuración.
3. Ejecutar la Importación y Configurar el Mapeo
Dependiendo de la cantidad y longitud de los datos que traigas desde HubSpot, el sistema procesará la importación bajo uno de estos dos escenarios:
Escenario A: Importación con Mapeo Automático
Este escenario ocurre cuando tu propiedad de HubSpot cumple con el estándar de plataforma: menos de 50 opciones en total y ningún valor excede los 50 caracteres.
Al cumplir la regla, habilita el mapeo automático y haz clic en Guardar.
Restricción de seguridad: Para garantizar que la sincronización bidireccional funcione sin fallas, la edición local se bloqueará. No podrás modificar, agregar ni reordenar estas opciones dentro de Atom. Si necesitas hacer cambios, deberás eliminar el mapeo primero.
Escenario B: Importación Simple (Límites excedidos)
Se activa cuando la propiedad en HubSpot supera la capacidad (más de 50 opciones o textos de más de 50 caracteres).
El mapeo automático se deshabilitará.
Atom realizará una importación parcial: extraerá solo las primeras 50 opciones y truncará los textos a un máximo de 50 caracteres.
Una vez guardado, el campo se desconecta de HubSpot y se comporta como un campo nativo de Atom, dándote libertad total para editar, agregar o desactivar opciones a tu gusto.
💡 Tip: Si tu objetivo es mantener un mapeo bidireccional activo (Escenario A), audita las propiedades en HubSpot antes de importarlas para asegurarte de que no superen los límites de 50 opciones/50 caracteres.
Auditoría y Verificación
Para confirmar que tu configuración fue exitosa, revisa cómo se comporta el campo en tu plataforma:
Si el mapeo automático fue exitoso: En la tabla principal de campos verás el icono de HubSpot. Además, si vas a Configuraciones > Integraciones > HubSpot (pestaña Propiedades de los Contactos), verás el campo listado y confirmando su sincronización. Sus controles de edición en Atom estarán bloqueados.
Si ocurrió una importación simple: El campo no tendrá el icono de HubSpot en la tabla principal y, al ingresar a su configuración, tendrás los controles habilitados para modificar cualquier opción.
Con esta herramienta tienes el control total para asegurar que la información fluya de manera impecable entre tus plataformas. Mantener tu ecosistema sincronizado y libre de errores tipográficos te permite escalar tus automatizaciones y flujos de trabajo con absoluta confianza. ✅