---
title: "n8n"
description: "Automatiza Quire con n8n e o nodo comunitario de Quire."
image: "https://docs.quirelms.com/og.png"
---
> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/gl/llms.txt
> Use this file to discover all available pages before exploring further.
# n8n
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
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](https://docs.quirelms.com/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
1. **Quire Trigger** para `enrolment.created`.
2. Nodo **Quire**, recurso **Users**, operación **Get**, co ID da persoa
`{{$json.data.user_id}}`.
3. Nodo **Quire**, recurso **Courses**, operación **Get**, co ID do curso
`{{$json.data.course_id}}`.
4. 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`.
Source: https://docs.quirelms.com/gl/integrations/n8n/index.mdx
