---
title: "n8n"
description: "n8n과 Quire 커뮤니티 노드로 Quire 자동화하기."
image: "https://docs.quirelms.com/og.png"
---

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

# n8n

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

n8n용 Quire 커뮤니티 노드는 REST API를 위한 액션 노드와, Quire에서 무언가
일어나면 워크플로를 시작하는 트리거 노드를 제공합니다. 런타임 의존성이 없어
자신 외에는 n8n 인스턴스에 아무것도 추가하지 않습니다.

## 설치 <!--quire:install-->

n8n에서 **Settings**를 연 뒤 **Community nodes**에서 **Install**을 고르고
`@quire/n8n-node`를 입력하세요. 셀프호스트 n8n에서는 n8n 사용자 폴더에서
`npm install @quire/n8n-node`를 실행하고 다시 시작해도 됩니다.

## 연결 <!--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>

- **Quire API Key**: **Base URL**은 조직 주소를 끝 슬래시 없이 쓴 것으로,
  예를 들어 `https://acme.quirelms.com`입니다. **API Key**는 관리자가
  `/admin/integrations/api-keys`에서 만들고 `qk_live_`로 시작하는 키입니다.
  워크플로에 필요한 스코프만 부여하세요.
- **Quire OAuth2**: 특정 사람처럼 행동해야 하는 워크플로용입니다.
  `/admin/integrations/oauth-clients`에 n8n의 주소(자격 증명 화면에 n8n이
  표시합니다)로 OAuth 클라이언트를 등록한 뒤, 클라이언트 ID, 비밀, 스코프를
  입력하세요.

## 액션 <!--quire:actions-->

**Quire** 노드는 사용자, 코스, 등록, 그룹, 완료, 성적, 수료증, 제출, 퀴즈
응시, 프로그램, 주문, 이메일, 조직을 다룹니다. API가 제공하는 곳에서는 각각
목록, 조회, 생성, 수정, 삭제를 제공하며, 동기화에 알맞은 외부 ID 기반
upsert도 제공합니다. 같은 워크플로를 두 번 실행해도 중복이 생기지 않습니다.

작업은 Quire의 OpenAPI 문서로부터 생성되므로 [API 레퍼런스](https://docs.quirelms.com/api/)와
필드 단위까지 일치합니다. 모든 작업은 n8n AI 에이전트가 도구로 쓸 수도
있으며, 설명은 API 레퍼런스에서 가져옵니다.

목록은 기본적으로 모든 페이지를 반환합니다. 조직이 크다면 **Return All**을
끄고 상한을 지정하세요.

## 트리거 <!--quire:trigger-->

**Quire Trigger** 노드를 추가하고 자격 증명을 고른 뒤 **Events**를
선택하세요. `enrolment.created` 같은 이름의 이벤트, `course.*` 같은 영역
전체, 또는 전체 중에서 고를 수 있습니다. 워크플로를 활성화하면 노드가 n8n
주소를 위해 Quire에 웹훅 구독을 만들고, 비활성화하면 구독이 제거됩니다.

각 전달의 서명은 워크플로가 실행되기 전에 검사됩니다. 검증에 실패한 전달은
노드 오류와 함께 버려지므로, 위조된 요청으로는 워크플로를 시작할 수 없습니다.
이벤트의 `data`에는 식별자가 담겨 있으니, 트리거 뒤에 Quire 노드를 붙여 전체
기록을 가져오세요.

## 예시: 등록 시 환영 이메일 <!--quire:example-welcome-email-on-enrolment-->

1. `enrolment.created`에 대한 **Quire Trigger**.
2. **Quire** 노드, 리소스 **Users**, 작업 **Get**, 사용자 ID
   `{{$json.data.user_id}}`.
3. **Quire** 노드, 리소스 **Courses**, 작업 **Get**,
   `{{$json.data.course_id}}`.
4. 그 사람의 이름과 코스 제목을 쓰는 이메일 또는 채팅 노드.

## 문제 해결 <!--quire:troubleshooting-->

- 모든 호출에서 **401**: Base URL과 키가 서로 다른 조직에 속했거나 키가
  폐기되었습니다.
- 한 작업에서 **403**: 키에 그 스코프가 없습니다.
  `/admin/integrations/api-keys`에서 추가하세요.
- 트리거가 전혀 실행되지 않음: n8n의 웹훅 주소는 HTTPS로 Quire에서 접근
  가능해야 합니다. `/admin/webhooks`의 구독 전달 로그를 확인하세요.

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