Ir al contenido
Documentación de Connecto
connecto.lat
Guía de usuarioConfiguración: canales y sesiones de chat

Integraciones (conectores)

Para qué sirve#

Los conectores unen Connecto con los programas que tu empresa ya usa. Hoy existe uno: HubSpot, para traer tus contactos y sus listas a Connecto. Más adelante se agregarán otros: la pantalla ya muestra una tarjeta «Más conectores · En camino» con la etiqueta PRÓXIMAMENTE.

Quién puede usarlo: solo administradores. Si otro rol abre la pantalla, vuelve a la página principal. Si intenta usar el servicio, recibe «Solo el administrador puede configurar los conectores.»

Cómo llegar: menú del avatar → Conectores. La pantalla dice «Conecta Connecto con los programas que ya usas.»

La tarjeta de HubSpot#

Muestra el logo y el texto: «Trae tus contactos de HubSpot con sus datos y sus listas (segmentos). Si el contacto ya existe en Connecto (se busca por correo o teléfono, nunca por nombre) se completa con lo que le falte, sin pisar lo que ya tiene; si no existe, se crea. Las listas se crean como listas de distribución si no existen y se les asocian sus contactos.»

ElementoQué hace
Etiqueta de estadoSIN CONECTAR o CONECTADO (con «Conectado desde» y la fecha)
Importar contactosAbre el asistente de importación
DesconectarBorra el token guardado. Solo aparece si HubSpot está conectado

Paso a paso: conectar e importar#

El asistente tiene dos pasos: 1. Conexión y 2. Importación.

Paso 1: conexión#

  1. En HubSpot entra a Configuración → Integraciones → Aplicaciones privadas y pulsa Crear aplicación privada.
  2. En la pestaña Permisos (scopes) marca:
    1. crm.objects.contacts.read (obligatorio, para traer los contactos),
    2. crm.lists.read (para traer las listas),
    3. crm.schemas.contacts.read (para traer tus campos personalizados).
  3. Pulsa Crear aplicación y copia el token de acceso (empieza con pat-).
  4. Pégalo en Token de acceso de la aplicación privada.
  5. Elige el Tipo que tendrán los contactos nuevos (la lista de tipos de contacto de Connecto).
  6. Deja marcada (o desmarca) la casilla Los teléfonos de HubSpot son WhatsApp (se podrá escribirles por WhatsApp desde Connecto). Viene marcada por defecto.
  7. Pulsa Continuar. El botón dice «Comprobando con HubSpot…» mientras valida el token.

El token se guarda cifrado y no se vuelve a mostrar. Si ya está conectado, el asistente muestra «HubSpot ya está conectado» y no pide el token: «Si cambias de cuenta, desconecta y vuelve a conectar desde la tarjeta.»

Si ya habías importado los contactos y solo quieres traer las listas, usa el enlace Ya importé los contactos: importar solo las listas (requiere que HubSpot ya esté conectado; si no: «Primero conecta HubSpot con tu token y usa Continuar.»).

Paso 2: importación#

La importación corre en segundo plano en el servidor: puedes cerrar la ventana o salir de Connecto y volver a ver el avance después. Muestra una barra con el porcentaje, el texto de avance y dos recuadros:

  • Contactos: total procesado, cuántos fueron leídos, nuevos y actualizados.
  • Listas: cuántas se procesaron, cuántas son nuevas y cuántos contactos se asociaron.

Botones: Detener (pide al proceso que pare; se puede continuar después), Continuar importación (si se interrumpió) y Cerrar.

Estados de una importación: En curso, Completada e Interrumpida. Una importación «en curso» que deja de dar señales de vida por más de 3 minutos (por ejemplo, por un reinicio del servidor) se muestra como Interrumpida; en la tarjeta aparece «Importación interrumpida: …» con el botón Continuar. Lo ya importado queda guardado.

Qué datos se traen y cómo se tratan#

Datos que se leen de cada contacto de HubSpot: nombre, apellido, correo, correos adicionales, teléfono, móvil, teléfono de WhatsApp, dirección, ciudad, estado o departamento, código postal, país, empresa, cargo, sitio web, fecha de nacimiento, etapa del ciclo de vida y estado del lead, más hasta 40 campos personalizados de tu cuenta (si el token puede leer el esquema).

