Хабарламаларға тіркемелер жіберу функциялары

! Бұл функциялар кез келген типтегі файлдарды жіберуге мүмкіндік береді. Ұсынылатын форматтар: GIF, PDF, ZIP өлшемі 2 ГБ дейін.

! Telegram бизнес-аккаунтымен жұмыс

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 — хабарлама жіберілуі тиіс Telegram-дағы клиент идентификаторы *

! document — Telegram серверіндегі құжатқа сілтеме. tg_request арқылы сілтемені алу осында түсіндірілген.

caption — сипаттама, 1024 таңбаға дейін

reply_markup — түйме параметрлері **

parse_mode — сипаттамадағы мәтінді пішімдеу (қалың немесе курсив) ***. Мүмкін мәндер: html, markdown, markdownV2. сілтеме

reply_to_message_id - жауап берілетін хабарламаның 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 — хабарлама жіберілуі тиіс Telegram-дағы клиент идентификаторы *

! document_list - құжаттар массиві. Мұндай массивті құру мысалы төменде келтірілген

disable_notification — дыбыстық хабарландыруды басқару жалаушасы (әдепкі: 0).
1 - хабарландырусыз жіберу, 0 - хабарландырумен жіберу

protect_content — мазмұнды көшіруден қорғау жалаушасы. Қосу үшін 0, False немесе бос тырнақша '' мәнінен басқа кез келген мәнді беріңіз.

reply_to_message_id - жауап берілетін хабарламаның ID (яғни, дәйексөз)

message_thread_id — тақырып идентификаторы (форум функционалы бар супертоптарда қолжетімді)

document_list массивін құру мысалы:
'[["Құжат сілтемесі", "сипаттама", "parse_mode"], ["Құжат сілтемесі 2"], ["Құжат сілтемесі 3", "сипаттама"]]'

Бір құжат үшін деректерді пішімдеу мысалы
["Құжат сілтемесі", "сипаттама", "parse_mode"]

Параметрлердің реті маңызды! Құжаттар массивін жасау кезінде тырнақшаларды " " алып тастауға болады.

document_list массиві үшін параметрлердің сипаттамасы:
! Құжат сілтемесі - Telegram серверінен алынған құжат сілтемесі. tg_request арқылы сілтемені алу осында түсіндірілген
caption — 1024 таңбаға дейінгі сипаттама
parse_mode — сипаттаманы пішімдеу, яғни мәтінді қалың немесе курсивпен бөлектеу ***

Бір құжатты жіберу, құжатқа инлайн түймелер мен сипаттама қосу мысалын қарастырайық:

1. Алдымен, құжатыңызға сілтеме алыңыз. Мұны қалай жасау керектігі туралы егжей-тегжейлі түсініктемені осы жерден табуға болады.

2. Скриншотта көрсетілгендей блок жасаңыз және айнымалыларды орнатыңыз:
   

   

3. Блокты өзімізге жіберіп, жұмысымыздың нәтижесін көреміз:

Енді бірнеше құжатты жіберуді қарастырайық.

1. Мұнда да әрбір құжат үшін ішкі Telegram сілтемесін алып, массив құру керек.
   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)

! Бұл функция OPUS кодекімен кодталған .OGG типіндегі дауыстық файлдарды, өлшемі 2 ГБ дейін жіберуге мүмкіндік береді.

! Тек Telegram бизнес-аккаунтымен жұмыс істейді

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 — хабарлама жіберілуі тиіс Telegram-дағы клиент идентификаторы *

! voice - .OGG форматындағы дауыстық хабарламаға сілтеме

caption - 1024 таңбаға дейінгі сипаттама

reply_markup — түйме параметрлері **

parse_mode — сипаттамадағы мәтінді пішімдеу (қалың немесе курсив) ***. Мүмкін мәндер: html, markdown, markdownV2.

reply_to_message_id - жауап берілетін хабарламаның 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 ГБ дейін жіберуге мүмкіндік береді.

! Telegram бизнес-аккаунтымен жұмыс істейді

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

Параметрлер:

! platform_id — хабарлама жіберілуі тиіс Telegram-дағы клиент идентификаторы *

! audio_list - аудио файлдар массиві (төменде егжей-тегжейлі)

disable_notification — хабарламаны дыбыстық хабарландырумен немесе онсыз жіберу жалаушасы (әдепкі: 0). 1 — хабарландырусыз жіберу, 0 — хабарландырумен жіберу

protect_content — мазмұнды көшіруден қорғау жалаушасы. Қосу үшін 0, False немесе бос тырнақша '' мәнінен басқа кез келген мәнді беріңіз.

reply_to_message_id - жауап берілетін хабарламаның ID (яғни, дәйексөз)

message_thread_id — тақырып ID (форум функционалы бар супертоптарда қолжетімді)

