Zapier

يتصل Zapier بـQuire عبر REST API وعملاء OAuth وخطافات الويب نفسها التي تستخدمها عمليات التكامل الأخرى. ولا تحتاج أي من الجهتين إلى شيفرة خاصة بـQuire، لذا يمكن لإجراء Zap تنفيذ أي وظيفة يقدمها مرجع API.

ابدأ Zap عند وقوع حدث في Quire

1. اختر Webhooks by Zapier كمُشغّل في Zapier، مع الحدث Catch Raw Hook. اختر البيانات الخام لأن التوقيع يُحسب من البايتات نفسها التي أرسلها Quire. انسخ العنوان الذي يمنحك إياه Zapier.
2. افتح /admin/webhooks في Quire واختر إضافة اشتراك والصق العنوان واختر الأحداث، مثل course_completion.changed. يرسل Quire حدث اختبار أولًا؛ ويبدأ الاشتراك بعد أن يستلمه Zapier.
3. أضف خطوة Code by Zapier للتحقق من التوقيع باستخدام سر الاشتراك كما هو موضح في دليل المطور. أوقف Zap إذا لم يجتز الحدث التحقق.
4. حلل محتوى الطلب وتابع بالخطوات المطلوبة.

نفّذ إجراءً في Quire من Zap

استخدم 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 مبني من معرف الحدث حتى لا يؤدي تكرار Zapier للطلب إلى تسجيل الشخص نفسه مرتين.
• 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}.