Fin para Ventas puede conectarse directamente a tu cuenta de HubSpot y crear un conector de datos funcional para ti en minutos. No requiere conocimientos de API, ni código, ni mapeo manual de campos.
Elige una plantilla, autentícate con HubSpot y nuestro generador de IA inspecciona tu instancia de HubSpot (incluidos tus campos personalizados) para crear un conector totalmente configurado. Revisa los mapeos sugeridos, ajusta lo que necesites y añádelo a tu configuración. A partir de entonces, Fin puede obtener contexto de contacto en vivo en cada conversación de ventas y sincronizar contactos cualificados de vuelta a HubSpot.
Lo que puedes hacer:
📥 Enriquecer Contacto(lectura) | 📤 Sincronizar Contacto (escritura) |
Fin extrae contexto de contacto en vivo desde HubSpot a tus conversaciones de ventas. | Fin sincroniza contactos cualificados a HubSpot. Esto es un upsert: actualiza el contacto coincidente si existe, o crea uno nuevo si no existe. |
Nota: Hay dos plantillas disponibles: Enriquecer contacto desde HubSpot (lectura) y Sincronizar datos de conversación al contacto de HubSpot (escritura).
Importante: configura Enriquecer Contacto y Sincronizar Contacto juntos
El conector Sync contact (write) es un upsert, indexado por la dirección de correo electrónico del contacto. HubSpot actualiza el contacto con ese correo, o crea uno si ningún contacto lo tiene — así que Sync no creará duplicados por sí solo.
Al inicio de una conversación, Fin no conoce el ID de contacto de HubSpot. El conector Enrich Contact (read) es lo que resuelve a una persona recurrente con su registro existente en HubSpot (y su ID de contacto).
Enrich es lo que hace que Sync valga la pena. Sin él, Fin escribe en el contacto correcto pero no tiene contexto para calificarlo en primer lugar.
Antes de comenzar
Necesitarás una cuenta de HubSpot conectada (te autenticarás vía OAuth durante la configuración).
Cómo configurarlo
Conectas HubSpot a Fin para Ventas desde la sección "Connected services" en Fin AI Agent > Sales > Train > Integrations.
Paso 1: Autenticar
Conecta HubSpot vía OAuth si aún no lo has hecho.
Paso 2: Elige una plantilla
Elige Enriquecer contacto desde HubSpot (lectura) o Sincronizar datos de conversación al contacto de HubSpot (escritura). Para sincronizar contactos de vuelta, configura ambos (ver la nota arriba).
Paso 3: Proporciona un correo de prueba
Esto ejecuta una búsqueda real contra la cuenta de HubSpot de tu espacio de trabajo para que el conector pueda construirse y probarse con datos en vivo. El correo debe pertenecer a un contacto existente en HubSpot.
Paso 4: Deja que la IA genere el conector
Esto toma alrededor de 15–30 segundos mientras la IA inspecciona el esquema de HubSpot, ejecuta una solicitud de prueba y arma el conector.
Paso 5: Revisa los mapeos de campos
Verás una tabla de propiedad de HubSpot → atributo de Intercom que puedes editar antes de confirmar. Cualquier propiedad de HubSpot que no coincida con un atributo existente de Intercom se asigna automáticamente a un nuevo atributo con prefijo hs_ que la IA crea para ti.
Paso 6: Añádelo a tu configuración
Conector de lectura: añádelo a enrichment - se ejecuta al inicio de cada conversación.
Conector de escritura: adjúntalo a un routing outcome - se activa cuando se alcanza ese outcome.
Nota:
Sync is an upsert: Sync contact is keyed on email. HubSpot updates the contact with that email address, or creates one if no contact has it.
Actualización automática: Los tokens de acceso de HubSpot expiran periódicamente. El conector se actualiza automáticamente, por lo que no necesitas reconectar cada vez.
Propiedades personalizadas incluidas: Fin lee tus propiedades personalizadas de HubSpot durante la configuración, para que tus datos personalizados también puedan mapearse.
Solución de problemas
Si ves… | Qué hacer |
“No contacts found in HubSpot for email…” when creating a connector | El correo de prueba no coincidió con un contacto en tu cuenta de HubSpot. Verifica que el correo exista como contacto, luego inténtalo de nuevo. |
La configuración falla al leer tus propiedades de HubSpot | Generalmente es un problema de permisos o de conexión. Reconecta HubSpot en Settings > Integrations y ejecuta la configuración nuevamente. |
Un sync (write) falla con un error de "campo obligatorio faltante" | Tu cuenta de HubSpot requiere campos que no se recopilaron en la conversación. Asegúrate de que esos campos obligatorios se estén capturando para el resultado que tiene el conector de escritura. |
El conector dejó de funcionar después de ~1 hora | Generalmente es un problema de autenticación de HubSpot. El conector debería actualizarse automáticamente y reintentar. Si persiste, reconecta HubSpot. |
¿Sigues atascado? Ponte en contacto con nuestro equipo y te ayudaremos a configurar todo.