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

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. 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.