Bekerja dengan ID platform dalam MaviBot

Dalam MaviBot, semua entiti Telegram (pengguna, kumpulan, saluran) dikenal pasti oleh pembolehubah generik platform_id. Pembolehubah ini tidak membezakan antara jenis entiti.

Masalah: Untuk menggunakan fungsi seperti accept atau reject yang memerlukan jenis entiti tertentu, anda perlu mengetahui kedua-dua ID chat dan ID pengguna secara berasingan.

Penyelesaian: Apabila anda menerima panggilan balik atau mesej, segera simpan nilai platform_id dalam dua pembolehubah yang berbeza dan dinamakan mengikut tujuan:

  • chat_id – untuk menyimpan ID kumpulan/saluran.
  • user_id – untuk menyimpan ID pengguna individu.

Ini membolehkan anda merujuk ID yang betul kemudian dalam logik aplikasi anda.

Cara menukar nama chat melalui bot Telegram

Penerangan

tg_set_group_title(platform_id, title)

Menukar tajuk kumpulan Telegram.

Parameter

Parameter Penerangan
platform_id ID chat dalam Telegram.
title Nama chat baharu.
Parameter Penerangan
**!** platform_id ID chat dalam Telegram *
**!** title nama chat baharu

Cara menukar penerangan chat melalui bot Telegram

Penerangan

tg_set_chat_description(platform_id, description)

Menukar penerangan chat Telegram.

Parameter

Parameter Penerangan
platform_id ID chat dalam Telegram.
description Penerangan chat baharu.
Parameter Penerangan
**!** platform_id ID chat dalam Telegram *
**!** description nama chat baharu

Cara menetapkan avatar dalam kumpulan/chat dalam Telegram

Penerangan

tg_set_chat_photo(platform_id, photo)

Menetapkan foto profil baharu untuk chat Telegram.

Parameter

Parameter Penerangan
platform_id ID chat dalam Telegram tempat anda ingin menetapkan foto profil baharu.
photo Pautan terus ke foto.
Parameter Penerangan
**!** platform_id ID chat dalam Telegram *, di mana anda ingin menetapkan avatar
**!** photo pautan foto

Cara memadam avatar dalam kumpulan/chat dalam Telegram

Penerangan

tg_delete_chat_photo(platform_id)

Mengalih keluar foto profil semasa daripada chat Telegram.

Parameter

Parameter Penerangan
platform_id ID chat dalam Telegram dari mana anda ingin mengalih keluar foto profil.
Parameter Penerangan
**!** platform_id ID chat dalam Telegram *, di mana anda perlu menetapkan avatar

Cara menyekat kumpulan Telegram

Penerangan

tg_ban_chat_sender_chat(platform_id, sender_chat_id)

Menyekat chat penghantar daripada menghantar mesej dalam chat Telegram.

Parameter

Parameter Penerangan
platform_id ID chat Telegram di mana chat penghantar akan disekat.
sender_chat_id ID chat penghantar untuk disekat.

Nota

Setelah disekat, pemilik chat penghantar tidak lagi boleh menghantar mesej bagi pihak chat tersebut dalam chat Telegram yang ditentukan sehingga sekatan dialih keluar.

Parameter Penerangan
**!** platform_id ID chat dalam Telegram *, yang perlu anda sekat
**!** sender_chat_id ID chat yang akan menyekat

Pada masa yang sama, pemilik chat yang disekat tidak boleh menulis bagi pihak chat lain sehingga dia disekat.

Cara menyahsekat kumpulan Telegram

Penerangan

tg_unban_chat_sender_chat(platform_id, sender_chat_id)

Menyahsekat chat penghantar yang sebelum ini disekat dalam chat Telegram.

Parameter

Parameter Penerangan
platform_id ID chat Telegram di mana chat penghantar akan dinyahsekat.
sender_chat_id ID chat penghantar untuk dinyahsekat.
Parameter Penerangan
**!** platform_id ID chat dalam Telegram *, di mana anda menyahsekat
**!** sender_chat_id ID chat yang anda nyahsekat

Cara mencipta pautan jemputan untuk menyertai chat Telegram

Penerangan

Mencipta pautan jemputan baharu untuk chat Telegram.

Parameter

Parameter Penerangan
platform_id ID chat Telegram.
member_limit Bilangan maksimum pengguna yang boleh menyertai menggunakan pautan jemputan ini.
hours Masa tamat tempoh pautan jemputan, dalam jam.
request Jika ditetapkan kepada True, pengguna yang mengklik pautan mesti mengemukakan permintaan penyertaan yang boleh diluluskan oleh pentadbir.
name Nama tersuai untuk pautan jemputan.

Penting

Jika parameter member_limit ditentukan, parameter request secara automatik ditetapkan kepada False.

Untuk memerlukan pengguna mengemukakan permintaan penyertaan, biarkan parameter member_limit kosong.

Parameter Penerangan
**!** platform_id ID chat dalam Telegram *
member_limit had bilangan peserta
hours Masa tamat tempoh pautan (dalam jam)
request parameter yang selepas mengklik pautan, permintaan untuk menyertai chat harus dijana.
name nama pautan

Apabila menghantar parameter member_limit, nilai parameter request secara automatik ditukar kepada False. Jika anda perlu menerima permohonan untuk keahlian, biarkan parameter member_limit kosong.

Mencipta pautan jemputan chat

Cara memadam pautan jemputan chat dalam Telegram

Penerangan

Membatalkan pautan jemputan sedia ada untuk chat Telegram.

Parameter

Parameter Penerangan
platform_id ID chat Telegram.
invite_link Pautan jemputan untuk dibatalkan.
Parameter Penerangan
**!** platform_id ID chat dalam Telegram *
**!** invite_link pautan yang perlu anda padam

Cara menyahaktifkan semua pautan sedia ada dan menggantikannya dengan satu pautan

Penerangan

Mencipta pautan jemputan utama baharu untuk chat Telegram.

Parameter

Parameter Penerangan
platform_id ID chat Telegram.

Amaran

Kaedah ini menjana pautan jemputan utama baharu untuk chat.

Semua pautan jemputan utama yang dijana sebelum ini akan menjadi tidak aktif. Pautan yang baru dijana akan menjadi satu-satunya pautan jemputan utama yang aktif sehingga pautan jemputan tambahan dibuat.

