--- title: "n8n" description: "Automatisoi Quire n8n:llä ja Quiren yhteisösolmulla." image: "https://docs.quirelms.com/og.png" --- > Documentation Index > Fetch the complete documentation index at: https://docs.quirelms.com/fi/llms.txt > Use this file to discover all available pages before exploring further. # n8n Quiren n8n-yhteisösolmu tarjoaa REST API:n toimintasolmuna ja käynnistinsolmun, joka aloittaa työnkulun Quiren tapahtumasta. Solmulla ei ole ajoaikaisia riippuvuuksia, joten se ei tuo n8n-asennukseesi mitään muuta kuin itsensä. ## Asentaminen Avaa n8n:ssä **Settings**, sitten **Community nodes**, valitse **Install** ja syötä `@quire/n8n-node`. Itse ylläpidetyssä n8n-asennuksessa voit vaihtoehtoisesti suorittaa `npm install @quire/n8n-node` n8n-käyttäjän kansiossa ja käynnistää palvelun uudelleen. ## Yhdistäminen
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.
Luo tunnistetieto. Tarjolla on kaksi tyyppiä: - **Quire API Key**: **Base URL** on organisaatiosi osoite ilman lopun kauttaviivaa, esimerkiksi `https://acme.quirelms.com`. **API Key** on ylläpitäjän osoitteessa `/admin/integrations/api-keys` luoma avain, jonka alku on `qk_live_`. Anna sille vain työnkulun tarvitsemat oikeudet. - **Quire OAuth2**: työnkuluille, joiden tulee toimia tietyn henkilön nimissä. Rekisteröi OAuth-asiakas osoitteessa `/admin/integrations/oauth-clients` ja aseta sen uudelleenohjausosoitteeksi n8n:n osoite (n8n näyttää sen tunnistetiedossa). Syötä sitten asiakastunnus, salaisuus ja käyttöoikeudet. ## Toiminnot **Quire**-solmu kattaa käyttäjät, kurssit, ilmoittautumiset, ryhmät, suorittamiset, arvosanat, todistukset, palautukset, tietovisojen suoritukset, ohjelmat, tilaukset, sähköpostit ja organisaatiot. API:n tukemille kohteille se tarjoaa listauksen, haun, luonnin, päivityksen ja poiston sekä ulkoisen tunnisteen perusteella tehtävän upsert-toiminnon, joka sopii synkronointiin: saman työnkulun voi ajaa uudelleen ilman kaksoiskappaleita. Toiminnot luodaan Quiren OpenAPI-dokumentista, joten ne vastaavat kenttä kentältä [API-viitettä](https://docs.quirelms.com/api/). Jokaista toimintoa voi käyttää myös n8n-tekoälyagentin työkaluna; kuvaus tulee API-viitteestä. Listat palauttavat oletuksena kaikki sivut. Poista suurissa organisaatioissa **Return All** käytöstä ja määritä raja. ## Käynnistin Lisää **Quire Trigger** -solmu, valitse tunnistetieto ja määritä **Events**: tapahtuma nimen perusteella, kuten `enrolment.created`, kokonainen aihealue, kuten `course.*`, tai kaikki tapahtumat. Kun aktivoit työnkulun, solmu luo Quireen webhook-tilauksen n8n:n osoitteeseen. Kun poistat sen käytöstä, tilaus poistetaan. Jokaisen toimituksen allekirjoitus tarkistetaan ennen työnkulun käynnistymistä. Tarkistusta läpäisemätön toimitus hylätään solmuvirheenä, joten väärennetty pyyntö ei voi käynnistää työnkulkua. Tapahtuman `data` sisältää tunnisteet; lisää käynnistimen jälkeen Quire-solmu, jolla haet koko tietueen. ## Esimerkki: tervetuloviesti ilmoittautumisen jälkeen 1. **Quire Trigger**, tapahtumana `enrolment.created`. 2. **Quire**-solmu: resurssi **Users**, toiminto **Get**, käyttäjän tunnisteella `{{$json.data.user_id}}`. 3. **Quire**-solmu: resurssi **Courses**, toiminto **Get**, kurssin tunnisteella `{{$json.data.course_id}}`. 4. Sähköposti- tai chat-solmu, jossa käytetään henkilön nimeä ja kurssin otsikkoa. ## Vianmääritys - **401** kaikissa kutsuissa: perusosoite ja avain kuuluvat eri organisaatioille tai avain on peruttu. - **403** yhdessä toiminnossa: avaimella ei ole kyseistä oikeutta. Lisää se osoitteessa `/admin/integrations/api-keys`. - Käynnistin ei koskaan laukea: n8n:n webhook-osoitteen on oltava Quiren saavutettavissa HTTPS-yhteydellä. Tarkista tilauksen toimitusloki osoitteessa `/admin/webhooks`. Source: https://docs.quirelms.com/fi/integrations/n8n/index.mdx