Saltar al contenido principal

Plantillas

Plantillas de flujos de trabajo

Al crear un nuevo flujo de trabajo, puedes elegir si comenzar con un flujo de trabajo vacío o utilizar una plantilla existente.

Las plantillas ofrecen:

  • Ayuda para empezar: es posible que n8n ya tenga una plantilla que haga exactamente lo que necesitas.
  • Ejemplos de lo que puedes construir
  • Prácticas recomendadas para crear tus propios flujos de trabajo

Acceder a las plantillas

Selecciona Ver icono de plantillas Plantillas para ver la biblioteca de plantillas.

Si utilizas la biblioteca de plantillas de n8n, se te redirigirá al sitio web de n8n para explorar los Flujos de trabajo disponibles. Si tu organización proporciona una biblioteca personalizada, podrás buscar y navegar entre las plantillas directamente en la aplicación.

Añadir tu flujo de trabajo a la biblioteca de n8n

n8n está trabajando en un programa para creadores y desarrollando un marketplace de plantillas. Este es un proyecto en curso y es probable que los detalles cambien.

n8n autohospedado: Usa tu propia biblioteca

En tus variables de entorno, establece N8N_TEMPLATES_HOST con la URL base de tu API.

Endpoints

Tu API debe proporcionar los mismos endpoints y estructura de datos que n8n.

Los endpoints son:

MétodoRutaPropósito
GET/templates/workflows/Obtener metadatos de la plantilla para previsualización o navegación
GET/workflows/templates/Obtener los datos del flujo de trabajo para importar en el lienzo
GET/templates/searchBuscar plantillas de flujos de trabajo
GET/templates/collections/Obtener una colección específica de plantillas
GET/templates/collectionsListar todas las colecciones de plantillas
GET/templates/categoriesListar todas las categorías de plantillas
GET/healthEndpoint de verificación de estado (health check)

Importante: Se requieren dos formatos de respuesta diferentes

Los dos endpoints relacionados con flujos de trabajo requieren formatos de respuesta distintos:

  • /templates/workflows/: Devuelve la plantilla completa, incluyendo el flujo de trabajo en la clave workflow
  • /workflows/templates/: Devuelve directamente el objeto del flujo de trabajo (sin envoltura adicional)

Consulta los esquemas a continuación para más detalles.

Parámetros de consulta

El endpoint /templates/search acepta los siguientes parámetros de consulta:

ParámetroTipoDescripción
pageenteroLa página de resultados a devolver
rowsenteroEl número máximo de resultados por página
categorylista de cadenas separadas por comas (categorías)Las categorías en las que buscar
searchcadenaLa consulta de búsqueda

El endpoint /templates/collections acepta los siguientes parámetros de consulta:

ParámetroTipoDescripción
categorylista de cadenas separadas por comas (categorías)Las categorías en las que buscar
searchcadenaLa consulta de búsqueda

Esquemas

La diferencia clave entre los dos endpoints de flujos de trabajo:

| // GET /templates/workflows/ devuelve (respuesta envuelta):

{ "id": "...", "name": "...", ... "workflow": { "nodes": [...], "connections": {...} } }

// GET /workflows/templates/ devuelve (respuesta plana):

{ "nodes": [...], "connections": {...} }

---|---

Esquemas detallados de los objetos de respuesta:

Mostrar esquema de datos del elemento workflow

Utilizado por el endpoint /templates/workflows/ (envuelto en una clave workflow).

Este esquema describe los metadatos de la plantilla usados para mostrar las plantillas en la interfaz de búsqueda/navegación. Incluye una propiedad anidada workflow que contiene la definición real del flujo de trabajo que se puede importar.

Esquema de datos del elemento workflow

{ "id": "...", "name": "...", "totalViews": ..., "price": ..., "purchaseUrl": "...", "recentViews": ..., "createdAt": "...", "user": { "username": "...", "verified": true }, "nodes": [ { "id": "...", "icon": "...", "name": "...", "codex": { "resources": [ { "url": "...", "icon": "...", "label": "..." } ], "primaryDocumentation": { "url": "..." } }, "categories": ["..."], "nodeVersion": ..., "codexVersion": ..., "group": "...", "defaults": { "name": "...", "color": "..." }, "iconData": { "type": "...", "fileBuffer": "..." }, "displayName": "...", "typeVersion": ..., "nodeCategories": [ { "id": "...", "name": "..." } ] } ], "description": "...", "image": { "url": "..." }, "categories": [ { "id": "...", "name": "..." } ], "workflowInfo": { "nodeTypes": [...] }, "workflow": { "nodes": [...], "connections": {...}, "settings": {...}, "pinData": {...} } }

Mostrar esquema de datos del elemento category

Esquema de datos del elemento category

{ "id": "...", "name": "..." }

Mostrar esquema de datos del elemento collection

Esquema de datos del elemento collection

{ "id": "...", "rank": ..., "name": "...", "totalViews": ..., "createdAt": "...", "workflows": [ { "id": "..." } ], "nodes": [...] }

También puedes explorar interactivamente los endpoints de la API de n8n en las siguientes direcciones:

https://api.n8n.io/templates/categories
https://api.n8n.io/templates/collections
https://api.n8n.io/templates/search
https://api.n8n.io/health

Puedes contactarnos si necesitas más ayuda.