HubSpot
Sincronización bidireccional entre OmniBuy y HubSpot CRM.
Configuración
POST /api/v1/integrations/hubspot
{
"enabled": true,
"access_token": "pat-xxx-xxx",
"refresh_token": "rt-xxx",
"portal_id": "12345678",
"sync_contacts": true,
"sync_deals": true,
"sync_products": true
}
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
enabled | bool | No | Activar/desactivar la integración |
access_token | string | Sí | Access token de HubSpot (OAuth o Private App) |
refresh_token | string | No | Refresh token para renovar access token |
portal_id | string | No | ID del portal de HubSpot |
sync_contacts | bool | No | Sincronizar contactos (OmniBuy customers → HubSpot contacts) |
sync_deals | bool | No | Sincronizar deals (OmniBuy orders → HubSpot deals) |
sync_products | bool | No | Sincronizar productos |
Endpoints de sincronización
Sync individual
Sincroniza un registro específico:
POST /api/v1/integrations/hubspot/sync/contacts/:customer_id
POST /api/v1/integrations/hubspot/sync/deals/:order_id
POST /api/v1/integrations/hubspot/sync/products/:product_id
Sync masivo
Sincroniza todos los registros de un tipo:
POST /api/v1/integrations/hubspot/sync/contacts/all
POST /api/v1/integrations/hubspot/sync/products/all
Consultar registros
GET /api/v1/integrations/hubspot/sync/records?status=failed&entity_type=contact
Reintentar fallidos
POST /api/v1/integrations/hubspot/sync/retry
Mapeo de campos
| OmniBuy | HubSpot | Dirección |
|---|---|---|
| Customer | Contact | Bidireccional |
| Order | Deal | OmniBuy → HubSpot |
| Product | Product | Bidireccional |
Errores
| Código | Descripción |
|---|---|
NOT_CONFIGURED | HubSpot no configurado para este tenant |
CONNECTION_FAILED | No se pudo conectar con HubSpot |
SYNC_FAILED | Error durante la sincronización |