وظائف إرسال المرفقات في الرسائل

! تتيح لك هذه الدوال إرسال ملفات من أي نوع. التنسيقات الموصى بها: GIF، PDF، ZIP بحجم يصل إلى 2 جيجابايت.

! العمل مع حساب تيليجرام التجاري

tg_send_document(platform_id, document, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, disable_notification, message_thread_id, entities)

المعلمات:

!** platform_id — معرف العميل في تيليجرام الذي يجب إرسال الرسالة إليه *

!** document - رابط المستند على خادم تيليجرام. شرح الحصول على الرابط عبر tg_request موجود هنا.

caption - وصف، حتى 1024 حرفًا

reply_markup — إعدادات الأزرار **

parse_mode — تنسيق النص في الوصف (غامق أو مائل) ***. القيم الممكنة: html، markdown، markdownV2. رابط

reply_to_message_id - معرف الرسالة المراد الرد عليها (أي الاقتباس)

protect_content — علامة لحماية المحتوى من النسخ. للتفعيل، مرر أي قيمة غير 0 أو False أو علامات اقتباس فارغة ''.

disable_notification — علامة للتحكم في الإشعارات الصوتية (الافتراضي: 0).
1 - إرسال بدون إشعار، 0 - إرسال مع إشعار

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)

entities — يتيح لك إعادة استخدام النص المنسق مسبقًا مع الأنماط. ببساطة حدد إزاحة الحرف ونطاق التنسيق. مثال متاح في tg_request في الحقل المقابل. يجب أن يكون قاموسًا.

مثال على تمرير المعلمة:
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"}]

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

لتبسيط وصف مجموعة الأزرار، يمكنك استخدام الحيلة التالية.

! تتيح لك هذه الدوال إرسال ملفات من أي نوع. التنسيقات الموصى بها: GIF، PDF، ZIP بحجم يصل إلى 2 جيجابايت.

tg_send_some_document(platform_id, document_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

المعلمات:

!** platform_id — معرف العميل في تيليجرام الذي يجب إرسال الرسالة إليه *

!** document_list - مصفوفة من المستندات. مثال على بناء هذه المصفوفة موضح أدناه

disable_notification — علامة للتحكم في الإشعارات الصوتية (الافتراضي: 0).
1 - إرسال بدون إشعار، 0 - إرسال مع إشعار

protect_content — علامة لحماية المحتوى من النسخ. للتفعيل، مرر أي قيمة غير 0 أو False أو علامات اقتباس فارغة ''.

reply_to_message_id - معرف الرسالة المراد الرد عليها (أي الاقتباس)

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)

مثال على بناء مصفوفة document_list:
'[["رابط المستند", "الوصف", "parse_mode"], ["رابط المستند 2"], ["رابط المستند 3", "الوصف"]]'

مثال على تنسيق البيانات لمستند واحد
["رابط المستند", "الوصف", "parse_mode"]

ترتيب المعلمات مهم! عند إنشاء مصفوفة المستندات، يمكن حذف علامات الاقتباس " ".

وصف معلمات مصفوفة document_list:
!** رابط المستند - رابط المستند من خادم تيليجرام. شرح الحصول على الرابط عبر tg_request موجود هنا
الوصف — وصف حتى 1024 حرفًا
parse_mode — تنسيق الوصف، أي تمييز النص بالغامق أو المائل ***

دعنا نستعرض مثالاً على إرسال مستند واحد، مع إضافة أزرار مضمنة ووصف للمستند:

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

2. أنشئ كتلة وقم بتعيين المتغيرات كما هو موضح في لقطة الشاشة:
   

   

3. أرسل الكتلة إلى أنفسنا وشاهد نتيجة عملنا:

الآن دعنا نلقي نظرة على إرسال عدة مستندات.

1. هنا أيضًا، تحتاج إلى الحصول على رابط تيليجرام داخلي لكل مستند وتشكيل مصفوفة.
   lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "المستند1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "المستند2"]]'
2. أخيرًا، قم بتجميع دالة إرسال المستندات:

3. وتحقق من نتيجة العمل:

تذكر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابطك الخاصة

مثال كود لإرسال مستند واحد:

lnkdoc= "BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ"
opts = {"inline_keyboard": [[{"text": "ممتاز","callback_data":"Answer1"}, {"text": "غير مقبول","callback_data":"Answer2"}]]}
soob=tg_send_document(platform_id, lnkdoc, "إرسال مستند", opts) 

