---
title: "Zapier"
description: "با وب‌هوک‌ها و REST API، Quire را به Zapier وصل کنید."
image: "https://docs.quirelms.com/og.png"
---

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

# Zapier

<span id="zapier"></span>

Zapier با همان REST API، کلاینت‌های OAuth و وب‌هوک‌هایی به Quire وصل می‌شود که همهٔ یکپارچه‌سازی‌ها به کار می‌برند. در هیچ‌یک از دو طرف کد ویژهٔ Quire وجود ندارد؛ بنابراین هر آنچه [مرجع API](https://docs.quirelms.com/api/) فراهم کند، یک Zap هم می‌تواند انجام دهد.

## آغاز Zap هنگام رخداد در Quire <!--quire:start-a-zap-when-something-happens-in-quire-->

1. در Zapier، **Webhooks by Zapier** را به‌عنوان راه‌انداز و رویداد **Catch Raw Hook** انتخاب کنید. داده را به‌صورت خام بگیرید، چون امضا بر پایهٔ بایت‌های دقیقی ساخته می‌شود که Quire فرستاده است. نشانی‌ای را که Zapier می‌دهد کپی کنید.
2. در Quire، `/admin/webhooks` را باز کنید، **Add subscription** را بزنید، نشانی را بچسبانید و رویدادها را انتخاب کنید؛ برای نمونه `course_completion.changed`. ابتدا Quire یک رویداد آزمایشی می‌فرستد؛ پس از دریافت آن توسط Zapier اشتراک فعال می‌شود.
3. مرحلهٔ **Code by Zapier** را اضافه کنید تا امضا را با راز اشتراک بررسی کند؛ روش کار در [راهنمای توسعه‌دهندگان](/fa/developer/#webhooks) آمده است. اگر امضا معتبر نیست، Zap را متوقف کنید.
4. بدنه را تجزیه و گام‌های موردنیازتان را ادامه دهید.

## اجرای کنش در Quire از یک Zap <!--quire:act-in-quire-from-a-zap-->

از کنش **Custom Request** در **Webhooks by Zapier** یا **API Request** در گام یک برنامه استفاده کنید:

- **URL**: `https://acme.quirelms.com/api/v1/...`؛ برای نمونه `/api/v1/enrolments` برای ثبت‌نام یک نفر.
- **Headers**: `Authorization: Bearer qk_live_...` با کلیدی که تنها برای همین Zap در `/admin/integrations/api-keys` ساخته‌اید، و `Idempotency-Key` که از شناسهٔ راه‌انداز ساخته شده باشد تا اگر Zapier Zap را دوباره اجرا کرد، همان شخص دوباره ثبت‌نام نشود.
- **Data**: JSON، طبق توضیح مرجع API.

برای عمل کردن از طرف یک شخص به‌جای سازمان، یک کلاینت OAuth در `/admin/integrations/oauth-clients` با نشانی تغییرمسیر Zapier ثبت کنید و آن را از یک یکپارچه‌سازی خصوصی Zapier به کار ببرید.

## نمونه: ثبت‌نام مشتری پس از نهایی‌شدن معامله <!--quire:example-enrol-a-customer-when-a-deal-closes-->

1. راه‌انداز: رویداد «برنده‌شدن معامله» در CRM شما.
2. درخواست سفارشی `PUT /api/v1/users/ext:{customer id}` با نام و ایمیل شخص؛ کاربر را ایجاد می‌کند یا اگر از پیش وجود داشته باشد به‌روزرسانی‌اش می‌کند.
3. درخواست سفارشی `POST /api/v1/enrolments` با کاربر و دوره، و `Idempotency-Key: deal-{deal id}`.

Source: https://docs.quirelms.com/fa/integrations/zapier/index.mdx