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

# Pipedrive

> Opera leads, personas, organizaciones, ofertas y actividad comercial en Pipedrive desde Brain Studio.

**Pipedrive** es un CRM diseñado alrededor del **pipeline de ventas**: cada interacción gira en torno a mover leads, personas y ofertas a través de etapas definidas hasta el cierre. A diferencia de CRMs más amplios como HubSpot o Salesforce, Pipedrive se concentra en la disciplina comercial diaria del equipo de ventas.

En **Brain Studio**, la integración permite que tus flujos capturen leads, abran ofertas, avancen etapas y registren actividad directamente desde WhatsApp o cualquier canal conversacional. El pipeline refleja lo que realmente pasó en la conversación, sin reingreso manual.

## Qué habilita Pipedrive

Al conectar **Pipedrive**, puedes:

* **Capturar leads en el momento** — registrar cada prospecto que llega por WhatsApp o webchat sin salir de la conversación
* **Mantener personas y organizaciones limpias** — crear, actualizar o fusionar contactos para que el pipeline no tenga duplicados ni datos obsoletos
* **Mover el pipeline desde el canal** — abrir ofertas, cambiar etapas y actualizar montos según lo que se acordó en la conversación
* **Dejar trazabilidad sin esfuerzo** — notas y actividades que se registran automáticamente para que el seguimiento no dependa de la memoria del ejecutivo

***

## Instalación

### Requisitos previos

1. Una **cuenta activa en Pipedrive** con permisos acordes a leads, personas, ofertas y notas.
2. Autorización para **conectar aplicaciones de terceros** (OAuth) en tu organización, si tu administrador lo exige.

### Cómo conectarla

La forma más directa es usar [**Jelou Agent**](/guides/getting-started/jelou-agent): describe lo que necesitas y el agente conecta **Pipedrive** automáticamente dentro del flujo.

Si prefieres instalar manualmente, sigue estos pasos en el **Marketplace**. La conexión usa **OAuth de Pipedrive**; no necesitas copiar credenciales.

<Steps>
  <Step title="Abrir el Marketplace">
    En Brain Studio, abre **Marketplace** desde el menú lateral.
  </Step>

  <Step title="Buscar Pipedrive">
    Encuentra la integración y haz clic en **Conectar**.
  </Step>

  <Step title="Autorizar con Pipedrive">
    Completa el flujo OAuth con tu cuenta de Pipedrive.
  </Step>

  <Step title="Confirmar instalación">
    La integración aparecerá como **conectada**.

    <Check>
      Puedes usarla en **Canvas** o agregarla como herramienta en **AI Agent**.
    </Check>
  </Step>
</Steps>

***

## Tools disponibles

La integración expone **17 tools**. Las agrupamos por **uso comercial** en Pipedrive. Los nombres coinciden con los que verás en Brain Studio.

<AccordionGroup>
  <Accordion title="Leads">
    Centraliza la captación y el trabajo sobre **leads** antes o durante la conversión a oportunidad.

    **Tools incluidas**

    * Agregar Lead
    * Obtener todos los leads
    * Obtener Lead por ID
    * Buscar leads

    **Cuándo usar esta categoría**

    * Cuando el contacto entra por WhatsApp u otro canal y necesitas **registrar o recuperar el lead** en Pipedrive
    * Cuando quieres **listar o filtrar leads** para calificar, enrutar o dar seguimiento
    * Cuando el flujo necesita el **detalle de un lead concreto** por su identificador en Pipedrive
  </Accordion>

  <Accordion title="Personas y organizaciones">
    Mantiene **personas** y **empresas** alineadas con el pipeline y evita registros dispersos.

    **Tools incluidas**

    * Agregar persona
    * Agregar Organización
    * Obtener detalles de la persona
    * Buscar personas
    * Actualizar Persona
    * Fusionar Personas

    **Cuándo usar esta categoría**

    * Cuando capturas datos en chat y debes **crear o actualizar** la ficha de persona u organización
    * Cuando necesitas **buscar** si ya existe un contacto antes de crear una oferta
    * Cuando hay **duplicados** y conviene **fusionar personas** con criterio operativo
  </Accordion>

  <Accordion title="Deals">
    Opera el **pipeline**: nuevas oportunidades, cambios de estado y consolidación de registros.

    **Tools incluidas**

    * Añadir oferta
    * Actualizar oferta
    * Fusionar ofertas

    **Cuándo usar esta categoría**

    * Cuando un hito en la conversación debe reflejarse como **nueva oferta** o **cambio en una existente**
    * Cuando el negocio avanza y necesitas **actualizar** monto, etapa u otros campos que use tu equipo
    * Cuando detectas **ofertas duplicadas** y quieres **fusionarlas** para un solo historial
  </Accordion>

  <Accordion title="Actividad y contexto comercial">
    Deja **trazabilidad** en el CRM: qué se dijo, qué pasó y qué sigue, sin depender solo de la memoria del ejecutivo.

    **Tools incluidas**

    * Agregar actividad
    * Agregar nota
    * Buscar notas
    * Eliminar notas duplicadas

    **Cuándo usar esta categoría**

    * Cuando quieres **registrar una actividad** ligada al ritmo comercial (llamada, reunión, tarea, etc., según defina la tool en el editor)
    * Cuando necesitas **anotar contexto** de la conversación en el registro correcto
    * Cuando buscas **notas previas** antes de responder o cerrar un paso
    * Cuando aplicas **higiene de datos** eliminando notas duplicadas
  </Accordion>
