Fungsi untuk menghantar lampiran dalam mesej

! Fungsi ini membolehkan anda menghantar fail dari sebarang jenis. Format yang disyorkan: GIF, PDF, ZIP sehingga 2GB.

! Berfungsi dengan akaun perniagaan Telegram

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

Parameter:

! platform_id — pengecam pelanggan dalam Telegram yang mesti dihantar mesej *

! document - pautan ke dokumen pada pelayan Telegram. Mendapatkan pautan melalui tg_request diterangkan di sini.

caption - penerangan, sehingga 1024 aksara

reply_markup — tetapan butang **

parse_mode — pemformatan teks dalam kapsyen (tebal atau condong) ***. Nilai yang mungkin: html, markdown, markdownV2. pautan

reply_to_message_id - ID mesej untuk dibalas (iaitu, petikan)

protect_content — bendera untuk melindungi kandungan daripada penyalinan. Untuk mendayakan, hantar sebarang nilai selain 0, False, atau petikan kosong ''.

disable_notification — bendera untuk mengawal pemberitahuan bunyi (lalai: 0).
1 - hantar tanpa pemberitahuan, 0 - hantar dengan pemberitahuan

message_thread_id — pengecam utas (tersedia dalam kumpulan super dengan fungsi forum)

entities — membolehkan anda menggunakan semula teks pra-format dengan gaya. Hanya takrifkan ofset aksara dan julat untuk pemformatan. Contoh tersedia dalam tg_request di bawah medan yang sepadan. Perlu menjadi kamus.

Contoh menghantar parameter:
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"}]

Dalam contoh ini, hanya kamus ditunjukkan, manakala teks mesej sebenar ditakrifkan dalam pembolehubah berasingan.

Untuk memudahkan penerangan set butang, anda boleh menggunakan lifehack berikut.

! Fungsi ini membolehkan anda menghantar fail dari sebarang jenis. Format yang disyorkan: GIF, PDF, ZIP sehingga 2GB.

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

Parameter:

! platform_id — pengecam pelanggan dalam Telegram yang mesti dihantar mesej *

! document_list - tatasusunan dokumen. Contoh membina tatasusunan sedemikian disediakan di bawah

disable_notification — bendera untuk mengawal pemberitahuan bunyi (lalai: 0).
1 - hantar tanpa pemberitahuan, 0 - hantar dengan pemberitahuan

protect_content — bendera untuk melindungi kandungan daripada penyalinan. Untuk mendayakan, hantar sebarang nilai selain 0, False, atau petikan kosong ''.

reply_to_message_id - ID mesej untuk dibalas (iaitu, petikan)

message_thread_id — pengecam utas (tersedia dalam kumpulan super dengan fungsi forum)

Contoh membina tatasusunan document_list:
'[["Pautan dokumen", "kapsyen", "parse_mode"], ["Pautan dokumen 2"], ["Pautan dokumen 3", "kapsyen"]]'

Contoh pemformatan data untuk satu dokumen
["Pautan dokumen", "kapsyen", "parse_mode"]

Urutan parameter adalah penting! Semasa membuat tatasusunan dokumen, tanda petikan " " boleh diabaikan.

Penerangan parameter untuk tatasusunan document_list:
! Pautan dokumen - pautan dokumen dari pelayan Telegram. Mendapatkan pautan melalui tg_request diterangkan di sini
caption — penerangan sehingga 1024 aksara
parse_mode — pemformatan penerangan, iaitu menyerlahkan teks dalam huruf tebal atau condong ***

Mari kita lihat contoh menghantar satu dokumen, menambah butang sebaris dan penerangan pada dokumen:

1. Mula-mula, dapatkan pautan ke dokumen anda. Penjelasan terperinci tentang cara melakukan ini boleh didapati di sini.

2. Cipta blok dan tetapkan pembolehubah seperti yang ditunjukkan dalam tangkapan skrin:
   

   

3. Hantar blok kepada diri sendiri dan lihat hasil kerja kami:

