Configurar la integración con HubSpot
La integración con HubSpot envía 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 través de una Private App. Los datos de contacto se mapean directamente a las propiedades de contacto estándar de HubSpot. Los contactos existentes se actualizan automáticamente según la dirección de correo electrónico.
¿Qué se sincroniza?
Todos los campos de contacto que selecciones en Heyloha se envían automáticamente a las propiedades de contacto estándar 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 país
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 sesión en HubSpot y ve a Configuración > Integraciones > 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 pestaña 'Scopes' y activa estos dos permisos: crm.objects.contacts.write y crm.objects.contacts.read.
Copia el Access Token
Después de crear la app, aparece un Access Token. Cópialo, lo necesitarás 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
Ve a Agente, luego Integraciones
En el menú de la izquierda haz clic en Agente y abre la pestaña Integraciones. La sección Webhooks está arriba del todo.
Haz clic en Añadir webhook
En la sección Webhooks, haz clic en Añadir webhook. Se abre un formulario para configurar la conexión.
Elige 'HubSpot' como plataforma
Selecciona HubSpot en el formulario. El formulario se adapta automáticamente y muestra solo los campos que necesitas.
Elige los canales (opcional)
Por defecto el webhook se aplica a todos los canales de tu agente. Para limitarlo, por ejemplo, solo al chat web o solo a WhatsApp, selecciona los canales que quieras. Si lo dejas vacío, la conexión se aplica a todos los canales.
Pega el Access Token
Pega el Private App Access Token que copiaste de HubSpot. No se necesita URL, Heyloha se conecta directamente con la API de HubSpot.
Nombra la integración
Elige un nombre reconocible, por ejemplo 'HubSpot Lead Sync'. Este nombre también se usa como nombre de función interna.
Selecciona los campos de contacto
Elige qué datos debe recopilar tu Agente IA. Selecciona al menos un correo electrónico. La IA solo pregunta por los campos que selecciones aquí.
Elige los disparadores de eventos
Selecciona cuándo debe activarse la integración: al capturar datos de contacto, al reservar una cita o al alcanzar un objetivo.
Describe cuándo debe usarse la conexión
Proporciona una instrucción corta sobre cuándo la IA debe activar esta integración, por ejemplo: 'Úsalo cuando un visitante quiera reservar una demo y deje sus datos.'
Guarda y activa
Pon la integración en 'Activo' y haz clic en Guardar en el formulario. La conexión se activa al instante.
Probar la conexión
Después de guardar, puedes probar la conexión directamente con el botón 'Probar conexión' en la tarjeta de integración. Se envía un contacto de prueba a HubSpot.
- Verde 'Conectado': tus credenciales son válidas y HubSpot aceptó el contacto de prueba.
- Error rojo: algo está 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 envío 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 envío 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 automáticos.
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?
Sí. 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 integraciones?
Sí. Cada agente IA puede tener múltiples integraciones. Por ejemplo, puedes enviar simultáneamente a HubSpot y ActiveCampaign.
Configurar integración webhook genéricaConfigurar integración ActiveCampaign