Nodo programático en n8n con execute
Contenido del curso
Matias Tofful
Me gustaria saber mas el porque usaria custom nodes y nodos programaticos en n8n?
Bryan David Gutierrez Alvarez
Es una buena pregunta.
Todos los nodos tienen distintos funciones, como iniciar workflows, recibir y enviar información, procesar y manipular información, etc. Y, los nodos pueden estar conectados a distintas aplicaciones como Google Sheets, WhatsApp, Telegram, ChatGPT, etc.
Si, por ejemplo, tienes tu propio aplicación de manejo de finanzas, puedes crear un nodo personalizado para que tú u otras personas puedan usarlo en sus workflows.
O, por ejemplo, Platzi puede crear un nodo que se integre a su API, para que otras personas puedan crear sus workflows y consultar los cursos que no terminaron, los puntos que tienen, etc. Y con el nodo pueden crear un workflow en donde integren otros nodos como WhatsApp, GPT-5 de OpenAI, y Google Calendar.
Puedes crear un agente para que, desde WhatsApp, le preguntes los cursos que te faltan terminar en Platzi y luego le pides que te programe los cursos en Google Calendar a la fecha y hora que quieras.
Recuerda que los workflows son, solamente, ejemplos para que se pueda comprender la creación de nodos personalizados. El límite está en tu imaginación!
Jesus David Vargas Guerra
Al desarrollar un nodo personalizado, es común obtener el siguiente error de ESLint:
"Avoid calling 'this.helpers.httpRequest()' in a function that retrieves credentials via 'this.getCredentials()'. Use 'this.helpers.httpRequestWithAuthentication()' instead..."
En lugar de obtener las credenciales manualmente con getCredentials y pasarlas en la petición, se debe delegar esa tarea al helper oficial.
1. En el archivo del Nodo (.node.ts):
Sustituye la lógica manual por httpRequestWithAuthentication:
// ANTES (Manual - Con errores de ESLint) const credentials = await this.getCredentials('miApi'); const response = await this.helpers.httpRequest({ qs: { api_key: credentials.apiKey }, // ❌ Mal // ... }); // AHORA (Correcto - Sin errores) const response = await this.helpers.httpRequestWithAuthentication.call(this, 'miApi', { method: 'GET', url: 'https://ejemplo.com', qs: { email: email, // Solo pasas parámetros de la API, NO la clave }, json: true, });
2. En el archivo de Credenciales (.credentials.ts):
Debes definir el bloque authenticate para que n8n sepa dónde inyectar la clave automáticamente:
authenticate: IAuthenticateGeneric = { type: 'generic', properties: { qs: { // O 'headers' si la API lo pide ahí 'api_key': '={{$credentials.apiKey}}' } }, };
Tips extra de limpieza
IHttpRequestOptions o IDataObject no se usan, bórralos de la sección import para limpiar tu código.prepareOutputData está obsoleto (deprecated). La forma moderna de retornar datos es:
return [returnData as INodeExecutionData[]];
Pablo Mederos
No entendí el concepto de creación declarativa vs programática. Veo que todo el tiempo se escribió código imperativo para realizar las llamadas de API y procesar la respuesta. ¿cómo sería el modo declarativo?
Elkin Camargo
Por q es necesaria la API key si la persona esta haciendo la verificacion directamente en el codigo?
Pablo Mederos
La API key es necesaria para autenticar tu nodo personalizado con el servicio externo al que estás accediendo. Aunque la verificación se realice en tu código, la API key actúa como una credencial que demuestra que tu nodo tiene permiso para usar ese servicio. Es como una llave que abre la puerta a la información o funcionalidad que necesitas. Si bien el nodo ahora está en tu instancia de n8n, en el futuro podrías compartirlo con otra persona, y en su instancia, usará otra api key no la tuya. El uso de api keys puede tener un costo, y tú no querrás pagar por el uso que le da otra parsona a la api.
Elkin Camargo
Esos custom node solo quedan local o en n8n en general?
Juan Rincon
Todo lo que se ha visto hasta el momento es haciendo estos custom nodes en local, en la siguiente clase explican como publicarlo
Jeisson Espinosa
Información resumida de esta clase
#EstudiantesDePlatzi