Sekarang mari kita lihat menghantar berbilang dokumen.

1. Di sini juga, anda perlu mendapatkan pautan Telegram dalaman untuk setiap dokumen dan membentuk tatasusunan.
   lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'
2. Akhir sekali, susun fungsi untuk menghantar dokumen:

3. Dan lihat hasil kerja:

Ingat bahawa pautan adalah unik untuk setiap bot, jadi pastikan anda menjana pautan anda sendiri

Contoh kod untuk menghantar satu dokumen:

lnkdoc= "BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ"
opts = {"inline_keyboard": [[{"text": "Excellent","callback_data":"Answer1"}, {"text": "Not accepted","callback_data":"Answer2"}]]}
soob=tg_send_document(platform_id, lnkdoc, "Document sending", opts) 

Contoh kod untuk menghantar beberapa dokumen:

lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'
soob=tg_send_some_document(platform_id, lnkdoc)

! Fungsi ini membolehkan menghantar fail suara jenis .OGG yang dikodkan dengan OPUS, sehingga 2 GB saiznya.

! Berfungsi hanya dengan akaun perniagaan Telegram

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

Parameter:

! platform_id — pengecam pelanggan dalam Telegram yang mesti dihantar mesej *

! voice - pautan ke mesej suara dalam format .OGG

caption - penerangan sehingga 1024 aksara

reply_markup — tetapan butang **

parse_mode — pemformatan teks dalam penerangan tebal atau condong ***. Nilai yang mungkin: html, markdown, markdownV2.

reply_to_message_id - ID mesej untuk dibalas (iaitu, petikan)

protect_content — bendera untuk melindungi kandungan daripada disalin. Untuk mendayakannya, hantar sebarang nilai kecuali 0, False, atau petikan kosong ''.

disable_notification — bendera untuk menghantar mesej dengan pemberitahuan bunyi (lalai ialah 0) 1 - lumpuhkan pemberitahuan apabila diterima, 0 - hantar dengan pemberitahuan

message_thread_id — pengecam topik (tersedia dalam kumpulan super jika ciri forum didayakan).

entities —dengan parameter ini anda boleh menyalin teks berformat dengan semua cirinya dan menentukan dari aksara mana ke aksara mana ia akan dipaparkan dengan gaya tertentu. Anda boleh menyemak contoh dalam tg_request dalam medan yang sepadan. Parameter mestilah kamus.

Contoh penghantaran parameter:
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"}]

Contoh menunjukkan hanya kamus, manakala teks mesej itu sendiri ditakrifkan dalam pembolehubah.

Untuk memudahkan penerangan set butang, anda boleh menggunakan lifehack berikut

! Fungsi ini membolehkan menghantar fail audio jenis .MP3 atau .M4A dengan saiz maksimum 2GB.

! Berfungsi dengan akaun perniagaan Telegram

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

Parameter:

! platform_id — pengecam pelanggan dalam Telegram yang mesti dihantar mesej *

! audio_list - tatasusunan fail audio (butiran di bawah)

disable_notification — bendera untuk menghantar mesej dengan atau tanpa pemberitahuan bunyi (lalai: 0). 1 — hantar tanpa pemberitahuan, 0 — hantar dengan pemberitahuan

protect_content — bendera untuk melindungi kandungan daripada penyalinan. Untuk mendayakan, hantar sebarang nilai kecuali 0, False, atau petikan kosong ''.

reply_to_message_id - ID mesej untuk dibalas (iaitu, petikan)

message_thread_id — ID topik (tersedia dalam kumpulan super dengan fungsi forum)

Contoh membina tatasusunan audio_list:
'[["Pautan audio 1", "kapsyen", "parse_mode"], ["Pautan audio 2"], ["Pautan audio 3", "kapsyen"]]'

Contoh audio tunggal:
["Pautan audio", "kapsyen", "parse_mode"]

Urutan parameter adalah penting! Semasa membina tatasusunan fail audio, petikan "" boleh diabaikan

