Saltar al contenido principal

Minotaur × HubSpot — Guía de Integración

App: Integración Minotaur HubSpot
Publicado por: Minotaur Sales
Compatible con: app.minotaursales.io

Descripción general​

La integración de Minotaur con HubSpot te permite enriquecer registros existentes de HubSpot con datos de tu CRM de Minotaur:

  • Enviar datos de contactos de Minotaur a contactos coincidentes en HubSpot.
  • Enviar datos de compañías de Minotaur a compañías coincidentes en HubSpot.
  • Sincronizar registros seleccionados o una lista de contactos completa bajo demanda.
  • Monitorear el progreso de sincronización mediante notificaciones en la app y un registro de integración dedicado.

Comportamiento importante: Esta integración es solo de actualización y unidireccional (Minotaur → HubSpot). Solo actualiza registros que ya existen en HubSpot. Si un contacto o compañía de Minotaur no coincide con un registro existente en HubSpot, ese registro se omite — no se crea nada. No se obtienen datos de HubSpot hacia Minotaur.

Alcance de esta integración: Solo Contactos y Compañías. La sincronización de Deals no está soportada.

Requisitos previos​

RequisitoDetalles
Cuenta de HubSpotUna cuenta de HubSpot (Sales Hub o cualquier plan que incluya el CRM).
Permisos de HubSpotDebes tener permiso para instalar apps y leer/editar contactos y compañías en HubSpot.
Registros existentes en HubSpotLos registros deben existir en HubSpot para ser actualizados. Minotaur no crea nuevos contactos o compañías en HubSpot.
Cuenta de MinotaurDebes estar autenticado en app.minotaursales.io y tener acceso a Configuración.

Agregar la integración (Instalar y Conectar)​

  1. Inicia sesión en app.minotaursales.io.
  2. Ve a Configuración → Conexiones → HubSpot.
  3. Haz clic en Conectar.
  4. Se abre una nueva pestaña con la página de autorización de HubSpot. Inicia sesión en tu cuenta de HubSpot y revisa los permisos solicitados.
  5. Haz clic en Conectar app.
  6. La pestaña se cierra y eres redirigido a Minotaur. La página de conexión muestra Conectado con el nombre del portal y el ID del portal de HubSpot.

Configurar el mapeo de campos (Requerido antes de sincronizar)​

Antes de sincronizar datos, debes configurar qué campos de Minotaur se mapean a qué campos de HubSpot. La sincronización fallará con un error de "mapping not found" si se omite este paso.

  1. Ve a Configuración → Conexiones → HubSpot → Mapeo de campos.
  2. Configura el mapeo de campos de contactos.
  3. Configura el mapeo de campos de compañías.
  4. Revisa y guarda tus mapeos.

Los campos de email y teléfono están excluidos de la sincronización (se usan solo para hacer coincidir, no se escriben en HubSpot).

Usar la integración​

Sincronizar contactos seleccionados​

  1. Ve a Mis Contactos (o cualquier tabla de contactos).
  2. Selecciona uno o más contactos usando las casillas de verificación.
  3. Haz clic en Sincronizar a HubSpot en la barra de herramientas.
  4. Confirma la acción. Minotaur pone en cola los contactos seleccionados para sincronizar.
  5. Recibirás una notificación cuando la sincronización se complete. Ve los resultados en Configuración → Registros de integración → HubSpot.

Sincronizar compañías seleccionadas​

  1. Ve a la tabla de Compañías.
  2. Selecciona una o más compañías.
  3. Haz clic en Sincronizar a HubSpot y confirma.

Sincronizar una lista de contactos completa​

  1. Ve a Listas y abre una lista de contactos.
  2. Haz clic en Sincronizar a HubSpot.
  3. Confirma la acción. Todos los contactos de la lista se ponen en cola para sincronizar.

Cómo funciona la coincidencia​

Minotaur hace coincidir un contacto de Minotaur con un contacto de HubSpot usando:

  1. Los campos designados como campos clave en tu mapeo de campos.
  2. El email de trabajo o email personal del contacto (siempre se usa como búsqueda).

Si no se encuentra un contacto coincidente en HubSpot, el registro se omite (no se crea).

Pausar sincronización​

  1. Ve a Configuración → Conexiones → HubSpot.
  2. Haz clic en Pausar sincronización en la tarjeta de estado.

Mientras está en pausa, los botones "Sincronizar a HubSpot" están ocultos. Activa de nuevo para Reanudar sincronización.

Eliminar la integración​

  1. Ve a Configuración → Conexiones → HubSpot.
  2. Haz clic en Desconectar y confirma.
  3. Minotaur elimina tus tokens OAuth almacenados y revoca el token de actualización de HubSpot.

Resolución de problemas / Preguntas frecuentes​

Error "Mapping not found" al sincronizar​

Los mapeos de campos no han sido configurados. Ve a Configuración → Conexiones → HubSpot → Mapeo de campos y completa el mapeo antes de sincronizar.

Los registros fueron puestos en cola pero nada se actualizó en HubSpot​

Minotaur no pudo encontrar un contacto o compañía coincidente en HubSpot. Esta integración es solo de actualización — si el registro no existe en HubSpot con el mismo email o campo clave, será omitido.

Los Deals no se sincronizan​

La sincronización de Deals no está soportada en la versión actual. Solo se pueden sincronizar Contactos y Compañías.

La conexión muestra "Expirada"​

Ve a Configuración → Conexiones → HubSpot, haz clic en Desconectar, luego haz clic en Conectar de nuevo.

Datos y Privacidad​

Tipo de datosCómo se usa
Tokens OAuth de HubSpotAlmacenados de forma segura en la base de datos de Minotaur, con alcance a tu usuario.
Info del portal de HubSpotMostrado en la tarjeta de estado de conexión. No se comparte externamente.
Campos de enriquecimiento de MinotaurEnviados unidireccionalmente a HubSpot para actualizar registros coincidentes. Los valores de email y teléfono nunca se escriben en HubSpot.

Soporte​

Para obtener ayuda con esta integración, contacta el soporte de Minotaur: