Keperluan & had Telegram

1. Had mesej

  • Mesej teks sahaja: Maksimum 4,096 aksara.
  • Mesej dengan imej: Maksimum 1,024 aksara (untuk imej 1080x1080 px).

2. Keperluan imej

  • Format: Imej segi empat sama adalah diutamakan.
  • Saiz optimum: 900x900 piksel, maksimum 5 MB.

3. Keperluan fail

API Telegram mempunyai keperluan khusus untuk fail yang dimuat naik:

  • Bot boleh menghantar fail sehingga 2 GB.
  • Anda boleh menggunakan file_id untuk bekerja dengan fail yang telah dimuat naik sebelumnya. Dalam kes ini, had fail mengikut dokumentasi Telegram.
  • Fail boleh dihantar menggunakan URL (bot memuat turun dan menghantarnya):
    • Foto: ≤ 5 MB
    • Fail lain: ≤ 20 MB
  • Had berbeza dikenakan untuk penyiaran:
    • Foto: 10 MB
    • Fail lain: 2 GB

Baca lebih lanjut dalam sumber asal

Penciptaan bot Telegram

Bot Telegram dicipta melalui BotFather, sistem pengurusan bot rasmi Telegram. Alat yang disahkan ini (ditunjukkan dengan tanda semak biru) membolehkan anda mencipta bot tanpa pengetahuan pengaturcaraan dan melindungi anda daripada peniru penipuan.

Langkah Penciptaan:

  1. Mulakan sembang dengan BotFather.
  2. Hantar arahan: /newbot
  3. Pilih nama untuk bot anda (ini adalah nama paparan untuk pengguna).
  4. Pilih nama pengguna untuk bot anda. Ia mesti berakhir dengan bot atau _bot (contohnya, my_test_bot).

Jika nama pengguna tersedia, BotFather akan menghantar mesej pengesahan yang mengandungi "token"—kunci unik untuk akses API.

Penting: Token ini adalah kata laluan untuk bot anda. Simpan dengan selamat dan jangan sekali-kali berkongsi dengan sesiapa.

Navigasi ke bahagian Messengers, pilih Telegram, dan tampal token bot anda ke dalam ruangan yang disediakan.

Klik butang Done untuk melengkapkan persediaan bot dan mengaktifkan sambungan ke projek anda.

Bekerja dengan kumpulan/saluran Telegram

Maklumat berguna

Kumpulan Telegram ialah saluran komunikasi antara peserta: semua peserta boleh menulis di dalamnya.

Saluran Telegram ialah alat komunikasi sehala. Hanya pemilik atau pentadbir boleh menghantar mesej, manakala peserta lain hanya boleh melihatnya dan meninggalkan komen.

Cara menambah bot ke kumpulan/saluran Telegram

Ciri untuk bot ini disertakan dalam BotFather:

Langkah 1. Pergi ke tetapan bot:

Langkah 2. Klik pada "Allow Groups?'

Langkah 3. Perlu ada status didayakan.

Tambah bot sebagai pentadbir dalam kumpulan/saluran

Untuk mengautomasikan kerja dalam sembang dan saluran, anda perlu menambah bot anda sendiri sebagai Pentadbir.

Bagaimana untuk melakukannya?

Langkah 1. Pergi ke Pengurusan Kumpulan/Saluran dan pilih tab Administrators

Langkah 2. Klik butang "Add Admin".

Langkah 3. Masukkan nama pengguna bot anda dalam kotak carian.

Langkah 4. Untuk fungsi penuh, pastikan bot mempunyai hak untuk membaca dan memadam mesej.

Pembolehubah untuk bekerja dalam sembang

Sila ambil perhatian!

Menyimpan pembolehubah dalam sembang kumpulan untuk acara seperti menyertai sembang, keluar dari sembang, suka baharu, dsb. tidak tersedia.

Pembolehubah hanya akan tersedia di dalam blok yang telah berfungsi. Anda boleh mengeluarkan pembolehubah ini dalam blok untuk menjejaki kerja.