Penerangan parameter:
! Pautan audio - pautan ke fail audio dalam format .OGG
caption — penerangan (sehingga 1024 aksara)
parse_mode —pemformatan teks dalam kapsyen tebal atau condong ***

Seperti yang dinyatakan di atas, fungsi berfungsi dengan fail .OGG. Oleh itu, tugas pertama adalah untuk mendapatkan rakaman audio dalam format ini.
Jika anda mempunyai fail **.**MP3, anda boleh menukarnya kepada **.**OGG menggunakan bot https://t.me/mp3toolsbot.

Seterusnya, hantar fail yang terhasil kepada diri sendiri dalam bot untuk mendapatkan file_id mengikut algoritma yang diterangkan di sini.

Sekarang susun fungsi:

Hebat! Syabas!

Ingat bahawa pautan adalah unik untuk setiap bot, jadi pastikan anda menjana pautan anda sendiri

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

Jika mesej gagal dihantar disebabkan tetapan privasi, ralat berikut dikembalikan:

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

Punca ralat: tetapan privasi pengguna mengandungi pilihan "Jangan terima mesej suara" (sama ada daripada semua orang, atau hanya membenarkan daripada pengguna tertentu):

Walaupun pengguna melumpuhkan sekatan privasi ini, ralat masih akan terus muncul.

! Fungsi ini membolehkan menghantar GIF atau video H.264/MPEG-4 AVC tanpa bunyi dengan saiz maksimum 2GB.

! Bekerja dengan akaun perniagaan 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)

Parameter:

!** platform_id** — ID klien Telegram yang mana mesej harus dihantar. *

!** animation**- pautan ke animasi. Cara mendapatkan pautan melalui tg_request diterangkan di sini

caption - penerangan sehingga 1024 aksara

reply_markup — konfigurasi butang **

parse_mode — pemformatan teks dalam kapsyen tebal atau condong *****. Nilai yang mungkin: html, markdown, markdownV2

reply_to_message_id - ID mesej untuk dibalas (iaitu, petikan)

protect_content — bendera untuk melindungi kandungan daripada penyalinan. Untuk mendayakan, hantar sebarang nilai selain 0, False, atau petikan kosong ''.

has_spoiler — mendayakan spoiler. Untuk mendayakan, tetapkan True.

disable_notification — bendera untuk menghantar mesej dengan atau tanpa pemberitahuan bunyi (lalai: 0). 1 — hantar tanpa pemberitahuan, 0 — hantar dengan pemberitahuan

message_thread_id — ID utas (tersedia dalam kumpulan super dengan fungsi forum)

entities — dengan parameter ini anda boleh menyalin teks berformat dengan semua cirinya dan menentukan dari aksara mana ke aksara mana ia akan dipaparkan dengan gaya tertentu. Anda boleh menyemak contoh dalam tg_request dalam medan yang sepadan. Parameter hendaklah kamus.

show_caption_above_media - jika ditetapkan kepada True, kapsyen mesej akan dipaparkan di atas media

Contoh penghantaran parameter:
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"}]

Dalam contoh ini, hanya kamus ditunjukkan, manakala teks mesej itu sendiri disimpan dalam pembolehubah

Untuk memudahkan penerangan set butang, anda boleh menggunakan lifehack berikut

Mari kita jadikan tugas lebih kompleks dan hantar animasi dengan perlindungan salin dan spoiler.

Seperti biasa, proses bermula dengan mendapatkan pautan Telegram dalaman untuk animasi yang dipilih (butiran di sini).

Akhirnya, susun fungsi:

Dan lihat hasil kerja:

Ingat bahawa pautan adalah unik untuk setiap bot, jadi pastikan anda menjana pautan anda sendiri

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

! Fungsi ini membolehkan anda menghantar fail MPEG4 sehingga saiz 2GB.
(Format lain boleh dihantar sebagai fail menggunakan tg_send_document())

! Bekerja dengan akaun perniagaan 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)

