Vixiees se integra con HubSpot para sincronizar contactos, actividades y mantener ambos sistemas actualizados en tiempo real.
Conectar HubSpot
Requisitos
- Cuenta de HubSpot con permisos de administrador
- Permisos de administrador en Vixiees
Pasos para conectar
- Ve a Configuración > Integraciones > HubSpot
- Haz clic en Conectar con HubSpot
- Inicia sesión en tu cuenta de HubSpot
- Autoriza los permisos solicitados
- Espera a que se complete la sincronización inicial
Datos sincronizados
Al conectar, Vixiees sincroniza:
- Contactos existentes
- Propiedades de contactos
- Pipelines de deals
- Propiedades de deals
Sincronización de contactos
Campos sincronizados automáticamente
| Campo Vixiees | Campo HubSpot |
|---|---|
| Nombre | firstname |
| Apellido | lastname |
| Teléfono | phone |
| Empresa | company |
Campos adicionales
- Estado del lead (hs_lead_status)
- Ciclo de vida (lifecyclestage)
- Propietario (hubspot_owner_id)
Dirección de sincronización
- Contacto creado en Vixiees → Se crea en HubSpot
- Contacto creado en HubSpot → Se crea en Vixiees (via webhook)
- Cambios en cualquier sistema → Se reflejan en el otro
Sincronización de actividades
Llamadas
Cada llamada realizada en Vixiees se registra en HubSpot con:
| Campo | Descripción |
|---|---|
| Timestamp | Fecha y hora de la llamada |
| Duración | Tiempo de la llamada |
| Números | Origen y destino |
| Grabación | URL de la grabación (si está disponible) |
| Dirección | Entrante o saliente |
| Estado | Completada, ocupado, sin respuesta, etc. |
Emails
Los emails enviados desde Vixiees se registran con:
- Asunto
- Contenido (HTML y texto)
- Dirección (entrante o saliente)
- Timestamp
Notas
Las notas creadas en Vixiees se sincronizan con:
- Contenido de la nota
- Usuario que la creó
- Timestamp
La sincronización de actividades es unidireccional (Vixiees → HubSpot).
Mapeo de campos personalizados
Puedes mapear campos personalizados de Vixiees con propiedades de HubSpot:
- Ve a Configuración > Integraciones > HubSpot
- En la sección Mapeo de campos, configura las equivalencias
- Selecciona el campo de Vixiees y la propiedad de HubSpot correspondiente
- Guarda los cambios
Sincronización de skills
Puedes configurar un campo de HubSpot para sincronizar las habilidades del contacto. Las skills se guardan separadas por punto y coma.
Webhooks y eventos
HubSpot notifica a Vixiees cuando ocurren cambios:
Eventos de contactos
- Contacto creado
- Propiedad modificada
- Contacto eliminado
- Contactos fusionados
Eventos de deals
- Deal creado
- Propiedad modificada
- Etapa cambiada
Seguridad
Los webhooks se validan con firma HMAC-SHA256 para garantizar que provienen de HubSpot.
Errores comunes y soluciones
"Token expirado"
Causa: El token de acceso ha expirado.
Solución: El sistema renueva automáticamente el token. Si persiste, reconecta la integración.
"Contacto no encontrado"
Causa: El contacto fue eliminado en HubSpot.
Solución: El sistema reintenta hasta 3 veces y luego descarta la notificación.
"Límite de peticiones excedido"
Causa: Se superó el rate limit de HubSpot.
Solución: El sistema espera automáticamente y reintenta.
"Error de validación"
Causa: Un campo tiene un valor no válido para HubSpot.
Solución: Revisa el mapeo de campos y los valores permitidos.
Propiedades personalizadas de Vixiees
Al conectar, Vixiees crea automáticamente en HubSpot:
| Propiedad | Descripción |
|---|---|
| vixiees_url | URL del contacto en Vixiees |
| vixiees_last_update | Última actualización desde Vixiees |
Conclusión
La integración con HubSpot permite:
- Mantener contactos sincronizados en ambos sistemas
- Registrar todas las actividades de Vixiees en HubSpot
- Usar campos personalizados con mapeo flexible
- Recibir actualizaciones en tiempo real via webhooks
Escenarios relevantes
- Equipos de ventas con HubSpot CRM: Toda la actividad comercial se registra automáticamente
- Marketing y ventas integrados: Los leads de marketing llegan a Vixiees via HubSpot
- Análisis de rendimiento: HubSpot puede usar los datos de actividad para reportes
Te resulto util este articulo?