Gunakan kaedah ini dengan berhati-hati.

Parameter Penerangan
**!** platform_id ID chat dalam Telegram *
**!** invite_link pautan, yang perlu anda padam

Cara menerima permintaan dan menambah pengguna dalam saluran/chat Telegram

Penerangan

tg_approve_chat_join_request(chat_id, user_id)

Meluluskan permintaan penyertaan yang belum selesai untuk kumpulan atau saluran Telegram.

Parameter

Parameter Penerangan
chat_id ID kumpulan atau saluran Telegram.
user_id ID pengguna Telegram pengguna yang permintaan penyertaannya harus diluluskan.
**!** chat_id ID kumpulan/saluran dalam Telegram *
**!** user_id ID pengguna dalam Telegram *

Penerimaan permintaan:

Cara menolak permintaan dalam saluran/chat Telegram

Penerangan

tg_decline_chat_join_request(chat_id, user_id)

Menolak permintaan penyertaan yang belum selesai untuk kumpulan atau saluran Telegram.

Parameter

Parameter Penerangan
chat_id ID kumpulan atau saluran Telegram.
user_id ID pengguna Telegram pengguna yang permintaan penyertaannya harus ditolak.
**!** chat_id ID kumpulan/saluran dalam Telegram *
**!** user_id ID pengguna dalam Telegram *

Cara menyekat pengguna dalam Telegram

Penerangan

tg_ban_chat_member(chat_id, user_id, hours)

Menyekat pengguna daripada chat Telegram.

Parameter

Parameter Penerangan
chat_id ID chat Telegram.
user_id ID pengguna Telegram pengguna yang akan disekat.
hours Tempoh sekatan, dalam jam. Jika ditinggalkan, sekatan adalah kekal.

Nota

Jika nilai jam melebihi 366 hari, pengguna akan disekat secara kekal.

Parameter Penerangan
**!** chat_id ID sembang dalam Telegram *
**!** user_id ID pengguna dalam Telegram * untuk disekat
hours Tempoh sekatan dalam jam. Secara lalai, sekatan adalah kekal. Jika anda menentukan tempoh sekatan lebih daripada 366 hari, sekatan akan ditetapkan sebagai kekal.

Cara menyahsekat pengguna dalam Telegram

Penerangan

tg_unban_chat_member(chat_id, user_id)

Menyahsekat pengguna daripada sembang Telegram.

Parameter

Parameter Penerangan
chat_id ID sembang Telegram.
user_id ID pengguna Telegram pengguna yang akan dinyahsekat.
Parameter Penerangan
**!** chat_id ID sembang dalam Telegram *
**!** user_id ID pengguna dalam Telegram *, yang perlu dinyahsekat

Cara menyemak status langganan dalam Telegram

Penerangan

tg_get_chat_member(chat_id, user_id)

Mendapatkan maklumat tentang status keahlian pengguna dalam sembang Telegram.

Parameter

Parameter Penerangan
chat_id ID sembang Telegram.
user_id ID pengguna Telegram yang status keahliannya akan disemak.
Parameter Penerangan
**!** chat_id ID sembang dalam Telegram *
**!** user_id ID pengguna dalam Telegram *, yang langganannya kami semak

Cara menentukan bilangan ahli dalam saluran/sembang

Penerangan

tg_get_chat_member_count(platform_id)

Mengembalikan jumlah bilangan ahli dalam sembang Telegram.

Parameter

Parameter Penerangan
platform_id ID sembang Telegram.
Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *

Cara menyemak sama ada ahli sembang berada dalam senarai tertentu

some_client_in_list(list_id, recepient)

Memeriksa sama ada pengguna Telegram disertakan dalam senarai yang ditentukan.

Parameter

Parameter Penerangan
list_id ID senarai untuk diperiksa.
recepient ID pengguna Telegram. Untuk ahli sembang, gunakan pembolehubah chat_member_id.
Parameter Penerangan
**!** list_id nombor senarai
**!** recepient ID pengguna dalam Telegram *. Untuk klien sembang, nilai ini berada dalam pembolehubah chat_member_id.

Cara menunjukkan tindakan bot kepada pengguna (mencetak/memilih pelekat dan lain-lain)

Penerangan

tg_send_chat_action(platform_id, bot_action, message_thread_id)

Menghantar tindakan sembang (seperti menaip atau memuat naik fail) ke sembang Telegram.

Parameter

Parameter Penerangan
platform_id ID sembang Telegram.
bot_action Tindakan sembang untuk dipaparkan. Pilih salah satu daripada tindakan sembang Telegram yang disokong.
message_thread_id ID topik. Hanya tersedia untuk kumpulan super dengan Topik (Forum) didayakan.

Nota

Fungsi ini disokong apabila bekerja dengan akaun Telegram Perniagaan.

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *
**!** bot_action tindakan bot daripada senarai
message_thread_id ID topik (tersedia untuk kumpulan super jika fungsi forum tersedia).
**Senarai tindakan tersedia bot_action**

typing untuk mesej teks,
&#xNAN;upload_photo untuk foto,
&#xNAN;record_video atau upload_video untuk video,
&#xNAN;record_voice atau upload_voice untuk nota suara,
&#xNAN;upload_document untuk dokumen biasa,
&#xNAN;choose_sticker untuk pelekat,
&#xNAN;find_location untuk data lokasi,
&#xNAN;record_video_note atau upload_video_note untuk nota video.

Pemberitahuan ini akan dipaparkan sehingga sebarang respons diterima daripada bot, tetapi tidak lebih daripada 5 saat.

Cara menunjukkan pemberitahuan Amaran kepada pengguna

Penerangan

tg_answer_callback_query(callback_query_id, text, show_alert, cache_time)

Menghantar respons kepada pertanyaan panggil balik yang dicetuskan apabila pengguna mengklik butian sebaris dalam Telegram.

Parameter

Parameter Penerangan
callback_query_id ID pertanyaan panggil balik yang diterima apabila pengguna mengklik butang sebaris. Ini mengenal pasti panggil balik yang mana untuk dijawab.
text Teks untuk dipaparkan dalam pemberitahuan.
show_alert Mengawal cara pemberitahuan dipaparkan. Tetapkan kepada False untuk menunjukkan pemberitahuan gaya petua alat sementara, atau True untuk memaparkan dialog amaran berterusan.
cache_time Masa maksimum, dalam saat, bahawa respons panggil balik boleh dicache pada sisi klien. Lalai kepada 0. Klien Telegram menyokong caching bermula dari versi 3.14.