Parameter:

!** platform_id** — ID klien Telegram yang mana mesej harus dihantar *

!** video** - pautan video. Cara mendapatkan pautan melalui tg_request lihat di sini

caption - penerangan sehingga 1024 aksara

reply_markup — tetapan butang **

parse_mode — pemformatan teks dalam kapsyen tebal atau condong *****. Nilai yang mungkin: html, markdown, markdownV2.

reply_to_message_id - ID mesej untuk dibalas (iaitu, petikan)

protect_content — bendera untuk melindungi kandungan daripada penyalinan. Untuk mendayakan, hantar sebarang nilai selain 0, False, atau petikan kosong ''.

has_spoiler — mendayakan spoiler. Untuk mendayakan, tetapkan True

disable_notification — bendera untuk menghantar mesej dengan pemberitahuan bunyi (lalai: 0).
1 — hantar tanpa pemberitahuan, 0 — hantar dengan pemberitahuan

message_thread_id — ID utas (tersedia dalam kumpulan super dengan fungsi forum)

entities — dengan parameter ini anda boleh menyalin teks berformat dengan semua cirinya dan menentukan dari aksara mana ke aksara mana ia akan dipaparkan dengan gaya tertentu. Anda boleh menyemak contoh dalam tg_request dalam medan yang sepadan. Parameter hendaklah kamus.

show_caption_above_media - jika ditetapkan kepada True, teks mesej akan dipaparkan di atas media.

cover - imej kulit video dalam mesej. Mendapatkan URL melalui tg_request adalah di sini.

Contoh penghantaran parameter:
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"}]

Dalam contoh ini, hanya kamus ditunjukkan, manakala teks mesej itu sendiri disimpan dalam pembolehubah

Untuk memudahkan penerangan set butang, anda boleh menggunakan lifehack berikut

! Bekerja dengan akaun perniagaan Telegram

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

Parameter:

!** platform_id** — ID klien Telegram yang mana mesej harus dihantar *

!** video_list** - tatasusunan fail video (butiran di bawah)

disable_notification — bendera untuk menghantar mesej dengan pemberitahuan bunyi (lalai: 0).
1 — hantar tanpa pemberitahuan, 0 — hantar dengan pemberitahuan

reply_to_message_id - ID mesej untuk dibalas (iaitu, petikan)

has_spoiler — mendayakan pemformatan spoiler (pilihan; tetapkan kepada True untuk mengaktifkan)

message_thread_id — ID utas (tersedia dalam kumpulan super dengan fungsi forum)

Contoh membina tatasusunan video video_list:
'[["Pautan video1", "kapsyen", "parse_mode"], ["Pautan video2"], ["Pautan video3", "kapsyen"]]'

Contoh membina audio tunggal:
["Pautan video", "kapsyen", "parse_mode"]

Susunan parameter adalah penting! Semasa membina tatasusunan fail video, petikan "" boleh diabaikan

Penerangan parameter: \ !** Pautan video** — URL video Telegram dalaman. Mendapatkan pautan melalui tg_request diterangkan di sini.
caption — kapsyen teks sehingga 1024 aksara
parse_mode — pemformatan teks dalam kapsyen tebal atau condong *****. Nilai yang mungkin: html, markdown, markdownV2.

Jadi, mulakan dengan mendapatkan pautan ke fail yang ingin kami hantar, dan kemudian isikan parameter fungsi yang diperlukan:

Selepas menyemak, kami mendapat video:

Ingat bahawa pautan adalah unik untuk setiap bot, jadi pastikan anda menjana pautan anda sendiri

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

! Bermula dari versi 4.0, Telegram menyokong penghantaran video MPEG4 bulat dengan tempoh sehingga satu minit.

! Bekerja dengan akaun perniagaan Telegram

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

Parameter:

!** platform_id** — ID klien Telegram yang mana mesej harus dihantar *

!** video_note** - pautan video. Cara mendapatkan pautan melalui tg_request diterangkan di sini
reply_markup — tetapan butang **

