Contactos, cinco operaciones
Crear, obtener, listar, actualizar y archivar. El listado filtra por búsqueda, plataforma, correo electrónico, ID externo y Updated Since, que es el filtro en el que se apoya una sincronización incremental.
Nodo de n8n
Plan BusinessInstala n8n-nodes-pinlyx desde el panel Community Nodes, pega una clave de API y listo: un formulario enviado se convierte en un contacto, un negocio ganado en una factura y una conversación sin responder en un mensaje en el canal que vigile tu equipo. Ocho operaciones sobre tres recursos, sin dependencias en tiempo de ejecución y con licencia MIT.
Plan gratis para siempre · Sin tarjeta de crédito · Cancela cuando quieras
Última actualización:
Definición
Un nodo comunitario de n8n es un paquete publicado en npm que una instancia de n8n instala en tiempo de ejecución y que añade un bloque nuevo al lienzo. No es un fork de n8n ni un receptor de webhooks que tengas que alojar y mantener activo tú.
n8n-nodes-pinlyx es el de Pinlyx. Se autentica con una clave de API que generas en el panel y da a un flujo ocho operaciones sobre contactos, negocios y conversaciones, con la paginación por cursor ya resuelta.
Publicado en npm como n8n-nodes-pinlyx, con el código en GitHub bajo licencia MIT. Probado con n8n 1.60 y versiones posteriores sobre Node.js 20.15 o superior. npm · GitHub
El nodo habla con la misma API REST pública que usaría un script, así que todo lo que hace se puede reproducir con curl, y lo que no hace está a un nodo HTTP Request de distancia.
Tres recursos, elegidos porque son los que de verdad necesita una automatización. Todo lo que ves aquí lo impone la API, no el nodo.
Crear, obtener, listar, actualizar y archivar. El listado filtra por búsqueda, plataforma, correo electrónico, ID externo y Updated Since, que es el filtro en el que se apoya una sincronización incremental.
Crea un negocio con título, monto, moneda, etapa, probabilidad, fecha prevista de cierre y notas. Lístalos con filtros por etapa, contacto y búsqueda en el título.
Los hilos con actividad reciente en todos los canales conectados, de más nuevo a más antiguo. Cada fila incluye el ID del contacto, el canal, un indicador de no leído y un breve adelanto del último mensaje.
Guarda tu propio identificador en un contacto y, si el flujo se vuelve a ejecutar, la API lo rechaza con un HTTP 409 que indica qué registro ya existe, en lugar de crear en silencio una segunda copia de la misma persona.
Activa Return All y el nodo recorre todas las páginas por ti. Si lo dejas desactivado, fija un límite. Una página tiene como máximo 100 filas para contactos y negocios y 50 para conversaciones, así que una lista grande son muchas peticiones la pidas como la pidas.
La credencial guarda una sola clave de API. Cada operación declara el permiso que necesita, así que una clave sin contacts:write hace fallar una creación con un 403 en lugar de aparentar que funciona sin cambiar nada.
El nodo está publicado en npm como n8n-nodes-pinlyx y se instala como cualquier nodo comunitario: desde dentro de n8n, no copiando archivos en un servidor.
O, en una instancia autoalojada, desde la línea de comandos:
npm install n8n-nodes-pinlyx
# then restart n8nUna salvedad que conviene conocer antes de planificar nada: n8n Cloud solo ofrece los nodos comunitarios que el propio n8n ha revisado y verificado, y este paquete todavía no ha pasado esa revisión. Las instancias autoalojadas instalan cualquier paquete publicado. En Cloud, las mismas operaciones están disponibles con el nodo HTTP Request contra la API REST; preferimos decirlo claramente a esconderlo en la letra pequeña.
El paquete no declara dependencias en tiempo de ejecución. Cada petición pasa por el helper HTTP del propio n8n, que es lo que permite a la credencial añadir la cabecera Authorization y lo que mantiene la instalación ligera.
El nodo se autentica con una clave de API de Pinlyx: una clave, una cabecera y ningún ida y vuelta de OAuth.
La prueba de la credencial hace la llamada autenticada más barata que existe:
curl https://api.pinlyx.com/v1/me \
-H "Authorization: Bearer csk_live_YOUR_KEY"Las claves de API forman parte del plan Business. En Free y Pro no hay ninguna clave que generar, así que la credencial no tiene nada que guardar. Es el único requisito previo que vale la pena comprobar antes de instalar nada.
El límite por defecto es de 60 peticiones por minuto y por clave. Cada respuesta incluye X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset, y si te pasas recibes un HTTP 429 con un Retry-After en segundos. Como el límite va por clave y no por espacio de trabajo, un flujo atrapado en un bucle se frena a sí mismo en lugar de dejar sin margen a tus otras integraciones.
Esta es la superficie completa, no una selección de lo mejor.
Cada operación corresponde exactamente a un endpoint de la API pública v1, así que nada de esto se comporta distinto de una petición que escribirías a mano.
El campo de plataforma de un contacto acepta Telegram, WhatsApp, Instagram, LinkedIn, X y Email. Registra el canal por el que llegó la persona, que es como el CRM agrupa luego sus conversaciones.
Lo que no está en esa lista no está en el nodo. El envío de mensajes, las etiquetas, la puntuación de leads, las tareas, las facturas y las campañas existen en la API REST. Simplemente no forman parte de estas ocho operaciones.
Es el motivo más habitual para usar este nodo. Un cliente potencial rellena un formulario y el registro ya está en el CRM antes de que nadie abra una pestaña.
Si necesitas un upsert de verdad en lugar de un 409, la API REST tiene un endpoint por lotes que busca coincidencias por ID externo, correo electrónico, teléfono o nombre de usuario y acepta hasta 200 filas por petición. El nodo no lo expone. Apunta un nodo HTTP Request a POST /v1/contacts/batch y obtendrás el mismo comportamiento con una llamada en lugar de doscientas.
Merece la pena leer esto antes de construirlo, porque el diseño obvio es el equivocado.
Un negocio no se puede pasar a ganado desde la API de ninguna manera. Ganar un negocio registra un ingreso en el libro contable del CRM, así que esa transición se reserva a propósito para el panel, donde una persona la está viendo. El nodo lo refleja: Deal, Create rechaza las etapas won y lost, y no existe ninguna operación de actualización. Los negocios ganados se leen; no se escriben.
Si quince minutos es demasiado lento, no acortes la consulta. Suscríbete: Pinlyx lanza un webhook saliente en deal.won, firmado con HMAC-SHA256 en una cabecera X-Webhook-Signature y con el nombre del evento en X-Webhook-Event. Apúntalo a un nodo Webhook de n8n y la factura sale segundos después de que alguien cierre el negocio, sin gastar nada de tu cupo de consultas. Lo mismo vale para contact.created, contact.updated y message.received.
Conversation, Get Many devuelve los hilos con actividad reciente en todos los canales conectados: Telegram, WhatsApp, Instagram, X, correo electrónico y el chat en vivo de la web en una sola lista. Cada fila incluye el ID del contacto, el canal, si está sin leer y hasta 160 caracteres del último mensaje.
Antes de construirlo conviene conocer dos límites. El adelanto es solo un adelanto: el nodo no puede recorrer el hilo completo de mensajes, así que un clasificador solo ve el último mensaje. Además, el nodo no puede etiquetar un contacto ni enviar una respuesta. Ambas cosas existen en la API REST y en el servidor MCP; ninguna forma parte de estas ocho operaciones.
Tres comportamientos que deciden si un flujo sobrevive a su primera semana real.
Una respuesta de listado de la API sobre la que funciona el nodo:
{
"items": [ { "Id": 812, "Name": "Sarah Lin", "Platform": "email" } ],
"nextCursor": 764,
"hasMore": true
}Las sincronizaciones incrementales funcionan con Updated Since. Guarda la marca de tiempo de la última ejecución correcta, pásala en la siguiente y traerás solo los pocos contactos que han cambiado, no todos. Esa es la diferencia entre una sincronización nocturna que termina y otra que gasta todo su cupo en filas que nadie ha tocado.
Límites claros
Seis cosas que es mejor leer aquí que descubrir a mitad de construir un flujo que dependa de ellas.
La API REST puede poner en cola un mensaje de Telegram o un mensaje directo de X, y el servidor MCP también. Esas operaciones no están en este nodo. Si un flujo tiene que llegar a un cliente, usa un nodo HTTP Request o uno de los nodos de canal del propio n8n.
Ganar un negocio registra un ingreso en el libro contable, así que esa transición solo se hace desde el panel. El nodo crea negocios y los lista. No los cierra, y Create rechaza directamente las etapas won y lost.
Es un nodo de acción. Para iniciar un flujo a partir de algo que pasa en el CRM, registra un webhook saliente y recíbelo con el nodo Webhook de n8n. También puedes consultar con un Schedule Trigger, pero gasta cupo de peticiones que el webhook no gasta.
Las etiquetas, la puntuación de leads, la asignación de responsable, las tareas y los cambios de etapa en el embudo existen en la API REST. Ninguno forma parte de las ocho operaciones. Contact, Update escribe los campos básicos y nada más.
Ni facturas, ni asientos contables, ni pagos, ni reembolsos. Nada de este nodo mueve dinero en ninguna dirección, que es el mismo límite que marca el servidor MCP.
Las claves de API son una función del plan Business. En Free y Pro no hay ninguna clave que pegar en la credencial, así que el nodo no tiene con qué autenticarse, por bien instalado que esté.
Tres formas de conectar el mismo CRM, cada una adecuada para un trabajo distinto. La mayoría de los equipos acaba usando dos.
Trabajo determinista con una programación o un disparador
Sabes exactamente qué tiene que pasar y cuándo. Llega un formulario y se crea un contacto. Se cierra un negocio y sale una factura. La lógica vive en un lienzo que todo tu equipo puede leer, y una ejecución fallida queda a la vista en la lista de ejecuciones con los datos que la provocaron.
Ideal cuando la regla es fija y el volumen, estable.
Reaccionar en cuanto pasa algo
Registra un endpoint en el CRM y te enviará los eventos contact.created, contact.updated, message.received, deal.won y el resto. Firmados con HMAC-SHA256, reintentados con espera progresiva y repetibles desde un registro de entregas. Combínalo con un nodo Webhook de n8n y recibirás los datos al momento en lugar de consultarlos.
Ideal cuando la latencia importa más que la simplicidad.
Criterio, no fontanería
Un asistente de IA decide en el momento de la llamada con el hilo real delante, en lugar de seguir una regla escrita semanas antes. Herramientas, recursos y prompts sobre un único endpoint autenticado, con cada llamada limitada por los permisos de la clave.
Ideal cuando la respuesta depende de entender la situación.
Las preguntas que surgen en la primera hora, respondidas con el comportamiento real.
Las otras vías de acceso a los mismos datos y las partes del CRM en las que escribirá un flujo.
La capa que hay debajo del nodo: claves con permisos, paginación por cursor, escrituras idempotentes, cabeceras de límite de peticiones y webhooks salientes.
El mismo CRM para un asistente de IA en lugar de un flujo: herramientas, recursos y prompts sobre un único endpoint autenticado.
Un recorrido para desarrolladores: generar claves, primera petición autenticada, verificación de la firma de los webhooks y espera progresiva ante el límite de peticiones.
Cuándo debe decidir un asistente en el momento de la llamada, cuándo conviene escribir código y cuándo un disparador sin código es la respuesta correcta.
Gmail, Outlook, Calendly, Zoom, GitHub y los webhooks salientes que conectan el CRM con cualquier otra cosa.
Lo que contiene de verdad la ficha de un contacto: etiquetas, campos personalizados, puntuación de leads, responsable y una cronología completa de actividad.
El embudo en el que escriben las operaciones de negocios, y por qué la transición a ganado registra ingresos y se queda en el panel.
Comparativa de planes, incluido el plan Business, que trae las claves de API y los webhooks, y el servidor MCP, disponible en todos los planes.
Listo para empezar
Instala el nodo, genera una clave con dos permisos y deja que el primer formulario enviado llegue como contacto. A partir de ahí, todo es cuestión de arrastrar un nodo más al lienzo.