وظائف إرسال الرسائل وتحريرها

لننظر في مثال بسيط مع مجموعة من المعاملات المطلوبة:

يحدد platform_id معرف عميل معين.

انظر إلى نفس المثال، ولكن باستخدام المتغيرات:

في هذا المثال، سيحتوي المتغير soob على استجابة الخادم بعد إرسال الرسالة.

إذا قمت بحفظ message_id من الاستجابة المستلمة، فسيسمح لك ذلك بالعمل لاحقًا مع هذه الرسالة (تحرير، حذف، إعادة توجيه، تعليق).

غالبًا ما تنشأ صعوبات عند استخدام جميع المعاملات. لننظر في المثال التالي:

• أولاً، قم بتعريف جميع المعاملات المستخدمة في الدالة. تذكر، يمكن تمرير المعاملات ليس فقط كقيم ولكن أيضًا كمتغيرات، وهو غالبًا أكثر ملاءمة ووضوحًا. يمكن الحصول على متغيرات مثل platform_id و client_message_id من بطاقة ملف العميل.
  platform_id — معرف عميل Telegram الذي يجب إرسال الرسالة إليه *\ >سنرد في نفس الدردشة حيث يكتب العميل

  text - نص الرسالة. \ >نستخدم تنسيق النص - على سبيل المثال، التمييز بالخط العريض.

  client_message_id - معرف الرسالة المراد اقتباسها\ >في الدردشات، يتم تعيين هذا المتغير لقيمته تلقائيًا.
  reply_markup — إعدادات الأزرار **. \ >لنقم بتعيينه للمتغير opts.
  parse_mode — تنسيق النص بالخط العريض والمائل في الوصف ***. يمكن أن يأخذ قيمًا مثل html, markdown, markdownV2. الأحرف المستخدمة لتنسيق نص الرسالة موصوفة هنا. \ >لنستخدم markdown.
  disable_web_page_preview - إظهار معاينة الرابط. لتعطيلها، مرر 1؛ وإلا مرر 0 أو اتركها فارغة "".\ >يمكننا تمرير أي قيمة لأن نص الرسالة لا يحتوي على رابط.
  protect_content — علامة حماية المحتوى. مرر أي قيمة باستثناء 0 أو False أو '' لتفعيلها.\ >لسنا بحاجة إلى حماية المحتوى، لذلك سنمرر سلسلة فارغة ''.
  disable_notification — علامة الإشعار الصوتي (الافتراضي: 0). مرر 1 لتعطيل الإشعار، 0 لتفعيله.\ >الإشعار هو نافذة منبثقة تعرض نص الرسالة. لنقم بتفعيله.

• بعد ذلك، نقوم بتجميع الدالة. تذكر تعيين الدالة لمتغير - سيسمح لك ذلك بتتبع حالة إرسال الرسالة.

هذا ما حصلنا عليه:

بعد أن يرسل لنا العميل الكلمة المفتاحية test، نرد باقتباس رسالته.

في ok نرى حالة الإرسال؛ بعد ذلك تأتي معلومات حول الرسالة نفسها - معرفها وبيانات المرسل والمحتوى.

مثال مع المعامل entities

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

text = "qwert asdfg zxcvb poiuy lkjhg 12345"

يجب كتابة المعامل كقاموس مع البيانات وتحديد التنسيق المطلوب عن طريق الإشارة إلى الخطوط:

entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"`` https://mavibot.ai"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

مرر المعامل أخيرًا في الدالة التي تستخدمها. يمكن تمرير المعامل إلى كل من الدالتين tg_send_message و tg_send_message_1:

x = tg_send_message(platform_id, text, None, None, None, False, False, False, None, entities)

مثال على تمرير المعامل:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://mavibot.ai"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

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

مثال على الكود للنسخ:

react = tg_set_reaction(platform_id, 1556, '👌')

مثال في الآلة الحاسبة:

