حاليا ، أصبحت روبوتات فكونتاكتي أكثر شيوعا بين مستخدمي الشبكة الاجتماعية. إنها تساعد في أتمتة الردود على الرسائل وتقديم ألعاب تفاعلية والمزيد. واحدة من الأدوات المهمة لتكوين الروبوت هي واجهة برمجة تطبيقات رد الاتصال.
تسمح واجهة برمجة تطبيقات رد الاتصال للبوت بتلقي إشعارات حول الأحداث التي تحدث في مجتمع فكونتاكتي. بفضل هذا ، يمكن للبوت تلقي الرسائل الجديدة ومعالجتها ، وإنشاء منشورات الحائط وحذفها ، وتنفيذ العديد من الإجراءات الأخرى. ولكن للقيام بذلك ، تحتاج إلى تكوين واجهة برمجة تطبيقات رد الاتصال الخاصة بالبوت بشكل صحيح.
في هذه المقالة ، سنخبرك بكيفية إعداد واجهة برمجة تطبيقات رد الاتصال الخاصة ببوت فكونتاكتي في بضع خطوات بسيطة. سنشرح كيفية إنشاء وتكوين مجموعة فكونتاكتي ، ومعرفة معرفها ، والحصول على مفتاح الوصول السري ، وإعداد معالج الحدث باستخدام فب.
تحتاج إلى المعرفة الأساسية للعمل مع فك أبي و فب لتكوين بنجاح أبي الاتصال بوت فكونتاكتي.
- الشروع في العمل مع أبي رد الاتصال
- الحصول على مفتاح الوصول من فك أبي
- توصيل واجهة برمجة تطبيقات رد الاتصال الخاصة بالبوت
- إنشاء خادم رد الاتصال
- تكوين واجهة برمجة تطبيقات رد الاتصال
- معالجة الأحداث من واجهة برمجة تطبيقات رد الاتصال
- استقبال ومعالجة الرسائل الواردة
الشروع في العمل مع أبي رد الاتصال
- قم بإنشاء مجموعة أو مجتمع فكونتاكتي. إذا كان لديك بالفعل مجموعة ، فيمكنك استخدامها. خلاف ذلك ، قم بإنشاء مجموعة جديدة وتكوين معلماتها.
- احصل على مفتاح الوصول. في إعدادات المجتمع ، ابحث عن القسم "العمل مع واجهة برمجة التطبيقات". قم بإنشاء مفتاح وصول مع حقوق قراءة الرسائل وإدارة المجتمع.
- تكوين الخادم للاستماع للأحداث. ستحتاج إلى خادم ويب قادر على قبول طلبات النشر. حدد عنوان ورل للخادم في إعدادات واجهة برمجة تطبيقات رد الاتصال.
- قم بتأكيد عنوان الخادم. بعد تحديد عنوان ورل للخادم ، سيقوم بوت فكونتاكتي بإرسال طلب نشر إليه باستخدام معلمة"تأكيد". تحتاج إلى معالجة هذا الطلب وإرجاع القيمة "تأكيد" كرد.
- أحداث العملية. بعد تأكيد عنوان الخادم ، سيرسل روبوت فكونتاكتي طلبات نشر إليه بمعلومات حول الأحداث المختلفة. تحتاج إلى معالجة هذه الطلبات والرد على الأحداث وفقا لمنطق الروبوت الخاص بك.
بعد الانتهاء من هذه الخطوات ، ستتمكن من تكوين واستخدام واجهة برمجة تطبيقات رد الاتصال الخاصة ببوت فكونتاكتي لتلقي الأحداث ومعالجتها في مجتمعك. يمكن أن يكون هذا مفيدا لأتمتة عمل الروبوت والتفاعل مع المستخدمين.
الحصول على مفتاح الوصول من فك أبي
لإعداد أبي رد الاتصال فكونتاكتي بوت ، تحتاج إلى الحصول على مفتاح الوصول من أبي فك. سيتم استخدام هذا المفتاح لإرسال الطلبات إلى واجهة برمجة تطبيقات فكونتاكتي وتلقي معلومات حول الأحداث في المجتمع.
للحصول على مفتاح وصول من واجهة برمجة تطبيقات فك ، اتبع الخطوات التالية:
- انتقل إلى صفحة فكونتاكتي الخاصة بالمطور (https://vk.com/dev ) وتسجيل الدخول باستخدام حسابك.
- قم بإنشاء تطبيق مستقل جديد في قسم "تطبيقاتي".
- في إعدادات التطبيق ، انتقل إلى علامة التبويب" الإعدادات".
- انسخ "معرف التطبيق" واحفظه.
- اتبع الرابط التالي في متصفحك (استبدل معرف التطبيق الخاص بك بـ "معرف التطبيق" المنسوخ مسبقا):
https://oauth.vk.com/authorize?client_id=YOUR_APP_ID&display=page&scope=groups,messages,offline&response_type=token&v=5.131
عند فتح الرابط ، سترى صفحة ترخيص فكونتاكتي. اسمح للتطبيق بالوصول إلى الأذونات اللازمة (المجموعات والرسائل وغير المتصلة) وانقر على "السماح".
في شريط عنوان المتصفح ، سترى رابطا جديدا يحدد مفتاح الوصول(الوصول). نسخه وحفظه.
سيتم استخدام مفتاح الوصول المستلم من واجهة برمجة تطبيقات فك في إعدادات واجهة برمجة تطبيقات رد الاتصال لتخويل واستقبال البيانات حول الأحداث في المجتمع.
تمكين واجهة برمجة تطبيقات رد الاتصال الخاصة بالبوت
لإعداد واجهة برمجة تطبيقات رد الاتصال الخاصة ببوت فكونتاكتي ، اتبع الخطوات التالية:
| الخطوة 1: | افتح إعدادات المجتمع في فكونتاكتي وانتقل إلى علامة التبويب" العمل مع واجهة برمجة التطبيقات". |
| الخطوة 2: | انقر فوق الزر" إنشاء مفتاح "للمجموعة بنوع" واجهة برمجة تطبيقات رد الاتصال". |
| الخطوة 3: | أدخل أي قيمة في حقل" المفتاح السري". هذا هو المفتاح السري الذي سيتم استخدامه للتحقق من صحة الطلبات. |
| الخطوة 4: | حدد الرابط إلى الخادم الخاص بك حيث سيتم إرسال الطلبات من واجهة برمجة تطبيقات رد الاتصال. تأكد من أن الخادم متاح على الإنترنت. |
| الخطوة 5: | في الحقل أنواع الأحداث ، حدد الأحداث التي سيستجيب لها الروبوت الخاص بك. على سبيل المثال ، "رسالة_جديد" للرسائل الجديدة. |
| الخطوة 6: | انقر فوق الزر" تأكيد". |
| الخطوة 7: | ابدأ تشغيل الخادم على جهاز الكمبيوتر الخاص بك أو الاستضافة وقم بتكوينه للتعامل مع الطلبات الواردة من واجهة برمجة تطبيقات رد الاتصال. |
| الخطوة 8: | احصل على رمز وصول لبوت فكونتاكتي الخاص بك واحفظه. سيتم استخدامه لإرسال رسائل نيابة عن الروبوت. |
| الخطوة 9: | حدد إعدادات واجهة برمجة تطبيقات رد الاتصال الخاصة بالبوت في البرنامج النصي أو البرنامج الذي سيعالج الطلبات الواردة. |
بعد الانتهاء من هذه الخطوات ، سيتم توصيل روبوت فكونتاكتي الخاص بك بواجهة برمجة تطبيقات رد الاتصال وسيكون جاهزا للرد على الأحداث المحددة.
إنشاء خادم رد الاتصال
الخطوة 1. قم بإنشاء خادم هتبس الذي سيقوم بمعالجة الطلبات من واجهة برمجة تطبيقات رد الاتصال. للقيام بذلك ، يمكنك استخدام أي منصة تدعم هتبس ، على سبيل المثال ، عقدة.شبيبة أو قارورة.
الخطوة 2. قم بتكوين الخادم لقبول طلبات النشر عبر المسار / رد الاتصال. عند تلقي طلب لهذا المسار ، يجب على الخادم استخراج البيانات من نص الطلب.
من نص الطلب. يمكن العثور على مزيد من المعلومات حول المصادقة في وثائق فكونتاكتي.
الخطوة 4. قم بمعالجة البيانات المستلمة من واجهة برمجة تطبيقات رد الاتصال وفقا لمنطق الروبوت الخاص بك. تعرف على أنواع الأحداث التي تحتاج إلى التعامل معها وتعلم كيفية تفسيرها بشكل صحيح.
الخطوة 5. إرسال استجابة هتب مع رمز موافق 200 لجميع الطلبات المستلمة. يعد ذلك ضروريا حتى تعرف فكونتاكتي أن الخادم الخاص بك قد تلقى الطلب بنجاح ولن يكرره مرة أخرى.
الخطوة 6. قم بتكوين الخادم الخاص بك بحيث يعمل في الوصول المفتوح ، على سبيل المثال ، باستخدام الاستضافة السحابية أو تكوين إعادة توجيه المنفذ على جهاز التوجيه الخاص بك.
جاهز! الآن أصبح خادم رد الاتصال جاهزا لتلقي الأحداث من واجهة برمجة تطبيقات رد الاتصال ومعالجتها وفقا لمنطق الروبوت الخاص بك.
تكوين واجهة برمجة تطبيقات رد الاتصال
الخطوة 1: إنشاء خادم
تتمثل الخطوة الأولى في إنشاء خادم سيتم إطلاق الروبوت عليه. للقيام بذلك ، فمن المستحسن استخدام منصة تدعم العقدة.شبيبة أو بي إتش بي.
الخطوة 2: الوصول إلى واجهة برمجة تطبيقات رد الاتصال
للوصول إلى واجهة برمجة تطبيقات رد الاتصال ، تحتاج إلى إنشاء تطبيق فكونتاكتي عام والحصول على مفتاح وصول. للقيام بذلك ، انتقل إلى إعدادات التطبيق العام الخاص بك على صفحة مطور فكونتاكتي.
الخطوة 3: تكوين خادم رد الاتصال
بعد تلقي مفتاح الوصول ، تحتاج إلى تكوين الخادم الخاص بك بحيث يمكنه معالجة الطلبات الواردة من واجهة برمجة تطبيقات رد الاتصال. للقيام بذلك ، حدد عنوان الخادم الخاص بك في إعدادات تطبيق واجهة برمجة تطبيقات فكونتاكتي لإعادة الاتصال.
الخطوة 4: التحقق من صحة الطلب
ستحتوي الطلبات الواردة من واجهة برمجة تطبيقات رد الاتصال على الحقل "السري" ، والذي يجب التحقق منه على الخادم للتحقق من صحة الطلب. للقيام بذلك ، يمكنك استخدام وظيفة التجزئة في تركيبة مع المفتاح السري لتطبيق فكونتاكتي رد أبي الخاص بك.
الخطوة 5: معالجة الطلبات الواردة
بعد تكوين الخادم والتحقق من صحة الطلب ، من الضروري معالجة الطلبات الواردة من واجهة برمجة تطبيقات رد الاتصال. يعتمد تنفيذ معالجة الطلب على لغة البرمجة التي تختارها ومنصة الخادم.
من المهم أن تتذكر أنه يجب تنفيذ معالجات الطلبات بشكل غير متزامن حتى لا يتم حظر الخادم أثناء معالجة عدد كبير من الطلبات.
الخطوة 6: إرسال الردود
بعد معالجة الطلب الوارد ، تحتاج إلى إرسال رد إلى واجهة برمجة تطبيقات رد الاتصال. ستحتوي الاستجابة على حقل" الاستجابة " مع الرمز 200 لإبلاغ منصة فكونتاكتي بأن الطلب قد تمت معالجته بنجاح.
الخطوة 7: الاختبار والتصحيح
بعد تكوين واجهة برمجة تطبيقات رد الاتصال ، يوصى باختبار الخادم الخاص بك وتصحيحه. للقيام بذلك ، يمكنك استخدام الأدوات الخاصة التي توفرها منصة فكونتاكتي.
معالجة الأحداث من واجهة برمجة تطبيقات رد الاتصال
تتم معالجة الأحداث باستخدام لغة البرمجة التي يتم تطوير الروبوت بها. على سبيل المثال ، ضع في اعتبارك معالجة حدث "الرسائل الجديدة" ، والذي يحدث عند تلقي رسالة جديدة من مستخدم.
أولا ، تحتاج إلى إنشاء وظيفة من شأنها أن تكون معالج الحدث:
رسالة مواطن_الجديد (البيانات):
| رسالة مواطن_الجديد (البيانات): | رسالة = بيانات ['كائن'] ['رسالة'] ['نص'] |
|---|---|
| طباعة (رسالة) | |
| بعد إنشاء معالج حدث ، تحتاج إلى الاتصال به عندما تتلقى الحدث المقابل من واجهة برمجة التطبيقات فك. على سبيل المثال ، جنبا إلى جنب مع الاستجابة لطلب من واجهة برمجة التطبيقات فك ، يمكنك إرسال البيانات إلى المعالج: | |
| ديف التعامل مع الحدث (البيانات): | إذا كانت البيانات ['نوع'] = = 'رسالة_جديد': |
| رسالة_الجديد (البيانات) | # ... |
- تلقي جديد
- الرد على
- التحرير
- اشترك في المجتمعات
وبالتالي ، عند استلام حدث" رسالة جديدة " ، سيتم استدعاء وظيفة الرسالة الجديدة ، والتي ستعالج البيانات المستلمة وتنفذ الإجراءات اللازمة.
| يتم التعامل مع بقية الأحداث من واجهة برمجة تطبيقات رد الاتصال بنفس الطريقة. من المهم ملاحظة أنه قد تكون هناك حقول مختلفة في البيانات المستلمة لكل حدث ، لذلك قبل استخدامه ، تحتاج إلى قراءة وثائق واجهة برمجة التطبيقات فك. | الحدث |
| الوصف | من الرسالة_جديد |
رسالة_الرد
رسالة_تحرير الرسالة
مجموعة_انضم
مجموعة_إجازة
إلغاء الاشتراك من المجتمع