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

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