> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pipedrive

> Cómo conectar Pipedrive a un agente de ChatNorris, desde ChatNorris o desde el Marketplace de Pipedrive, y qué crea el agente en tu CRM: personas, organizaciones, Leads, notas y actividades.

# Pipedrive

Con la integración de Pipedrive, cada contacto que tu agente de ChatNorris capta llega solo a tu CRM. Cuando un visitante deja su email o su teléfono (en el chat, en el Lead Form o al agendar una cita), el agente:

* busca a la persona en Pipedrive por email o teléfono, y la crea si no existe;
* asocia su empresa como organización;
* crea un Lead en la bandeja de Leads, con una etiqueta para identificarlo;
* agrega una nota con el enlace a la conversación y, si quieres, un resumen hecho con IA;
* registra actividades de seguimiento cuando el agente deriva a una persona de tu equipo o cuando el visitante agenda una reunión.

Tu equipo de ventas trabaja el Lead en Pipedrive como cualquier otro, con todo el contexto de la conversación a un clic.

## Requisitos

* Una cuenta de ChatNorris con plan **Standard** o **Premium**. Puedes ver los planes en [chatnorris.ai/pricing](https://chatnorris.ai/pricing).
* Al menos un agente creado en ChatNorris. Si todavía no tienes uno, sigue [Crear un agente](https://docs.chatnorris.ai/guias/crear-agente-wizard.md).
* Una cuenta de Pipedrive con permiso para instalar apps.
* Rol **Owner** o **Admin** en tu organización de ChatNorris.

> [!NOTE]
>
> Pipedrive está en **beta**: si en tu hub de Integraciones aparece con el botón **Solicitar acceso**, pídelo desde ahí (ver [Integraciones en beta](https://docs.chatnorris.ai/guias/integraciones.md#integraciones-en-beta)).

## Conectar Pipedrive

Cada agente se conecta a una cuenta de Pipedrive. Puedes empezar desde ChatNorris o desde el Marketplace de Pipedrive; el resultado es el mismo.

**Desde ChatNorris**

**1. Abre el hub de Integraciones del agente**

En ChatNorris, entra a `Agentes → [tu agente] → Integraciones` y elige **Pipedrive** en el catálogo.

**2. Haz clic en Conectar con Pipedrive**

Se abre Pipedrive. Si no tienes la sesión iniciada, inicia sesión con tu cuenta.

**3. Acepta los permisos**

Pipedrive te muestra los permisos que pide ChatNorris (ver [Permisos](#permisos)). Acéptalos para continuar.

**4. Vuelve a ChatNorris**

Pipedrive te devuelve a la ficha de la integración, que muestra la conexión activa con el nombre de tu empresa de Pipedrive. Sigue con [Configurar la Acción](#configurar-la-accion).

**Desde el Marketplace de Pipedrive**

**1. Busca ChatNorris en el Marketplace**

En el Marketplace de Pipedrive, abre la app **ChatNorris** y haz clic en **Instalar ahora**.

**2. Inicia sesión en ChatNorris**

Pipedrive te lleva a ChatNorris. Inicia sesión con tu cuenta o, si todavía no tienes una, haz clic en **Pruébalo gratis** para crearla. Al terminar vuelves a la instalación.

Si confirmas tu cuenta por correo, vuelve a la pestaña de la instalación e inicia sesión ahí. Si todavía no tienes agentes, la pantalla te ofrece crear uno: después conecta Pipedrive desde el hub de Integraciones del agente (pestaña **Desde ChatNorris**).

**3. Elige el agente**

En la pantalla **Conectar Pipedrive**, elige el agente que va a enviar sus contactos a Pipedrive y haz clic en **Conectar**.

**4. Acepta los permisos**

Pipedrive te muestra los permisos que pide ChatNorris (ver [Permisos](#permisos)). Acéptalos para continuar. Vuelves a ChatNorris con la conexión activa.

> [!TIP]
>
> ¿Tienes varios agentes? Repite la conexión en cada uno. Pueden usar la misma cuenta de Pipedrive o cuentas distintas.

## Configurar la Acción

Conectar Pipedrive no envía nada todavía. Para elegir qué hace el agente en tu CRM:

**1. Crea la Acción Pipedrive**

Entra a `Agentes → [tu agente] → Acciones`, haz clic en **Nueva acción** y elige **Pipedrive**.

**2. Elige las capacidades**

Activa las que quieras (ver la tabla de abajo). Algunas dependen de otras: por ejemplo, para etiquetar el Lead primero tienes que crearlo.

**3. Activa la Acción y guarda**

Desde ese momento, cada contacto confirmado de este agente llega a Pipedrive.

| Capacidad | Qué hace en Pipedrive |
| - | - |
| **Sincronizar persona** | Busca a la persona por email o teléfono y la crea si no existe. Si ya existe, solo completa el email o el teléfono que le falten: nunca pisa tus datos. |
| **Sincronizar empresa** | Si el visitante indicó su empresa (por ejemplo, en el campo **Empresa** del Lead Form), la busca como organización por su nombre exacto y la crea si no existe. La asocia al Lead y a la persona, solo si la persona no tenía otra organización. |
| **Crear Lead** | Crea un Lead en la bandeja de Leads, asociado a la persona. Uno por cada lead de ChatNorris. Puedes cambiar el título; `{name}` se reemplaza por el nombre del visitante. |
| **Etiquetar el Lead** | Agrega una etiqueta al Lead (por defecto **ChatNorris**) para filtrarlo. Si la etiqueta no existe, se crea. |
| **Nota con la conversación** | Agrega al Lead una nota con el canal y el enlace a la conversación en ChatNorris. |
| **Resumen con IA** | Suma a la nota un resumen de lo que busca el visitante. Consume 1 crédito de IA por lead, solo cuando hay que generarlo. |
| **Asignar dueño** | Asigna cada Lead nuevo siempre al mismo vendedor o en rotación entre varios. Sin esto, el dueño es el usuario de Pipedrive que conectó la cuenta. |
| **Seguimiento al derivar a un humano** | Cuando el agente deriva la conversación a una persona de tu equipo, crea una llamada o una tarea en el Lead, con el resumen del caso y el vencimiento que elijas. |
| **Registrar reuniones agendadas** | Cuando el visitante agenda una cita con Google Calendar, Encuadrado o AgendaPro, la registra en el Lead como actividad **Reunión** con su fecha y hora. |

> [!NOTE]
>
> ChatNorris solo crea y completa datos: nunca borra personas, organizaciones ni Leads, y no lee tus negocios, tus correos ni tus productos. Si un mismo visitante vuelve a escribir, no se duplica nada: el agente reconoce a la persona y al Lead que ya creó.

## Permisos

Al instalar, Pipedrive te pide aceptar estos permisos para ChatNorris:

| Permiso de Pipedrive | Para qué lo usa ChatNorris |
| - | - |
| Contactos (`contacts:full`) | Crear y completar personas y organizaciones, y agregar notas. |
| Leads (`leads:full`) | Crear Leads y etiquetas de Lead. |
| Búsqueda (`search:read`) | Buscar personas por email o teléfono y organizaciones por nombre, para no duplicarlas. |
| Actividades (`activities:full`) | Crear las actividades de seguimiento y las reuniones. |
| Usuarios (`users:read`) | Listar los usuarios de tu cuenta para elegir el dueño de los Leads. |

## Desconectar o desinstalar

Puedes cortar la conexión desde cualquiera de los dos lados:

* **Desde ChatNorris:** en `Agentes → [tu agente] → Integraciones → Pipedrive`, haz clic en **Desconectar**. La Acción Pipedrive se apaga y conserva su configuración.
* **Desde Pipedrive:** en la configuración de tu cuenta, abre la lista de apps instaladas y desinstala ChatNorris. ChatNorris recibe el aviso y marca la conexión como vencida en todos los agentes que la usaban.

Lo que ya se creó en Pipedrive (personas, organizaciones, Leads, notas y actividades) se queda en tu cuenta. Para volver a enviar contactos, conecta Pipedrive de nuevo y activa la Acción.

## Preguntas frecuentes

> **¿Por qué dos leads quedaron en la misma persona?**
>
> El agente identifica a la persona por email o teléfono, no por el nombre. Si dos conversaciones dejan el mismo email o teléfono, los dos Leads se asocian a la misma persona, aunque el nombre escrito sea distinto. Así evitamos personas duplicadas en tu CRM.

> **El Lead no tiene organización**
>
> Revisa que la capacidad **Sincronizar empresa** esté activa y que el visitante haya indicado su empresa, por ejemplo en un campo **Empresa** del Lead Form. Sin empresa, el Lead se crea igual, solo con la persona.

> **La reunión agendada no aparece en el Lead**
>
> Revisa que **Registrar reuniones agendadas** esté activa. Solo se registran las citas de Google Calendar, Encuadrado y AgendaPro; Cal.com y Calendly no avisan la reserva a ChatNorris.

> **La integración aparece como Requiere atención**
>
> Pipedrive dejó de aceptar el acceso: por ejemplo, porque se desinstaló la app o porque la conexión estuvo más de 60 días sin usarse. Vuelve a conectar Pipedrive desde el hub de Integraciones.

> **¿Conectar Pipedrive consume créditos?**
>
> No. Solo el **Resumen con IA** consume 1 crédito de IA por lead, y solo cuando el resumen no existía ya en ChatNorris.

## Soporte

¿Necesitas ayuda con la instalación? Escríbenos a [hola@chatnorris.ai](mailto:hola@chatnorris.ai).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.