Integración Keap n8nAutomatiza Keap con n8n.

Crea una empresa en Keap, el objeto al que después cuelgas contactos y pedidos cuando vendes a organizaciones y no a particulares.

• Company Name: el único campo obligatorio, normalmente alimentado por {{ $json.company }} desde un formulario.
• Addresses, Phones y Faxes: colecciones separadas, que se rellenan línea a línea y no en una caja de texto única.
• Additional Fields: reúne Email, Website, Notes y Opt In Reason, más el detalle de la dirección, con el Country Code en formato ISO Alpha-3.

Saca de Keap el listado de empresas, entero o filtrado, y devuelve un item por empresa para el nodo siguiente.

• Return All: activado, n8n pide páginas hasta agotar la API; desactivado, se detiene en Limit.
• Company Name: acota la consulta a las empresas que llevan ese nombre.
• Order y Order Direction: ordena por datecreated, id o name, de forma ascendente o descendente.
• Fields: lista de propiedades separadas por comas que se añaden a la respuesta, porque las notas, el número de fax y los campos personalizados no vienen por defecto.

Una sola llamada que crea el contacto o actualiza el que ya está en Keap. Es la más usada del nodo: evita los duplicados en vez de arreglarlos luego.

• Duplicate Option: obligatorio. Email compara solo la dirección, Email And Name exige que coincidan dirección y nombre para que Keap considere que es la misma persona.
• Emails, Phones, Addresses y Social Accounts: colecciones, con cada entrada tipada por Field o Type.
• Additional Fields: 17 campos, entre ellos Given Name, Family Name, Job Title, Owner Name or ID, Company ID y Source Type.

Elimina un contacto de Keap. El nodo no pide confirmación: lo que entra, se borra.

• Contact ID: obligatorio, el identificador de Keap y no la dirección de correo. Suele venir de una búsqueda anterior, en forma de {{ $json.id }}.

Recupera una ficha de contacto por su identificador y la devuelve como un item, listo para que lo lean las expresiones de los nodos siguientes.

• Contact ID: obligatorio, el identificador numérico de la persona en Keap.
• Fields: lista de propiedades a incluir, separadas por comas, porque el identificador de origen del lead, los campos personalizados y el cargo no vienen por defecto.

Recorre la base de contactos página a página, con filtros que hacen el resultado manejable en lugar de enorme.

• Return All: activado para una exportación completa, desactivado para topar en Limit.
• Since y Until: una ventana de fechas sobre la última actualización, que es lo que convierte la exportación en sincronización incremental.
• Email, Given Name, Family Name: los filtros para dar con una persona concreta.
• Order y Order Direction: orden por date, email, id o name.

Escribe una nota en el historial de un contacto, la que el comercial lee antes de coger el teléfono.

• Contact ID: la persona a la que se engancha la nota.
• User Name or ID: el usuario de Infusionsoft en cuyo nombre se crea la nota, elegido en la lista o indicado por expresión.
• Additional Fields: Title, Body, y Type entre appointment, call, email, fax, letter y other.

Quita una nota del historial de forma definitiva. El resto de la ficha del contacto no se toca.

• Note ID: obligatorio, el identificador de la propia nota, que no es el del contacto. Recúpéralo con contactNote.getAll si solo sabes de quién es.

Devuelve una nota con su contenido, de modo que un flujo pueda leer lo que se escribió antes de decidir el siguiente paso.

• Note ID: obligatorio, y es la única entrada de esta operación.

Lista las notas de todos los contactos, o se centra en el historial de una sola persona en cuanto le pones un filtro.

• Return All: activado para recorrer todas las páginas, desactivado para pararse en Limit.
• Contact ID: deja únicamente las notas ligadas a ese contacto.
• User Name or ID: deja únicamente las notas creadas en nombre de ese usuario.

Modifica una nota que ya existe en lugar de apilar otra al lado. Solo cambian los campos que rellenas.

• Note ID: obligatorio, la nota que se reescribe.
• Additional Fields: Title, Body, Type, Contact ID para mover la nota a otra persona, y User Name or ID.

Pone una o varias etiquetas a un contacto en una sola llamada. Las etiquetas dirigen la segmentación en Keap, por eso suele ser el último paso de un flujo de captación.

• Contact ID: obligatorio, la persona a etiquetar.
• Tag Names or IDs: obligatorio, una selección múltiple que permite aplicar varias etiquetas de golpe, o una expresión cuando los identificadores se calculan antes.

Retira una etiqueta de un contacto, sin tocar ni la ficha ni la definición de la etiqueta.

• Contact ID: obligatorio.
• Tag IDs: obligatorio, y aquí es un campo de texto libre, no el selector que se usa al añadir.

Responde a la pregunta que acaba haciéndose todo flujo de enrutado: ¿con qué etiquetas está marcado ahora mismo este contacto?

• Contact ID: obligatorio, porque las etiquetas se leen siempre contacto por contacto.
• Return All: activado para obtener la lista completa, desactivado para pararse en Limit.

Registra un pedido en Keap, con sus líneas y su dirección de envío, para que la facturación y el ciclo de vida del cliente vivan en el mismo sitio.

