أصبحت روبوتات البرقية أكثر شيوعا في مختلف مجالات النشاط. إنها تسمح لك بأتمتة العمليات والتواصل مع المستخدمين. إضافة وظيفة إدخال البيانات إلى بوت برقية الخاص بك يمكن أن توسع بشكل كبير قدراتها. في هذه المقالة ، سنخبرك بكيفية إضافة هذه الميزة إلى الروبوت الخاص بك خطوة بخطوة.
الخطوة 1: قم بإنشاء روبوت واحصل على مفتاح واجهة برمجة التطبيقات. قبل إضافة وظيفة الإدخال ، يجب أن يكون لديك روبوت برقية خاص بك. للقيام بذلك ، يمكنك استخدام بوت برقية خاص يسمى بوتفاثر. وسوف تساعدك على إنشاء بوت جديد وإعطائها مفتاح أبي فريدة من نوعها التي سيتم استخدامها للتفاعل مع أبي برقية.
الخطوة 2: تثبيت المكتبات اللازمة. للعمل مع روبوتات برقية ووظيفة الإدخال ، ستحتاج إلى بعض مكتبات بايثون. تثبيتها باستخدام نقطة:
بيب تثبيت بيثون-برقية-بوت
بيب تثبيت بيثون-برقية-بوت [الجوارب]
- تثبيت مكتبة بيتليغرامبوتابي
- إنشاء بوت جديد في برقية
- الحصول على رمز مميز للعمل مع واجهة برمجة التطبيقات
- تكوين الروبوت
- إنشاء وظيفة لمعالجة أمر الإدخال
- تحديث معالج الرسائل
- اختبار بوت مع وظيفة الإدخال
- إرسال رسالة باستخدام الوظيفة
- سؤال وجواب
- كيف يمكنني إضافة وظيفة إدخال النص في بوت?
- هل من الممكن إضافة وظيفة لإدخال الأرقام في بوت برقية?
- كيف يمكنني عرض لوحة المفاتيح للكتابة في بوت?
- كيفية معالجة إدخال المستخدم باستخدام وظيفة الإدخال في بوت برقية?
تثبيت مكتبة بيتليغرامبوتابي
لإنشاء بوت برقية في بيثون ، وغالبا ما تستخدم مكتبة بيتيليغرامبوتابي. يسمح لك بالتفاعل بسهولة مع واجهة برمجة تطبيقات منصة تيليجرام وإنشاء مجموعة متنوعة من الروبوتات مع القدرة على معالجة الرسائل وإرسال الردود والإجراءات الأخرى.
لتثبيت مكتبة بيتليغرامبوتابي اتبع الخطوات التالية:
- افتح موجه أوامر أو محطة طرفية على جهاز الكمبيوتر الخاص بك.
- تأكد من تثبيت بايثون. للقيام بذلك ، اكتب الأمر بيثون 3 —الإصدار في موجه الأوامر. إذا كان لديك إصدار بايثون 3.س. س تثبيت ، سترى رقم الإصدار في الاستجابة.
- أدخل الأمر بيب تثبيت بيتيليغرامبوتابي لتثبيت مكتبة بيتيليغرامبوتابي باستخدام مدير حزمة بيب.
بعد الانتهاء من هذه الخطوات ، سيتم بنجاح تثبيت مكتبة بيتليغرامبوتابي على جهاز الكمبيوتر الخاص بك. الآن يمكنك استخدامه لإنشاء وتكوين بوت برقية الخاص بك.
من المهم أن نتذكر أنه قبل استخدام مكتبة بيتليغرامبوتابي ، تحتاج إلى الحصول على معرف بوت الخاص بك ورمز الوصول من منصة برقية. سوف تحتاج هذه البيانات لإعداد بوت وتوصيله إلى أبي برقية.
إنشاء بوت جديد في برقية
يوفر برقية فرصة لخلق بوت الخاصة بك على التواصل مع المستخدمين. للقيام بذلك ، اتبع الخطوات التالية:
- فتح برقية والعثور على بوت خاص يسمى بوتفاثر في ذلك.
- اكتب الأمر بوتفاثر / نيوبوت لإنشاء بوت جديد.
- سوف بوتفاثر يطلب منك إدخال اسم للبوت الجديد. أدخل الاسم المطلوب وفقا للتعليمات وإرسالها.
- بعد إنشاء بوت بنجاح ، سوف بوتفاثر توفر لك مع رمز. هذا الرمز المميز هو معرف فريد للبوت الخاص بك ، لذا احتفظ به في مكان آمن.
تهانينا ، لقد قمت للتو بإنشاء روبوت برقية خاص بك! يمكنك الآن المتابعة لتكوينها وإضافة وظيفة الإدخال للتفاعل مع المستخدمين.
ملاحظة: تأكد من أن تضع في اعتبارك أمان رمز الروبوت الخاص بك. لا تشاركه مع الغرباء ، حيث يمكن للمتسللين استخدامه للوصول غير المصرح به إلى الروبوت الخاص بك.
الحصول على رمز مميز للعمل مع واجهة برمجة التطبيقات
للعمل مع أبي في برقية السير ، تحتاج إلى الحصول على رمز أبي التي سيتم استخدامها للترخيص والتفاعل مع خوادم برقية. للحصول على رمز مميز ، اتبع الخطوات التالية:
- فتح التطبيق برقية والعثور على بوت "بوتفاثر" في البحث.
- بدء حوار مع بوتفاثر عن طريق إرسال الأمر "/ابدأ".
- اتبع تعليمات بوتفاثر واتبع الخطوات اللازمة لإنشاء بوت جديد.
- بعد إنشاء بوت ، سوف بوتفاثر توفر لك مع رمز فريد من نوعه. نسخه وحفظه في مكان آمن.
سيتم استخدام الرمز المميز المستلم في التعليمات البرمجية الخاصة بك لتهيئة الروبوت وإرسال الطلبات إلى خوادم واجهة برمجة تطبيقات تيليجرام. تأكد من الحفاظ على الرمز المميز آمنا ولا تشاركه مع الغرباء ، لأنه يتيح الوصول إلى الروبوت الخاص بك ويمكن استخدامه لتنفيذ إجراءات مختلفة نيابة عنه.
تكوين الروبوت
قبل إضافة وظيفة الإدخال في بوت برقية ، تحتاج إلى إجراء العديد من الإعدادات.
إنشاء روبوت جديد
أولا ، تحتاج إلى إنشاء بوت جديد في برقية. لهذا:
- تسجيل الدخول إلى برقية والعثور على بوت اسمه @ بوتفاثر.
- بدء حوار مع @ بوتفاثر من خلال النقر على"ابدأ".
- إرسال الأمر / نيوبوت لإنشاء بوت جديد.
- امنح الروبوت اسما وحدد اسم مستخدم فريدا (يجب أن ينتهي بـ "الروبوت").
- الحصول على رمز مميز للوصول إلى أبي هتب من بوت.
تثبيت بايثون ومكتبة بايثون-برقية-بوت
للعمل مع بوت برقية ، وسوف تحتاج بيثون ومكتبة بيثون برقية بوت. لتثبيتها:
- تثبيت بايثون من الموقع الرسمي: https://www.python.org/downloads/
- لتثبيت المكتبة.
إعداد البيئة
للعمل مع بوت برقية ، تحتاج إلى إنشاء ملف مع التمديد.إنف لتخزين الرمز المميز وبيانات التكوين الأخرى. في الملف .إنف إضافة السطر التالي:
تلغرام_توكين = الروبوت الخاص بك
بوت = برقية.بوت (رمز)
طباعة (بوت.احصل على())بعد إنشاء الروبوت في الكود ، يمكنك البدء في إضافة وظيفة الإدخال ومعالجة البيانات المدخلة.
إنشاء وظيفة لمعالجة أمر الإدخالبعد أن أضفنا وظيفة الإدخال إلى روبوت تيليجرام الخاص بنا ، نحتاج إلى إنشاء وظيفة لمعالجة هذا الأمر. ستقوم هذه الوظيفة بتنفيذ الإجراءات المتعلقة بإدخال المستخدم وإرجاع استجابة أو نتيجة.
الخطوة 1: إنشاء وظيفة لمعالجة أمر الإدخال. قم بتسميته ، على سبيل المثال ، مقبض_إدخال().
الخطوة 2: داخل وظيفة إدخال المقبض () ، حدد متغيرا سيتم فيه حفظ النص الذي أدخله المستخدم. على سبيل المثال:إدخال النص = تحديث.رسالة.النص
الخطوة 3: أسفل تعريف متغير الإدخال _ النص ، أضف الرمز الذي سيتم تنفيذه بناء على الأمر الذي تم إدخاله. على سبيل المثال ، إذا قام المستخدم بإدخال الأمر "/ ابدأ " ، فيجب أن يستجيب الروبوت برسالة ترحيب:
إذا كان إدخال النص = =' / ابدأ':
بوت.إرسال رسالة(معرف الدردشة=تحديث.رسالة.معرف الدردشة ، نص = ' مرحبا! أنا الروبوت الجديد الخاص بك. كيف بإمكاني مساعدتك؟')
الخطوة 4: أضف معالجة الأوامر الأخرى التي تريد تنفيذها في الروبوت الخاص بك. على سبيل المثال ، إذا كنت تريد أن يستجيب الروبوت لأمر" / مساعدة " ويقدم معلومات حول إمكانيات الروبوت ، فأضف الكود التالي:إليف_إدخال_النص = =' / مساعدة':
بوت.إرسال رسالة(معرف الدردشة=تحديث.رسالة.معرف الدردشة ، نص = ' يمكنني تنفيذ الأوامر التالية:
/ مساعدة-احصل على معلومات حول إمكانيات الروبوت
/ ابدأ-ابدأ العمل مع الروبوت')
الخطوة 5: أرفق كتل التعليمات البرمجية داخل وظيفة إدخال المقبض () في حالة إذا تحقق من أن الأمر الذي تم إدخاله مدعوم من قبل الروبوت. على سبيل المثال ، إذا قام مستخدم بإدخال أمر غير مدعوم ، فيجب أن يستجيب الروبوت برسالة خطأ:
آخر:
بوت.إرسال رسالة(معرف الدردشة=تحديث.رسالة.معرف الدردشة ، نص = ' آسف ، أنا لا أفهم هذا الأمر. يرجى المحاولة مرة أخرى.')الخطوة 6: في روبوت تيليجرام الخاص بك ، أضف مكالمة إلى وظيفة الإدخال() في المكان المناسب بحيث يتم استدعاؤها عند استلام أمر الإدخال من المستخدم.
الآن بوت برقية الخاص بك يجب معالجة أمر الإدخال بشكل صحيح وتنفيذ الإجراءات اعتمادا على الأمر الذي تم إدخاله. يمكنك إضافة أوامر أو إجراءات إضافية إلى وظيفة إدخال المقبض () وفقا لاحتياجاتك.
تحديث معالج الرسائل
بعد إضافة وظيفة الإدخال إلى روبوت تيليجرام ، من الضروري تحديث معالج الرسائل حتى يتمكن الروبوت من معالجة الرسائل الواردة الجديدة بشكل صحيح.
1. ابدأ بإنشاء وظيفة تتعامل مع الرسائل الواردة:
ديف التعامل مع رسالة (تحديث ، السياق):رسالة = تحديث.الرسالة
معرف المستخدم = message.from_user.id
نص = رسالة.النص
# منطق معالجة الرسالة
يتم تنفيذ 2 هنا. بعد إنشاء وظيفة المعالج ، تحتاج إلى إضافتها إلى الوظيفة الرئيسية التي ستقوم بتشغيل الروبوت ومعالجة الرسائل الواردة:
ديف ستارت_بوت():
محدث = محدث (رمز مميز=برقي_توكين ، استخدم _كونتيكست = صحيح)
المرسل = محدث.المرسل
# إضافة معالج الرسائلالمرسل.إضافة _مقبض(الرسائل(الفلاتر.النص ، التعامل مع_رسالة))
# إطلاق بوت
محدث.بدء الاستقطاب()
محدث.الخمول()
3. يمكنك الآن إضافة منطق معالجة الرسائل الواردة إلى وظيفة المقبض. على سبيل المثال ، لتنفيذ وظيفة الصدى ، والتي سوف تستجيب للمستخدم مع نفس الرسالة:
ديف التعامل مع رسالة (تحديث ، السياق):
رسالة = تحديث.الرسالة
معرف المستخدم = message.from_user.idنص = رسالة.النص
# نقوم بالرد على المستخدم بنفس الرسالة
السياق.بوت.إرسال رسالة (معرف الدردشة=معرف المستخدم ، نص = نص)
4. إذا كنت بحاجة إلى إضافة العديد من معالجات الرسائل الواردة المختلفة ، يمكنك استخدام وحدة كونفيرزاتيونهاندلر ، والذي يسمح لك لمعالجة الرسائل الواردة ضمن "خطوات" مختلفة من الحوار.
هنا مثال على استخدام كونفيرزاتيونهاندلر لإنشاء مربع حوار بسيط:
من برقية.تحويلة استيراد كونفيرزاتيونهاندلر
البداية ، الخطوة 1 ، الخطوة 2 ، النهاية = النطاق (4)
ديف ستارت (تحديث ، سياق):
context.bot.send_message(chat_id=update.message.chat_id, text="Привет! Это наш диалог. Что хочешь сделать?")
return STEP1
def step1(update, context):
context.bot.send_message(chat_id=update.message.chat_id, text="Шаг 1 выполнен! Теперь перейдем к шагу 2.")
return STEP2
def step2(update, context):
context.bot.send_message(chat_id=update.message.chat_id, text="Шаг 2 выполнен! Весь диалог завершен.")
return END
def end(update, context):
context.bot.send_message(chat_id=update.message.chat_id, text="Диалог завершен.")
conv_handler = ConversationHandler(
entry_points=[MessageHandler(Filters.text, start)],
states={
STEP1: [MessageHandler(Filters.text, step1)],
STEP2: [MessageHandler(Filters.text, step2)],END: [MessageHandler(Filters.text, end)]
},
fallbacks=[]
)
5. После создания обработчиков сообщений, их необходимо добавить в диспетчер:
- dispatcher.add_handler(conv_handler)
- الآن سيقوم الروبوت بمعالجة الرسائل الواردة في إطار مربع الحوار الذي تم إنشاؤه.
- اختبار بوت مع وظيفة الإدخال
- بعد إضافة وظيفة الإدخال إلى بوت برقية الخاص بك ، فقد حان الوقت لاختبار عملها. في هذا القسم ، سننظر في كيفية اختبار الروبوت باستخدام وظيفة الإدخال والتحقق من أنه يعمل بشكل صحيح.
- قبل بدء الاختبار ، تأكد من أن روبوت تيليجرام الخاص بك يعمل بدون أخطاء. تأكد أيضا من تكوين جميع المعلمات والرموز اللازمة للعمل مع واجهة برمجة تطبيقات برقية.
- لاختبار بوت مع وظيفة الإدخال ، وسوف تحتاج اثنين من حسابات برقية: سيتم استخدام حساب واحد لإرسال رسائل إلى الروبوت ، وسيتم استخدام الآخر لتلقي الردود.
- أولا ، فتح حساب برقية التي سيتم استخدامها لإرسال رسائل إلى بوت.
- ابحث عن روبوت البرقية الخاص بك في البحث وافتح الدردشة الخاصة به.
- في حقل إدخال الرسالة ، اكتب أمرا يقوم بتشغيل وظيفة الإدخال في الروبوت الخاص بك.
بعد إرسال الأمر ، يجب أن يطلب منك الروبوت إدخال بعض القيمة.
عند هذه النقطة ، يمكنك استخدام حساب برقية الثاني لإرسال القيمة إلى بوت الدردشة.
أرسل القيمة إلى روبوت الدردشة وانتظر ردها.
يجب على الروبوت معالجة القيمة الخاصة بك وإرسال رد إليك.
مواطنه إرسال رسالة (معرف الدردشة ، رسالة):
- تمريرة
- احصل على رمز الروبوت الخاص بك. يتم إصدار الرمز المميز عند تسجيل روبوت على منصة برقية.
استخدم الطلبات.وظيفة النشر () لإرسال طلب رسالة يحدد الرمز المميز ومعرف الدردشة ونص الرسالة. على سبيل المثال:
مواطنه إرسال رسالة (معرف الدردشة ، رسالة):