Zapier

Zapier অন্য integration-এর মতো একই REST API, OAuth client ও webhook দিয়ে Quire-এর সঙ্গে যুক্ত হয়। কোনো পাশেই Quire-নির্দিষ্ট কোড নেই, তাই API reference-এ যা আছে Zap তা করতে পারে।

Quire-এ কিছু ঘটলে Zap শুরু করুন

1. Zapier-এ trigger হিসেবে Webhooks by Zapier বেছে নিয়ে event Catch Raw Hook নির্বাচন করুন। Raw বেছে নিন, কারণ Quire পাঠানো হুবহু byte-এর ওপর signature হিসাব হয়। Zapier যে ঠিকানা দেয় তা কপি করুন।
2. Quire-এ /admin/webhooks খুলে Add subscription বেছে নিন, ঠিকানাটি পেস্ট করুন এবং event নির্বাচন করুন; যেমন course_completion.changed। Quire আগে একটি test event পাঠায়; Zapier সেটি পেলে subscription চালু হয়।
3. subscription secret ব্যবহার করে signature যাচাইয়ের জন্য Code by Zapier step যোগ করুন, যেমন ডেভেলপার নির্দেশিকা-এ দেখানো হয়েছে। যাচাই ব্যর্থ হলে Zap বন্ধ করুন।
4. body parse করে প্রয়োজনীয় step-গুলো চালিয়ে যান।

Zap থেকে Quire-এ কাজ করুন

Webhooks by Zapier-এর Custom Request action অথবা app step-এ API Request ব্যবহার করুন:

• URL: https://acme.quirelms.com/api/v1/...; যেমন কাউকে enrol করতে /api/v1/enrolments।
• Headers: Authorization: Bearer qk_live_... ব্যবহার করুন; এই Zap-এর জন্য key তৈরি হয় /admin/integrations/api-keys-এ। trigger-এর ID থেকে তৈরি Idempotency-Key দিন, যাতে Zapier Zap-টি আবার চালালেও একই ব্যক্তিকে দুবার enrol করা না হয়।
• Data: API reference-এ বর্ণিত JSON।

প্রতিষ্ঠানের পরিবর্তে কোনো ব্যক্তির পরিচয়ে কাজ করতে /admin/integrations/oauth-clients-এ Zapier-এর redirect address দিয়ে OAuth client নিবন্ধন করুন এবং private Zapier integration থেকে সেটি ব্যবহার করুন।

উদাহরণ: deal সম্পন্ন হলে গ্রাহক enrol করুন

1. Trigger: আপনার CRM-এ “deal won”।
2. ব্যক্তির নাম ও email-সহ custom request PUT /api/v1/users/ext:{customer id}: user তৈরি করে, আগে থাকলে হালনাগাদ করে।
3. user ও course-সহ custom request POST /api/v1/enrolments, এবং Idempotency-Key: deal-{deal id}।