protect_content — bendera untuk melindungi kandungan daripada penyalinan. Untuk mendayakan, hantar sebarang nilai selain 0, False, atau petikan kosong ''

reply_to_message_id - ID mesej untuk dibalas (iaitu, petikan)

disable_notification — bendera untuk menghantar mesej dengan pemberitahuan bunyi (lalai: 0).
1 — hantar tanpa pemberitahuan, 0 — hantar dengan pemberitahuan

message_thread_id — ID utas (tersedia dalam kumpulan super dengan fungsi forum)

Untuk memudahkan penerangan set butang, anda boleh menggunakan lifehack berikut

Jika anda mempunyai video segi empat sama, anda boleh menukarnya kepada video bulat menggunakan bot https://t.me/roundNoteBot:

Sebaik sahaja anda mempunyai video bulat, hantarkannya kepada diri sendiri dalam bot untuk mendapatkan pautan (butiran di sini), dan kemudian sediakan fungsi untuk menghantar video bulat:

Ingat bahawa pautan adalah unik untuk setiap bot, jadi pastikan anda menjana pautan anda sendiri

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

! Bekerja dengan akaun perniagaan Telegram

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

Parameter:

! platform_id — ID klien Telegram yang mana mesej harus dihantar *

! latitude — latitud

! longitude — longitud

! title — tajuk

! address — alamat

protect_content — bendera untuk melindungi kandungan daripada penyalinan. Untuk mengaktifkan, hantar sebarang nilai selain 0, False, atau petikan kosong ''

disable_notification — bendera untuk menghantar mesej dengan pemberitahuan bunyi (lalai: 0).
1 — hantar tanpa pemberitahuan, 0 — hantar dengan pemberitahuan

reply_to_message_id - ID mesej untuk dibalas (iaitu, petikan)

reply_markup — tetapan butang **

message_thread_id — ID utas (tersedia dalam kumpulan super dengan fungsi forum)

Untuk memudahkan penerangan set butang, anda boleh menggunakan lifehack berikut

Jadi, mari mulakan dengan menentukan koordinat tempat. Anda boleh mendapatkannya menggunakan Google Maps

Seterusnya, tukar koordinat yang diperoleh daripada darjah perpuluhan kepada format geografi menggunakan mana-mana penukar koordinat dalam talian:

Sekarang, mari teruskan mengisi parameter fungsi dan mendapatkan hasil yang diingini:

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

! Bekerja dengan akaun Telegram perniagaan

Telegram menyediakan cara pantas untuk berkongsi kenalan daripada buku alamat anda. Utusan menyokong penghantaran vCard — kad perniagaan elektronik

Fungsi tg_send_contact membolehkan menghantar nombor telefon dengan nama pertama (atau nama organisasi), serta menambah butang dan mengaktifkan perlindungan kandungan untuk mesej.

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

! - parameter fungsi wajib

Parameter:

! platform_id — ID klien Telegram yang mana mesej harus dihantar *

! phone — nombor telefon dalam format antarabangsa. Contohnya, untuk Rusia: +7XXXXXXXXXX

! first_name dan last_name - nama pertama dan nama keluarga

protect_content — bendera untuk melindungi kandungan daripada penyalinan. Untuk mengaktifkan, hantar sebarang nilai selain 0, False, atau petikan kosong ''

disable_notification — bendera untuk menghantar mesej dengan pemberitahuan bunyi (lalai: 0).
1 — hantar tanpa pemberitahuan, 0 — hantar dengan pemberitahuan

reply_to_message_id - ID mesej untuk dibalas (iaitu, petikan)

reply_markup — tetapan butang **

message_thread_id — ID utas (tersedia dalam kumpulan super dengan fungsi forum)

Untuk memudahkan penerangan set butang, anda boleh menggunakan lifehack berikut

Isi parameter: nombor telefon, nama pertama, dan nama keluarga.

Lihat hasilnya:

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

! Bekerja dengan akaun Telegram perniagaan

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