Cómo se busca si el contacto ya existe (en este orden): por el identificador de HubSpot guardado antes, por correo y por teléfono (coincidencia exacta; mínimo 7 dígitos). Nunca por nombre.

Si existe: se completa sin pisar lo que ya tiene: agrega correos y teléfonos que falten y llena campos vacíos (apellidos, dirección, fecha de nacimiento, país, departamento, ciudad, correo o teléfono principal). Si no cambia nada, cuenta como repetido.

Si no existe: se crea con el tipo elegido, con el idioma y la moneda por defecto de Connecto. Los datos de HubSpot que Connecto no tiene como campo (empresa, cargo, sitio web, código postal, etapa del ciclo de vida, estado del lead, campos personalizados y teléfonos con formato inválido) se guardan en la ficha y se dejan en una nota del contacto que empieza con «Datos importados de HubSpot:».

Reglas de datos:

  • Un contacto sin nombre, apellido, correo ni teléfono se omite (cuenta como «sin datos»).
  • Si no hay nombre, se usa la parte del correo antes de la arroba, o la empresa, o el teléfono, o «Sin nombre».
  • Los teléfonos se normalizan al formato internacional; si no traen indicativo se les asume el de Colombia (+57). Los inválidos no se importan como teléfono, sino que se anotan en «Teléfonos sin formato válido».
  • Si marcaste que los teléfonos son WhatsApp, todos se registran como WhatsApp. Si no, solo el campo de WhatsApp de HubSpot se marca como WhatsApp.
  • La fecha de nacimiento debe ser válida, posterior a 1900 y no futura; si no, se ignora.
  • El departamento y la ciudad se enlazan solo si coinciden de forma única con los catálogos de Connecto.

Listas: cada lista de contactos de HubSpot se crea como lista de distribución de tipo correo electrónico, con el mismo nombre (o «Lista HubSpot N» si no tiene), la descripción «Importada de HubSpot (lista N)» y se le asocian sus contactos. Si ya existe una lista con ese nombre (sin distinguir mayúsculas ni tildes), se reutiliza. Solo se asocian contactos que ya estén en Connecto con su identificador de HubSpot, por eso los contactos se importan antes que las listas.

Desconectar HubSpot#

  1. Pulsa Desconectar en la tarjeta.
  2. Confirma en «¿Seguro que quieres desconectar HubSpot?»: «Se borra el token guardado y ya no se podrá importar hasta volver a conectarlo. Los contactos y listas que ya se importaron se quedan en Connecto.»

Si hay una importación en curso, el sistema responde: «Hay una importación en curso. Deténla antes de desconectar.»

Mensajes del sistema#

MensajeCuándo
«Pega el token de acceso completo de tu aplicación privada de HubSpot (empieza con «pat-»).»Token demasiado corto o con espacios
«HubSpot no reconoce ese token. Revisa que lo copiaste completo y que la aplicación privada sigue activa.»Token inválido
«El token es válido pero no tiene permiso para leer contactos…»Falta el permiso de contactos
«El token no tiene permiso para leer listas…»Falta el permiso de listas; los contactos se importan igual
«HubSpot pidió bajar el ritmo. Espera un minuto y continúa.»HubSpot limita las peticiones. El proceso espera y reintenta solo (hasta 5 veces)
«Ya hay una importación de HubSpot en curso.»Intentas iniciar otra mientras una corre
«HubSpot no está conectado.»Intentas importar sin conexión
«Detenida por el administrador. Puedes continuar cuando quieras.»Pulsaste Detener

<!-- Fuente: tenant-app/public/conectores/index.php, tenant-app/public/api/conectores.php, shared/src/Core/HubSpot.php, tenant-app/cli/hubspot_importar.php, tenant-app/views/partials/sidebar.php, db/migrations/0114_conectores.sql, 0115_conectores_actualizar.sql, 0116_conectores_segundo_plano.sql -->

¿Te fue útil esta página?
Última actualización: 14/11/2026