مثال كود لإرسال عدة مستندات:

lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "المستند1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "المستند2"]]'
soob=tg_send_some_document(platform_id, lnkdoc)

! تتيح هذه الدالة إرسال ملفات صوتية من نوع .OGG مشفرة بـ OPUS، بحجم يصل إلى 2 جيجابايت.

! العمل فقط مع حساب تيليجرام التجاري

tg_send_voice(platform_id, voice, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, disable_notification, message_thread_id, entities)

المعلمات:

!** platform_id — معرف العميل في تيليجرام الذي يجب إرسال الرسالة إليه *

!** voice - رابط الرسالة الصوتية بتنسيق .OGG

caption - وصف حتى 1024 حرفًا

reply_markup — إعدادات الأزرار **

parse_mode — تنسيق النص في الوصف غامق أو مائل ***. القيم الممكنة: html، markdown، markdownV2.

reply_to_message_id - معرف الرسالة المراد الرد عليها (أي الاقتباس)

protect_content — علامة لحماية المحتوى من النسخ. للتفعيل، مرر أي قيمة غير 0 أو False أو علامات اقتباس فارغة ''.

disable_notification — علامة لإرسال الرسالة مع أو بدون إشعار صوتي (الافتراضي هو 0) 1 - تعطيل الإشعار عند الاستلام، 0 - إرسال مع إشعار

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة إذا كانت ميزة المنتدى مفعلة).

entities — باستخدام هذه المعلمة، يمكنك ببساطة نسخ النص المنسق بجميع ميزاته وتحديد من أي حرف إلى أي حرف سيتم عرضه بنمط معين. يمكنك التحقق من مثال في tg_request في الحقل المقابل. يجب أن تكون المعلمة قاموسًا.

مثال على تمرير المعلمة:
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"}]

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

لتبسيط وصف مجموعة الأزرار، يمكنك استخدام الحيلة التالية

! تتيح هذه الدالة إرسال ملفات صوتية من نوع .MP3 أو .M4A بحجم أقصى 2 جيجابايت.

! العمل مع حساب تيليجرام التجاري

tg_send_some_audio(platform_id, audio_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

المعلمات:

!** platform_id — معرف العميل في تيليجرام الذي يجب إرسال الرسالة إليه *

!** audio_list - مصفوفة من الملفات الصوتية (التفاصيل أدناه)

disable_notification — علامة لإرسال الرسالة مع أو بدون إشعار صوتي (الافتراضي: 0). 1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

protect_content — علامة لحماية المحتوى من النسخ. للتفعيل، مرر أي قيمة غير 0 أو False أو علامات اقتباس فارغة ''.

reply_to_message_id - معرف الرسالة المراد الرد عليها (أي الاقتباس)

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)

مثال على بناء مصفوفة audio_list:
'[["رابط الصوت 1", "الوصف", "parse_mode"], ["رابط الصوت 2"], ["رابط الصوت 3", "الوصف"]]'

مثال على صوت واحد:
["رابط الصوت", "الوصف", "parse_mode"]

ترتيب المعلمات مهم! عند بناء مصفوفة الملفات الصوتية، يمكن حذف علامات الاقتباس ""

وصف المعلمات:
!** رابط الصوت - رابط ملف صوتي بتنسيق .OGG
الوصف — وصف (حتى 1024 حرفًا)
parse_mode — تنسيق النص في الوصف غامق أو مائل ***

كما هو مذكور أعلاه، تعمل الدالة مع ملفات .OGG. لذلك، المهمة الأولى هي الحصول على تسجيل صوتي بهذا التنسيق.
إذا كان لديك ملف .MP3، يمكنك تحويله إلى .OGG باستخدام البوت https://t.me/mp3toolsbot.

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

الآن قم بتجميع الدالة:

رائع! أحسنت!

تذكر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابطك الخاصة

tg_send_voice(platform_id, "CQACAgIAAxkBAAER70Bi8VkgNhegB-msqDWXm2qHi3n9-AAC-iAAAk6giUvIXkW-XzBN0ikE")

إذا فشل إرسال رسالة بسبب إعدادات الخصوصية، يتم إرجاع الخطأ التالي:

{"ok":false,"error_code":400,"description":"Bad Request: user restricted receiving of voice messages"}

