📋 Antes de Comenzar
Para asegurar un mapeo exitoso, verifica que cumples con los siguientes requisitos en tu entorno de trabajo:
Tener una cuenta con rol de Administrador en la plataforma Atom.
Contar con la integración de HubSpot previamente conectada.
Identificar las propiedades en HubSpot que deseas sincronizar y confirmar que sean de un tipo compatible (revisa la matriz de compatibilidad más abajo).
⚙️ Configuración Paso a Paso
Puedes configurar tus propiedades durante la conexión inicial (One Click Integration) o en cualquier momento desde el panel general.
Ve a Configuraciones > Integraciones en el menú lateral izquierdo de Atom.
Selecciona tu integración activa de HubSpot y navega a la sección de Configuración de propiedades.
Selecciona la propiedad de HubSpot que deseas sincronizar.
En el menú desplegable contiguo, elige el campo de Atom con el cual deseas emparejarlo.
Haz clic en Guardar para activar la suscripción bidireccional.
💡 Tip: Si el campo que necesitas no existe en Atom, el selector te dará la opción de crearlo en ese momento utilizando el mismo nombre que tiene en HubSpot. Esto agiliza la configuración y mantiene la uniformidad de tu base de datos.
Una vez guardado, los datos viajarán de manera bidireccional: si un Agente actualiza un dato desde el Panel Lateral de Atom o a través del Flowbuilder, el cambio se reflejará instantáneamente en HubSpot, y viceversa. Atom se encargará automáticamente de las conversiones de formato necesarias.
🧩 Reglas de Compatibilidad de Propiedades
Para que la información fluya sin errores, es fundamental conocer qué tipos de datos admite la integración:
Estado | Tipos de Propiedades en HubSpot |
Soportadas | Texto (una/varias líneas), texto enriquecido, correo, teléfono, número, selector de fecha/hora, casillas de verificación (única/múltiple), botones de selección (Radio buttons) y listas desplegables (Dropdown). |
No Soportadas | Propiedades con cálculos internos o dependencias externas (Cálculo, Acumulación, Sincronización de propiedades, Archivo, Usuario o URL). |
🔒 Campos del Sistema y Datos Unidireccionales
Existen propiedades estratégicas que el sistema administra de forma automática. Estas no requieren configuración manual en este módulo:
Campos por defecto: Propiedades clave, como el teléfono (en Formato E.164), ya se encuentran mapeadas internamente para garantizar la creación del registro.
Campos unidireccionales: Información operativa como el enlace de la conversación, la Tipificación, el Agente asignado o los datos de captura de Meta (campañas CTWA) viajan exclusivamente de Atom hacia HubSpot de forma automática.
⚠️ Notas Técnicas y Gestión de Mapeos
Para propiedades de opciones cerradas (listas desplegables, botones de selección o casillas), el valor enviado desde Atom debe coincidir exactamente con el configurado en HubSpot (respetando mayúsculas, minúsculas y espacios). Enviar un dato discrepante causará un conflicto y la sincronización fallará.
Si modificas las reglas o valores de una propiedad en HubSpot (por ejemplo, agregando una nueva opción a un menú desplegable), debes ingresar a Atom y realizar nuevamente el mapeo para que el sistema actualice y reconozca las nuevas reglas.
Gestión de Mapeos Existentes
Si necesitas hacer ajustes en una propiedad que ya está operando, tienes dos caminos:
Desactivar el mapeo (Recomendado): Al apagar el interruptor, la información dejará de viajar temporalmente hacia el CRM, pero tu configuración se conservará intacta.
Eliminar el mapeo: Si borras el mapeo, se perderá la suscripción a los cambios y la información dejará de sincronizarse de manera definitiva.
🧪 Auditoría y Verificación
Para confirmar que tu configuración se está ejecutando perfectamente, realiza esta prueba cruzada:
Ingresa al módulo de Conversaciones en Atom y abre el chat de un cliente de prueba.
Desde el Panel Lateral derecho, modifica el valor de uno de los campos que acabas de mapear.
Ingresa a tu cuenta de HubSpot, busca el registro de ese Contacto y verifica que la propiedad se haya actualizado instantáneamente.
Realiza el proceso inverso: modifica el dato directamente en HubSpot y valida que, al recargar el Panel Lateral en Atom, el campo refleje la nueva información.
Mantener tu ecosistema sincronizado elimina el trabajo manual y asegura la integridad absoluta de tu información. Al dominar el mapeo de propiedades, empoderas a tu equipo con datos precisos en tiempo real, listos para cerrar más ventas y brindar una experiencia de usuario impecable. ✅