Parameter:

! platform_id — ID klien Telegram yang mana mesej harus dihantar *

! sticker_id - ID pelekat. Cara mendapatkan pautan melalui tg_request diterangkan di sini

protect_content — bendera untuk melindungi kandungan daripada penyalinan. Untuk mengaktifkan, hantar sebarang nilai selain 0, False, atau petikan kosong ''

disable_notification — bendera untuk menghantar mesej dengan pemberitahuan bunyi (lalai: 0).
1 — hantar tanpa pemberitahuan, 0 — hantar dengan pemberitahuan

reply_to_message_id - ID mesej untuk dibalas (iaitu, petikan)

reply_markup — tetapan butang **

message_thread_id — ID utas (tersedia dalam kumpulan super dengan fungsi forum)

Untuk memudahkan penerangan set butang, anda boleh menggunakan lifehack berikut

Menghantar pelekat tidak berbeza daripada menghantar lampiran lain:\

1. Dapatkan pautan dalaman Telegram (butiran di sini) \
2. Isi parameter fungsi\
3. Hantar blok kepada diri sendiri dan semak hasilnya

Hasil:

Ingat bahawa pautan adalah unik untuk setiap bot, jadi pastikan anda menjana pautan anda sendiri

soob=tg_send_sticker(platform_id, 'CAACAgIAAxkBAAEawJ5jmNeyat8uPGBMP3JzubRNXGjH3wACrw4AAsYg4UqePobN94_jkywE')

! Foto hendaklah tidak lebih besar daripada 10 MB. Jumlah lebar dan tinggi tidak boleh melebihi 10,000 piksel. Nisbah lebar-ke-tinggi tidak boleh melebihi 20.

! Bekerja dengan akaun Telegram perniagaan

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)

Parameter:

! platform_id — ID klien Telegram yang mana mesej harus dihantar *

! photo - pautan ke imej. Cara mendapatkan pautan melalui tg_request diterangkan di sini.

caption - penerangan sehingga 1024 aksara

reply_markup — tetapan butang **

parse_mode — pemformatan teks dalam kapsyen tebal atau condong ***

reply_to_message_id - ID mesej untuk dibalas (iaitu, petikan)

protect_content — bendera untuk melindungi kandungan daripada penyalinan. Untuk mengaktifkan, hantar sebarang nilai selain 0, False, atau petikan kosong ''

has_spoiler — mengaktifkan pemformatan spoiler, tetapkan kepada True untuk mengaktifkan

disable_notification — bendera untuk menghantar mesej dengan pemberitahuan bunyi (lalai: 0).
1 — hantar tanpa pemberitahuan, 0 — hantar dengan pemberitahuan

message_thread_id — ID utas (tersedia dalam kumpulan super dengan fungsi forum)

entities — dengan parameter ini anda boleh menyalin teks berformat dengan semua cirinya dan menentukan dari aksara mana ke aksara mana ia akan dipaparkan dengan gaya tertentu. Anda boleh menyemak contoh dalam tg_request dalam medan yang sepadan. Parameter hendaklah kamus.

show_caption_above_media - jika ditetapkan kepada True, teks mesej akan dipaparkan di atas media

Contoh penghantaran parameter:
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"}]

Dalam contoh ini, hanya kamus ditunjukkan, manakala teks mesej itu sendiri disimpan dalam pembolehubah

Untuk memudahkan penerangan set butang, anda boleh menggunakan lifehack berikut

! Foto hendaklah tidak lebih besar daripada 10 MB. Jumlah lebar dan tinggi tidak boleh melebihi 10,000 piksel. Nisbah lebar-ke-tinggi tidak boleh melebihi 20.

! Bekerja dengan akaun Telegram perniagaan

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)

Parameter:

! platform_id — ID klien Telegram yang mana mesej harus dihantar *

! image_list - tatasusunan fail imej (butiran di bawah)

