Integración HubSpot
— Conversia
Conecta tus Agentes AI con HubSpot para centralizar conversaciones, sincronizar contactos y ejecutar automatizaciones desde el CRM. 24/7, sin código adicional.
1. Overview
La integración entre Conversia y HubSpot permite centralizar la comunicación con leads, automatizar interacciones mediante inteligencia artificial y habilitar la gestión humana desde el inbox de HubSpot sin perder contexto.
A través de esta integración, los equipos comerciales pueden:
Conversaciones en tiempo real
Visualiza y responde mensajes de WhatsApp y widget web directamente desde el Inbox de HubSpot.
Human Handoff fluido
Intervén manualmente en cualquier conversación automatizada sin que el usuario note el cambio.
Análisis conversacional
Accede a 8 tipos de análisis generados por IA en el registro del contacto en HubSpot.
Workflow Actions nativas
Sincroniza contactos, deals y envía mensajes outbound desde workflows de HubSpot.
2. Capacidades principales
2.1 Sincronización en tiempo real (Custom Channels)
Conversia se integra con el Inbox de HubSpot mediante el framework oficial de Custom Channels, permitiendo sincronización bidireccional de mensajes en tiempo real.
| Canal soportado | Descripción |
|---|---|
| Vía Infobip o integración directa | |
| Widget web | Widget de Conversia embebido en tu sitio |
2.2 Human Handoff
Cuando un agente humano responde desde el inbox de HubSpot, Conversia transfiere automáticamente la sesión a estado human takeover. El asesor continúa con contexto completo — sin que el usuario note el cambio.
2.3 Sincronización bajo demanda
Conversia permite sincronizar conversaciones completas hacia HubSpot de forma manual o programada. Se invoca un endpoint con el contactId (HubSpot Record ID) y Conversia reconstruye el historial como thread en el Inbox.
Caso de uso típico: migración de conversaciones previas o sincronización posterior a eventos como cambios de estado en workflows.
2.4 Análisis conversacional (App Cards)
Conversia muestra 8 tipos de análisis como App Cards en el registro de contacto en HubSpot:
Resumen conversacional
Resumen ejecutivo de la interacción generado por IA.
SPICED
Calificación del lead según el framework SPICED completo.
Análisis de sentimiento
Tono y emoción detectados durante la conversación.
Calidad (CQ)
Evaluación de la calidad de la conversación.
ICP Fit
Qué tan bien encaja el lead con tu perfil de cliente ideal.
FAQs
Preguntas frecuentes identificadas en la conversación.
Drivers de contacto
Motivaciones principales del lead para contactar.
Causa raíz
Razón de fondo detrás de la interacción.
2.5 Automatización con Workflows
Conversia extiende HubSpot con Custom Workflow Actions nativas:
| Acción | Descripción |
|---|---|
| Sincronizar Contacto | Envía información del contacto desde HubSpot a Conversia. Mapea cualquier propiedad como identificador. |
| Sincronizar Deal | Sincroniza oportunidades comerciales y mantiene consistencia entre ambos sistemas. |
| Enviar Mensaje Outbound | Envía mensajes por WhatsApp desde Conversia, con templates y variables dinámicas. |
3. Flujo de funcionamiento
Operación en tiempo real
El usuario final inicia una conversación por WhatsApp o widget web.
Conversia procesa el mensaje mediante el Agente LLM configurado.
Los mensajes se sincronizan en tiempo real en el Inbox de HubSpot.
Un asesor puede tomar la conversación desde HubSpot. Conversia transfiere la sesión automáticamente.
Operación con Workflows
Un contacto cumple la condición de entrada definida en HubSpot.
Sincronización de contacto/deal o envío de mensaje outbound.
La acción se ejecuta y el resultado se refleja en ambos sistemas.
4. Permisos requeridos en HubSpot
| Permiso | Nivel | Uso |
|---|---|---|
conversations | read / write | Inbox, Custom Channels, mensajes en tiempo real |
contacts | read / write | Crear y actualizar contactos desde conversaciones |
deals | read / write | Sincronizar oportunidades comerciales |
La autenticación entre HubSpot y Conversia se realiza mediante OAuth estándar. Conversia nunca almacena credenciales de HubSpot — solo tokens OAuth con renovación automática.
5. Instalar la App de Conversia en HubSpot
Requisitos previos: necesitas una cuenta activa de Conversia y permisos de administrador en tu cuenta de HubSpot para instalar aplicaciones. Si no tienes cuenta en Conversia, regístrate en app.conversia.ai.
Desde tu cuenta de HubSpot, ve a Marketplace → App Marketplace y busca "Conversia". Haz clic en la app y luego en el botón Install app.
HubSpot te redirigirá a app.conversia.ai. Si no tienes sesión activa, inicia sesión con tu cuenta de Google o Microsoft.
Una vez autenticado, selecciona el workspace de Conversia que deseas conectar con HubSpot. Si tienes acceso a más de uno, elige el correspondiente.
Conversia iniciará el flujo de autorización OAuth. HubSpot te pedirá confirmar los permisos que se otorgarán a Conversia: lectura y escritura de conversaciones, contactos y deals.
Una vez confirmados los permisos, serás redirigido de vuelta a HubSpot. La integración queda activa y Conversia ya está conectado a tu portal.
6. Verificar la instalación
Desde HubSpot
En HubSpot, ve a Configuración → Integraciones → Apps conectadas.
Deberías ver la App de Conversia listada como conectada. Esto confirma que el portal de HubSpot está vinculado correctamente.
Desde Conversia
En app.conversia.ai, ve a Integraciones → HubSpot.
Verás el mensaje "Conversia App Instalada — La aplicación está instalada correctamente en tu cuenta de HubSpot."
La App está instalada. El siguiente paso es crear un canal personalizado para comenzar a recibir conversaciones en el Inbox de HubSpot.
7. Crear un canal personalizado en HubSpot
Una vez instalada la App, debes conectar tu integración de WhatsApp o Widget como un canal en el Inbox de HubSpot.
Requisitos previos: la App de Conversia instalada en HubSpot, una integración configurada en Conversia (WhatsApp, Infobip o Widget) y permisos para acceder y editar el Inbox de HubSpot.
En el menú principal de HubSpot, ve a CRM → Bandeja de entrada.
En la esquina inferior izquierda, haz clic en el enlace de Configuración de la bandeja de entrada.
En el panel derecho, selecciona la bandeja de entrada en la que deseas conectar el canal y haz clic en Conectar canal.
Como la App ya está instalada, aparecerá disponible entre las opciones. Selecciona Conversia App.
Confirma la conexión. Se abrirá una nueva pestaña con el formulario de configuración. Los campos ID del Portal, ID del Canal, Token de Cuenta e ID del Buzón se completan automáticamente — no los modifiques.
Completa los siguientes campos:
| Campo | Valor |
|---|---|
| Tipo de Canal | Selecciona WhatsApp o Widget según tu integración en Conversia |
| Identificador de entrega |
Para WhatsApp: wa:{{integration_id}}Para Widget: widget:{{integration_id}}
Obtén el |
| ID de Integración | El mismo valor del Integration ID, sin el prefijo wa: o widget: |
| Nombre de la cuenta | El nombre con el que quieres identificar este canal en HubSpot |
| Nombre para mostrar | El nombre visible en el Inbox de HubSpot |
Haz clic en Conectar. Al terminar, la pestaña se cerrará automáticamente.
Regresa a la pestaña original de HubSpot. El sistema mostrará ahora el Paso 2 de la configuración.
En la sección "Set up routing rules", no selecciones ninguna opción. Haz clic en Next.
HubSpot mostrará un resumen de la configuración. Haz clic en Done. El canal ya aparecerá en el Inbox.
8. Configurar el agente conversacional
Para completar la integración, debes indicar qué usuario de HubSpot actuará como agente conversacional (el usuario "técnico" que representa al Agente AI en HubSpot).
En Conversia, ve a la integración recién conectada. Verás el mensaje: "Has creado el canal en HubSpot. Para completar la configuración, proporciona el ID del usuario de HubSpot que actuará como agente conversacional."
En HubSpot, ve a Configuración → Usuarios y equipos. Haz clic en el usuario que actuará como agente. Identifica el parámetro userId en la URL del navegador — ese número es el ID.
Ingresa el ID con el prefijo A- (ejemplo: A-12345678). No elimines el prefijo. Haz clic en Finalizar integración.
¡Listo! El canal personalizado ha sido correctamente creado y configurado. Conversia comenzará a sincronizar conversaciones en tiempo real con tu Inbox de HubSpot.
9. Workflow Actions disponibles
Desde cualquier Workflow de HubSpot puedes agregar acciones nativas de Conversia en el paso "+" → busca "Conversia".
| Acción | Parámetros | Descripción |
|---|---|---|
| Sincronizar Contacto | contactId | Envía el contacto y sus propiedades desde HubSpot a Conversia. Útil para pre-cargar leads en campañas outbound. |
| Sincronizar Deal | dealId | Sincroniza el deal y sus propiedades, manteniendo coherencia entre el pipeline de HubSpot y Conversia. |
| Enviar Mensaje Outbound | contactId template canal | Envía un mensaje por WhatsApp al contacto directamente desde el workflow. Soporta templates con variables dinámicas. |
10. App Cards en registros de HubSpot
Las App Cards de Conversia aparecen automáticamente en los registros de Contacto y Deal en HubSpot. Se actualizan en tiempo real con cada conversación.
| Card | Contenido |
|---|---|
| Resumen ejecutivo | Síntesis de la conversación generada por IA, lista para que el asesor entienda el contexto en segundos. |
| SPICED | Calificación Situation / Pain / Impact / Critical Event / Decision del lead. |
| Sentimiento | Tono general de la conversación (positivo, neutro, negativo) con fragmentos representativos. |
| Calidad (CQ) | Score de calidad de la conversación basado en parámetros configurables. |
| ICP Fit | Encaje del lead con el perfil de cliente ideal definido para el agente. |
| FAQs | Preguntas más frecuentes identificadas en la conversación. |
| Drivers de contacto | Motivaciones principales que llevaron al lead a iniciar la conversación. |
| Causa raíz | Razón de fondo detrás del contacto (interés, problema, comparación, etc.). |
11. Casos de uso
Primera respuesta automática
El Agente AI responde al instante a todos los leads entrantes, 24/7, y los califica antes de derivarlos al equipo.
Recontacto de leads fríos
Activa secuencias de recontacto automáticas desde workflows cuando un lead deja de responder.
Campañas outbound
Envía mensajes por WhatsApp a listas de contactos directamente desde workflows de HubSpot.
Handoff a equipo humano
Transfiere conversaciones a asesores humanos en el Inbox de HubSpot con contexto completo ya disponible.
Análisis de pipeline
Enriquece cada registro de HubSpot con inteligencia conversacional sin trabajo manual del equipo.
Cobranzas automatizadas
El Agente gestiona recordatorios de pago y recuperación de cuentas via WhatsApp desde flujos de HubSpot.
¿Tienes preguntas sobre la integración? Contáctanos en contacto@conversia.ai o accede al chat de soporte desde app.conversia.ai.
12. Desinstalar la App
Si necesitas desconectar Conversia de tu cuenta de HubSpot, sigue estos pasos. La desinstalación no elimina los datos de contacto ya sincronizados en HubSpot.
Paso 1 — Desinstalar desde HubSpot
En HubSpot, ve a Configuración → Integraciones → Apps conectadas.
Localiza la App de Conversia en la lista y haz clic en ella.
Haz clic en Desinstalar y confirma la acción. HubSpot revocará el acceso OAuth de Conversia inmediatamente.
Paso 2 — Desconectar el canal en HubSpot (opcional)
En HubSpot, ve a CRM → Bandeja de entrada → Configuración de la bandeja de entrada.
Selecciona el canal creado con Conversia y haz clic en Eliminar canal. Esto detiene la sincronización de nuevos mensajes.
Importante: la desinstalación revoca el acceso de Conversia a HubSpot, pero no elimina los contactos, deals ni conversaciones ya sincronizados en tu CRM. Si necesitas eliminar esos datos, debes hacerlo manualmente desde HubSpot.
¿Necesitas ayuda con la desinstalación o tienes problemas con la integración? Escríbenos a contacto@conversia.ai.