Penting

Fungsi ini hanya boleh digunakan sebagai respons kepada pengguna yang mengklik butang panggil balik sebaris dalam Telegram.

Contoh

Papan kekunci sebaris berikut menghantar nilai panggil balik yang berbeza apabila setiap butang diklik:

[{"line":0,"index_in_line":0,"text":"111","type":"inline","callback":"first"}, {"line":1,"index_in_line":0,"text":"222","type":"inline","callback":"second"}, {"line":2,"index_in_line":0,"text":"333","type":"inline","callback":"third"}]

Selepas mengklik butang, panggil balik tiba dengan teks yang terkandung dalam medan yang sepadan. Apabila anda mengklik butang “111”, anda akan menerima panggil balik dengan teks “first".

Mari buat blok Mula dan nyatakan teks yang dikehendaki dalam pencetus. Dalam kes kami: "first

Jika dalam medan Padanan anda memilih Mengabaikan ralat dan ketidaktepatan, blok ini kemudiannya boleh digunakan semula untuk semua varian serupa yang berbeza dengan 1–2 aksara. Sebagai contoh, untuk mengucapkan terima kasih kepada pengguna kerana memberikan penilaian dengan butang sedemikian.

Seterusnya, dalam kalkulator, gunakan fungsi tg_answer_callback_query dan hantar parameter berikut:
callback_query_id - ID ini membolehkan anda mengenal pasti pengguna yang menekan butang dan memaparkan pemberitahuan Amaran kepada mereka
text - teks pemberitahuan Amaran.

Contoh kod untuk disalin:

tg_answer_callback_query('#{callback_query_id}', "Anda menekan butang 111")

Perhatian! Parameter callback_query_id harus dihantar tepat seperti yang ditunjukkan dalam contoh, iaitu di dalam '#{}'

Jika semuanya disediakan dengan betul, menekan butang akan menghasilkan pemberitahuan Amaran dengan teks yang ditentukan. Dalam versi mudah alih, nama bot akan muncul sebagai pengepala di atas teks.

Jika anda ingin menunjukkan mesej timbul ringkas sebaliknya, hantar False sebagai parameter ketiga, seperti yang ditunjukkan dalam contoh di bawah:
tg_answer_callback_query('#{callback_query_id}', "Anda melepasi butang 222", False)

Menambah ubah hala bot dengan tag sebagai respons butang panggil balik

Penerangan

tg_callback_url_open(callback_query_id, url, cache_time)

Membuka bot Telegram menggunakan pautan dalam sebagai respons kepada panggil balik butang sebaris.

Parameter

Parameter Penerangan
callback_query_id ID pertanyaan panggil balik yang diterima apabila pengguna mengklik butang sebaris. Ini mengenal pasti panggil balik yang mana untuk dijawab.
url Pautan dalam ke bot dalam format https://t.me/your_bot?start=XXXX, di mana your_bot ialah nama pengguna bot dan XXXX ialah parameter mula.
cache_time Masa maksimum, dalam saat, bahawa respons panggil balik boleh dicache pada sisi klien. Lalai kepada 0. Klien Telegram menyokong caching bermula dari versi 3.14.

Penting

Fungsi ini hanya boleh digunakan sebagai respons kepada pengguna yang mengklik butang panggil balik sebaris dalam Telegram.

Contoh

Dalam respons butang panggil balik, anda boleh menambah peralihan ke bot menggunakan tag tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX')

Sebagai contoh, mari gunakan butang berikut:

[{"line":0,"index_in_line":0,"text":"111","type":"inline","callback":"first"}, {"line":1,"index_in_line":0,"text":"222","type":"inline","callback":"second"}, {"line":2,"index_in_line":0,"text":"333","type":"inline","callback":"third"}]

Selepas mengklik butang, panggil balik tiba dengan teks yang terkandung dalam medan yang sepadan. Apabila anda mengklik butang “111”, anda akan menerima panggil balik dengan teks “first".

Buat blok dengan semakan syarat utama dan nyatakan teks yang dikehendaki dalam syarat. Dalam kes kami: “first”:

Jika dalam medan Pilihan padanan anda memilih Abaikan ralat dan ketidaktepatan, blok ini kemudiannya boleh digunakan semula untuk semua varian serupa yang berbeza dengan 1–2 aksara. Sebagai contoh, untuk mengucapkan terima kasih kepada pengguna kerana memberikan penilaian dengan butang sedemikian.

Seterusnya, dalam kalkulator blok, nyatakan tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX'):

Cara menaikkan pangkat pengguna kepada pentadbir dalam kumpulan super atau saluran

Penerangan

tg_promote_user(platform_id, user_id, promote_options_list)

Menaikkan pangkat pengguna Telegram kepada pentadbir dalam kumpulan super atau saluran dengan kebenaran yang ditentukan.

Parameter

Parameter Penerangan
platform_id Pengecam kumpulan super Telegram, atau nama pengguna saluran dalam format @channelusername apabila menaikkan pangkat pengguna dalam saluran.
user_id ID pengguna Telegram pengguna yang akan dinaikkan pangkat.
promote_options_list Senarai kebenaran pentadbir yang akan diberikan kepada pengguna.

Nota

Hanya kebenaran yang disertakan dalam promote_options_list akan diberikan kepada pengguna.

**Parameter yang diperlukan: promote_options_list**

Kebenaran berikut boleh ditentukan dalam promote_options_list :

  1. is_anonymous — menyembunyikan kehadiran pentadbir dalam sembang,
  2. can_manage_chat — pentadbir boleh mengakses log acara sembang, statistik sembang, statistik mesej dalam saluran, melihat ahli saluran, melihat pentadbir tanpa nama dalam kumpulan super, dan memintas mod perlahan. Tahap kebenaran ini diberikan secara lalai jika mana-mana keistimewaan berikutnya ditentukan
  3. can_post_messages — pentadbir boleh membuat siaran saluran (saluran sahaja)
  4. can_edit_messages — pentadbir boleh mengedit mesej pengguna lain dan menyemat mesej (saluran sahaja)
  5. can_delete_messages — pentadbir boleh memadam mesej pengguna lain
  6. can_manage_video_chats — pentadbir boleh mengurus sembang video,
  7. can_restrict_members — pentadbir boleh menyekat ahli, melarang/nyahlarang mereka dalam sembang,
  8. can_promote_members — pentadbir boleh melantik pentadbir baharu dengan subset keistimewaan mereka sendiri, atau menurunkan pangkat pentadbir yang telah mereka lantik secara langsung atau tidak langsung (cth., pentadbir yang dilantik oleh mereka)
  9. can_change_info — pentadbir boleh menukar tajuk sembang, foto, dan tetapan lain
  10. can_invite_users — pentadbir boleh menjemput pengguna baharu ke sembang
  11. can_pin_messages — pentadbir boleh menyemat mesej (kumpulan super sahaja).