</AccordionGroup>

***

## Cómo usar en Brain

### En AI Agent

Úsalo cuando la conversación sea **abierta**: el usuario puede pedir cosas distintas en cualquier orden (consultar un lead, añadir una nota, proponer una oferta). El agente elige la tool según la intención, siempre dentro de las acciones que hayas habilitado.

<Steps>
  <Step title="Abre el nodo AI Agent">
    En el Canvas, selecciona o añade el nodo **AI Agent**.
  </Step>

  <Step title="Abre Herramientas">
    En el panel derecho, entra a la pestaña **Herramientas**.
  </Step>

  <Step title="Agrega Pipedrive">
    Usa **Agregar tool**, busca **Pipedrive** y actívala.
  </Step>

  <Step title="Configura las tools">
    Activa solo las acciones que quieras exponer (por ejemplo solo leads y notas en un canal de calificación).

    <Check>
      **Pipedrive** aparece en la lista de herramientas del agente; puedes afinar permisos desde el icono de ajustes de la integración.
    </Check>
  </Step>
</Steps>

### En Canvas

Úsalo cuando el proceso sea **determinista**: primero buscas persona, luego creas oferta, luego añades nota, con ramas claras según respuesta del usuario o datos ya guardados en memoria.

<Steps>
  <Step title="Arrastra Pipedrive al Canvas">
    En el panel lateral, abre **Marketplace** y arrastra **Pipedrive** al flujo.
  </Step>

  <Step title="Selecciona la tool">
    Con el nodo seleccionado, en **Tools** elige la acción (por ejemplo **Buscar personas** o **Añadir oferta**).
  </Step>

  <Step title="Configura el cuerpo y la memoria">
    Completa el JSON en el editor del nodo y, si aplica, **Guardar respuesta** en variables de memoria para los pasos siguientes.
  </Step>

  <Step title="Conecta el flujo">
    Enlaza **Finalizó la tarea** y **Hubo un error** con los nodos que sigan la lógica comercial.

    <Check>
      El orden de los nodos define el proceso; Pipedrive ejecuta la acción configurada en cada paso.
    </Check>
  </Step>
</Steps>

El editor del nodo te muestra la forma esperada del cuerpo según la tool. El ejemplo siguiente es **orientativo**: ajústalo a los campos reales que indique Brain Studio para **Añadir oferta** y a tus variables de memoria.

```json theme={null}
{
  "title": "{{$memory.resumen_oportunidad}}",
  "person_id": "{{$memory.person_id_pipedrive}}",
  "stage_id": "{{$memory.etapa_pipeline}}",
  "value": "{{$memory.monto_estimado}}"
}
```

***

## Casos de uso