Ini TIDAK akan menjejaskan operasi chatbot dalam apa jua cara, adalah mustahil untuk menjejaki siapa yang masuk/keluar dalam bahagian pelanggan.

  • Pembolehubah dengan maklumat tentang pengarang mesej

message_from - ID pengarang mesej

message_from_name - nama pengarang mesej

message_from_username - nama panggilan pengarang mesej dalam Telegram

  • Pembolehubah dengan maklumat tentang mesej yang dimajukan

reply_message_id - nombor mesej yang dimajukan

reply_from - siapa pengarang mesej yang dimajukan

reply_from_name - nama orang yang mesejnya dimajukan

reply_from_username - nama panggilan orang yang mesejnya dimajukan

reply_from_chat_id - nombor dialog dari mana mesej dimajukan

  • Menambah dan mengalih keluar daripada kumpulan

Dalam kes ini, panggil balik new_chat_member dan left_chat_member dicetuskan (pembolehubah tidak disimpan dalam kad pelanggan):

chat_member_name - nama pengguna

chat_member_username - nama panggilan pengguna

chat_member_id - nombor pengguna

Panggil balik dalam Telegram

client_unsubscribed - pelanggan telah berhenti melanggan, menyekat bot

client_returned - pelanggan telah menyahsekat bot

Panggil balik dalam kumpulan/saluran

new_chat_member - pengguna baharu telah ditambah

left_chat_member - pengguna meninggalkan saluran

kicked_chat_member - pengguna telah dipadam oleh pentadbir

chat_join_request - permintaan telah diterima untuk ditambah ke saluran

edited_channel_post - siaran di saluran telah diedit (edited_channel_post + tarikh dan masa pengeditan)

Panggil balik dipaparkan dalam bahagian Clients

bot_added_to_group - bot telah ditambahkan ke sembang (tidak kira yang mana, ia akan bertindak balas kepada sesiapa sahaja, walaupun bot yang disambungkan ditambahkan ke kumpulan itu sendiri);

bot_left_group - panggil balik yang serupa mengalih keluar bot daripada saluran;

new_like - menyukai siaran

like_deleted - memadamkan suka daripada siaran

Nombor dalam panggil balik (new_like; like_deleted) ialah ID mesej yang dijawab atau dialih keluar.

Sila ambil perhatian!

  • Panggil balik untuk reaksi tidak dipaparkan dalam saluran Telegram! Panggil balik untuk reaksi hanya datang dalam kumpulan.
  • Jika seorang telah meletakkan beberapa suka, dan kemudian memadamkan 1 daripadanya, ia tidak menunjukkan yang mana satu telah dipadamkan.

Apabila panggil balik dengan reaksi muncul dalam kumpulan, pembolehubah tersedia dalam blok:

reaction_on_message_id - mengandungi ID mesej yang dijawab

reaction_from - id daripada siapa terdapat reaksi

message_from_username - nama pengguna daripada siapa terdapat reaksi (jika ada)

reaction_from_name - nama daripada siapa reaksi itu

Juga, jika Telegram membalas mesej, pembolehubah reply_text dalam kad akan mengandungi teks penuh mesej yang dijawab.

Jika mesej dihantar sebagai balasan (memetik mesej sebelumnya), sistem juga akan menjana pembolehubah tg_quote, yang mengandungi teks yang dipetik.

Panggil balik dengan boost

  • chat_boost_from user #{id_user} - memberikan boost kepada sembang (atau saluran):

Apabila panggil balik ini dicetuskan, pembolehubah dijana:

  • remove_boost_from user #{id_user} - mereka mengambil boost daripada sembang (atau saluran):

Apabila panggil balik ini dicetuskan, pembolehubah dijana:

  • chat_boost from giveaway - dikeluarkan semasa undian bintang dalam saluran
  • remove_chat_boost from giveaway - tempoh boost untuk undian bintang dalam saluran telah tamat

