Integración Pipedrive n8nAutomatiza Pipedrive con n8n.

Registra una llamada, una reunión o una tarea en la línea de tiempo de Pipedrive y devuelve la actividad recién creada con su identificador.

• Subject: la línea que el comercial lee en su lista, así que redáctala como una tarea.
• Type: el tipo de actividad, en texto libre: call, meeting.
• Additional Fields: Deal ID, Person ID u Organization Name or ID deciden de qué cuelga la actividad, Due Date espera una fecha YYYY-MM-DD y User Name or ID se la asigna a otro comercial.

Elimina una actividad. Desaparece de la línea de tiempo del trato, la persona o la organización a la que estaba unida, y n8n devuelve el identificador que se ha retirado.

• Activity ID: el identificador numérico de la actividad, casi siempre {{ $json.id }} heredado de una búsqueda o del trigger.

Lee una única actividad y devuelve sus campos en un item: asunto, tipo, fecha de vencimiento, responsable y fichas enlazadas.

• Activity ID: qué actividad leer.
• Show Raw Field Keys: desactivado, la salida usa nombres legibles; activado, muestra las claves de campo de Pipedrive en bruto y los IDs de opción, que es lo que hace falta cuando un nodo posterior cruza datos por una clave de campo personalizado.

Devuelve una lista de actividades en vez de una sola. La colección Filters recorta del lado de Pipedrive, así que llega menos ruido al resto del flujo.

• Return All: activado, n8n encadena las páginas de la API de Pipedrive y trae todas las actividades; desactivado, Limit fija el máximo.
• Filters: Start Date y End Date aceptan fechas de vencimiento en YYYY-MM-DD, Done deja solo las terminadas o las pendientes, User Name or ID acota a un comercial y Deal ID a un trato.

Edita una actividad existente y deja intacto todo campo que no rellenes.

• Activity ID: la actividad a editar.
• Update Fields: Done la cierra, Due Date la reprograma, Subject y Type reescriben la cabecera, User Name or ID la traspasa, Busy Flag marca la franja como ocupada y Public Description lleva el detalle al calendario externo.

Abre un trato en el embudo y lo devuelve con su identificador, listo para el siguiente nodo.

• Title: el nombre del trato que se ve en la tarjeta.
• Associate With: organization o person; después el formulario pide Organization ID o Person ID.
• Additional Fields: Value con Currency en código de 3 caracteres como EUR, Stage Name or ID para colocar la tarjeta, porque sin ese campo el trato cae en la primera etapa del embudo por defecto, Expected Close Date en formato YYYY-MM-DD, y Visible To.

Borra un trato de Pipedrive. Después no hay vuelta atrás, así que esta operación va detrás de una condición y nunca justo después de un trigger.

• Deal ID: el identificador numérico del trato a borrar, salido de una búsqueda o de un nodo Pipedrive anterior.

Copia un trato existente en uno nuevo y devuelve la copia con identificador propio. La copia llega como tarjeta nueva, y un update detrás fija las fechas, el importe y la etapa del ciclo que empieza.

• Deal ID: el trato que sirve de modelo.

Recupera un trato entero: importe, divisa, etapa, responsable y la persona u organización que hay detrás.

• Deal ID: el trato a leer.
• Show Raw Field Keys: cambia la salida de nombres legibles a claves de campo de Pipedrive en bruto e IDs de opción.

Lista tratos, con filtro o sin él. Todo lo que hace la colección Filters ocurre del lado de Pipedrive, así que el flujo recibe menos datos que descartar.

• Return All: activado, vuelven todas las páginas de resultados; desactivado, Limit decide cuántos tratos devuelve el nodo.
• Filters: Status vale all_not_deleted por defecto y también acepta open, won, lost o deleted, Stage Name or ID deja una etapa, User Name or ID un responsable y Predefined Filter Name or ID apunta a un filtro ya guardado.

Busca tratos a partir de texto libre, igual que la barra de búsqueda de Pipedrive, y devuelve cada coincidencia como un item.

• Term: el texto a buscar, 2 caracteres como mínimo, o 1 si Exact Match está activo. La búsqueda ignora mayúsculas.
• Search Fields: title, notes o custom_fields, todos por defecto.
• Return All y Limit: el dúo habitual cuando un término vago devuelve demasiados resultados.
• Additional Fields: Organization ID o Person ID acotan a una cuenta e Include Fields añade datos opcionales como deal.cc_email.

Reescribe los campos de un trato que ya está en el embudo y no toca nada más.

• Deal ID: la tarjeta a editar.
• Update Fields: Status mueve el trato a won, lost o deleted, Lost Reason anota el motivo, Stage Name or ID lo hace avanzar, Value y Currency corrigen el importe, Expected Close Date mueve la fecha y User Name or ID cambia de responsable.

