---
title: "n8n"
description: "Automatiza Quire con n8n y el nodo comunitario de Quire."
image: "https://docs.quirelms.com/og.png"
---
> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/es-419/llms.txt
> Use this file to discover all available pages before exploring further.
# n8n
El nodo comunitario de Quire para n8n ofrece un nodo de acción para la API REST y un nodo disparador que inicia un flujo de trabajo cuando ocurre algo en Quire. No tiene dependencias de ejecución, así que no agrega nada a tu instancia de n8n aparte del propio nodo.
## Instalar
En n8n, abre **Settings**, luego **Community nodes**, elige **Install** e ingresa `@quire/n8n-node`. En una instancia autoalojada de n8n, también puedes ejecutar `npm install @quire/n8n-node` en la carpeta de usuario de n8n y reiniciarlo.
## Conectar
Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.
Crea una credencial. Hay dos tipos:
- **Quire API Key**: **Base URL** es la dirección de tu organización sin una barra final, por ejemplo, `https://acme.quirelms.com`. **API Key** es una clave que un administrador creó en `/admin/integrations/api-keys` y que comienza con `qk_live_`. Asígnale solo los permisos que necesita el flujo de trabajo.
- **Quire OAuth2**: para flujos que deben actuar como una persona específica. Registra un cliente OAuth en `/admin/integrations/oauth-clients` con la dirección de redirección de n8n (n8n la muestra en la credencial), y luego ingresa el ID, el secreto y los permisos del cliente.
## Acciones
El nodo **Quire** incluye usuarios, cursos, inscripciones, grupos, finalizaciones, calificaciones, certificados, entregas, intentos de cuestionarios, programas, pedidos, correo y organizaciones. Cada opción ofrece listar, obtener, crear, actualizar y eliminar cuando la API lo permite, así como insertar o actualizar mediante un ID externo. Esto sirve para sincronizar: si ejecutas el mismo flujo dos veces, no se duplica nada.
Las operaciones se generan a partir del documento OpenAPI de Quire, así que coinciden campo por campo con la [referencia de la API](https://docs.quirelms.com/api/). Cada operación también se puede usar como herramienta de un agente de IA de n8n; su descripción proviene de la referencia de la API.
De forma predeterminada, las listas devuelven todas las páginas. Para organizaciones grandes, desactiva **Return All** y establece un límite.
## Disparador
Agrega el nodo **Quire Trigger**, elige la credencial y selecciona los **Events**: un evento por nombre, como `enrolment.created`; un área completa, como `course.*`; o todos los eventos. Cuando activas el flujo, el nodo crea una suscripción de webhook en Quire para la dirección de n8n; cuando lo desactivas, elimina la suscripción.
La firma de cada entrega se verifica antes de que se ejecute el flujo. Si no se verifica, la entrega se descarta y el nodo genera un error; así, una solicitud falsificada no puede iniciar el flujo. `data` del evento incluye identificadores; agrega un nodo Quire después del disparador para obtener el registro completo.
## Ejemplo: enviar un correo de bienvenida al inscribirse
1. **Quire Trigger** para `enrolment.created`.
2. Nodo **Quire**, recurso **Users**, operación **Get**, con el ID de usuario `{{$json.data.user_id}}`.
3. Nodo **Quire**, recurso **Courses**, operación **Get**, con el ID de curso `{{$json.data.course_id}}`.
4. Tu nodo de correo o chat, con el nombre de la persona y el título del curso.
## Solución de problemas
- **401** en todas las llamadas: la URL base y la clave pertenecen a organizaciones distintas o se revocó la clave.
- **403** en una operación: la clave no tiene ese permiso. Agrégalo en `/admin/integrations/api-keys`.
- El disparador no se activa: la dirección de webhook de n8n debe ser accesible desde Quire por HTTPS. Revisa el registro de entregas de la suscripción en `/admin/webhooks`.
Source: https://docs.quirelms.com/es-419/integrations/n8n/index.mdx
