Quire
n8n용 Quire 커뮤니티 노드는 REST API를 위한 액션 노드와, Quire에서 무언가 일어나면 워크플로를 시작하는 트리거 노드를 제공합니다. 런타임 의존성이 없어 자신 외에는 n8n 인스턴스에 아무것도 추가하지 않습니다.
설치
n8n에서 Settings를 연 뒤 Community nodes에서 Install을 고르고
@quire/n8n-node를 입력하세요. 셀프호스트 n8n에서는 n8n 사용자 폴더에서
npm install @quire/n8n-node를 실행하고 다시 시작해도 됩니다.
연결
자격 증명을 만드세요. 두 가지가 제공됩니다.
- 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 노드는 사용자, 코스, 등록, 그룹, 완료, 성적, 수료증, 제출, 퀴즈 응시, 프로그램, 주문, 이메일, 조직을 다룹니다. API가 제공하는 곳에서는 각각 목록, 조회, 생성, 수정, 삭제를 제공하며, 동기화에 알맞은 외부 ID 기반 upsert도 제공합니다. 같은 워크플로를 두 번 실행해도 중복이 생기지 않습니다.
작업은 Quire의 OpenAPI 문서로부터 생성되므로 API 레퍼런스와 필드 단위까지 일치합니다. 모든 작업은 n8n AI 에이전트가 도구로 쓸 수도 있으며, 설명은 API 레퍼런스에서 가져옵니다.
목록은 기본적으로 모든 페이지를 반환합니다. 조직이 크다면 Return All을 끄고 상한을 지정하세요.
트리거
Quire Trigger 노드를 추가하고 자격 증명을 고른 뒤 Events를
선택하세요. enrolment.created 같은 이름의 이벤트, course.* 같은 영역
전체, 또는 전체 중에서 고를 수 있습니다. 워크플로를 활성화하면 노드가 n8n
주소를 위해 Quire에 웹훅 구독을 만들고, 비활성화하면 구독이 제거됩니다.
각 전달의 서명은 워크플로가 실행되기 전에 검사됩니다. 검증에 실패한 전달은
노드 오류와 함께 버려지므로, 위조된 요청으로는 워크플로를 시작할 수 없습니다.
이벤트의 data에는 식별자가 담겨 있으니, 트리거 뒤에 Quire 노드를 붙여 전체
기록을 가져오세요.
예시: 등록 시 환영 이메일
enrolment.created에 대한 Quire Trigger.- Quire 노드, 리소스 Users, 작업 Get, 사용자 ID
{{$json.data.user_id}}. - Quire 노드, 리소스 Courses, 작업 Get,
{{$json.data.course_id}}. - 그 사람의 이름과 코스 제목을 쓰는 이메일 또는 채팅 노드.
문제 해결
- 모든 호출에서 401: Base URL과 키가 서로 다른 조직에 속했거나 키가 폐기되었습니다.
- 한 작업에서 403: 키에 그 스코프가 없습니다.
/admin/integrations/api-keys에서 추가하세요. - 트리거가 전혀 실행되지 않음: n8n의 웹훅 주소는 HTTPS로 Quire에서 접근
가능해야 합니다.
/admin/webhooks의 구독 전달 로그를 확인하세요.