Engancha una línea de producto a un trato, con su precio y su cantidad, y devuelve el enganche creado.

• Deal ID: el trato que recibe la línea.
• Product ID: el producto tomado del catálogo de Pipedrive.
• Item Price y Quantity: el precio aplicado en este trato y cuántas unidades entran.
• Additional Fields: Discount con Discount Type en percentage o amount, Tax como porcentaje y Comments para describir la línea.

Relee las líneas de producto enganchadas a un trato, cada una con su precio, su cantidad y el identificador de enganche que necesitan las demás operaciones de producto.

• Deal ID: el trato cuyas líneas se leen.
• Return All: activado para todas las líneas; desactivado, Limit corta antes.

Desengancha una línea de producto de un trato. El producto sigue en el catálogo, lo único que desaparece es su vínculo con este trato.

• Deal ID: el trato que sostiene la línea.
• Product Attachment ID: el identificador del par trato-producto, que no es el del producto. Get many products of a deal lo devuelve, y ese es el valor que va aquí.

Cambia una línea ya enganchada a un trato: precio, cantidad, descuento o impuesto.

• Deal ID y Product Attachment ID: qué línea se edita, otra vez con el identificador trato-producto y no con el del producto.
• Update Fields: Item Price y Quantity para las condiciones comerciales, Discount con Discount Type, Tax como porcentaje y Comments para la nota de la línea.

Sube un archivo a Pipedrive desde los datos binarios que trae el nodo anterior y lo engancha a la ficha que le indiques.

• Input Binary Field: el nombre del campo binario de entrada que contiene el archivo a escribir, el que produjo el nodo anterior.
• Additional Fields: Deal ID, Person ID, Organization Name or ID, Activity ID, Lead ID o Product ID, según a qué pertenezca el documento.

Retira un archivo guardado en una ficha de Pipedrive. La ficha se queda como está, solo se va el adjunto, y la operación responde con el identificador del archivo borrado.

• File ID: el identificador numérico del archivo a borrar.

Trae el contenido de un archivo de Pipedrive de vuelta al flujo como datos binarios, listo para que otro nodo lo lea o lo guarde en otro sitio.

• File ID: qué archivo descargar.
• Put Output File in Field: el nombre del campo binario de salida donde cae el archivo. El nodo siguiente lee ese campo, así que ponle el nombre que espera.

Devuelve lo que Pipedrive sabe de un archivo, nombre y descripción incluidos, pero no el contenido binario. Download a file es la operación que transporta los bytes, y las dos se encadenan a menudo.

• File ID: el archivo a leer.

Renombra un archivo o reescribe lo que dice de sí mismo, sin volver a subirlo.

• File ID: el archivo a editar.
• Update Fields: Name fija el nombre visible del archivo y Description el texto que aparece al lado.

Un lead es una pista sin calificar, guardada en Pipedrive antes de que exista ningún trato. La operación crea una con lo que el flujo acaba de recoger.

• Title: el nombre con el que la pista aparece en la lista, casi siempre la empresa más el canal por el que entró.
• Associate With: elegir organization o person determina si el nodo pide Organization ID o Person ID.
• Value: el importe potencial de la pista, dentro de Additional Fields junto a Expected Close Date en formato YYYY-MM-DD.

Las pistas duplicadas se acumulan rápido cuando dos formularios alimentan la misma lista. Esta operación borra la que sobra, sin vuelta atrás.

• Lead ID: el identificador de la pista, una cadena de texto que llega del nodo que la localizó; al ser obligatorio, un valor vacío detiene la ejecución en lugar de borrar cualquier cosa.

Leer una pista por su identificador devuelve el estado real en Pipedrive, no la copia que una etapa anterior arrastra desde hace rato.

• Lead ID: el único campo que hay que rellenar; la operación lee sin modificar nada, así que entra bien dentro de un bucle o en una rama de reintento.

La lista completa de pistas sale en un elemento por pista, que es como empieza cualquier informe y cualquier sincronización.

• Return All: activado, n8n encadena las páginas de la API hasta la última pista; desactivado, Limit marca el tope.
• Archived Status: not_archived para lo que sigue vivo, archived para lo apartado, all para ambas cosas.
• Filters: recorta la lectura en origen por Owner Name or ID, Organization ID o Person ID.

Solo viajan a Pipedrive los campos que abres en Update Fields. El resto conserva su valor, y por eso un flujo puede pasar varias veces sobre la misma pista sin pisar lo que el equipo escribió a mano.

• Lead ID: la pista que se modifica, obligatorio aunque cambie un solo dato.
• Is Archived: saca la pista de la lista activa sin borrarla, el final lógico de una rama que termina en un no.
• Title, Value y Expected Close Date: los tres campos que hacen legible una pista dentro de una previsión.

