Zapier

Zapier با همان REST API، کلاینت‌های OAuth و وب‌هوک‌هایی به Quire وصل می‌شود که همهٔ یکپارچه‌سازی‌ها به کار می‌برند. در هیچ‌یک از دو طرف کد ویژهٔ Quire وجود ندارد؛ بنابراین هر آنچه مرجع API فراهم کند، یک Zap هم می‌تواند انجام دهد.

آغاز Zap هنگام رخداد در 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 را اضافه کنید تا امضا را با راز اشتراک بررسی کند؛ روش کار در راهنمای توسعه‌دهندگان آمده است. اگر امضا معتبر نیست، Zap را متوقف کنید.
4. بدنه را تجزیه و گام‌های موردنیازتان را ادامه دهید.

اجرای کنش در Quire از یک 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 به کار ببرید.

نمونه: ثبت‌نام مشتری پس از نهایی‌شدن معامله

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