---
title: "n8n"
description: "Automatiza Quire con n8n y el nodo de la comunidad de Quire."
image: "https://docs.quirelms.com/og.png"
---
> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/es/llms.txt
> Use this file to discover all available pages before exploring further.
# n8n
El nodo de la comunidad de Quire para n8n ofrece un nodo de acción para la API REST y un nodo activador que inicia un flujo de trabajo cuando ocurre algo en Quire. No tiene dependencias en tiempo de ejecución, así que no añade nada a tu instancia de n8n aparte del propio nodo.
## Instalar
En n8n, abre **Settings**, luego **Community nodes**, elige **Install** e introduce `@quire/n8n-node`. En una instalación 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. Se ofrecen dos tipos:
- **Quire API Key**: **Base URL** es la dirección de tu organización sin barra final, por ejemplo, `https://acme.quirelms.com`. **API Key** es una clave que un administrador creó en `/admin/integrations/api-keys` y que empieza por `qk_live_`. Asígnale solo los ámbitos que necesite el flujo de trabajo.
- **Quire OAuth2**: para los flujos de trabajo que deben actuar como una persona concreta. 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 introduce el ID, el secreto y los ámbitos del cliente.
## Acciones
El nodo **Quire** abarca usuarios, cursos, inscripciones, grupos, finalizaciones, calificaciones, certificados, entregas, intentos de cuestionarios, programas, pedidos, correo electrónico y organizaciones. Para cada recurso ofrece operaciones de listar, obtener, crear, actualizar y eliminar cuando la API las admite, así como actualizar o insertar mediante un ID externo, la opción adecuada para sincronizar: puedes ejecutar el mismo flujo de trabajo dos veces sin duplicar nada.
Las operaciones se generan a partir del documento OpenAPI de Quire, por lo que coinciden campo por campo con la [referencia de la API](https://docs.quirelms.com/api/). Todas las operaciones también se pueden usar como herramienta de un agente de IA de n8n; su descripción procede 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.
## Activador
Añade el nodo **Quire Trigger**, elige la credencial y selecciona los **Events**: un evento por nombre, como `enrolment.created`, un área entera, como `course.*`, o todos los eventos. Al activar el flujo de trabajo, el nodo crea en Quire una suscripción de webhook para la dirección de n8n; al desactivarlo, elimina la suscripción.
La firma de cada entrega se comprueba antes de ejecutar el flujo. Una entrega que no se verifica se descarta y genera un error del nodo, por lo que una solicitud falsificada no puede iniciar el flujo de trabajo. `data` del evento contiene identificadores; añade un nodo Quire después del activador para obtener el registro completo.
## Ejemplo: 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 del 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 ámbito. Añádelo en `/admin/integrations/api-keys`.
- El activador no se ejecuta: la dirección del webhook de n8n debe ser accesible desde Quire mediante HTTPS. Consulta el registro de entregas de la suscripción en `/admin/webhooks`.
Source: https://docs.quirelms.com/es/integrations/n8n/index.mdx