audio_list массивін құру мысалы:
'[["Аудио сілтемесі 1", "сипаттама", "parse_mode"], ["Аудио сілтемесі 2"], ["Аудио сілтемесі 3", "сипаттама"]]'

Бір аудио мысалы:
["Аудио сілтемесі", "сипаттама", "parse_mode"]

Параметрлердің реті маңызды! Аудио файлдар массивін құру кезінде тырнақшаларды "" алып тастауға болады

Параметрлердің сипаттамасы:
! Аудио сілтемесі - .OGG форматындағы аудио файлға сілтеме
caption — сипаттама (1024 таңбаға дейін)
parse_mode — сипаттамадағы мәтінді пішімдеу (қалың немесе курсив) ***

Жоғарыда айтылғандай, функция .OGG файлдарымен жұмыс істейді. Сондықтан, бірінші міндет - осы форматтағы аудио жазбаны алу.
Егер сізде .MP3 файлы болса, оны https://t.me/mp3toolsbot боты арқылы .OGG форматына түрлендіруге болады.

Содан кейін, алынған файлды осы жерде сипатталған алгоритм бойынша 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"}

Қатенің себебі: пайдаланушының құпиялылық параметрлерінде "Дауыстық хабарламаларды қабылдамау" опциясы бар (барлығынан немесе тек белгілі бір пайдаланушыларға рұқсат ету):

Пайдаланушы бұл құпиялылық шектеуін өшірсе де, қате пайда бола береді.

! Бұл функция максималды өлшемі 2 ГБ болатын GIF немесе H.264/MPEG-4 AVC дыбыссыз бейнені жіберуге мүмкіндік береді.

! Telegram business-аккаунтымен жұмыс

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)

! Бұл функция өлшемі 2 ГБ-қа дейінгі MPEG4 файлдарын жіберуге мүмкіндік береді.
(Басқа пішімдерді tg_send_document() көмегімен файлдар ретінде жіберуге болады)

! Telegram business-аккаунтымен жұмыс

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 - хабарламадағы бейненің мұқаба суреті. tg_request арқылы URL алу осында.

Параметрді беру мысалы:
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-аккаунтымен жұмыс

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 бейне URL-і. 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 business-аккаунтымен жұмыс

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 business-аккаунтымен жұмыс

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 Maps көмегімен алуға болады

Әрі қарай, алынған координаттарды ондық градустан географиялық форматқа кез келген онлайн координаттар түрлендіргішін пайдаланып түрлендіріңіз:

Енді функция параметрлерін толтыруға және қажетті нәтижені алуға көшейік:

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

! Telegram business - аккаунтпен жұмыс

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 business - аккаунтпен жұмыс

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 МБ-тан аспауы керек. Жалпы ені мен биіктігі 10 000 пиксельден аспауы керек. Еннің биіктікке қатынасы 20-дан аспауы керек.

! Telegram business - аккаунтпен жұмыс

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 МБ-тан аспауы керек. Жалпы ені мен биіктігі 10 000 пиксельден аспауы керек. Еннің биіктікке қатынасы 20-дан аспауы керек.

! Telegram business-аккаунтпен жұмыс

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 мысалы:

'[["Image link 1", "caption", "parse_mode"], ["Image link 2"], ["Image link 3", "caption"]]'

Бір суретке арналған деректер мысалы:
["Image link 1", "caption", "parse_mode"]

Параметрлердің реті маңызды! Сурет файлдарының массивін құру кезінде "" тырнақшаларын алып тастауға болады

Параметрлердің сипаттамасы:

! Image link 1 - сурет сілтемесі. tg_request арқылы сілтемені қалай алуға болатыны осында түсіндірілген

caption — 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 - жіберілетін файл. Telegram серверлерінде бұрыннан бар файлды жіберу үшін file_id (ұсынылады), Telegram файлды Интернеттен алуы үшін HTTP URL немесе «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": "ghosts video"}, {"type": "video", "media": "BAACAgIAAxkBAAIKpGW6P_HGDoVz7u4blDF6925WO-hmAALVPQACicvYSYwIWCJKwKIWNAQ", “caption”: “hare video”}]

Бірнеше суретті жіберу функциясының мысалын қарастырайық:

алдымен суреттер массивін жасаңыз

Содан кейін функция параметрлерін толтырыңыз

Блокты өзіңізге жіберіп, нәтижені тамашалаңыз

Есіңізде болсын, сілтемелер әр бот үшін бірегей, сондықтан бейне үшін өз сілтемелеріңізді жасаңыз

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. Сондай-ақ қажетті кез келген тіркеме түрін жібере аласыз.

Қалай жасау керек:

Қоғамдық қолжетімді тіркемеге сілтемені көшіріңіз:

Содан кейін көшірілген сілтемені блоктағы тіркеме функциясына қойыңыз:

Дайын. Осылайша сіз кез келген түрдегі және өлшемдегі тіркемелерді жібере аласыз.