Requisitos Previos
Antes de configurar tus mapeos, asegúrate de contar con lo siguiente:
Acceso con rol de Administrador en la plataforma Atom.
Acceso a la configuración de propiedades de Contactos dentro de tu cuenta de HubSpot.
Las propiedades y opciones que deseas mapear deben estar previamente creadas en HubSpot.
1. Reglas de Compatibilidad de Tipos
Para garantizar la integridad de los datos, Atom aplica reglas estrictas al conectar plataformas. Ya no es posible mapear selectores de HubSpot con campos de texto libre en Atom; el sistema exige una coincidencia exacta de formatos.
Utiliza esta matriz de equivalencias para asegurar un mapeo exitoso:
Propiedad en HubSpot | Tipo de Campo Compatible en Atom |
Casilla de verificación única | Selector Simple |
Opciones desplegables | Selector Simple |
Botón de selección (Radio) | Selector Simple |
Casilla de verificación múltiple | 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.
2. Lógica de Sincronización Automática
Al momento de guardar tu configuración, Atom auditará que las opciones entre ambas plataformas coincidan al 100% (incluyendo caracteres exactos). Si detecta discrepancias, visualizarás un modal explicativo; al hacer clic en Aceptar, el sistema ejecutará las siguientes reglas de homologación:
Opciones presentes en ambas plataformas: Se conservarán intactas.
Opciones exclusivas de HubSpot: Se crearán de forma automática o se reactivarán en Atom para replicar exactamente la estructura de tu CRM.
Opciones exclusivas de Atom: Se desactivarán automáticamente en tu base de datos de Atom, ya que no existen en tu CRM.
⚠️ Importante: La sincronización automática se bloqueará si superas los límites del sistema. Esto ocurrirá si la propiedad en HubSpot tiene más de 50 opciones, si alguna de esas opciones supera los 50 caracteres, o si el campo en Atom ha alcanzado su límite máximo de almacenamiento.
3. Gestión de Mapeos Existentes (Legacy)
Si actualmente tienes propiedades de tipo selector en HubSpot mapeadas con antiguos campos de texto en Atom, no te preocupes: seguirán funcionando sin alteraciones.
Sin embargo, si decides editar un mapeo Legacy, el sistema te solicitará obligatoriamente actualizarlo a un campo de tipo selector compatible (o mantener el de texto antiguo sin hacer modificaciones).
💡 Tip: Te recomendamos planificar la migración de tus campos antiguos hacia el nuevo formato de selectores. Esto estandariza la recolección de variables en tus Flows y elimina definitivamente los errores de digitación de los usuarios.
Verificación del Mapeo
Para auditar que tu configuración fue exitosa y los datos están fluyendo, realiza estos pasos:
Ve a Configuración > Conversaciones > Campos de información.
Localiza en la lista el campo que acabas de configurar.
Observa la columna de asociaciones: debes visualizar el ícono representativo de HubSpot. Esto confirma que el vínculo bidireccional está 100% activo.
¡Has dado un gran paso en la limpieza y blindaje de tus datos!
Al dominar estas reglas de compatibilidad, garantizas que la información viaje de forma segura y estructurada entre Atom y HubSpot. Tienes el control total para construir automatizaciones más robustas y mantener tu CRM impecable. ✅