سبب الخطأ: تحتوي إعدادات الخصوصية للمستخدم على خيار "عدم استقبال الرسائل الصوتية" (إما من الجميع، أو السماح فقط لمستخدمين معينين):

حتى إذا قام المستخدم بتعطيل هذا القيد الخصوصي، سيستمر ظهور الخطأ.

! تتيح هذه الوظيفة إرسال صور GIF أو فيديو H.264/MPEG-4 AVC بدون صوت بحجم أقصى 2 جيجابايت.

! العمل مع حساب Telegram التجاري

tg_send_animation(platform_id, animation, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media)

المعلمات:

!** platform_id** — معرف عميل Telegram الذي يجب إرسال الرسالة إليه. *

!** animation** - رابط الرسم المتحرك. كيفية الحصول على رابط عبر tg_request موضحة هنا

caption - وصف يصل إلى 1024 حرفًا

reply_markup — تكوين الأزرار **

parse_mode — تنسيق النص في الوصف عريض أو مائل *****. القيم الممكنة: html, markdown, markdownV2

reply_to_message_id - معرف الرسالة المراد الرد عليها (أي الاقتباس)

protect_content — علامة لحماية المحتوى من النسخ. للتفعيل، مرر أي قيمة غير 0 أو False أو علامات اقتباس فارغة ''.

has_spoiler — تفعيل المفسد. للتفعيل، اضبط على True.

disable_notification — علامة لإرسال الرسالة مع أو بدون إشعار صوتي (الافتراضي: 0). 1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)

entities — باستخدام هذه المعلمة، يمكنك ببساطة نسخ النص المنسق بكل ميزاته وتحديد من أي حرف إلى أي حرف سيتم عرضه بنمط معين. يمكنك التحقق من مثال في tg_request في الحقل المقابل. يجب أن تكون المعلمة قاموسًا.

show_caption_above_media - إذا تم ضبطه على True، سيتم عرض وصف الرسالة فوق الوسائط

مثال على تمرير المعلمة:
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 الداخلي للرسم المتحرك المحدد (التفاصيل هنا).

أخيرًا، قم بتجميع الوظيفة:

وتحقق من نتيجة العمل:

تذكر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابطك الخاصة

animation="CgACAgIAAxkBAAIQDWO9Dbb0QODBmI_CUMhKHoWch7MDAAJBIQACtjXoScUjA-n5kGCYLQQ"
caption = "Happy New Year!"
soob=tg_send_animation(platform_id, animation, caption, None, None, None, True,True)

! تتيح هذه الوظيفة إرسال ملفات MPEG4 بحجم يصل إلى 2 جيجابايت.
(يمكن إرسال التنسيقات الأخرى كملفات باستخدام tg_send_document())

! العمل مع حساب Telegram التجاري

tg_send_video(platform_id, video, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media, cover)

المعلمات:

!** platform_id** — معرف عميل Telegram الذي يجب إرسال الرسالة إليه *

!** video** - رابط الفيديو. كيفية الحصول على الروابط عبر tg_request انظر هنا

caption - وصف يصل إلى 1024 حرفًا

reply_markup — إعدادات الأزرار **

parse_mode — تنسيق النص في الوصف عريض أو مائل *****. القيم الممكنة: html, markdown, markdownV2.

reply_to_message_id - معرف الرسالة المراد الرد عليها (أي الاقتباس)

protect_content — علامة لحماية المحتوى من النسخ. للتفعيل، مرر أي قيمة غير 0 أو False أو علامات اقتباس فارغة ''.

has_spoiler — تفعيل المفسد. للتفعيل، اضبط على True

disable_notification — علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)

entities — باستخدام هذه المعلمة، يمكنك ببساطة نسخ النص المنسق بكل ميزاته وتحديد من أي حرف إلى أي حرف سيتم عرضه بنمط معين. يمكنك التحقق من مثال في tg_request في الحقل المقابل. يجب أن تكون المعلمة قاموسًا.

show_caption_above_media - إذا تم ضبطه على True، سيتم عرض نص الرسالة فوق الوسائط.

cover - صورة غلاف الفيديو في الرسالة. الحصول على URL عبر tg_request موجود هنا.

مثال على تمرير المعلمة:
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 التجاري

tg_send_some_video(platform_id, video_list, disable_notification, protect_content, reply_to_message_id, has_spoiler, message_thread_id)