يمكنك العثور على مثال تفصيلي للعمل مع وظائف Telegram API لتحرير الرسائل أدناه.

مثال 1

/*من الملائم تعريف النص في متغير مسبقًا*/
text='كتابة-كتابة-كتابة نص'
/*دالة إرسال رسالة*/
soob=tg_send_message(platform_id, text)
/*حفظ معرف الرسالة المرسلة*/
soob_id=soob['result']['message_id']

مثال 2

id_group=-1001847103100
text='اختبار إرسال رسالة عبر طريقة API. على سبيل المثال، *نص عريض*'
opts = {"inline_keyboard": [[{"text": "👍","callback_data":1}, {"text": "👎","callback_data":2}]]}
disable_web_page_preview=1
protect_content=''
disable_notification=1
parse_mode='markdown'
soob=tg_send_message(id_group, text,client_message_id, opts, parse_mode, disable_web_page_preview, protect_content, disable_notification) 

لذا، دعنا نرسل لأنفسنا رسالة مع لوحة مفاتيح مضمنة:

بعد ذلك، قم بتحرير نص الرسالة:

وتحرير الأزرار:

لنحاول تحرير رسالة تحتوي على صورة. للقيام بذلك، أرسل رسالة مع صورة واحفظ معرف الرسالة المرسلة. اقرأ التعليمات التفصيلية حول كيفية الحصول على رابط الصورة هنا:

الآن، دعنا نحرر الصورة ووصفها:

/*من الملائم تعريف المعاملات في متغير مسبقًا.*/
text='ما الحزمة التي ترغب في اختيارها؟'
opts = {"inline_keyboard": [[{"text": "الحزمة 1","callback_data":1}, {"text": "الحزمة 2","callback_data":2}]]}
/*دالة إرسال رسالة*/
soob=tg_send_message(platform_id, text, None, opts)
/*حفظ معرف الرسالة المرسلة*/
soob_id=soob['result']['message_id']

/*تحرير الرسالة*/
text='ما الحزمة التي تهتم بها؟'
tg_edit_message_text(platform_id, soob_id, text, opts)  

/*تحرير لوحة المفاتيح المضمنة*/
opts = {"inline_keyboard": [[{"text": "قياسية","callback_data":1}, {"text": "ممتازة","callback_data":2}]]}
tg_edit_message_reply_markup(platform_id, soob_id, opts)


/*إرسال صورة مع الوصف*/
soob=tg_send_photo(platform_id, "AgACAgIAAxkBAAIPpWO4T7jhOgYHq6uR8rjnq9rIvBs-AAJlwDEb5fHASaGdhzgWjyn7AQADAgADeAADLQQ", "هذه صورة")
/*حفظ معرف الرسالة المرسلة*/
soob_id=soob['result']['message_id']

/*تحرير الصورة*/
media='{"type": "photo", "media": "AgACAgIAAxkBAAIPrmO4UiH7Tazqn-3IbFVzPKNsVEZmAAJ1wDEb5fHASWcNXKah-egvAQADAgADeQADLQQ"}'
tg_edit_message_media(platform_id, soob_id, media)
/*تحرير وصف الصورة*/
tg_edit_message_caption(platform_id, soob_id, 'هذا أنا!')

دعنا نرسل رسالة ونحفظ معرفها.

ونسخ الرسالة المرسلة سابقًا.

/*من الملائم تعريف المعاملات في متغير مسبقًا.*/
text='ما الحزمة التي ترغب في اختيارها؟'
opts = {"inline_keyboard": [[{"text": "الحزمة 1","callback_data":1}, {"text": "الحزمة 2","callback_data":2}]]}
/*دالة إرسال رسالة*/
soob=tg_send_message(platform_id, text, None, opts)
/*حفظ معرف الرسالة المرسلة*/
soob_id=soob['result']['message_id']


/*نسخ الرسالة المرسلة*/
tg_copy_message('5081438490', '1840834360', soob_id, None, opts, None, None, 1)