Skip to content
English
Ir a www.atomchat.io
  • There are no suggestions because the search field is empty.

Aprende a conectar Atom y HubSpot en pocos clics!

📌 ¿Qué es la integración One Click?

La integración One Click permite conectar Atom con HubSpot de forma rápida y guiada, habilitando:

  • Sincronización bidireccional de datos (contactos, negocios, tickets y compañías).

  • Uso de componentes de HubSpot dentro del Flowbuilder de Atom.

  • Importación de usuarios de HubSpot como agentes en Atom.

  • Gestión unificada de clientes con información actualizada en tiempo real.

🧩 Requisitos previos

Antes de iniciar la integración, asegúrate de cumplir con lo siguiente:

✅ Accesos necesarios

  • Atom

    • Rol: Administrador

    • Acceso al módulo Configuraciones

  • HubSpot

    • Rol: Super Admin o Admin

    • Permisos para administrar:

      • Objetos del CRM

      • Workflows

      • Esquemas de datos

📌 Recomendación: tener iniciada la sesión de HubSpot en el mismo navegador para agilizar la autorización.

🚀 Paso a paso de la integración

Fase 1: Iniciar la conexión desde Atom

  1. En el menú lateral de Atom, ve a
    Configuraciones > Plataforma.

  2. Ingresa al submódulo Integraciones.

  3. Localiza la tarjeta de HubSpot.

  4. Haz clic en el botón CONECTAR (botón naranja).

Ventana de consideraciones

  1. Se abrirá un modal informativo.

  2. Revisa la sección Permisos, donde se detallan los accesos solicitados:

    • Contactos

    • Esquemas

    • Workflows

    • Sincronización de datos

  3. Haz clic en CONECTAR CON HUBSPOT.

Fase 2: Autorización en HubSpot (OAuth)

  1. Serás redirigido a la pantalla de autorización de HubSpot.

  2. Selecciona la cuenta (ID del portal) que deseas vincular con Atom.

  3. HubSpot mostrará el listado de permisos requeridos:

    • CRM

    • Schemas

    • Content

    • E-commerce (entre otros)

  4. Desplázate hacia abajo y revisa la información.

  5. Si aparece una advertencia de verificación (común en entornos de prueba o apps privadas):

    • Marca la casilla “Entiendo los riesgos…”.

  6. Haz clic en Conectar aplicación (Connect app).

Fase 3: Asistente de configuración One Click

Al volver a Atom, se iniciará un asistente guiado de 4 pasos.

Paso 1: Identificador de HubSpot

  1. Define qué columna de Atom se usará para buscar o crear contactos en HubSpot.

  2. Puedes elegir cualquiera de las tres columnas de teléfono. Desde Atom, te recomendamos seleccionar la que tenga más contactos, siguiendo la lógica de tu negocio.

  3. Es importante que el formato de teléfono sea válido.

IMPORTANTE: Ten en cuenta que, aunque selecciones una única columna como identificador, igual tienes acceso al resto de columnas para seguir creando y vinculando contactos.

     4. Configura los toggles de sincronización:

  • Sincronizar contactos automáticamente
    (envía los contactos a HubSpot al asignarse en Atom).

  • Sobrescribir teléfono
    (Atom actualiza el número en HubSpot si detecta diferencias).

Paso 2: Mapeo de propiedades

  1. Verás campos mapeados por defecto (y no podrán ser modificados):

  • Número de Teléfono

  • Correo electrónico 

  • Nombre 

  • Apellido

  • Lifecycle Stage
  • Propietario de HubSpot

  1. Para agregar campos personalizados:

  • Busca la propiedad en la columna HubSpot.

  • Selecciona su equivalente en la columna Atom.

📌 Importante:
La sincronización es bidireccional.
Los cambios realizados en Atom se reflejan en HubSpot y viceversa.

  1. Haz clic en CONTINUAR.

Paso 3: Importar usuarios

  1. El sistema buscará usuarios existentes en HubSpot.

  2. Los campos Nombre y Apellido son requeridos.

  3. El match se realiza por correo electrónico.

  4. Selecciona los usuarios que deseas importar como agentes en Atom.

📌 Match automático:
Si el nombre del Equipo en HubSpot coincide con un Grupo en Atom, el match se realizará automáticamente.

  1. Haz clic en CONTINUAR.

Paso 4: Resumen y finalización

  1. Revisa la tarjeta “¡Todo listo!”, donde verás:

  • Identificador seleccionado.

  • Estado de la sincronización automática.

  • Cantidad de propiedades mapeadas.

  • Cantidad de usuarios a sincronizar.

  1. Haz clic en FINALIZAR.

✅ Resultado esperado

Al finalizar, serás redirigido a la pantalla de Configuración de HubSpot dentro de Atom, donde deberás visualizar:

  • Estado de la integración: Conectado

  • Panel de control con controles activos para:

    • Permitir crear contactos sin correo electrónico.

    • Activar o desactivar sincronización automática.

    • Definir reglas de sobrescritura de datos.

IMPORTANTE: No se traerán todos los contactos del CRM automáticamente a la plataforma, ni todos los contactos de la plataforma serán enviados al CRM. Esto sólo sucederá cuando sean asignados a un agente del lado de Atom, o cuando haya una actualización del lado de HubSpot, ya sea a través de workflows, webhooks, plantillas, o la actualización de algún dato como el número de teléfono, el nombre o el lifecycle stage. Este tipo de eventos si hacen que se creen clientes en Atom desde el CRM.

Checklist de revisión final

Antes de dar la integración por finalizada, valida lo siguiente:

  • ⬜ Permisos de Admin
    El usuario que realizó la conexión tiene permisos de Super Admin en HubSpot.

  • ⬜ Identificador único correcto
    Se seleccionó la columna principal (por ejemplo, Número de teléfono).

  • ⬜ Mapeo bidireccional validado
    Los campos personalizados críticos del negocio están correctamente emparejados.