disable_notification — bendera untuk menghantar mesej dengan pemberitahuan bunyi (lalai: 0).
1 — hantar tanpa pemberitahuan, 0 — hantar dengan pemberitahuan

protect_content — bendera untuk melindungi kandungan daripada penyalinan (parameter pilihan, untuk mengaktifkan hantar 1 sebagai nilai)

reply_to_message_id - ID mesej untuk dibalas (iaitu, petikan)

has_spoiler — mengaktifkan pemformatan spoiler (pilihan; tetapkan kepada True untuk mengaktifkan)

message_thread_id — ID utas (tersedia dalam kumpulan super dengan fungsi forum)

Contoh image_list:

'[["Pautan imej 1", "kapsyen", "parse_mode"], ["Pautan imej 2"], ["Pautan imej 3", "kapsyen"]]'

Contoh data untuk satu imej:
["Pautan imej 1", "kapsyen", "parse_mode"]

Susunan parameter adalah penting! Semasa membina tatasusunan fail imej, petikan "" boleh diabaikan

Penerangan parameter:

! Pautan imej 1 - pautan imej. Cara mendapatkan pautan melalui tg_request diterangkan di sini

caption — kapsyen sehingga 1024 aksara

parse_mode — pemformatan teks dalam kapsyen tebal atau condong ***

Mari lihat contoh fungsi untuk menghantar berbilang imej:

pertama, buat tatasusunan imej

Seterusnya, isi parameter fungsi

Hantar blok kepada diri sendiri dan nikmati hasilnya

Ingat bahawa pautan adalah unik untuk setiap bot, jadi pastikan anda menjana pautan anda sendiri untuk 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)

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

! Berfungsi dengan akaun Telegram perniagaan - akaun

Parameter:

! platform_id — ID pelanggan Telegram yang mana mesej harus dihantar *

emoji - emoji yang akan dihantar. Jika anda membiarkan parameter kosong, dadu akan dihantar secara lalai. Anda boleh menghantar sama ada emoji itu sendiri sebagai rentetan atau kata kunci yang digunakan untuk mewakilinya

reply_markup — tetapan butang **

disable_notification — bendera untuk menghantar mesej dengan pemberitahuan bunyi (lalai: 0).
1 — hantar tanpa pemberitahuan, 0 — hantar dengan pemberitahuan

reply_to_message_id -ID mesej untuk dibalas (iaitu, petikan)

protect_content — bendera untuk melindungi kandungan daripada disalin. Untuk mendayakan, hantar sebarang nilai selain 0, False, atau petikan kosong ''

message_thread_id — ID utas (tersedia dalam kumpulan super dengan fungsi forum)

Untuk memudahkan penerangan set butang, anda boleh menggunakan lifehack berikut

Senarai emoji yang mungkin: \

1. 'darts' atau '🎯', nilai dari 1 hingga 6 \
2. 'dice' atau '🎲', nilai dari 1 hingga 6 \
3. 'bowling' atau '🎳', nilai dari 1 hingga 6 \
4. 'basketball' atau '🏀',nilai dari 1 hingga 5 \
5. 'football' atau '⚽', nilai dari 1 hingga 5 \
6. 'slots' atau '🎰', nilai dari 1 hingga 64

Selain itu, jika pelanggan menghantar salah satu emoji ini kepada bot, anda akan menerima panggil balik yang mengandungi maklumat tentang skor dan emoji yang digunakan.

Pilihan paling mudah ialah memanggil fungsi dengan hanya satu parameter yang diperlukan:

Dalam kes ini, pelanggan akan menerima dadu:

Jika pelanggan melambung dadu (dengan mengklik pada emoji yang diterima), bot akan menerima panggil balik dengan bilangan mata yang dilambung:

Anda boleh bereksperimen dengan fungsi ini. Sebagai contoh, mari kita cipta mesin slot dan tambah butang Mata. Apabila butang ditekan, kita akan menerima jumlah mata pelanggan:

Contoh pertama:

soob=tg_send_dice(platform_id)

Contoh kedua:

