الوثائق المتاحة في قراءة المستندات.
إطار عمل روبوت للدردشة يعتمد على Python لـ Mattermost. تمت إعادة تحليل الكود الخاص بإطار عمل الروبوت هذا بشكل كبير في الإصدار 2.0.0 وسيعمل فقط مع Python 3.8 أو أعلى. لدعم Python 2 وPython3 < 3.8، يرجى استخدام الإصدارات v1.3.9 أو الإصدارات الأقدم.
الأهم | mmpy_bot |
---|---|
>= 4.0 | > 1.2.0 |
< 4.0 | غير مدعوم |
pip install mmpy-bot
pip install mmpy-bot==1.3.9
تحتاج أولاً إلى إنشاء حساب روبوت على خادم Mattermost الخاص بك. ملاحظة: يجب تمكين إنشاء حساب الروبوت ضمن وحدة تحكم النظام
لاحظ أن بعض وظائف واجهة برمجة التطبيقات، مثل ردود الرسائل المؤقتة، ستتطلب أن يكون الروبوت جزءًا من مجموعة مسؤول النظام ، ومع ذلك فإن معظم وظائف واجهة برمجة التطبيقات ستعمل مع دور حساب عضو عادي. فقط كن على علم أنه إذا كانت بعض وظائف واجهة برمجة التطبيقات (API) لا تعمل، فقد يكون ذلك بسبب عدم وجود الأذونات المناسبة.
قم بإنشاء ملف نقطة إدخال (أو انسخ الملف المقدم)، الذي يحدد إعدادات خادم Mattermost وحساب الروبوت الخاص بك ويستورد الوحدات المطلوبة.
مثال my_bot.py
:
#!/usr/bin/env python
from mmpy_bot import Bot , Settings
from my_plugin import MyPlugin
bot = Bot (
settings = Settings (
MATTERMOST_URL = "http://chat.example.com" ,
MATTERMOST_PORT = 443 ,
BOT_TOKEN = "a69155mvlsobcnqpfdceqihaa" ,
BOT_TEAM = "test" ,
SSL_VERIFY = True ,
), # Either specify your settings here or as environment variables.
plugins = [ MyPlugin ()], # Add your own plugins here.
)
bot . run ()
قم بتعيين البت القابل للتنفيذ في ملف نقطة الإدخال (أي chmod +x my_bot.py
) وابدأ تشغيل الروبوت الخاص بك من موجه الأوامر. الآن يمكنك التحدث إلى الروبوت الخاص بك في عميل Mattermost الخاص بك!
من أجل تحقيق أقصى استفادة من الروبوت الخاص بك، سوف تحتاج إلى كتابة المكونات الإضافية الخاصة بك. ارجع إلى وثائق المكونات الإضافية للبدء.
القناة الأساسية للتواصل هي GitHub عبر المشكلات أو طلبات السحب ولكن قد تجد أيضًا البعض منا في Discord لبعض التفاعل في الوقت الفعلي.