Integración HubSpot CRM

Sincronización bidireccional de contactos, deals y suscripciones. Auto-discovery de tu estructura HubSpot para configuración sin código.

Funcionalidades

FeatureDescripción
Sync de ContactosSuscriptores de PayWL se crean como contactos en HubSpot
Sync de DealsSuscripciones se crean como deals en tu pipeline
Custom ObjectsSoporte para objetos personalizados de suscripción
Mapeo de StagesStages de HubSpot → Estados de PayWL (activo, cancelado, etc.)
Código de ProductoExtrae código de producto de line items para facturación Siigo
Actualización FacturaGuarda número de factura Siigo en el deal

Configuración con Auto-Discovery

PayWL detecta automáticamente la estructura de tu HubSpot:

  1. Ve a Configuración → Integraciones → HubSpot
  2. Ingresa tu Access Token de HubSpot (Private App)
  3. Clic en "Detectar Configuración"
  4. PayWL detectará:
    • Custom Objects disponibles
    • Pipelines y stages
    • Propiedades de contacto
    • Productos y line items
  5. Revisa el mapeo automático de stages
  6. Ajusta si es necesario y guarda

Mapeo de Stages

PayWL infiere el estado de suscripción basado en el nombre del stage:

Patrón en StageEstado PayWL
activ*ACTIVE
inactiv*, cancel*CANCELLED
trial*, pending*, registr*TRIAL
pausad*, pause*PAUSED
expir*, vencid*EXPIRED

Flujo de Sincronización

1 Usuario se suscribe en PayWL
→
2 Se crea/actualiza contacto en HubSpot
→
3 Se crea deal con line item
→
4 Se extrae código de producto
→
5 Código pasa a Siigo para factura

Código de Producto para Siigo

PayWL busca el código de producto en los line items del deal:

  1. Busca contacto por email
  2. Obtiene deals asociados
  3. En cada deal, busca line items
  4. Extrae la propiedad hs_sku o codigo_al_facturar
  5. Envía el código a Siigo para la factura
Tip: Configura la propiedad de HubSpot que contiene el código de Siigo en la configuración de la integración.

Importar Suscriptores desde HubSpot

Puedes importar suscriptores existentes de HubSpot a PayWL:

  1. Ve a Integraciones → HubSpot → Sync
  2. Clic en "Importar Contactos"
  3. PayWL:
    • Lee contactos con custom objects de suscripción
    • Mapea stages a estados de PayWL
    • Crea planes basados en productos
    • Importa suscriptores con su estado actual

Crear App Privada en HubSpot

  1. Ve a Settings → Integrations → Private Apps
  2. Clic en "Create private app"
  3. Nombre: "PayWL Integration"
  4. Scopes requeridos: 
    crm.objects.contacts.read
crm.objects.contacts.write
crm.objects.deals.read
crm.objects.deals.write
crm.objects.line_items.read
crm.schemas.custom.read
crm.schemas.deals.read
  5. Clic en "Create app"
  6. Copia el Access Token y pégalo en PayWL