/* Contoh pertama */
tg_send_message(platform_id,'Klik pada mesin slot untuk mencuba nasib anda!')
opts='{"inline_keyboard": [[{"text": " 👓 ","callback_data":"Play"}]]}'
soob=tg_send_dice(platform_id, 'slots', opts)

/* Blok kedua - Mesej Teks */
 #{res[1]} mata dilambung
/* Blok kedua - Kalkulator */
res=splitter('#{question}', ' ')
balls=if(balls==None,0,balls) + int(res[1])

/* Blok ketiga - Mesej Teks */
Anda mempunyai jumlah #{balls} mata

! Berfungsi dengan akaun Telegram perniagaan - akaun

Kaedah untuk menghantar sekumpulan foto, video, dokumen, atau fail audio sebagai album. Setelah berjaya, tatasusunan fail yang dihantar dikembalikan.

Nota: dokumen dan fail audio tidak boleh dikumpulkan dengan jenis fail lain!

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

Parameter:

! platform_id — ID pelanggan Telegram yang mana mesej harus dihantar

! media_list - tatasusunan yang mengandungi dari 2 hingga 10 foto, video, dokumen, atau fail audio (butiran di bawah);

disable_notification — bendera untuk menghantar mesej dengan pemberitahuan bunyi (lalai: 0).
1 — hantar tanpa pemberitahuan, 0 — hantar dengan pemberitahuan

protect_content — bendera untuk melindungi kandungan daripada disalin. Untuk mendayakan, hantar sebarang nilai selain 0, False, atau petikan kosong ''

reply_to_message_id - ID mesej untuk dibalas (iaitu, petikan)

message_thread_id — ID utas (tersedia dalam kumpulan super dengan fungsi forum);

Kandungan elemen tatasusunan media_list:

! type - jenis fail, “photo”, “video”, “audio” atau ”document”

! media - fail untuk dihantar. Hantar file_id untuk menghantar fail yang sudah wujud pada pelayan Telegram (disyorkan), URL HTTP untuk Telegram mengambil fail dari Internet atau «attach://<file_attach_name>», untuk memuat naik fail baharu menggunakan multipart/form-data dengan nama <file_attach_name>.

Baca lebih lanjut: https://core.telegram.org/bots/api#sending-files

caption — tajuk fail yang dihantar, 0–1024 aksara.

parse_mode — pemformatan teks dalam kapsyen tebal atau condong

Baca lebih lanjut: https://core.telegram.org/bots/api#sending-files

Contoh tatasusunan media_list:

[{"type": "photo", "media": "AgACAgIAAxkBAAIKa2W6HqQG151EaWOKnCyy8feBi8p_AAIH1zEbicvYSfi2QYj-CMreAQADAgADeAADNAQ", "caption": "video hantu"}, {"type": "video", "media": "BAACAgIAAxkBAAIKpGW6P_HGDoVz7u4blDF6925WO-hmAALVPQACicvYSYwIWCJKwKIWNAQ", “caption”: “video arnab”}]

Mari lihat contoh fungsi untuk menghantar berbilang imej:

pertama, cipta tatasusunan imej

Seterusnya, isi parameter fungsi

Hantar blok kepada diri sendiri dan nikmati hasilnya

Ingat bahawa pautan adalah unik untuk setiap bot, jadi pastikan anda menjana pautan anda sendiri untuk 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)

Dalam Telegram (untuk akaun perniagaan dan akaun biasa), anda boleh menghantar lampiran melalui pautan:

1. Anda boleh menghantar lampiran dari sebarang saiz, memintas had saiz fail.
2. Anda juga boleh menghantar sebarang jenis lampiran yang anda perlukan.

Cara melakukannya:

Salin pautan ke lampiran yang sudah boleh diakses secara umum:

Kemudian, tampal pautan yang disalin ke dalam fungsi lampiran dalam blok anda:

Selesai. Dengan cara ini, anda boleh menghantar lampiran dari sebarang jenis dan saiz.