يمكن استخدام واجهة برمجة تطبيقات Discourse لأتمتة إرسال رسائل البريد الإلكتروني للدعوة من منتدىك عند تنفيذ إجراء ما على تطبيق خارجي. بالنسبة للعديد من التطبيقات، يمكنك استخدام Zapier لإعداد هذا دون الحاجة إلى كتابة أي تعليمات برمجية.
أحد حالات الاستخدام الشائعة لهذا هو دعوة المستخدمين إلى منتدىك عندما يشترون منتجًا أو يشتركون في خدمة خارجية. بالنسبة للمثال في هذا الموضوع، سأستخدم تكامل Zapier WordPress لتشغيل إرسال دعوة من Discourse عند اشتراك مستخدم جديد في موقع WordPress.
إعداد خطوة الزناد (trigger step) على Zapier
انتقل إلى لوحة معلومات Zapier وابحث عن التطبيق الذي تريد تشغيل البريد الإلكتروني للدعوة منه. في لقطات الشاشة أدناه، اخترت WordPress كـ “زناد”.
التكوين الوحيد المطلوب لهذا هو ربط “زناد” WordPress بحساب WordPress، واختيار حدث “مستخدم جديد” (New User) لتشغيل “الزناد”.
إعداد خطوة الإجراء (action step) لإرسال الدعوة
انقر فوق زر “إضافة خطوة” (Add a Step) ثم انقر فوق “إجراء/بحث” (Action/Search) من القائمة المنسدلة.
أدخل “webhook” في قائمة البحث ثم حدد “Webhooks by Zapier” من قائمة الإجراءات. ستتم إضافة خطوة إجراء Webhook إلى الشريط الجانبي لـ “الزناد” الخاص بك، وسيتم فتح نموذج يسمح لك باختيار نوع الطلب الذي تريد أن يقوم به الـ Webhook.
حدد POST من النموذج ثم انقر فوق “متابعة” (Continue).
يسمح لك النموذج الذي يفتح بتكوين طلب POST الذي يتم إجراؤه على Discourse. في حقل “عنوان URL” (URL)، أدخل عنوان URL الأساسي للمنتدى الخاص بك، متبوعًا بـ /invites. على سبيل المثال، عنوان URL الأساسي لمنتدى هو https://demo.scossar.com، لذا فإن الرابط الكامل لمسار الدعوات هو https://demo.scossar.com/invites
أنت الآن بحاجة إلى تكوين أقسام النموذج الخاصة بـ نوع الحمولة (Payload Type)، و__البيانات__ (Data)، و__العناوين__ (Headers). يمكن ترك جميع الأقسام الأخرى في النموذج بقيمها الافتراضية.
يخبر “نوع الحمولة” (Payload Type) Zapier بتنسيق إرسال الحمولة به. يجب ضبطه على Json.
يُستخدم قسم “البيانات” (Data) لإخبار Discourse بعنوان البريد الإلكتروني الذي سيتم إرسال الدعوة إليه، ولتعيين قائمة اختيارية بأسماء المجموعات ورسالة مخصصة. لدعوة مستخدم دون إضافته إلى مجموعات أو تضمين رسالة مخصصة، أدخل النص email كمفتاح بيانات (Key)، ثم انقر فوق أيقونة “إدراج حقل” (Insert a Field) لفتح القائمة المنسدلة للحقل. قم بالتمرير لأسفل القائمة حتى ترى القيمة التي تم تمريرها من تطبيق الزناد الخاص بك وتحتوي على بريد المستخدم الإلكتروني. عند استخدام WordPress كتطبيق زناد، يجب أن يبدو قسم البيانات المكتمل مشابهًا لهذا:
لإضافة المستخدمين تلقائيًا إلى المجموعات عند قبولهم للدعوة، انقر فوق أيقونة 
في قسم البيانات لإضافة حقل جديد. اضبط مفتاح الحقل على group_names. اضبط قيمة الحقل على قائمة مفصولة بفواصل لأسماء المجموعات التي تريد إضافة المستخدمين إليها. لتضمين رسالة مخصصة في البريد الإلكتروني للدعوة، أنشئ حقلًا آخر بمفتاحه مضبوطًا على custom_message وقيمته مضبوطة على الرسالة التي تريد إرسالها.
ملاحظة: من خلال إضافة خطوة “التعليمات البرمجية” (Code) بعد خطوة الزناد الخاصة بـ Zap، يجب أن يكون من الممكن تعيين أسماء المجموعات ورسالة مخصصة ديناميكيًا لمستخدمين محددين.
يُستخدم قسم “العناوين” (Headers) للمصادقة على طلبك. لتكوين حقل “العناوين”، ستحتاج إلى إنشاء مفتاح API على موقع Discourse الخاص بك. للقيام بذلك، انتقل إلى صفحة “المسؤول / واجهة برمجة التطبيقات” (Admin / API) الخاصة بموقع Discourse الخاص بك وانقر على زر “مفتاح API جديد” (New API Key). عند إنشاء المفتاح، قم بتعيينه لمستخدم من الموظفين واضبط النطاق على شامل (Global)، أو استخدم نطاق مفصل (Granular) مع تحديد المربع الدعوات > إنشاء (Invites > Create).
الآن، في قسم “العناوين” في Zap، أدخل أزواج المفتاح/القيمة التالية. استبدل أي قيم قمت بتضمينها بين قوسين بقيم مناسبة لموقعك. التمييز بين حالتي الأحرف لأسماء المفاتيح مهم.
Api-Username: <اسم المستخدم للموظف الذي تريد إرسال الدعوات منه>
Api-Key: <مفتاح API الذي قمت بإنشائه>
Content-Type: application/json
يجب أن يبدو النموذج الآن مشابهًا للقطة الشاشة أدناه، ولكن مع اسم المستخدم و مفتاح API الخاص بك:
انقر فوق زر “متابعة” (Continue).
ستتمكن الآن من اختبار التكامل بالنقر فوق الزر “إرسال اختبار إلى Webhooks by Zapier” (Send Test To Webhooks by Zapier). سيتم إجراء الاختبار باستخدام البيانات التي قمت بإعدادها في خطوة الزناد الخاصة بك. سترى رسالة نجاح إذا كان كل شيء مهيأ بشكل صحيح، وإذا لم يكن المستخدم الذي قمت بإعداده في خطوة الزناد موجودًا بعد على منتدى Discourse الخاص بك، فسيتم إرسال بريد إلكتروني للدعوة وسترى رسالة نجاح على Zapier. بمجرد أن تجتاز خطوة الاختبار، انقر فوق زر “إنهاء” (Finish) وقم بتشغيل Zap الخاص بك.
للحصول على تفاصيل حول كيفية إجراء أنواع أخرى من الطلبات إلى واجهة برمجة تطبيقات Discourse باستخدام Zapier، راجع Make requests to the Discourse API with Zapier.