• Contact ID, Order Date, Order Title y Order Type: todos obligatorios, con el tipo en online u offline.
• Order Items: una colección donde cada línea lleva Product ID, Quantity, Description y un Price opcional que pisa el precio del catálogo.
• Shipping Address y Promo Codes, estos últimos separados por comas para que se aplique el descuento correspondiente.

Recupera un pedido y su detalle, la llamada que haces cuando un webhook te da una referencia de pedido y nada más.

• Order ID: obligatorio, y el único campo que hay que rellenar.

Borra un pedido de Keap. Conviene dejarlo para casos límite, porque el pedido también sostiene el histórico de facturación.

• Order ID: obligatorio, el identificador del pedido que se retira.

Barre los pedidos con los filtros que importan para el seguimiento: una ventana de fechas, el estado de pago, un cliente o un producto.

• Return All: activado para recorrerlo todo, desactivado para topar en Limit.
• Since y Until: el periodo en el que buscar.
• Paid: un booleano que separa los pedidos cobrados del resto.
• Contact ID y Product ID: para limitarse a un cliente o a un artículo.

Da de alta un producto en el catálogo de Keap para que los pedidos puedan referenciarlo después por su identificador.

• Product Name: el único campo obligatorio.
• Additional Fields: SKU, Product Price, Product Description y Product Short Desc, más dos booleanos, Active para la visibilidad y Subscription Only para los artículos que se venden por suscripción.

Saca un producto del catálogo de Keap de forma definitiva.

• Product ID: obligatorio, el identificador del catálogo y no el SKU que usas en la tienda.

Consulta un producto concreto y devuelve su ficha de catálogo, precio y descripción incluidos.

• Product ID: obligatorio, el identificador del artículo en Keap.

Recorre el catálogo y devuelve los productos como items, que es la forma de convertir Keap en la lista de referencia del resto del flujo.

• Return All: activado para recuperar el catálogo entero, desactivado para pararse en Limit.
• Active: un filtro booleano que conserva solo los productos todavía a la venta.

Aquí no sale ningún correo: la operación deja constancia en Keap de un email enviado desde otra herramienta.

• Sent To Address: la dirección del destinatario, obligatoria, normalmente {{ $json.email }} desde el nodo anterior.
• Sent From Address: la dirección desde la que salió el mensaje, también obligatoria.
• Contact ID: dentro de Additional Fields, el identificador numérico del contacto Keap al que se asocia el registro.
• Original Provider: dentro de Additional Fields, UNKNOWN, INFUSIONSOFT, MICROSOFT o GOOGLE, junto a Original Provider ID, que Keap genera como UUID sin guiones si lo dejas vacío.

La operación devuelve los correos ya enviados desde Keap, uno por item, listos para contarlos o encadenarlos con otra rama del flujo de trabajo.

• Return All: activado, n8n recorre todas las páginas de la API de Keap; desactivado, Limit marca cuántos correos llegan.
• Contact ID: dentro de Filters, reduce la lista a los correos de un solo contacto.
• Email: dentro de Filters, una dirección tipo name@email.com cuando no tienes el identificador.
• Since Sent Date y Until Sent Date: la ventana de fechas; la fecha de inicio es obligatoria en cuanto rellenas la de fin.

En esta operación el envío lo hace Keap, en nombre de uno de sus usuarios, y el correo queda ligado a esa identidad.

• User Name or ID: obligatorio, el usuario de Infusionsoft en cuyo nombre sale el correo; lo eliges de la lista o pasas un identificador con una expresión.
• Contact IDs: los destinatarios, separados por comas si son varios.
• Subject: el asunto, acompañado de HTML Content o Plain Content en Additional Fields, ambos codificados en Base64.
• Attachments: hasta 10 adjuntos por copia, de 1MB cada uno, rellenados con File Name y File Data o leídos de una Property binaria.

Un archivo desaparece de la biblioteca de Keap. El nodo recibe su identificador, devuelve el resultado y ahí termina.

• File ID: obligatorio, el identificador del archivo que se borra, casi siempre {{ $json.id }} heredado del listado anterior.

Recorrer la biblioteca de archivos de Keap desde un flujo de trabajo empieza por esta operación, que devuelve cada archivo como item independiente.

• Return All: marcado, se recuperan todas las páginas de archivos; sin marcar, Limit corta el listado.
• Name: dentro de Filters, búsqueda por nombre donde * antes o después del texto lanza una consulta LIKE.
• Type: dentro de Filters, la categoría del archivo, desde attachment e image hasta webform o digitalProduct.
• Permission y Viewable: user, company o both por un lado, public, private o both por otro.

Un presupuesto firmado o un PDF generado en un paso anterior termina guardado en Keap y asociado a una ficha concreta.

• Input Binary Field: obligatorio, el nombre del campo binario de entrada que lleva el archivo; Binary File indica al nodo que lea ahí los datos.
• File Association: obligatorio, company, contact o user, con Contact ID para señalar la ficha destino.
• File Name: obligatorio, con extensión incluida, porque Keap guarda el nombre tal cual.
• File Data: obligatorio, el contenido codificado en Base64, y Is Public decide la visibilidad.