Una nota es el rastro escrito que hace legible una ficha meses después. La operación la crea y la engancha al objeto que el flujo tiene entre manos.

• Content: el texto de la nota, único campo obligatorio, casi siempre montado por un nodo anterior con el resumen de una llamada.
• Deal ID, Person ID, Organization Name or ID y Lead ID: la ficha a la que se engancha, todos dentro de Additional Fields.
• Pinned to Deal: fija la nota arriba del trato en vez de dejarla caer en el histórico.

Hay notas que escribe la automatización y que no deberían sobrevivirla: un borrador ya sustituido, una nota puesta en la ficha equivocada.

• Note ID: el identificador numérico de la nota, tomado del paso que la creó o la listó; en Pipedrive las notas llevan número y las pistas llevan cadena de texto, así que no hay forma de confundirlas.

Cuando el paso siguiente tiene que citar una nota palabra por palabra, empieza por leerla aquí en lugar de reconstruirla.

• Note ID: el identificador de la nota, un número; la operación no pide nada más y encaja detrás de cualquier paso que ya sepa qué nota quiere.

Las notas vuelven en lista, filtradas del lado de Pipedrive en vez de descartarlas después dentro del flujo.

• Filters: Start Date y End Date en YYYY-MM-DD acotan un periodo, mientras que Deal ID, Person ID o Lead ID dejan solo las notas de una ficha.
• Sort: update_time pone delante las más recientes, content ordena alfabéticamente e id sigue el orden de creación.
• Return All: sin activar, Limit mantiene el lote pequeño mientras ajustas el flujo.

Editar la nota existente funciona mejor que apilar otra debajo, sobre todo cuando el flujo rehace el mismo resumen después de cada llamada.

• Note ID: la nota que se edita, obligatorio.
• Content: el texto de reemplazo, aquí dentro de Update Fields cuando en la creación era obligatorio.
• Pinned to Person y Pinned to Organization: cambian dónde se ve la nota sin tocar una sola palabra.

Las empresas entran en Pipedrive como organizaciones, y el nodo crea una con un solo campo obligatorio.

• Name: el nombre de la empresa, obligatorio; es el dato sobre el que buscarás más adelante, así que normalizarlo antes ahorra cuentas duplicadas.
• Custom Fields: dentro de Additional Fields, donde van el sector, el segmento o cualquier campo que el equipo comercial haya añadido.
• Visible To: 1 reserva la ficha al propietario y a sus seguidores, 3 la abre a toda la empresa.

Borrar la ficha de una empresa es raro y casi nunca tiene marcha atrás: mejor colocar la operación detrás de una aprobación humana que a la salida directa de un disparador.

• Organization ID: el identificador numérico de la organización, nunca su nombre, y por eso suele ir antes una búsqueda que traduce uno en otro.

Leer una organización concreta devuelve la cuenta tal como la guarda Pipedrive, campos personalizados incluidos.

• Organization ID: la cuenta que se lee, obligatorio.
• Show Raw Field Keys: activado, la salida trae las claves internas de Pipedrive y los identificadores de opción en lugar de los nombres legibles, que es lo que necesita un mapeo hacia otra herramienta.

Toda la cartera de cuentas sale de una vez, que es por donde empiezan las exportaciones, las auditorías y los enriquecimientos.

• Return All: marcado, el nodo encadena las páginas solo; sin marcar, Limit decide cuántas organizaciones vuelven.
• Predefined Filter Name or ID: reutiliza un filtro ya creado dentro de Pipedrive, así la lógica de selección se queda donde el equipo la mantiene.
• First Character: un único carácter que deja solo las organizaciones cuyo nombre empieza por él, útil para partir una exportación grande por letras.

Buscar sale mejor que listar cuando el flujo tiene un nombre y necesita la cuenta que le corresponde, por ejemplo para no crear dos veces la misma empresa.

• Term: el texto buscado, mínimo dos caracteres, o uno solo si activas Exact Match.
• Exact Match: devuelve únicamente las coincidencias completas del término, sin distinguir mayúsculas de minúsculas.
• Search Fields: limita la búsqueda a name, address, notes o custom_fields; vacío, se consultan todos.

Los datos de una cuenta envejecen deprisa: una compra, un cambio de nombre, otro propietario. La operación escribe esos cambios sobre la ficha que ya existe.

• Organization ID: la organización que se modifica, obligatorio.
• Name y Owner Name or ID: van en Update Fields, y enviar uno deja el otro intacto.
• Use Raw Field Keys: permite dirigirse a los campos personalizados por sus claves de Pipedrive y sus identificadores de opción en vez de por sus nombres legibles, más estable cuando las etiquetas cambian.

Los contactos viven en el objeto person, y el nodo crea uno a partir de un nombre; todo lo demás es opcional.