Cara mengautomasikan pengalihan keluar pemberitahuan sistem dalam kumpulan

Untuk memadam secara automatik semua mesej sistem, cukup untuk memberikan sebarang nilai kepada pembolehubah del_tg_system_messages (pembolehubah boleh sama ada pemalar projek atau pembolehubah transaksi) dan memberi bot kebenaran untuk memadam mesej.

Pembolehubah del_tg_system_messages hanya boleh digunakan dalam kumpulan. Dalam saluran, memberikan sebarang nilai kepada pembolehubah ini tidak akan membawa kepada sebarang hasil.

Hak pentadbir dalam tetapan kumpulan Telegram

Jenis pemberitahuan sistem berikut dialih keluar:

- Nama kumpulan telah ditukar

- Foto kumpulan telah ditukar

- Foto kumpulan dipadam

- Mesej disemat

- Pengguna menyertai kumpulan

- Pengguna telah meninggalkan kumpulan

Jika anda ingin memadam hanya jenis pemberitahuan sistem yang dipilih, maka daripada pembolehubah del_tg_system_messages, cipta pembolehubah del_tg_chosen_messages dan masukkan ke dalamnya tatasusunan dengan jenis pemberitahuan yang akan dipadam, dipisahkan dengan koma.

Sila ambil perhatian!

Pembolehubah ini hanya akan berfungsi untuk kumpulan Telegram, tetapi bukan untuk saluran.

Pilihan pemberitahuan sistem:

  • 'new_chat_member' – pengguna menyertai kumpulan,
  • 'left_chat_member' – pengguna meninggalkan kumpulan,
  • 'pinned_message' – mesej disemat,
  • 'delete_chat_photo' – foto kumpulan dipadam,
  • 'new_chat_photo' – foto kumpulan telah ditukar,
  • 'new_chat_title' – nama kumpulan telah ditukar

Sebagai contoh, anda perlu memadam semua jenis mesej sistem kecuali menyertai kumpulan; maka anda perlu menambah semua jenis panggil balik ke pembolehubah projek (pemalar) kecuali "new_chat_member".

Sila ambil perhatian!

Memadam pemberitahuan sistem tidak akan menjejaskan panggil balik. Hanya mesej sistem daripada dialog Telegram akan dipadamkan.

Forum dalam Telegram

Forum ialah kumpulan di mana anda boleh mencipta topik berasingan untuk perbincangan. Anda boleh menggunakan fungsi standard dalam forum: lampirkan fail media, siarkan tinjauan dan sediakan pemberitahuan. Anda juga boleh menyemat mesej dan menambah bot individu ke setiap sembang.

Tujuan utama forum adalah untuk menstrukturkan komunikasi dalam komuniti yang besar.

Dalam sembang kumpulan standard dengan ramai peserta, mengikuti perbualan dan mencari mesej yang berkaitan menjadi sukar. Forum menyelesaikan ini dengan menyusun perbincangan ke dalam benang tematik yang khusus. Ini secara automatik membahagikan komuniti mengikut topik dan minat, menjadikan komunikasi lebih fokus dan terurus.

Hanya pemilik kumpulan boleh mencipta topik jika terdapat lebih daripada 100 ahli dalam kumpulan. Jika kumpulan dipautkan ke saluran, maka anda tidak akan dapat mencipta tema. Topik didayakan dalam Tetapan kumpulan:

Sebagai pentadbir, anda boleh mencipta topik dalam tetapan kumpulan forum:

Selepas menyambungkan Topik, avatar akan bertukar daripada bulat kepada segi empat sama, yang membolehkan anda membezakan forum daripada sembang Telegram yang lain:

Bagaimana untuk mengkonfigurasi ikatan pelanggan Telegram dengan laman web?

Baca lebih lanjut tentang cara memautkan pelanggan telegram dan pelanggan dari laman web selepas pembayaran yang berjaya di sini.