Contoh

Contoh: Menaikkan pangkat pengguna kepada pentadbir dalam kumpulan super:

Dalam contoh ini, sebagai tambahan kepada kebenaran yang ditentukan, kebenaran can_manage_chat akan diberikan secara lalai.

Contoh kod untuk disalin

Contoh 1. 
promote_options_list = ‘[“can_promote_members”,”can_change_info”,”can_invite_users”]’ 
tg_promote_user(platform_id, user_id, promote_options_list)

Contoh 2. 
promote_options_list = '["can_manage_chat","can_post_messages","can_edit_messages","can_delete_messages","can_manage_video_chats","can_promote_members","can_restrict_members","can_invite_users","can_pin_messages"]' 
result=tg_promote_user(platform_id, reply_from, promote_options_list)  

Cara menukar gelaran pentadbir menggunakan bot dalam Telegram

Penerangan

tg_set_administrator_title(platform_id, user_id, title)

Menetapkan gelaran pentadbir tersuai untuk pentadbir kumpulan super Telegram.

Parameter

Parameter Penerangan
platform_id ID kumpulan super Telegram.
user_id ID pengguna Telegram pentadbir.
title Gelaran pentadbir tersuai.

Penting

  • Gelaran mestilah antara 0 dan 16 aksara panjang.
  • Emoji tidak dibenarkan dalam gelaran.
  • Fungsi ini berfungsi hanya untuk pentadbir yang dinaikkan pangkat oleh bot.

Contoh

result = tg_set_administrator_title(platform_id, reply_from, "firetitle")

Sekatan umum untuk ahli sembang biasa atau pengguna Telegram tertentu

Penerangan

tg_chat_permission(platform_id, permission, media_permissions)

Menetapkan kebenaran lalai untuk ahli dalam sembang Telegram.

Parameter

Parameter Penerangan
platform_id ID sembang Telegram.
permission Tatasusunan kebenaran sembang umum. Setiap elemen sepadan dengan kebenaran dalam senarai kebenaran yang disokong. Gunakan 1 untuk membenarkan tindakan dan 0 untuk melarangnya.
media_permissions Tatasusunan kebenaran berkaitan media. Setiap elemen sepadan dengan kebenaran dalam senarai kebenaran media yang disokong. Gunakan 1 untuk membenarkan tindakan dan 0 untuk melarangnya.

Nota

Susunan nilai dalam kedua-dua tatasusunan mesti sepadan dengan susunan senarai kebenaran yang sepadan. Setiap elemen tatasusunan mengawal kebenaran tertentu:

  • 1 — Kebenaran diberikan.
  • 0 — Kebenaran dinafikan.
Senarai sekatan untuk parameter yang diperlukan **permission**

Senarai sekatan untuk permission:
1. ! can_send_messages - kebenaran untuk menghantar mesej teks, kenalan, lokasi, dan tempat.
2. ! can_send_media_messages - kebenaran untuk menghantar audio, dokumen, foto, video, nota video, dan nota suara. Ia memerlukan can_send_messages
3. ! can_send_polls - kebenaran untuk menghantar undian. Ia memerlukan can_send_messages
4. ! can_send_other_messages - kebenaran untuk menghantar animasi, permainan, pelekat, dan menggunakan bot sebaris. Ia memerlukan can_send_media_messages
5. ! can_add_web_page_previews - kebenaran untuk menambah pratonton halaman web pada mesej. Ia memerlukan can_send_media_messages
6. ! can_change_info - kebenaran untuk menukar tajuk sembang, foto, dan tetapan lain. Ini diabaikan dalam kumpulan super awam.
7. ! can_invite_users - kebenaran untuk menjemput pengguna
8. ! can_pin_messages - kebenaran untuk menyemat mesej. Ini diabaikan dalam kumpulan super awam.
9. can_manage_topics - kebenaran untuk mencipta topik dalam kumpulan forum. Jika digunakan dalam kumpulan jenis yang salah, fungsi akan gagal dan mengembalikan ralat.

Senarai nilai untuk parameter yang diperlukan **media_permissions**

Nilai untuk memberikan kebenaran berkaitan media media_permissions:

1. can_send_audios - kebenaran untuk menghantar fail audio
2. can_send_documents -kebenaran untuk menghantar dokumen
3. can_send_photos - kebenaran untuk menghantar foto
4. can_send_videos - kebenaran untuk menghantar video
5. can_send_video_notes - kebenaran untuk menghantar mesej video bulat
6. can_send_voice_notes - kebenaran untuk menghantar mesej suara

Sekatan peribadi Telegram untuk pengguna sembang biasa atau untuk pengguna Telegram tertentu

Penerangan

tg_restrict_chat_member(platform_id, user_id, minutes, permission, media_permissions).

Parameter:

Parameter Penerangan
! platform_id ID sembang dalam Telegram *
! user_id ID pengguna dalam Telegram *
minutes bilangan minit semasa sekatan akan kekal aktif. Jika anda tidak menetapkan nilai, lalai ialah 3600, yang bersamaan dengan 60 jam. Jika anda menetapkannya kepada 0, sekatan menjadi kekal
permission tatasusunan nilai daripada senarai sekatan kebenaran.
media_permissions senarai nilai untuk memberikan kebenaran berkaitan media
Senarai sekatan untuk parameter yang diperlukan **permission**