• Name: el nombre del contacto, único campo obligatorio.
• Emails y Phones: son colecciones y no campos de texto, porque un contacto suele llevar un correo de trabajo y otro personal, un fijo y un móvil.
• Organization Name or ID: engancha el contacto a una cuenta desde el principio y ahorra el enlace manual posterior.

Un contacto que pide desaparecer, o un duplicado creado por dos integraciones a la vez, sale de la base con esta operación.

• Person ID: el identificador numérico del contacto, que suele resolverse un paso antes con una búsqueda por correo electrónico.

Vuelve un solo contacto, leído por su identificador, con los campos que mantiene el equipo comercial.

• Person ID: el contacto que se lee, obligatorio.
• Show Raw Field Keys: devuelve las claves internas y los identificadores de opción en lugar de las etiquetas, cómodo cuando el nodo siguiente espera claves estables.

Una sincronización, una segmentación o una caza de correos que faltan empiezan igual, leyendo la base de contactos entera.

• Return All: activado, todos los contactos suben página tras página; desactivado, Limit mantiene corta la ejecución mientras ajustas el montaje.
• Filters: Predefined Filter Name or ID reutiliza un filtro guardado en Pipedrive y First Character deja solo los contactos cuyo nombre empieza por la letra indicada.

Cuando el flujo conoce un correo pero no el identificador, la búsqueda es el paso que convierte uno en otro.

• Term: lo que buscas, desde dos caracteres, o uno con Exact Match activado.
• Search Fields: email, phone, name, notes o custom_fields; buscar solo por email evita caer en un homónimo.
• Organization ID: deja únicamente los contactos de una cuenta, mientras que Include Fields añade datos opcionales como person.picture.

Los teléfonos cambian, la gente se muda de empresa, las etiquetas se rehacen. La operación aplica esas correcciones sobre un contacto que ya está en la base.

• Person ID: el contacto que se modifica, único campo obligatorio.
• Emails y Phones: se envían como colecciones, así que el contacto puede llevar varias direcciones y varios números.
• Visible To: 1 para el propietario y sus seguidores, 3 para toda la empresa.

El catálogo de Pipedrive crece desde el flujo de trabajo: el nombre es lo único obligatorio y el resto de la ficha viaja en Additional Fields.

• Name: el rótulo que ve el equipo comercial al asociar el producto a un negocio; vacío, detiene la ejecución.
• Additional Fields: reúne Code para la referencia, Unit para la unidad de venta, Tax para el impuesto, Prices para los importes y Owner ID para la persona propietaria.
• Visible To: 1 lo reserva a su propietario y a sus seguidores, 3 lo comparte con toda la empresa.

Borrar una ficha de producto se resuelve con un solo parámetro. Pipedrive espera el identificador numérico y no el nombre, así que el valor llega de un paso anterior que ya localizó la ficha.

• Product ID: el número de la ficha que se elimina, normalmente {{ $json.id }} tomado de una búsqueda o de un listado previo.

La lectura de una ficha devuelve sus campos al resto del flujo. Así un presupuesto o un aviso interno usan la unidad y el impuesto que constan en el catálogo, y no lo que alguien recuerda de memoria.

• Product ID: la ficha que se lee, en formato numérico; una expresión como {{ $json.product_id }} la hereda del nodo anterior.
• Show Raw Field Keys: sin marcar, la salida trae nombres legibles; marcado, devuelve las claves de campo brutas de Pipedrive y los IDs de opción.

Get Many trae los productos de la cuenta, un item por ficha, sin filtros que rellenar. Lo único que decides es cuántos entran.

• Return All: marcado, n8n recorre las páginas de la API hasta el último producto; sin marcar, Limit fija el máximo de fichas devueltas.
• Show Raw Field Keys: el mismo interruptor de la lectura individual, aplicado a cada elemento de la lista.

La búsqueda trabaja con texto en lugar de con identificadores. Une un nombre escrito a mano, en un formulario o en un correo, con la ficha real del catálogo.

• Term: el texto que se busca, con dos caracteres como mínimo, o uno solo si Exact Match está activo.
• Exact Match: deja pasar únicamente las coincidencias completas del término, sin distinguir mayúsculas de minúsculas.
• Search Fields: acota la búsqueda a name, code o custom_fields, que por defecto se consultan los tres; Include Fields suma campos opcionales al resultado.

La actualización envía solo los campos que pones en Update Fields. Cambiar un precio deja intactos el código, la unidad y la propiedad de la ficha.

• Product ID: la ficha que se modifica, identificada por su número en Pipedrive.
• Update Fields: recoge los mismos atributos que la creación, Name incluido, que aquí es opcional porque renombrar no siempre hace falta.
• Use Raw Field Keys: actívalo cuando los valores de entrada ya vienen con las claves de campo brutas de Pipedrive y los IDs de opción.