---
title: "n8n"
description: "Aiwatar da ayyukan Quire ta n8n da node ɗin Quire na al'umma."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/ha/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

<span id="n8n"></span>

Node ɗin Quire na al'umma don n8n yana ba ka node na aiki ga REST API da node
na farawa wanda ke fara workflow idan wani abu ya faru a Quire. Ba shi da
dogarorin lokacin aiki, saboda haka ba ya ƙara komai ga shigarwar n8n sai shi kaɗai.

## Girka <!--quire:install-->

A n8n, buɗe **Saituna**, sannan **Community nodes**, zaɓi **Girka**, kuma shigar
da `@quire/n8n-node`. A n8n ɗin da kake sarrafawa, a madadin haka za ka iya
gudanar da `npm install @quire/n8n-node` a babban fayil ɗin mai amfani na n8n,
sannan ka sake farawa.

## Haɗa <!--quire:connect-->

<figure class="quire-shot" lang="en" dir="ltr"><img src="/screenshots/admin-api-keys.webp" alt="The API keys page with a key named for an n8n automation." width="944" height="700" loading="lazy" decoding="async"><figcaption>Create a key at /admin/integrations/api-keys and paste it into the Quire credential in n8n.</figcaption></figure>

Ƙirƙiri shaidar shiga. Akwai nau'i biyu:

- **Maɓallin API na Quire**: **URL na asali** shi ne adireshin ƙungiyarka ba tare
  da alamar slash a ƙarshe ba, kamar `https://acme.quirelms.com`. **Maɓallin API**
  shi ne maɓallin da mai gudanarwa ya ƙirƙira a `/admin/integrations/api-keys`,
  yana farawa da `qk_live_`. Ka ba shi izinin ayyukan workflow ɗin kawai.
- **Quire OAuth2**: ga workflow da ya kamata ya yi aiki a matsayin mutum na
  musamman. Yi rajistar abokin OAuth a `/admin/integrations/oauth-clients` tare
  da adireshin komawa na n8n (n8n yana nuna shi a shaidar shiga), sannan shigar
  da ID ɗin abokin, sirri da izini.

## Ayyuka <!--quire:actions-->

Node na **Quire** ya ƙunshi masu amfani, kwasa-kwasai, shigarwa, ƙungiyoyi,
kammalawa, maki, takardun shaida, ayyukan miƙawa, ƙoƙarin jarrabawa, shirye-shirye,
oda, imel da ƙungiyoyi. Kowanne yana bayar da lissafa, samo, ƙirƙira, sabuntawa
da sharewa inda API ya bayar, da kuma saka ko sabuntawa ta ID na waje; wannan shi
ne abin da ya dace da daidaita bayanai: gudanar da workflow ɗaya sau biyu ba zai
maimaita abu ba.

Ana samar da ayyukan daga takardar OpenAPI ta Quire, saboda haka sun yi daidai
filin da filin da [jagorar API](https://docs.quirelms.com/api/). Haka kuma kowane aiki za a iya
amfani da shi a matsayin kayan aikin wakilin AI na n8n; bayaninsa yana fitowa
daga jagorar API.

Jerin abubuwa yana dawo da duk shafuka a matsayin tsoho. Kashe **Mayar da dukkan
sakamako** sannan ka sa iyaka ga manyan ƙungiyoyi.

## Fara aiki <!--quire:trigger-->

Ƙara node na **Quire Trigger**, zaɓi shaidar shiga, sannan zaɓi **Abubuwan da
suka faru**: abu mai suna kamar `enrolment.created`, yanki gaba ɗaya kamar
`course.*`, ko komai. Idan ka kunna workflow, node ɗin yana ƙirƙirar rajistar
webhook a Quire don adireshin n8n; idan ka kashe shi, ana cire rajistar.

Ana tantance sa hannun kowane aika kafin workflow ya gudana. Ana watsar da aika
da bai inganta ba tare da kuskuren node, domin buƙatar bogi ba za ta fara workflow
ɗinka ba. `data` na taron yana ɗauke da masu ganewa; ƙara node na Quire bayan
mai farawa domin samo cikakken rikodin.

## Misali: imel maraba yayin shigarwa <!--quire:example-welcome-email-on-enrolment-->

1. **Quire Trigger** a kan `enrolment.created`.
2. Node na **Quire**, albarkatu **Masu amfani**, aiki **Samo**, da ID mai amfani
   `{{$json.data.user_id}}`.
3. Node na **Quire**, albarkatu **Kwasa-kwasai**, aiki **Samo**, da
   `{{$json.data.course_id}}`.
4. Node ɗin imel ko hira naka, tare da amfani da sunan mutum da taken kwas.

## Gyara matsaloli <!--quire:troubleshooting-->

- **401** ga kowane kira: URL na asali da maɓallin na ƙungiyoyi daban ne, ko an
  soke maɓallin.
- **403** a aiki ɗaya: maɓallin ba shi da izinin aikin. Ƙara shi a
  `/admin/integrations/api-keys`.
- Mai farawa ba ya aiki: dole a iya samun adireshin webhook na n8n daga Quire ta
  HTTPS. Duba rajistar isarwar rajistar a `/admin/webhooks`.

Source: https://docs.quirelms.com/ha/integrations/n8n/index.mdx