Senarai sekatan untuk permission:
1. ! can_send_messages - kebenaran untuk menghantar mesej teks, kenalan, lokasi, dan tempat.
2. ! can_send_media_messages - kebenaran untuk menghantar audio, dokumen, foto, video, nota video, dan nota suara. Ia memerlukan can_send_messages
3. ! can_send_polls - kebenaran untuk menghantar undian. Ia memerlukan can_send_messages
4. ! can_send_other_messages - kebenaran untuk menghantar animasi, permainan, pelekat, dan menggunakan bot sebaris. Ia memerlukan can_send_media_messages
5. ! can_add_web_page_previews - kebenaran untuk menambah pratonton halaman web pada mesej. Ia memerlukan can_send_media_messages
6. ! can_change_info - kebenaran untuk menukar tajuk sembang, foto, dan tetapan lain. Ini diabaikan dalam kumpulan super awam.
7. ! can_invite_users - kebenaran untuk menjemput pengguna
8. ! can_pin_messages - kebenaran untuk menyemat mesej. Ini diabaikan dalam kumpulan super awam.
9. can_manage_topics - kebenaran untuk mencipta topik dalam kumpulan forum. Jika digunakan dalam kumpulan jenis yang salah, fungsi akan gagal dan mengembalikan ralat.

Senarai nilai untuk parameter yang diperlukan **media_permissions**

Nilai untuk memberikan kebenaran berkaitan media media_permissions:

1. can_send_audios - kebenaran untuk menghantar fail audio
2. can_send_documents -kebenaran untuk menghantar dokumen
3. can_send_photos - kebenaran untuk menghantar foto
4. can_send_videos - kebenaran untuk menghantar video
5. can_send_video_notes - kebenaran untuk menghantar mesej video bulat
6. can_send_voice_notes - kebenaran untuk menghantar mesej suara

Contoh

Contoh penggunaan fungsi, di mana pengguna disekat daripada segala-galanya selama 3 minit:

Apabila pengguna memasuki sembang, mereka akan melihat pemberitahuan bahawa mereka tidak boleh menghantar mesej dalam sembang.
Jika had masa ditetapkan, mereka juga akan melihat tempoh sekatan ini.

Contoh kod untuk disalin:

permission = [0, 0, 0, 0, 0, 0, 0, 0] 
tg_restrict_chat_member(-1001607137668, 473737685, 3, permission)

Cara menyematkan mesej

Penerangan

tg_pin_chat_message(platform_id, message_id, disable_notification)

Menyematkan mesej dalam sembang Telegram.

Parameter

Parameter Penerangan
platform_id ID sembang Telegram.
message_id ID mesej yang ingin disematkan.
disable_notification Mengawal sama ada ahli sembang diberitahu tentang mesej yang disematkan. Tetapkan kepada 1 untuk menyematkan mesej secara senyap, atau 0 untuk menghantar pemberitahuan.

Nota

Pemberitahuan sentiasa dilumpuhkan dalam saluran dan sembang peribadi, tanpa mengira nilai disable_notification.

Cara menyahsematan mesej

Penerangan

tg_unpin_chat_message(platform_id, message_id)

Menyahsematan mesej dalam sembang Telegram.

Parameter

Parameter Penerangan
platform_id ID sembang Telegram.
message_id ID mesej yang ingin dinyahsematkan. Jika ditinggalkan, mesej yang paling baru disematkan akan dinyahsematkan.

Nota

Jika message_id tidak dinyatakan, fungsi akan menyahsematan mesej yang disematkan terbaharu berdasarkan masa penghantarannya.

Cara menyahsematan semua mesej yang disematkan

Penerangan

tg_unpin_all(platform_id)

Parameter:

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *

PERHATIAN!

Telegram mempunyai had untuk fungsi semat/nyahsemat mesej.

Had masa untuk menggunakan **tg_pin_chat_message / tg_unpin_chat_message / tg_unpin_all TIDAK ditetapkan oleh sistem MaviBot.

Jika masa yang dibenarkan untuk menyematkan mesej telah tamat, fungsi masih akan mengembalikan true, tetapi Telegram tidak akan menggunakan perubahan tersebut.

Ia juga penting untuk diperhatikan bahawa mesej yang disematkan mungkin kekal dalam cache, jadi ia mungkin tidak hilang secara visual dengan serta-merta.

Cara membuat undian dalam Telegram

Penerangan

tg_send_poll(platform_id, question, options, is_anonymous, allows_multiple_answers, reply_markup, disable_notification, protect_content, token, reply_to_message_id, message_thread_id, business_connection_id)

Parameter:

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *
**!** question soalan
**!** options tatasusunan pilihan jawapan
is_anonymous 1 - undian tanpa nama , '' - tidak tanpa nama
allows_multiple_answers 1 - pelbagai jawapan tersedia, '' - satu jawapan
reply_markup papan kekunci atau '' - tanpa papan kekunci
disable_notification bendera untuk menghantar dengan pemberitahuan bunyi (lalai 0)
1 – lumpuhkan pemberitahuan semasa penerimaan, 0 – hantar dengan pemberitahuan
protect_content 1 untuk melindungi daripada penyalinan dan tangkapan skrin, '' tiada perlindungan
token token bot; jika tidak disediakan, token semasa digunakan
reply_to_message_id ID mesej yang dipetik
message_thread_id ID utas (tersedia untuk kumpulan super jika fungsi forum wujud)
business_connection_id nilai semasa menyambungkan bot (ID Perniagaan). Menunjukkan dalam saluran. Perlu disediakan jika token bot digunakan dan mesej mesti dihantar melalui akaun pengguna yang disambungkan ke bot
Penting untuk diketahui!

Nota

  1. Fungsi mengembalikan respons daripada Telegram dengan message_id. Adalah lebih baik untuk menyimpannya. Menggunakan message_id, anda boleh menghentikan undian dengan tg_stop_poll (lihat penerangan di bawah) dan mendapatkan hasilnya.

  2. Jika pengguna menambah undian dalam utusan, panggil balik dihantar ke sembang:

poll_added - bahagian yang tidak berubah
YOUR QUESTION - teks soalan daripada undian

Contoh panggil balik semasa menambah undian dalam saluran

Contoh panggil balik semasa menambah undian dalam sembang

Panggil balik kedua selepas poll_added mengandungi nombor - ini tidak lain adalah ID pengguna dalam Telegram yang menambah undian.

Apabila membuat undian oleh bot, panggil balik tidak datang.

3. Dalam saluran, hanya undian tanpa nama boleh dibuat