<AccordionGroup>
  <Accordion title="Captación de leads en el momento desde WhatsApp">
    Cada mensaje entrante de un prospecto es una oportunidad que puede perderse si no se registra. Con el flujo conectado, el lead queda en Pipedrive antes de que termine la conversación.

    **Ejemplo concreto:** una empresa de software B2B recibe consultas por WhatsApp. El prospecto pregunta por precios. El flujo busca si ya existe en Pipedrive; si no, crea el lead con nombre, empresa y canal de origen. El ejecutivo encuentra la ficha lista cuando entra al CRM, con el contexto de la primera interacción.

    **Ideal para:** equipos comerciales donde la velocidad de respuesta importa y los leads llegan por múltiples canales conversacionales.
  </Accordion>

  <Accordion title="Avance del pipeline según lo que se acuerda en el chat">
    Cuando el prospecto confirma interés, acepta una propuesta o da un dato clave, el flujo puede reflejar ese hito directamente en el pipeline de Pipedrive: crear la oferta, mover la etapa o actualizar el monto.

    **Ejemplo concreto:** un equipo de ventas con pipeline en 5 etapas. El prospecto dice por WhatsApp "me interesa la propuesta de 15,000". El flujo crea la oferta en la etapa "Propuesta enviada" con el monto indicado y agrega una nota con el extracto de la conversación. El manager ve el pipeline actualizado sin que el ejecutivo haya abierto Pipedrive.

    **Ideal para:** equipos de ventas con etapas definidas que necesitan que el CRM refleje lo que realmente se acordó.
  </Accordion>

  <Accordion title="Consulta del pipeline sin salir de WhatsApp">
    El ejecutivo va camino a una reunión y necesita saber el estado de una oportunidad. El líder comercial quiere un resumen rápido de los leads de la semana. En lugar de abrir Pipedrive, preguntan por chat.

    **Ejemplo concreto:** el director comercial escribe "¿cómo va lo de Grupo Alfa?". El flujo busca la oferta en Pipedrive, encuentra la etapa actual, el monto y las notas recientes, y responde con un resumen. Si el ejecutivo necesita más detalle, el flujo le muestra actividades pendientes.

    **Ideal para:** equipos comerciales que operan desde el celular y necesitan acceso rápido al CRM sin abrir la app.
  </Accordion>
</AccordionGroup>

***

## Integraciones que combinan bien con Pipedrive

<AccordionGroup>
  <Accordion title="Gmail">
    Cuando una oferta avanza de etapa o un lead queda calificado, el flujo puede enviar automáticamente un correo de seguimiento, una propuesta o material comercial al contacto, sin que el ejecutivo tenga que redactarlo.

    **Flujo combinado:** oferta movida a "Propuesta" en Pipedrive → correo con PDF de propuesta al contacto.

    [Documentación de Gmail](/guides/integraciones/productividad/gmail)
  </Accordion>

  <Accordion title="Calendly">
    Después de calificar un lead o mover una oferta, el flujo puede enviar un enlace de Calendly para que el prospecto agende una reunión. La cita queda alineada con el contexto comercial que ya existe en Pipedrive.

    **Flujo combinado:** lead calificado → enviar enlace de Calendly → registrar actividad en Pipedrive cuando se confirma la cita.

    [Documentación de Calendly](/guides/integraciones/agendamiento/calendly)
  </Accordion>

  <Accordion title="Slack">
    Cada lead de prioridad alta, oferta ganada o perdida puede disparar una alerta al canal comercial en Slack. El equipo se entera al instante sin depender de que alguien revise Pipedrive.

    **Flujo combinado:** oferta marcada como ganada → mensaje a #ventas con nombre del deal, monto y ejecutivo.

    [Documentación de Slack](/guides/integraciones/productividad/slack)
  </Accordion>

  <Accordion title="Google Sheets">
    Para comités comerciales, forecasting o reporting semanal, el flujo puede exportar datos del pipeline a una hoja compartida con management o revenue ops.

    **Flujo combinado:** cada viernes, consultar ofertas activas en Pipedrive → actualizar hoja de forecast en Sheets.

    [Documentación de Google Sheets](/guides/integraciones/productividad/google-sheets)
  </Accordion>
</AccordionGroup>

***

## Artículos relacionados

<CardGroup cols={2}>
  <Card title="Integraciones" href="/guides/integraciones/integraciones" icon="grid">
    Catálogo de integraciones disponibles en el Marketplace.
  </Card>

  <Card title="Cómo usar integraciones en Brain" href="/guides/integraciones/como-usar-integraciones-en-brain" icon="book-open">
    Flujo general para instalar y usar integraciones en Brain Studio.
  </Card>
</CardGroup>