المعلمات:

!** platform_id** — معرف عميل Telegram الذي يجب إرسال الرسالة إليه *

!** video_list** - مصفوفة من ملفات الفيديو (التفاصيل أدناه)

disable_notification — علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

reply_to_message_id - معرف الرسالة المراد الرد عليها (أي الاقتباس)

has_spoiler — تفعيل تنسيق المفسد (اختياري؛ اضبط على True للتفعيل)

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)

مثال على بناء مصفوفة فيديو video_list:
'[["Video link1", "caption", "parse_mode"], ["Video link2"], ["Video link3", "caption"]]'

مثال على بناء صوت واحد:
["Video link", "caption", "parse_mode"]

ترتيب المعلمات مهم! عند بناء مصفوفة ملفات الفيديو، يمكن حذف علامات الاقتباس ""

وصف المعلمات: \ !** Video link** — رابط فيديو Telegram الداخلي. الحصول على الرابط عبر tg_request موصوف هنا.
caption — نص وصفي يصل إلى 1024 حرفًا
parse_mode — تنسيق النص في الوصف عريض أو مائل *****. القيم الممكنة: html, markdown, markdownV2.

لذا، ابدأ بالحصول على رابط الملف الذي نريد إرساله، ثم املأ معلمات الوظيفة المطلوبة:

بعد التحقق، نحصل على الفيديو:

تذكر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابطك الخاصة

video="BAACAgIAAxkBAAIQFmO9Ycbt5JDIr9HKQh-XkhS9FqTxAALQIwACtjXoSXKlqfbH-I_gLQQ"
soob=tg_send_video(platform_id, video

! بدءًا من الإصدار 4.0، يدعم Telegram إرسال مقاطع فيديو MPEG4 دائرية بمدة تصل إلى دقيقة واحدة.

! العمل مع حساب Telegram التجاري

tg_send_video_note(platform_id, video_note, reply_markup, protect_content, reply_to_message_id, disable_notification, message_thread_id)

المعلمات:

!** platform_id** — معرف عميل Telegram الذي يجب إرسال الرسالة إليه *

!** video_note** - رابط الفيديو. كيفية الحصول على الرابط عبر tg_request موصوفة هنا
reply_markup — إعدادات الأزرار **

protect_content — علامة لحماية المحتوى من النسخ. للتفعيل، مرر أي قيمة غير 0 أو False أو علامات اقتباس فارغة ''

reply_to_message_id - معرف الرسالة المراد الرد عليها (أي الاقتباس)

disable_notification — علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)

لتبسيط أوصاف مجموعات الأزرار، يمكنك استخدام الحيلة التالية

إذا كان لديك فيديو مربع، يمكنك تحويله إلى فيديو دائري باستخدام البوت https://t.me/roundNoteBot:

بمجرد حصولك على الفيديو الدائري، أرسله إلى نفسك في البوت للحصول على الرابط (التفاصيل هنا)، ثم قم بإعداد الوظيفة لإرسال الفيديو الدائري:

تذكر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابطك الخاصة

tg_send_video_note(platform_id, 'DQACAgIAAxkBAAER6cVi6OzIezJo9FWu6WyZPzDgQX8B3QACcxsAArR3SUtRizDeiHWLNikE','','1')

! العمل مع حساب Telegram التجاري

tg_send_venue(platform_id, latitude, longitude, title, address, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

المعلمات:

! platform_id — معرف عميل Telegram الذي يجب إرسال الرسالة إليه *

! latitude — خط العرض

! longitude — خط الطول

! title — العنوان

! address — العنوان

protect_content — علامة لحماية المحتوى من النسخ. للتفعيل، مرر أي قيمة غير 0 أو False أو علامات اقتباس فارغة ''

disable_notification — علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

reply_to_message_id - معرف الرسالة المراد الرد عليها (أي الاقتباس)

reply_markup — إعدادات الأزرار **

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)

لتبسيط أوصاف مجموعة الأزرار، يمكنك استخدام الحيلة التالية

لذا، لنبدأ بتحديد إحداثيات المكان. يمكنك الحصول عليها باستخدام خرائط Google

بعد ذلك، قم بتحويل الإحداثيات التي تم الحصول عليها من الدرجات العشرية إلى التنسيق الجغرافي باستخدام أي محول إحداثيات عبر الإنترنت:

