Requisitos Previos
Antes de iniciar con la configuración de tu embudo, asegúrate de cumplir con los siguientes requisitos en tu entorno:
Contar con un usuario que tenga permisos de Administrador en la plataforma Atom.
Tener la integración nativa de HubSpot conectada y activa en el módulo de integraciones.
Haber definido previamente tus Lifecycle Stages en HubSpot (el sistema soporta tanto las etapas por defecto del CRM como las personalizadas).
Haber creado y estructurado las Etapas operativas para Clientes/Conversaciones dentro de las configuraciones de Atom.
⚙️ Configuración Paso a Paso
Sigue esta ruta para emparejar las etapas de ambas plataformas y asegurar que tus conversaciones se muevan automáticamente:
Ve al menú principal en Atom y navega a Configuraciones > Plataforma > Integraciones > HubSpot.
Haz clic en la opción Configuración Lifecycle Stage HubSpot.
Visualizarás una lista completa con todos los Lifecycle Stages provenientes de tu CRM. Por defecto, la columna de Atom estará vacía y el indicador mostrará el estado Sin mapeo.
Haz clic en el ícono de Editar (representado por un lápiz) situado en la columna de Acciones junto a la etapa que deseas configurar.
En el menú desplegable que se habilita en la columna de Atom, selecciona la etapa de la conversación que servirá como su equivalente exacto.
Repite el proceso para cada uno de los estados restantes. A medida que vincules las etapas de Atom, estas desaparecerán de las opciones del menú para evitar duplicidades.
🔄 Orígenes de Actualización de Etapas
Para que las conversaciones en Atom se actualicen de forma automática, el estado de destino debe estar previamente mapeado. Una vez configurado, Atom detectará el cambio de etapa y moverá la conversación si el cambio se origina desde:
Modificaciones manuales ejecutadas por un usuario directamente en el CRM de HubSpot.
Actualizaciones impulsadas por la automatización de un Workflow dentro de HubSpot.
Ediciones manuales realizadas por los Agentes utilizando el Panel Lateral de HubSpot dentro de la bandeja de Atom.
El paso del usuario por un componente de Lifecycle Stage configurado en tu Flowbuilder.
La ejecución de Tareas Automáticas diseñadas para cambiar el estado de un contacto.
Peticiones externas a través de la API o mediante un Componente HTTP.
⚠️ Importante: La sincronización de este mapeo es estrictamente UNIDIRECCIONAL (fluyendo únicamente de HubSpot hacia Atom). Cualquier cambio de etapa que realices manualmente a las conversaciones dentro de Atom jamás alterará el Lifecycle Stage original del contacto en el CRM.
🧪 Resultados, Verificación y Mantenimiento
Una vez finalizada la asignación, las etapas configuradas correctamente cambiarán su indicador en la columna de estado a Mapeado (acompañado de una marca de verificación verde).
Para comprobar que la implementación fue exitosa:
Modifica el Lifecycle Stage de un contacto de prueba directamente en HubSpot o en el Panel Lateral de Atom.
Verifica en el módulo de clientes de Atom que la conversación asociada se haya trasladado automáticamente a la nueva etapa correspondiente.
⚠️ Importante: Precaución de Mantenimiento. Si en el futuro eliminas un Lifecycle Stage directamente en HubSpot o borras una etapa de conversación en Atom, el mapeo asociado se romperá y pasará a un estado de Error. Para solucionarlo, deberás ingresar nuevamente a esta pantalla, hacer clic en Editar y seleccionar una etapa válida, o elegir la opción "- Sin asignar -" para devolver la regla a su estado inactivo.
Mantener sincronizadas las etapas de tu ciclo de vida elimina el trabajo manual y asegura que tu equipo siempre tenga visibilidad del estado real de cada oportunidad. Al automatizar el recorrido de tus leads entre HubSpot y Atom, garantizas una reportería impecable y un flujo de trabajo sin interrupciones. ✅