Perhatian, adalah disyorkan untuk menghantar hanya undian tanpa nama ke kumpulan!

  1. Selepas membuat undian, simpan IDnya dalam pembolehubah untuk memahami undian mana yang menerima panggil balik.
Contoh

Maklum balas pelanggan adalah kunci kepada pertumbuhan kami. Undian menawarkan kaedah yang mudah untuk menangkap maklum balas ini dan menterjemahkannya ke dalam kesimpulan perniagaan yang konkrit.

Contoh kod untuk disalin:

/* Contoh membuat undian mudah */
options = ["white", "red", "blue", "green"]
poll1 = tg_send_poll(platform_id, 'What is your favorite color?', options, 1, '', '', 1, '')

Fungsi untuk membuat undian dalam Telegram:

Undian yang kami buat dalam Telegram

Cara membuat kuiz dalam Telegram

Penerangan

tg_send_quiz_poll(platform_id, question, options, explanation, correct_option_id, is_anonymous, reply_markup, parse_mode, protect_content, disable_notification, token, reply_to_message_id, message_thread_id )

Parameter:

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *
**!** question soalan
**!** options tatasusunan pilihan jawapan
**!** explanation teks yang dipaparkan apabila pengguna memilih jawapan yang salah atau mengklik ikon lampu dalam undian gaya kuiz, 0–200 aksara dengan tidak lebih daripada dua pemisah baris selepas penghuraian entiti.
**!** correct_option_id nombor jawapan yang betul, penomboran bermula dari 1
is_anonymous 1 - undian tanpa nama , '' - tidak tanpa nama
reply_markup papan kekunci atau '' - tanpa papan kekunci
parse_mode format penjelasan: markdown, html, atau '' (rentetan kosong untuk tiada pemformatan)
protect_content 1 untuk melindungi daripada penyalinan dan tangkapan skrin, '' tiada perlindungan
disable_notification bendera untuk menghantar dengan pemberitahuan bunyi (lalai 0)
1 – lumpuhkan pemberitahuan semasa penerimaan, 0 – hantar dengan pemberitahuan
token token bot; jika tidak disediakan, token semasa digunakan
reply_to_message_id ID mesej yang dipetik
message_thread_id ID topik (tersedia dalam kumpulan super dengan ciri forum aktif)
**Penting untuk diketahui!**

Nota

1. Simpan message_id

Fungsi API mengembalikan respons Telegram yang mengandungi message_id. Sentiasa simpan ID ini, kerana ia diperlukan untuk:

  • Menamatkan kuiz menggunakan fungsi tg_stop_poll (lihat penerangan di bawah).
  • Mendapatkan keputusan akhir.

2. Panggil balik poll_added

Jika pengguna menambah undian ke saluran, bot menerima panggil balik:

  • Format: poll_added + Soalan undian
  • Jika ditambah ke sembang kumpulan: panggil balik juga termasuk ID Pengguna Telegram orang yang menambah undian.

Jika dibuat oleh bot: Tiada panggil balik poll_added dihantar.

3. Sekatan saluran

Hanya kuiz tanpa nama boleh dibuat dalam saluran.

4. Panggil balik poll_answer (Pengundian pengguna)

Apabila pengguna mengundi dalam kuiz yang dihantar ke sembang peribadi atau kumpulan, panggil balik dihantar ke dialog bot dengan pelanggan tersebut:

  • Format: poll_answer + ID Undian + [Indeks jawapan]
  • Contoh: poll_answer 5325838371359031648 [3]
  • Nota: penomboran jawapan bermula dari 0. [3] bermaksud pengguna memilih pilihan jawapan keempat.

5. Webhook untuk undian kumpulan bukan tanpa nama

Untuk undian bukan tanpa nama dalam kumpulan di mana bot adalah pentadbir, webhook dihantar untuk setiap undian. Setelah menerimanya, bot akan memajukan panggil balik poll_answer (seperti dalam titik 4) ke dialognya dengan pelanggan yang sepadan.

6. Keperluan pengaktifan & amalan terbaik

  • Keperluan: bot tidak boleh memulakan perbualan. Jika pelanggan tidak pernah menghubungi bot, anda tidak boleh menghantar mesej langsung kepada mereka sebagai respons kepada undian mereka sehingga mereka mengaktifkan bot terlebih dahulu (cth., dengan menghantar arahan /start).

Cadangan: untuk mengelakkan had ini, adalah sangat disyorkan untuk menghantar hanya kuiz tanpa nama ke kumpulan.

7. Jejaki undian anda

Sejurus selepas membuat kuiz, simpan ID Undian uniknya ke dalam pembolehubah. Ini membolehkan anda mengenal pasti undian tertentu yang dirujuk oleh panggil balik yang masuk.

Contoh

Contoh kod untuk disalin.

options = ["white", "red", "blue", "green"] 
r = tg_send_quiz_poll(platform_id, "What color is a crocodile?", options, "That is the explanation", 4, '', '', '', '', 1)

Contoh: penciptaan kuiz.

Cara menamatkan undian

Penerangan

tg_stop_poll(platform_id, message_id)

Parameter:

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *
**!** message_id ID mesej undian/kuiz. Ia boleh diperoleh daripada webhook

Memanggil fungsi ini untuk menamatkan undian/kuiz mengembalikan kamus yang mengandungi keputusan akhir.

Cara bekerja dengan topik dalam Telegram

Penting: topik utama kumpulan tidak mempunyai ID dan memerlukan fungsi berasingan untuk bekerja dengannya.

Cara menamakan semula Topik Umum kumpulan

Penerangan

tg_edit_general_forum_topic(platform_id, topic_name)

Parameter:

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *
**!** topic_name nama topik baharu
bot_name

parameter pilihan: nama bot.

Apabila bekerja dengan topik, anda boleh menentukan bot mana yang harus melaksanakan fungsi tersebut. Ini berguna jika projek anda menggunakan berbilang bot Telegram. Cari nama bot dalam bahagian "Saluran", dalam medan "ID Kumpulan".

Contoh

Topik Umum kumpulan boleh diubah menggunakan fungsi tg_edit_general_forum_topic(). Ia memerlukan dua parameter wajib: ID sembang dan nama baharu untuk Topik Kumpulan:

Contoh kod untuk disalin