الآن، لننتقل إلى ملء معلمات الدالة والحصول على النتيجة المرجوة:

soob=tg_send_venue(platform_id, "48°52′", "2°4′", "Dreams come true!", "Paris, Eiffel Tower") 

! العمل مع حساب Telegram للأعمال

يوفر Telegram طريقة سريعة لمشاركة جهات الاتصال من دفتر العناوين الخاص بك. يدعم المراسل إرسال vCard — بطاقة عمل إلكترونية

تتيح الدالة tg_send_contact إرسال رقم هاتف مع الاسم الأول (أو اسم المؤسسة)، بالإضافة إلى إضافة أزرار وتمكين حماية المحتوى للرسالة.

tg_send_contact(platform_id, phone, first_name, last_name, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

! - معلمة دالة إلزامية

المعلمات:

! platform_id — معرف عميل Telegram الذي يجب إرسال الرسالة إليه *

! phone — رقم الهاتف بالتنسيق الدولي. على سبيل المثال، لروسيا: +7XXXXXXXXXX

! first_name و last_name - الاسم الأول واسم العائلة

protect_content — علامة لحماية المحتوى من النسخ. للتفعيل، مرر أي قيمة غير 0 أو False أو علامات اقتباس فارغة ''

disable_notification — علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

reply_to_message_id - معرف الرسالة المراد الرد عليها (أي الاقتباس)

reply_markup — إعدادات الأزرار **

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)

لتبسيط أوصاف مجموعة الأزرار، يمكنك استخدام الحيلة التالية

املأ المعلمات: رقم الهاتف والاسم الأول واسم العائلة.

تحقق من النتيجة:

soob=tg_send_contact(platform_id, "+79999999999", "Ann", "Test", 1) 

! العمل مع حساب Telegram للأعمال

tg_send_sticker(platform_id, sticker_id, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

المعلمات:

! platform_id — معرف عميل Telegram الذي يجب إرسال الرسالة إليه *

! sticker_id - معرف الملصق. كيفية الحصول على رابط عبر tg_request موضحة هنا

protect_content — علامة لحماية المحتوى من النسخ. للتفعيل، مرر أي قيمة غير 0 أو False أو علامات اقتباس فارغة ''

disable_notification — علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

reply_to_message_id - معرف الرسالة المراد الرد عليها (أي الاقتباس)

reply_markup — إعدادات الأزرار **

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)

لتبسيط أوصاف مجموعة الأزرار، يمكنك استخدام الحيلة التالية

إرسال ملصق لا يختلف عن إرسال أي مرفق آخر:\

1. احصل على رابط Telegram الداخلي (التفاصيل هنا) \
2. املأ معلمات الدالة\
3. أرسل الكتلة إلى نفسك وتحقق من النتيجة

النتيجة:

تذكر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابطك الخاصة

soob=tg_send_sticker(platform_id, 'CAACAgIAAxkBAAEawJ5jmNeyat8uPGBMP3JzubRNXGjH3wACrw4AAsYg4UqePobN94_jkywE')

! يجب ألا يزيد حجم الصورة عن 10 ميغابايت. يجب ألا يتجاوز إجمالي العرض والارتفاع 10000 بكسل. يجب ألا تتجاوز نسبة العرض إلى الارتفاع 20.

! العمل مع حساب Telegram للأعمال

tg_send_photo(platform_id, photo, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media)

المعلمات:

! platform_id — معرف عميل Telegram الذي يجب إرسال الرسالة إليه *

! photo - رابط الصورة. كيفية الحصول على رابط عبر tg_request موضحة هنا.

caption - وصف يصل إلى 1024 حرفًا

reply_markup — إعدادات الأزرار **

parse_mode — تنسيق النص في التعليق عريض أو مائل ***

reply_to_message_id - معرف الرسالة المراد الرد عليها (أي الاقتباس)

protect_content — علامة لحماية المحتوى من النسخ. للتفعيل، مرر أي قيمة غير 0 أو False أو علامات اقتباس فارغة ''

has_spoiler — يتيح تنسيق المفسد، اضبط على True للتفعيل

disable_notification — علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)

entities — باستخدام هذه المعلمة، يمكنك ببساطة نسخ النص المنسق بجميع ميزاته وتحديد من أي حرف إلى أي حرف سيتم عرضه بنمط معين. يمكنك التحقق من مثال في tg_request في الحقل المقابل. يجب أن تكون المعلمة قاموسًا.

