# Pipedrive

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

Conecta tu cuenta de Pipedrive a Frihet para importar tus contactos (personas) como clientes. Pipedrive es un CRM centrado en el pipeline de ventas, y con esta integración puedes traer los datos de tus contactos a Frihet para facturarles sin necesidad de duplicar información entre sistemas.

## ¿Para qué sirve?

- **Importar personas como clientes** — Los contactos (persons) de Pipedrive se convierten en clientes de Frihet con nombre, email, teléfono y empresa
- **Datos primarios automáticos** — Se importa el email y teléfono principal de cada contacto
- **Sin doble entrada** — Evita crear manualmente en Frihet los clientes que ya existen en tu CRM
- **Facturación directa** — Una vez importados, crea facturas para esos clientes con todos los datos ya completados

## Requisitos

- Cuenta activa en [Pipedrive](https://www.pipedrive.com)
- Plan Frihet Pro o Premium
- API Token de Pipedrive

## Cómo conectar

### Paso 1: Obtener tu API Token en Pipedrive

1. Inicia sesión en [app.pipedrive.com](https://app.pipedrive.com)
2. Haz clic en tu avatar o iniciales en la esquina superior derecha
3. Selecciona **Personal preferences** (Preferencias personales)
4. Ve a la pestaña **API**
5. Copia tu **API Token** personal que se muestra en pantalla

:::caution Nota
El API Token de Pipedrive es personal y tiene acceso a todos los datos de tu cuenta. No lo compartas y guárdalo de forma segura.
:::

### Paso 2: Configurar en Frihet

1. En Frihet, ve a **Settings → Integraciones**
2. Busca **Pipedrive** y haz clic en el card
3. Pega tu **API 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 Pipedrive utilizando tu API Token como parámetro de autenticación. Cuando lanzas una importación, Frihet consulta las personas (persons) registradas en Pipedrive y las crea como clientes en Frihet.

La importación es bajo demanda. Se importa el email y teléfono principal de cada persona. Los contactos ya importados se identifican por su ID de Pipedrive y no se duplican.

### Mapeo de datos

| Dato en Pipedrive | Campo en Frihet      |
| ----------------- | -------------------- |
| Name              | Nombre del cliente   |
| Email (primary)   | Email del cliente    |
| Phone (primary)   | Teléfono del cliente |
| Organization name | Empresa del cliente  |

## Casos de uso

### Equipo comercial con pipeline en Pipedrive

Tu equipo gestiona oportunidades en Pipedrive. Cuando un deal se cierra, importas la persona asociada a Frihet como cliente y creas la factura directamente. El flujo va de CRM a ERP sin fricciones.

### Migración de base de contactos

Tienes años de contactos acumulados en Pipedrive. En lugar de exportar un CSV y reimportarlo, conectas Pipedrive a Frihet y traes todos tus contactos con un clic.

### Freelancer o consultor

Usas Pipedrive para gestionar tus leads y oportunidades. Cuando un prospecto se convierte en cliente, lo importas a Frihet para empezar a facturarle con los datos correctos desde el principio.

## Solución de problemas

### Error de conexión

- Verifica que el API Token es correcto y corresponde a tu cuenta
- Comprueba que tu cuenta de Pipedrive está activa y no ha expirado
- Si cambiaste tu contraseña en Pipedrive, el API Token puede haberse regenerado — verifica en Personal preferences > API

### No se importan contactos

- Asegúrate de que tienes personas (persons) creadas en Pipedrive, no solo organizaciones
- Los contactos sin nombre se omiten durante la importación
- Verifica que tu plan de Pipedrive permite acceso a la API

### Falta el email o teléfono

- Pipedrive permite múltiples emails y teléfonos por persona. Frihet importa solo el marcado como **primary**
- Si un contacto no tiene email o teléfono primary, esos campos quedarán vacíos en Frihet

## Siguientes pasos

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