Configurar la integración con HubSpot
La integración con HubSpot envia los datos de contacto recopilados por tu agente IA directamente a tu CRM de HubSpot. Cuando un visitante comparte su nombre, correo electrónico o número de teléfono, se crea automáticamente un nuevo contacto o se actualiza uno existente. Sin entrada manual, sin archivos CSV.
En resumen
Heyloha se conecta a HubSpot a traves de una Private App. Los datos de contacto se mapean directamente a las propiedades de contacto estandar de HubSpot. Los contactos existentes se actualizan automáticamente segun la dirección de correo electrónico.
Qué se sincroniza?
Todos los campos de contacto que selecciones en Heyloha se envian automáticamente a las propiedades de contacto estandar de HubSpot. No se necesita configuración de campos personalizados.
- Nombre y apellido
- Dirección de correo electrónico
- Número de teléfono
- Dirección, código postal, ciudad y pais
Heyloha usa el endpoint upsert de HubSpot: si ya existe un contacto con la misma dirección de correo, la información se actualiza en lugar de crear un duplicado.
Qué necesitas?
- Una cuenta de HubSpot con acceso API (disponible en todos los planes CRM de pago y gratuitos).
- Una Private App en HubSpot con los permisos correctos.
- Una cuenta activa de Heyloha con al menos un agente IA.
Crear una Private App en HubSpot
Ve a Private Apps
Inicia sesion en HubSpot y ve a Configuración > Integraciónes > Private Apps.
Crea una nueva Private App
Haz clic en 'Create a Private App' y dale un nombre reconocible, por ejemplo 'Heyloha'.
Configura los permisos
Ve a la pestana 'Scopes' y activa estos dos permisos: crm.objects.contacts.write y crm.objects.contacts.read.
Copia el Access Token
Despues de crear la app, aparece un Access Token. Copialo, lo necesitaras en Heyloha.
Guarda el Access Token de forma segura. No lo compartas con terceros. En Heyloha, el token se almacena cifrado y nunca se muestra en los logs.
Configurar la integración en Heyloha
Abre tu agente IA
Ve al panel de Heyloha y haz clic en el agente IA que quieres conectar.
Configuración > Avanzado > Integraciónes
Haz clic en 'Agregar integración' para crear una nueva conexión.
Elige 'HubSpot' como plataforma
Selecciona HubSpot de la lista. El formulario se adapta automáticamente.
Pega el Access Token
Pega el Private App Access Token que copiaste de HubSpot. No se necesita URL.
Nombra la integración
Elige un nombre reconocible, por ejemplo 'HubSpot Lead Sync'.
Selecciona los campos de contacto
Elige que datos debe recopilar tu agente IA. Selecciona al menos un correo electrónico.
Elige los disparadores de eventos
Selecciona cuando debe activarse la integración: al capturar datos de contacto, al reservar una cita o al alcanzar un objetivo.
Describe cuando usar la integración
Proporciona una instruccion corta sobre cuando la IA debe activar esta integración.
Guarda y activa
Activa la integración y haz clic en Guardar. No olvides guardar también el agente IA.
Probar la conexión
Despues de guardar, puedes probar la conexión directamente con el boton 'Probar conexión' en la tarjeta de integración. Se envia un contacto de prueba a HubSpot.
- Verde 'Conectado': tus credenciales son válidas y HubSpot acepto el contacto de prueba.
- Error rojo: algo esta mal. El mensaje de error indica el problema.
Notas de HubSpot con resumen de conversación
Cuando activas "Incluir resumen", Heyloha crea automáticamente una Nota en el contacto de HubSpot con un resumen de la conversación. Esto da a tu equipo de ventas contexto inmediato.
Registro de entrega
Cada intento de envio se registra en el registro de entrega. El registro muestra la marca de tiempo, el evento, el estado y el número de intentos. Heyloha reintenta cada envio hasta 4 veces (1 intento directo + 3 reintentos en segundo plano con backoff exponencial).
Una breve interrupción de HubSpot no resulta en leads perdidos gracias al sistema de reintentos automaticos.
Preguntas frecuentes
Qué plan de HubSpot necesito?
Necesitas un plan de HubSpot con acceso API y el scope crm.objects.contacts.write. Disponible en todos los planes CRM de pago y gratuitos. Nota: las cuentas de prueba para desarrolladores pueden no tener este scope disponible. Usa una cuenta CRM gratuita o un plan de pago.
Se evitan los duplicados?
Si. Heyloha usa el endpoint upsert de HubSpot. Si ya existe un contacto con el mismo correo, los datos se actualizan.
Puedo combinar HubSpot con otras integraciónes?
Si. Cada agente IA puede tener multiples integraciónes. Por ejemplo, puedes enviar simultaneamente a HubSpot y ActiveCampaign.
Configurar integración webhook genéricaConfigurar integración ActiveCampaign