show_caption_above_media - إذا تم ضبطه على True، فسيتم عرض نص الرسالة فوق الوسائط

مثال على إرسال المعلمة:
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"}]

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

لتبسيط أوصاف مجموعة الأزرار، يمكنك استخدام الحيلة التالية

! يجب ألا يزيد حجم الصورة عن 10 ميغابايت. يجب ألا يتجاوز إجمالي العرض والارتفاع 10000 بكسل. يجب ألا تتجاوز نسبة العرض إلى الارتفاع 20.

! العمل مع حساب Telegram للأعمال

tg_send_some_photo(platform_id, image_list, disable_notification=0, protect_content=False, reply_to_message_id=0, has_spoiler=False,message_thread_id)

المعلمات:

! platform_id — معرف عميل Telegram الذي يجب إرسال الرسالة إليه *

! image_list - مصفوفة ملفات الصور (التفاصيل أدناه)

disable_notification — علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

protect_content — علامة لحماية المحتوى من النسخ (معلمة اختيارية، للتفعيل مرر 1 كقيمة)

reply_to_message_id - معرف الرسالة المراد الرد عليها (أي الاقتباس)

has_spoiler — يتيح تنسيق المفسد (اختياري؛ اضبط على True للتفعيل)

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)

مثال image_list:

'[["رابط الصورة 1", "تعليق", "parse_mode"], ["رابط الصورة 2"], ["رابط الصورة 3", "تعليق"]]'

مثال بيانات لصورة واحدة:
["رابط الصورة 1", "تعليق", "parse_mode"]

ترتيب المعلمات مهم! عند إنشاء مصفوفة ملفات الصور، يمكن حذف علامات الاقتباس ""

وصف المعلمات:

! رابط الصورة 1 - رابط الصورة. كيفية الحصول على رابط عبر tg_request موضحة هنا

تعليق — تعليق يصل إلى 1024 حرفًا

parse_mode — تنسيق النص في التعليق عريض أو مائل ***

لنلقِ نظرة على مثال لدالة إرسال صور متعددة:

أولاً، قم بإنشاء مصفوفة الصور

بعد ذلك، املأ معلمات الدالة

أرسل الكتلة إلى نفسك واستمتع بالنتيجة

تذكر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابط خاصة بك للفيديو

image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)

tg_send_dice(platform_id, emoji, reply_markup, disable_notification, reply_to_message_id, protect_content, message_thread_id)

! يعمل مع حساب Telegram للأعمال

المعلمات:

! platform_id — معرف عميل Telegram الذي يجب إرسال الرسالة إليه *

emoji - الرمز التعبيري الذي سيتم إرساله. إذا تركت المعلمة فارغة، سيتم إرسال نرد افتراضيًا. يمكنك تمرير الرمز التعبيري نفسه كسلسلة نصية أو الكلمة المفتاحية المستخدمة لتمثيله

reply_markup — إعداد الأزرار **

disable_notification — علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

reply_to_message_id - معرف الرسالة للرد عليها (أي الاقتباس)

protect_content — علامة لحماية المحتوى من النسخ. للتفعيل، مرر أي قيمة غير 0 أو False أو علامات اقتباس فارغة ''

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)

لتبسيط أوصاف مجموعة الأزرار، يمكنك استخدام الحيلة التالية

قائمة الرموز التعبيرية الممكنة: \

1. 'darts' أو '🎯'، القيم من 1 إلى 6 \
2. 'dice' أو '🎲'، القيم من 1 إلى 6 \
3. 'bowling' أو '🎳'، القيم من 1 إلى 6 \
4. 'basketball' أو '🏀'، القيم من 1 إلى 5 \
5. 'football' أو '⚽'، القيم من 1 إلى 5 \
6. 'slots' أو '🎰'، القيم من 1 إلى 64

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

الخيار الأبسط هو استدعاء الدالة بمعامل واحد مطلوب فقط:

في هذه الحالة، سيتلقى العميل نردًا:

إذا قام العميل برمي النرد (بالنقر على الرمز التعبيري المستلم)، سيتلقى البوت رد اتصال بعدد النقاط التي تم رميها:

يمكنك تجربة هذه الدالة. على سبيل المثال، لنقم بإنشاء آلة سلوت وإضافة زر النقاط. عند الضغط على الزر، سنتلقى إجمالي نقاط العميل:

