يمكنك الآن إنشاء مساعدين شخصيين للأعمال — روبوتات خاصة تتكامل مباشرة مع محادثات Telegram الفردية. تقوم هذه الروبوتات بمعالجة الطلبات الواردة تلقائيًا والرد نيابة عن مالك الحساب، مما يقلل بشكل كبير من الوقت المستغرق في المهام الروتينية ويحسن كفاءة التواصل.
حالات الاستخدام:
يمكن تكوين هؤلاء المساعدين لأغراض متنوعة، مثل:
- تقديم استشارات حول المنتجات أو الخدمات.
- الإجابة على الأسئلة الشائعة.
- أداء مجموعة واسعة من المهام الآلية الأخرى.
الميزة الرئيسية: تحكم سلس
يمكن للمستخدم التبديل فورًا إلى التواصل اليدوي في أي وقت دون مقاطعة أو تعطيل تشغيل الروبوت، مما يضمن تحكمًا كاملاً في المحادثة.
انتبه!
حساب Telegram Business لديه نافذة مدتها 24 ساعة.
بمجرد أن يرسل المستخدم رسالته الأولى، يكون لدى الروبوت نافذة مدتها 24 ساعة للرد ومواصلة المحادثة. يتم إعادة تعيين هذه النافذة في كل مرة يرد فيها المستخدم.
- إذا رد المستخدم: تبدأ النافذة التي تبلغ 24 ساعة من جديد، مما يسمح بحوار مستمر.
- إذا لم يرد المستخدم خلال 24 ساعة: تُغلق النافذة. سيتم حظر الروبوت من إرسال المزيد من الرسائل حتى يرسل المستخدم رسالة جديدة لإعادة بدء الاتصال.
توصيل الروبوت
الخطوة 1. الإعداد في قسم المراسلين.
- إذا كنت تقوم بتوصيل روبوت Telegram لأول مرة.
أولاً، انتقل إلى علامة التبويب "القنوات" في قسم Mavibot لتوصيل روبوت محادثة Telegram (إذا لم يكن موجودًا بعد).
بعد ذلك، نقوم بتوصيل روبوت Telegram وفقًا للتوجيهات .
- إذا كان Telegram متصلاً.
في حال كان لديك بالفعل روبوت Telegram متصل، ابحث عن هذا الروبوت في القنوات:
بعد ذلك، انقر على زر الإعدادات، وبعدها ستظهر لك نافذة منبثقة تحتوي على حقول الرمز المميز وما إلى ذلك:
في النافذة المنبثقة التي تفتح، انقر على "تم" لتحديث إعدادات روبوت Telegram الخاص بك (لا تحتاج إلى تغيير أي إعدادات أخرى):
في هذه المرحلة، يتم الانتهاء من العمل مع القنوات. انتقل إلى إعدادات المراسل.
الخطوة 2. إعدادات المراسل.
لتوصيل روبوت محادثة Telegram بحساب عملك، انتقل إلى إعدادات ملفك الشخصي، حيث تحتاج إلى العثور على علامة التبويب "Telegram Business":
بعد ذلك، سترى علامة التبويب "Chatbots"، حيث تحتاج إلى الذهاب:
ثم، في علامة التبويب المفتوحة حديثًا، أدخل رابط روبوت Telegram المطلوب أو اسم المستخدم الخاص به (إدخال الرابط هو المفضل).
في نفس علامة التبويب، قم بتعيين الإذن (خانة اختيار "الرد على الرسائل") لكي يتمكن روبوت المحادثة من الرد على الرسائل.
في هذه المرحلة، تم الانتهاء من إعداد روبوت المحادثة في حساب العمل. تابع.
الخطوة 3. إعدادات BotFather.
بعد ربط روبوت المحادثة بحساب العمل، تحتاج إلى تحديث إعدادات روبوت المحادثة في BotFather، حيث قمت بإنشاء روبوت Telegram في البداية.
للقيام بذلك، افتح المحادثة مع BotFather وقم بتمكينه من العمل مع حساب العمل:
انتقل إلى إعدادات الروبوت:
بعد ذلك، انقر على زر "Business Mode" لتمكين وضع العمل لروبوت المحادثة:
جاهز! تم الانتهاء من جميع إعدادات روبوت المحادثة الضرورية مع حساب العمل.
الآن، في إعدادات القناة، ستجد روبوت Telegram وسترى معرف العمل وكذلك اسم مالك حساب العمل:
كيفية التعطيل
لتعطيل روبوت المحادثة مع وضع العمل، انتقل إلى القنوات وابحث عن روبوت المحادثة الذي تريد تعطيل هذا الإعداد فيه. انقر على زر الإعدادات:
انقر على زر "تعطيل حساب العمل".
إذا قمت بتعطيل حساب عملك، فسيستمر روبوت المحادثة في العمل في الوضع القياسي.
الوظائف المتاحة
- (API) وظيفة في الحاسبة:
tg_callback(platform_id , callback_message,group_id, tg_business)
المعلمات:
! platform_id - معرف عميل Telegram
! callback_message - رسالة الرد
group_id - معرف روبوت Telegram
tg_business - للعمل مع عملاء الأعمال، يأخذ القيمة "1".
tg_send_poll(platform_id, question, options, is_anonymous, allows_multiple_answers, reply_markup, disable_notification, protect_content, token, reply_to_message_id, message_thread_id, business_connection_id)
المعلمات:
! platform_id - معرف الدردشة داخل Telegram *
! question - السؤال
! options - مصفوفة من خيارات الإجابة
is_anonymous - 1 - استطلاع مجهول، '' - غير مجهول
allows_multiple_answers - 1 - يُسمح بإجابات متعددة، '' - إجابة واحدة فقط
reply_markup - لوحة المفاتيح، أو '' - بدون لوحة مفاتيح
disable_notification — علامة للإرسال مع إشعار صوتي (الافتراضي 0)؛ 1 - إرسال بصمت، 0 - إرسال مع إشعار
protect_content - 1 - حماية من النسخ ولقطات الشاشة، '' - بدون حماية
token - رمز الروبوت المميز؛ إذا لم يتم توفيره، يتم استخدام الرمز الحالي
reply_to_message_id - معرف الرسالة المقتبسة
message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)
business_connection_id - القيمة المستخدمة عند توصيل روبوت (معرف العمل، المعروض في القنوات)؛ يجب تمريرها إذا تم توفير رمز الروبوت المميز ويجب إرسال الرسالة عبر حساب المستخدم المرتبط بالروبوت
tg_send_quiz_poll(platform_id, question, options, explanation, correct_option_id, is_anonymous, reply_markup, parse_mode, protect_content, disable_notification, token, reply_to_message_id, message_thread_id )
! platform_id - معرف الدردشة داخل Telegram *
! question - السؤال
! options - مصفوفة من خيارات الإجابة
! explanation - النص الذي يظهر عندما يختار المستخدم إجابة غير صحيحة أو ينقر على أيقونة المصباح في استطلاع من نوع الاختبار؛ 0-200 حرف، مع عدم وجود أكثر من فاصلتي أسطر بعد تحليل الكيان.
! correct_option_id - رقم الإجابة الصحيحة، بدءًا من 1.
is_anonymous -1 - استطلاع مجهول، '' - غير مجهول
reply_markup - لوحة المفاتيح، أو '' - بدون لوحة مفاتيح
parse_mode - markdown أو html لـ explanation، أو '' بدون تنسيق.
protect_content - 1 حماية من النسخ ولقطات الشاشة، '' - بدون حماية.
disable_notification — علامة للإرسال مع إشعار صوتي (الافتراضي 0)؛ 1 - إرسال بصمت، 0 - إرسال مع إشعار
token - رمز الروبوت المميز؛ إذا لم يتم توفيره، يتم استخدام الرمز الحالي.
reply_to_message_id - معرف الرسالة المقتبسة
message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)
open_period - الوقت المسموح به لإكمال الاختبار/الاستبيان؛ قيمة رقمية من 5 إلى 600، تمثل الثواني.
business_connection_id - القيمة المستخدمة عند توصيل روبوت (معرف العمل، المعروض في القنوات)؛ يجب تمريرها إذا تم توفير رمز الروبوت المميز ويجب إرسال الرسالة عبر حساب المستخدم المرتبط بالروبوت
tg_send_message_1(token, platform_id, text, client_message_id, reply_markup, parse_mode, disable_web_page_preview, protect_content, disable_notification, message_thread_id, entities, business_connection_id)
المعلمات:
! token — رمز روبوت Telegram المميز الذي تم الحصول عليه من BotFather
! platform_id — معرف عميل Telegram الذي يجب إرسال الرسالة إليه *
! text - نص الرسالة
client_message_id - معرف الرسالة المقتبسة
reply_markup — إعدادات الأزرار **
parse_mode — وضع تنسيق النص للخط العريض أو المائل في وصف الرسالة ***. القيم الممكنة: html، markdown، markdownV2
disable_web_page_preview - ما إذا كان سيتم عرض معاينة الرابط؛ اضبط على 1 لتعطيل، وإلا 0 أو اتركه فارغًا ("")
protect_content — علامة لحماية المحتوى من النسخ؛ للتمكين، مرر أي قيمة غير 0 أو False أو علامات اقتباس فارغة ('')
disable_notification — علامة للإرسال مع إشعار صوتي (الافتراضي 0)؛ 1 - إرسال بصمت، 0 - إرسال مع إشعار
message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى) entities — يسمح بنسخ النص المنسق مسبقًا مع جميع التنسيقات؛ حدد نطاقات الأحرف لكل نمط تنسيق. يمكنك العثور على مثال في حقل tg_request. يجب أن تحتوي المعلمة على قاموس.
business_connection_id - القيمة المستخدمة عند توصيل روبوت (معرف العمل، المعروض في القنوات)؛ يجب تمريرها إذا تم توفير رمز الروبوت المميز ويجب إرسال الرسالة عبر حساب المستخدم المرتبط بالروبوت
مثال على تمرير المعلمة:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]
في المثال، يتم عرض القاموس فقط، بينما يتم تعريف نص الرسالة نفسه في متغير منفصل.
- الطرق
تعمل تلقائيًا مع العملاء الذين كتبوا إلى حساب Telegram Business بنفس الطريقة كما في الروبوتات.
لمزيد من المعلومات حول هذه الطرق، راجع المقالة Telegram API"