Zapier

Zapier는 모든 연동이 사용하는 동일한 REST API, OAuth 클라이언트, 웹훅을 통해 Quire에 연결합니다. 양쪽 모두 Quire 전용 코드가 없으므로 API 레퍼런스가 제공하는 모든 것을 Zap으로 수행할 수 있습니다.

Quire에서 무언가 일어나면 Zap 시작

1. Zapier에서 트리거로 Webhooks by Zapier를 이벤트 Catch Raw Hook과 함께 선택하세요. Raw인 이유는 서명이 Quire가 보낸 정확한 바이트에 대해 계산되기 때문입니다. Zapier가 주는 주소를 복사하세요.
2. Quire에서 /admin/webhooks를 열고 구독 추가를 선택해 주소를 붙여넣고 이벤트를 고르세요. 예: course_completion.changed. Quire는 먼저 테스트 이벤트를 보내고, Zapier가 받은 뒤에 구독이 시작됩니다.
3. 구독 비밀로 서명을 검증하는 Code by Zapier 단계를 개발자 가이드에 나온 대로 추가하세요. 검증에 실패하면 Zap을 멈추세요.
4. 본문을 파싱하고 필요한 단계를 이어가세요.

Zap에서 Quire에서 행동하기

Webhooks by Zapier의 Custom Request 동작을 쓰거나, 앱 단계의 API Request를 사용하세요.

• URL: https://acme.quirelms.com/api/v1/.... 예를 들어 누군가를 등록하려면 /api/v1/enrolments.
• Headers: Authorization: Bearer qk_live_...는 이 Zap 전용으로 /admin/integrations/api-keys에서 만든 키를 사용하고, Idempotency-Key는 트리거 ID로 만들어 Zapier가 재전송한 Zap이라도 같은 사람을 두 번 등록하지 않습니다.
• Data: API 레퍼런스에 설명된 대로 JSON.

조직이 아니라 사람으로 행동하려면 Zapier의 주소로 /admin/integrations/oauth-clients에 OAuth 클라이언트를 등록하고, 비공개 Zapier 연동에서 사용하세요.

예시: 성사된 거래의 고객 등록

1. 트리거: CRM의 “거래 성사”.
2. 사용자의 이름과 이메일을 담아 커스텀 요청 PUT /api/v1/users/ext:{customer id}: 사용자를 만들거나, 이미 있으면 갱신합니다.
3. 사용자와 코스를 담아 커스텀 요청 POST /api/v1/enrolments에 Idempotency-Key: deal-{deal id}를 붙입니다.