# HubSpot CRM

:::tip Disponible
Esta integración está disponible en Frihet. Configúrala en **Settings → Integraciones → HubSpot CRM**.
:::

Conecta tu cuenta de HubSpot CRM a Frihet para importar tus contactos como clientes. Si usas HubSpot para gestionar tu pipeline de ventas y relaciones comerciales, esta integración te permite traer esos contactos a Frihet para facturarles directamente, sin duplicar datos ni escribir nada a mano.

## ¿Para qué sirve?

- **Importar contactos como clientes** — Los contactos de HubSpot se convierten en clientes de Frihet con nombre, email, teléfono, empresa y dirección
- **Eliminación de doble entrada** — No necesitas volver a crear en Frihet los clientes que ya tienes en HubSpot
- **Base de clientes unificada** — Mantén una única fuente de datos de clientes que fluye desde tu CRM a tu ERP
- **Facturación inmediata** — Una vez importados, puedes crear facturas para esos clientes directamente desde Frihet

## Requisitos

- Cuenta activa en [HubSpot](https://www.hubspot.com)
- Plan Frihet Pro o Premium
- Private App con access token en HubSpot (necesita el scope `crm.objects.contacts.read`)

## Cómo conectar

### Paso 1: Crear una Private App en HubSpot

1. Inicia sesión en [app.hubspot.com](https://app.hubspot.com)
2. Ve a **Settings** (icono de engranaje en la barra superior)
3. En el menú lateral, navega a **Integrations → Private Apps**
4. Haz clic en **Create a private app**
5. En la pestaña **Basic Info**:
   - Nombre: "Frihet ERP"
   - Descripción (opcional): "Importar contactos a Frihet"
6. En la pestaña **Scopes**, busca y activa:
   - `crm.objects.contacts.read` — Lectura de contactos
7. Haz clic en **Create app** y confirma
8. Copia el **Access Token** que se muestra. Este es el token que usarás en Frihet.

### Paso 2: Configurar en Frihet

1. En Frihet, ve a **Settings → Integraciones**
2. Busca **HubSpot CRM** y haz clic en el card
3. Pega tu **Access Token** (Private App token) en el campo correspondiente
4. Haz clic en **Probar conexión** para verificar
5. Si la conexión es exitosa, haz clic en **Guardar**

## Cómo funciona

Frihet se conecta a la API de HubSpot utilizando el access token de tu Private App. Cuando lanzas una importación, Frihet consulta los contactos de tu cuenta de HubSpot y los crea como clientes en Frihet.

La importación es bajo demanda. Los contactos ya importados se identifican por su ID de HubSpot y no se duplican en importaciones posteriores.

### Mapeo de datos

| Dato en HubSpot                    | Campo en Frihet       |
| ---------------------------------- | --------------------- |
| First name + Last name             | Nombre del cliente    |
| Email                              | Email del cliente     |
| Phone                              | Teléfono del cliente  |
| Company                            | Empresa del cliente   |
| Address, City, State, Zip, Country | Dirección del cliente |

## Casos de uso

### Agencia que cierra deals en HubSpot

Tu equipo comercial gestiona el pipeline en HubSpot. Cuando un deal se cierra, importas el contacto a Frihet para crear la factura. No necesitas pedirle los datos al cliente de nuevo ni copiarlos a mano.

### Consultora con base de clientes en HubSpot

Tienes cientos de contactos en HubSpot acumulados durante años. En lugar de crear cada cliente manualmente en Frihet, haces una importación masiva y tu base de datos de facturación queda lista al instante.

### Freelancer con HubSpot Free

Usas el CRM gratuito de HubSpot para gestionar contactos. Cuando necesitas facturar a un contacto, lo importas a Frihet con un clic y creas la factura con todos los datos ya completados.

## Solución de problemas

### Error de conexión

- Verifica que el access token de la Private App es correcto
- Comprueba que la Private App tiene el scope `crm.objects.contacts.read` activado
- Si eliminaste y recreaste la Private App, el token anterior deja de funcionar — actualízalo en Frihet

### No se importan contactos

- Asegúrate de que tienes contactos en tu cuenta de HubSpot
- Verifica que los contactos tienen al menos nombre o email (los contactos sin datos se omiten)
- Comprueba que la Private App no ha sido desactivada en HubSpot

### Datos incompletos en clientes importados

- Solo se importan los campos que tienen datos en HubSpot
- Si un contacto no tiene teléfono o dirección en HubSpot, esos campos quedarán vacíos en Frihet
- Puedes completar los datos directamente en Frihet después de la importación

## Siguientes pasos

- [Conecta Pipedrive como alternativa de CRM](./pipedrive)
- [Gestiona tus clientes en Frihet](../clientes/gestion-clientes)
- [Importa y exporta clientes en lote](../clientes/importar-exportar)