n8n | Quire

O nodo comunitario de Quire para n8n ofrece un nodo de acción para a API REST e un nodo disparador que inicia un fluxo de traballo cando sucede algo en Quire. Non ten dependencias de execución, polo que non engade nada á instancia de n8n agás o propio nodo.

Instalar

En n8n, abre Configuración, despois Nodos comunitarios, escolle Instalar e introduce @quire/n8n-node. Nunha instalación propia de n8n, tamén podes executar npm install @quire/n8n-node no cartafol de usuario de n8n e reiniciar.

Conectar

The API keys page with a key named for an n8n automation. — Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.

Crea unha credencial. Hai dous tipos:

Quire API Key: URL base é o enderezo da túa organización sen barra final, como https://acme.quirelms.com. API Key é unha clave que unha persoa administradora creou en /admin/integrations/api-keys e comeza por qk_live_. Concédelle só os ámbitos que precise o fluxo.
Quire OAuth2: para fluxos que deban actuar como unha persoa concreta. Rexistra un cliente OAuth en /admin/integrations/oauth-clients co enderezo de redirección de n8n (n8n amóstrao na credencial) e introduce o ID, o segredo e os ámbitos do cliente.

Accións

O nodo Quire abrangue persoas usuarias, cursos, matrículas, grupos, finalizacións, cualificacións, certificados, entregas, intentos de cuestionario, programas, pedidos, correo e organizacións. Para cada recurso ofrece listar, obter, crear, actualizar e eliminar cando a API o permite, ademais de actualizar ou crear por ID externo, que é o ideal para sincronizar: executar o mesmo fluxo dúas veces non duplica nada.

As operacións xéranse a partir do documento OpenAPI de Quire, polo que coinciden campo por campo coa referencia da API. Cada operación tamén pode usarse como ferramenta por un axente de IA de n8n; a descrición procede da referencia da API.

De maneira predeterminada, as listas devolven todas as páxinas. Desactiva Devolver todo e establece un límite para organizacións grandes.

Disparador

Engade o nodo Quire Trigger, escolle a credencial e selecciona os eventos: un evento polo nome, como enrolment.created; unha área completa, como course.*; ou todos. Ao activar o fluxo, o nodo crea en Quire unha subscrición de webhook para o enderezo de n8n; ao desactivalo, elimina a subscrición.

A sinatura de cada entrega compróbase antes de executar o fluxo. Se non se verifica, descártase e o nodo comunica un erro, polo que unha petición falsificada non pode iniciar o fluxo. data do evento leva identificadores; engade un nodo Quire despois do disparador para obter o rexistro completo.

Exemplo: correo de benvida ao matricularse

Quire Trigger para enrolment.created.
Nodo Quire, recurso Users, operación Get, co ID da persoa {{$json.data.user_id}}.
Nodo Quire, recurso Courses, operación Get, co ID do curso {{$json.data.course_id}}.
Nodo de correo ou conversa, usando o nome da persoa e o título do curso.

Solución de problemas

401 en todas as chamadas: a URL base e a clave son de organizacións distintas, ou a clave foi revogada.
403 nunha operación: falta ese ámbito na clave. Engádeo en /admin/integrations/api-keys.
O disparador non se executa: Quire debe poder acceder ao enderezo do webhook de n8n mediante HTTPS. Consulta o rexistro de entregas da subscrición en /admin/webhooks.