المثال الأول:

soob=tg_send_dice(platform_id)

المثال الثاني:

/* المثال الأول */
tg_send_message(platform_id,'انقر على آلة السلوت لتجربة حظك!')
opts='{"inline_keyboard": [[{"text": " 👓 ","callback_data":"Play"}]]}'
soob=tg_send_dice(platform_id, 'slots', opts)

/* الكتلة الثانية - رسالة نصية */
 #{res[1]} نقطة تم رميها
/* الكتلة الثانية - آلة حاسبة */
res=splitter('#{question}', ' ')
balls=if(balls==None,0,balls) + int(res[1])

/* الكتلة الثالثة - رسالة نصية */
لديك إجمالي #{balls} نقطة

! يعمل مع حساب Telegram للأعمال

طريقة لإرسال مجموعة من الصور أو مقاطع الفيديو أو المستندات أو الملفات الصوتية كألبوم. عند النجاح، يتم إرجاع مصفوفة من الملفات المرسلة.

ملاحظة: لا يمكن تجميع المستندات والملفات الصوتية مع أنواع الملفات الأخرى!

tg_send_media_group(platform_id, media_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

المعلمات:

! platform_id — معرف عميل Telegram الذي يجب إرسال الرسالة إليه

! media_list - مصفوفة تحتوي على من 2 إلى 10 صور أو مقاطع فيديو أو مستندات أو ملفات صوتية (التفاصيل أدناه)؛

disable_notification — علامة لإرسال الرسالة مع إشعار صوتي (الافتراضي: 0).
1 — إرسال بدون إشعار، 0 — إرسال مع إشعار

protect_content — علامة لحماية المحتوى من النسخ. للتفعيل، مرر أي قيمة غير 0 أو False أو علامات اقتباس فارغة ''

reply_to_message_id - معرف الرسالة للرد عليها (أي الاقتباس)

message_thread_id — معرف الموضوع (متاح في المجموعات الفائقة مع وظيفة المنتدى)؛

محتوى عناصر مصفوفة media_list:

! type - نوع الملف، "photo" أو "video" أو "audio" أو "document"

! media - الملف المراد إرساله. مرر file_id لإرسال ملف موجود بالفعل على خوادم Telegram (موصى به)، أو عنوان URL HTTP ليحصل Telegram على الملف من الإنترنت، أو «attach://<file_attach_name>» لتحميل ملف جديد باستخدام multipart/form-data بالاسم <file_attach_name>.

اقرأ المزيد: https://core.telegram.org/bots/api#sending-files

caption — عنوان الملف المرسل، 0–1024 حرفًا.

parse_mode — تنسيق النص في التسمية التوضيحية عريض أو مائل

اقرأ المزيد: https://core.telegram.org/bots/api#sending-files

مثال على مصفوفة media_list:

[{"type": "photo", "media": "AgACAgIAAxkBAAIKa2W6HqQG151EaWOKnCyy8feBi8p_AAIH1zEbicvYSfi2QYj-CMreAQADAgADeAADNAQ", "caption": "فيديو أشباح"}, {"type": "video", "media": "BAACAgIAAxkBAAIKpGW6P_HGDoVz7u4blDF6925WO-hmAALVPQACicvYSYwIWCJKwKIWNAQ", "caption": "فيديو أرنب"}]

لنلقِ نظرة على مثال لدالة إرسال صور متعددة:

أولاً، قم بإنشاء مصفوفة صور

بعد ذلك، املأ معلمات الدالة

أرسل الكتلة إلى نفسك واستمتع بالنتيجة

تذكر أن الروابط فريدة لكل بوت، لذا تأكد من إنشاء روابط خاصة بك للفيديو

image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)

في Telegram (لكل من حسابات الأعمال والحسابات العادية)، يمكنك إرسال المرفقات عبر رابط:

1. يمكنك إرسال مرفقات من أي حجم، متجاوزًا حدود حجم الملف.
2. يمكنك أيضًا إرسال أي نوع من المرفقات التي تحتاجها.

كيفية القيام بذلك:

انسخ الرابط إلى مرفق متاح بالفعل للجمهور:

ثم، الصق الرابط المنسوخ في دالة المرفق في الكتلة الخاصة بك:

تم. بهذه الطريقة، يمكنك إرسال مرفقات من أي نوع وحجم.