/namakan semula sembang Topik Umum/
answer = tg_edit_general_forum_topic(-1001839380031, 'General')

Cara menutup Topik Umum

Penerangan

tg_close_general_forum_topic(platform_id)

Parameter:

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *
bot_name

parameter pilihan: nama bot.

Apabila bekerja dengan topik, anda boleh menentukan bot yang harus melaksanakan fungsi tersebut. Ini berguna jika projek anda menggunakan berbilang bot Telegram. Cari nama bot dalam bahagian "Saluran", dalam medan "ID Kumpulan".

Contoh kod untuk disalin

/tutup sembang Topik Umum/
answer = tg_close_general_forum_topic(-1001839380031)

Cara membuka semula Topik Umum yang telah ditutup sebelumnya

Penerangan

tg_reopen_general_forum_topic(platform_id)

Parameter:

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *
bot_name

parameter pilihan: nama bot.

Apabila bekerja dengan topik, anda boleh menentukan bot yang harus melaksanakan fungsi tersebut. Ini berguna jika projek anda menggunakan berbilang bot Telegram. Cari nama bot dalam bahagian "Saluran", dalam medan "ID Kumpulan".

Contoh kod untuk disalin

/buka semula sembang Topik Umum/
answer = tg_reopen_general_forum_topic(-1001839380031)

Cara menyembunyikan Topik Umum

Penerangan

tg_hide_general_forum_topic(platform_id)

Parameter:

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *
bot_name

parameter pilihan: nama bot.

Apabila bekerja dengan topik, anda boleh menentukan bot yang harus melaksanakan fungsi tersebut. Ini berguna jika projek anda menggunakan berbilang bot Telegram. Cari nama bot dalam bahagian "Saluran", dalam medan "ID Kumpulan".

Sembang Topik Umum boleh ditutup untuk peserta Topik (mereka boleh membaca tetapi tidak boleh menulis) dan disembunyikan daripada senarai sembang umum Telegram untuk pengguna baharu.

Contoh kod untuk disalin

/sembunyikan sembang Topik Umum/
answer = tg_hide_general_forum_topic(-1001839380031)

Cara memaparkan Topik Umum atau memulihkan keterlihatannya

Penerangan

tg_unhide_general_forum_topic(platform_id)

Parameter:

Parameter Penerangan
**!** platform_id ID topik dalam Telegram *
bot_name

parameter pilihan: nama bot.

Apabila bekerja dengan topik, anda boleh menentukan bot yang harus melaksanakan fungsi tersebut. Ini berguna jika projek anda menggunakan berbilang bot Telegram. Cari nama bot dalam bahagian "Saluran", dalam medan "ID Kumpulan".

Penting!

Fungsi ini tidak membuka semula Topik Umum; ia hanya menjadikannya kelihatan.

Contoh kod untuk disalin

/paparkan sembang Topik Umum/
answer = tg_unhide_general_forum_topic(-1001839380031)

Cara membuat topik baharu dalam Telegram

Penerangan

tg_create_forum_topic(platform_id, name, icon, icon_color)

Parameter:

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *
**!** name nama topik baharu
icon ID emoji yang akan ditetapkan untuk topik. Dihantar sebagai rentetan. Anda hanya boleh menggunakan emoji daripada senarai yang diambil oleh fungsi tg_get_forum_icon.
icon_color warna emoji daripada senarai: 7322096, 16766590, 13338331, 9367192, 16749490, 16478047. Tidak semua emoji menyokong perubahan warna.
bot_name

parameter pilihan: nama bot.

Apabila bekerja dengan topik, anda boleh menentukan bot yang harus melaksanakan fungsi tersebut. Ini berguna jika projek anda menggunakan berbilang bot Telegram. Cari nama bot dalam bahagian "Saluran", dalam medan "ID Kumpulan".

Warna yang ditetapkan tidak boleh diubah; warna hanya boleh diberikan semasa membuat topik.

Apabila dilaksanakan, fungsi akan mengembalikan respons yang mengandungi parameter topik baharu, termasuk ID topik (diperlukan untuk pelbagai fungsi).

Contoh kod untuk disalin

Untuk mencipta sembang topik tambahan
answer = tg_create_forum_topic(-1001839380031, 'second_bot_topic', None, 7322096)

Untuk menyimpan ID sembang topik tambahan yang dicipta
answer={"ok":true,"result":{"message_thread_id":254,"name":"second_bot_topic","icon_color":7322096}}/
idtema1=answer['result']['message_thread_id']

Cara mengedit topik. Cara menamakan semula dan/atau menukar emoji untuk topik

Penerangan

tg_edit_forum_topic(platform_id, message_thread_id, name, icon)

Parameter:

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *
**!** message_thread_id ID sembang topik tambahan
name nama topik baharu
icon ID emoji yang akan ditetapkan untuk topik. Dihantar sebagai rentetan. Anda hanya boleh menggunakan emoji daripada senarai yang diambil oleh fungsi tg_get_forum_icon.
bot_name

parameter pilihan: nama bot.

Apabila bekerja dengan topik, anda boleh menentukan bot yang harus melaksanakan fungsi tersebut. Ini berguna jika projek anda menggunakan berbilang bot Telegram. Cari nama bot dalam bahagian "Saluran", dalam medan "ID Kumpulan".

Contoh kod untuk disalin

answer = tg_edit_forum_topic(-1001839380031, 254)

Cara menutup topik yang dipilih

Penerangan

Menutup topik bermakna menjadikannya hanya-baca; menulis dalam topik yang ditutup tidak dibenarkan.

tg_close_forum_topic(platform_id, message_thread_id)

Parameter:

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *
**!** message_thread_id ID sembang topik tambahan
bot_name

parameter pilihan: nama bot.

Apabila bekerja dengan topik, anda boleh menentukan bot yang harus melaksanakan fungsi tersebut. Ini berguna jika projek anda menggunakan berbilang bot Telegram. Cari nama bot dalam bahagian "Saluran", dalam medan "ID Kumpulan".

Contoh kod untuk disalin

answer = tg_close_forum_topic(-1001839380031, 254)

Cara membuka semula topik yang telah ditutup sebelumnya

Penerangan

tg_reopen_forum_topic(platform_id, message_thread_id)

Parameter:

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *
**!** message_thread_id ID sembang topik tambahan
bot_name

parameter pilihan: nama bot.

