يمكنك الآن إنشاء مساعدين شخصيين للأعمال — روبوتات خاصة تتكامل مباشرة مع محادثات Telegram الفردية. تقوم هذه الروبوتات بمعالجة الطلبات الواردة تلقائيًا والرد نيابة عن مالك الحساب، مما يقلل بشكل كبير من الوقت المستغرق في المهام الروتينية ويحسن كفاءة التواصل.

حالات الاستخدام:
يمكن تكوين هذه المساعدين لأغراض مختلفة، مثل:

  • تقديم استشارات حول المنتجات أو الخدمات.
  • الإجابة على الأسئلة الشائعة.
  • أداء مجموعة واسعة من المهام الآلية الأخرى.

الميزة الرئيسية: التحكم السلس

يمكن للمستخدم التبديل فورًا إلى التواصل اليدوي في أي وقت دون مقاطعة أو تعطيل تشغيل الروبوت، مما يضمن التحكم الكامل في المحادثة.

انتباه!

حساب Telegram Business لديه نافذة زمنية مدتها 24 ساعة.

بمجرد أن يرسل المستخدم رسالته الأولى، يكون لدى الروبوت نافذة زمنية مدتها 24 ساعة للرد ومواصلة المحادثة. يتم إعادة تعيين هذه النافذة في كل مرة يرد فيها المستخدم.

  • إذا رد المستخدم: تبدأ النافذة الزمنية لمدة 24 ساعة من جديد، مما يسمح بحوار مستمر.
  • إذا لم يرد المستخدم خلال 24 ساعة: تُغلق النافذة. سيتم حظر الروبوت من إرسال المزيد من الرسائل حتى يرسل المستخدم رسالة جديدة لإعادة بدء الاتصال.

توصيل الروبوت

الخطوة 1. الإعداد في قسم المراسلات (Messengers).

  1. إذا كنت تقوم بتوصيل روبوت Telegram لأول مرة.

أولاً، انتقل إلى علامة التبويب "القنوات (Channels)" في قسم Mavibot لتوصيل روبوت محادثة Telegram (إذا لم يكن موجودًا بعد).

بعد ذلك، نقوم بتوصيل روبوت Telegram وفقًا لـالتعليمات.

  1. إذا كان Telegram متصلاً بالفعل.

في حال كان لديك بالفعل روبوت Telegram متصل، ابحث عن هذا الروبوت في القنوات.

بعد ذلك، انقر على زر الإعدادات، وبعد ذلك ستظهر لك نافذة منبثقة تحتوي على حقول الرمز المميز (token) وما إلى ذلك:

في النافذة المنبثقة التي تفتح، انقر على "تم (DONE)" لتحديث إعدادات روبوت Telegram الخاص بك (لا تحتاج إلى تغيير أي إعدادات أخرى):

في هذه المرحلة، يتم الانتهاء من العمل مع القنوات. انتقل إلى إعدادات المراسلة.

الخطوة 2. إعدادات المراسلة.

لتوصيل روبوت محادثة Telegram بحساب عملك، انتقل إلى إعدادات ملفك الشخصي، حيث تحتاج إلى العثور على علامة التبويب "Telegram Business":

بعد ذلك، سترى علامة التبويب "Chatbots"، حيث تحتاج إلى الذهاب:

ثم، في علامة التبويب المفتوحة حديثًا، أدخل رابط روبوت Telegram المطلوب أو اسم المستخدم الخاص به (إدخال الرابط هو المفضل).

في نفس علامة التبويب، قم بتعيين الإذن (خانة الاختيار "الرد على الرسائل (Reply to messages)") للروبوت للرد على الرسائل.

في هذه المرحلة، يتم الانتهاء من إعداد الروبوت في حساب العمل. تابع.

الخطوة 3. إعدادات BotFather.

بعد ربط الروبوت بحساب العمل، تحتاج إلى تحديث إعدادات الروبوت في BotFather، حيث قمت بإنشاء روبوت Telegram في البداية.

للقيام بذلك، افتح المحادثة مع BotFather وقم بتمكينه من العمل مع حساب العمل:

انتقل إلى إعدادات الروبوت:

بعد ذلك، انقر على زر "وضع الأعمال (Business Mode)" لتمكين وضع الأعمال للروبوت:

جاهز! تم الانتهاء من جميع إعدادات الروبوت الضرورية مع حساب العمل.

الآن، في إعدادات القناة، ستجد روبوت Telegram وسترى معرف الأعمال (business ID) وكذلك اسم مالك حساب العمل:

كيفية التعطيل

لتعطيل الروبوت مع وضع الأعمال، انتقل إلى القنوات وابحث عن الروبوت الذي تريد تعطيل هذا الإعداد فيه. انقر على زر الإعدادات:

انقر على زر "تعطيل حساب العمل (Disable Business Account)".

إذا قمت بتعطيل حساب عملك، فسيستمر الروبوت في العمل في الوضع القياسي.

الوظائف المتاحة

  1. (API) دالة في الآلة الحاسبة:

tg_callback(platform_id , callback_message,group_id, tg_business)

tg_callback

المعلمات:

! 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)

tg_send_poll

المعلمات:

! 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 )

tg_send_quiz_poll

! 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)

tg_send_message_1

المعلمات:

! 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"}]

في المثال، يتم عرض القاموس فقط، بينما يتم تعريف نص الرسالة نفسه في متغير منفصل.

  1. الطرق

تعمل هذه الوظائف تلقائيًا مع العملاء الذين كتبوا إلى حساب Telegram Business بنفس الطريقة التي تعمل بها في البوتات.

لمزيد من المعلومات حول هذه الطرق، راجع المقالة Telegram API