Apabila bekerja dengan topik, anda boleh menentukan bot yang harus melaksanakan fungsi tersebut. Ini berguna jika projek anda menggunakan berbilang bot Telegram. Cari nama bot dalam bahagian "Saluran", dalam medan "ID Kumpulan".

Contoh kod untuk disalin

answer = tg_reopen_forum_topic(-1001839380031, 254)

Cara memadam topik dan semua mesejnya

Penerangan

tg_delete_forum_topic(platform_id, message_thread_id)

Parameter:

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *
**!** message_thread_id ID sembang topik tambahan
bot_name

parameter pilihan: nama bot.

Apabila bekerja dengan topik, anda boleh menentukan bot yang harus melaksanakan fungsi tersebut. Ini berguna jika projek anda menggunakan berbilang bot Telegram. Cari nama bot dalam bahagian "Saluran", dalam medan "ID Kumpulan".

Contoh kod untuk disalin

answer = tg_delete_forum_topic(-1001839380031, 254)

Cara menyemat semua mesej dalam topik

Penerangan

tg_unpin_topic_messages(platform_id, message_thread_id)

Parameter:

Parameter Penerangan
**!** platform_id ID sembang dalam Telegram *
**!** message_thread_id ID sembang topik tambahan
bot_name

parameter pilihan: nama bot.

Apabila bekerja dengan topik, anda boleh menentukan bot yang harus melaksanakan fungsi tersebut. Ini berguna jika projek anda menggunakan berbilang bot Telegram. Cari nama bot dalam bahagian "Saluran", dalam medan "ID Kumpulan".

Contoh kod untuk disalin

answer = tg_unpin_topic_messages(-1001839380031, 254)

Cara mendapatkan senarai emoji untuk Topik Telegram

Penerangan

Cara mendapatkan senarai emoji

tg_get_forum_icon() – fungsi ini mengembalikan senarai emoji yang tersedia untuk digunakan sebagai ikon topik forum. Hasilnya mesti diberikan kepada pemboleh ubah, kerana ia mengembalikan kamus di mana setiap kunci adalah emoji dan nilai yang sepadan adalah pengecam unik emoji (id).

Parameter: tiada.

Kandungan senarai emoji

Untuk mendapatkan senarai emoji untuk sembang Topik, hantar arahan ke sembang yang berkaitan.

Fungsi akan mengembalikan senarai emoji dalam responsnya. Ini bermakna pemboleh ubah answer akan mengandungi kamus sebagai nilainya.

{'📰': '5434144690511290129', '💡': '5312536423851630001', '⚡️': '5312016608254762256', '🎙': '5377544228505134960', '🔝': '5418085807791545980', '🗣': '5368697802761185083', '🆒': '5420216386448270341', '❗️': '5379748062124056162', '📝': '5357193964787081133', '📆': '5433614043006903194', '📁': '5357315181649076022', '🔎': '5309965701241379366', '📣': '5309984423003823246', '🔥': '5312241539987020022', '❤️': '5312138559556164615', '❓': '5377316857231450742', '📈': '5350305691942788490', '📉': '5350713563512052787', '💎': '5309958691854754293', '💰': '5350452584119279096', '💸': '5309929258443874898', '\U0001fa99': '5377690785674175481', '💱': '5310107765874632305', '⁉️': '5377438129928020693', '🎮': '5309950797704865693', '💻': '5350554349074391003', '📱': '5409357944619802453', '🚗': '5312322066328853156', '🏠': '5312486108309757006', '💘': '5310029292527164639', '🎉': '5310228579009699834', '‼️': '5377498341074542641', '🏆': '5312315739842026755', '🏁': '5408906741125490282', '🎬': '5368653135101310687', '🎵': '5310045076531978942', '🔞': '5420331611830886484', '📚': '5350481781306958339', '👑': '5357107601584693888', '⚽️': '5375159220280762629', '🏀': '5384327463629233871', '📺': '5350513667144163474', '👀': '5357121491508928442', '\U0001fae6': '5357185426392096577', '🍓': '5310157398516703416', '💄': '5310262535021142850', '👠': '5368741306484925109', '✈️': '5348436127038579546', '\U0001f9f3': '5357120306097956843', '🏖': '5310303848311562896', '⛅️': '5350424168615649565', '🦄': '5413625003218313783', '🛍': '5350699789551935589', '👜': '5377478880577724584', '🛒': '5431492767249342908', '🚂': '5350497316203668441', '🛥': '5350422527938141909', '🏔': '5418196338774907917', '🏕': '5350648297189023928', '🤖': '5309832892262654231', '\U0001faa9': '5350751634102166060', '🎟': '5377624166436445368', '🏴\u200d☠️': '5386395194029515402', '🗳': '5350387571199319521', '🎓': '5357419403325481346', '🔭': '5368585403467048206', '🔬': '5377580546748588396', '🎶': '5377317729109811382', '🎤': '5382003830487523366', '🕺': '5357298525765902091', '💃': '5357370526597653193', '\U0001fa96': '5357188789351490453', '💼': '5348227245599105972', '\U0001f9ea': '5411138633765757782', '👨\u200d👩\u200d👧\u200d👦': '5386435923204382258', '👶': '5377675010259297233', '🤰': '5386609083400856174', '💅': '5368808634392257474', '🏛': '5350548830041415279', '\U0001f9ee': '5355127101970194557', '🖨': '5386379624773066504', '👮\u200d♂️': '5377494501373780436', '\U0001fa7a': '5350307998340226571', '💊': '5310094636159607472', '💉': '5310139157790596888', '\U0001f9fc': '5377468357907849200', '\U0001faaa': '5418115271267197333', '🛃': '5370947704199323325', '🍽': '5350344462612570293', '🐟': '5384574037701696503', '🎨': '5310039132297242441', '🎭': '5350658016700013471', '🎩': '5357504778685392027', '🔮': '5350367161514732241', '🍹': '5350520238444126134', '🎂': '5310132165583840589', '☕️': '5350392020785437399', '🍣': '5350406176997646350', '🍔': '5350403544182694064', '🍕': '5350444672789519765', '\U0001f9a0': '5312424913615723286', '💬': '5417915203100613993', '🎄': '5312054580060625569', '🎃': '5309744892677727325'}

Contoh kod untuk disalin
answer = tg_get_forum_icon()