Cara menghantar mesej menggunakan akaun Telegram Business
tg_send_message(platform_id, text, client_message_id, reply_markup, parse_mode, disable_web_page_preview, protect_content, disable_notification, message_thread_id, entities)
Parameter:
| Parameter | Penerangan |
|---|---|
| **!** platform_id | ID pengguna Telegram yang mana mesej harus dihantar * |
| **!** text | Teks mesej |
| client_message_id | ID mesej yang akan dipetik |
| reply_markup | Tetapan butang ** |
| parse_mode | Pemformatan teks tebal dan condong dalam penerangan ***. Ia boleh mempunyai nilai seperti html, markdown, markdownV2. |
| disable_web_page_preview | Tunjukkan pratonton pautan. Untuk melumpuhkannya, hantar 1; jika tidak, hantar 0 atau biarkan kosong "". |
| protect_content | Bendera perlindungan kandungan. Hantar sebarang nilai selain 0, False, atau '' untuk mengaktifkan. |
| disable_notification | Bendera pemberitahuan bunyi (lalai: 0). Hantar 1 untuk melumpuhkan pemberitahuan, 0 untuk mengaktifkannya. |
| message_thread_id | ID topik (tersedia untuk kumpulan super dengan fungsi forum diaktifkan) |
| entities | Ini membolehkan anda menyalin teks pra-format bersama semua gayanya dan hanya menentukan julat aksara di mana fon tertentu harus digunakan. Contoh boleh didapati dalam tg_request di bawah medan yang sepadan. Parameter mestilah kamus. Lihat tab contoh untuk rujukan. |
**Contoh terperinci**
Mari kita pertimbangkan contoh mudah dengan set parameter yang diperlukan:

platform_id menentukan pengecam pelanggan tertentu.
Lihat contoh yang sama, tetapi menggunakan pembolehubah:

Dalam contoh ini, pembolehubah soob akan mengandungi respons pelayan selepas menghantar mesej.

Jika anda menyimpan message_id daripada respons yang diterima, ia akan membolehkan anda kemudiannya bekerja dengan mesej ini (edit, padam, hantar semula, komen).
Kesukaran sering timbul apabila menggunakan semua parameter. Mari kita pertimbangkan contoh berikut:
-
Pertama, isytiharkan semua parameter yang digunakan dalam fungsi. Ingat, parameter boleh dihantar bukan sahaja sebagai nilai tetapi juga sebagai pembolehubah, yang selalunya lebih mudah dan lebih jelas. Pembolehubah seperti platform_id dan client_message_id boleh diperoleh daripada kad profil pelanggan.
platform_id — ID pelanggan Telegram yang mana mesej harus dihantar *\ >Kami akan membalas dalam sembang yang sama di mana pelanggan menulistext - teks mesej. \ >Kami menggunakan pemformatan teks - contohnya, penonjolan tebal.
client_message_id - ID mesej untuk dipetik\ >Dalam sembang, pembolehubah ini diberikan nilainya secara automatik.
reply_markup — tetapan butang **. \ >Mari kita tetapkan kepada pembolehubah opts.
parse_mode — Pemformatan teks tebal dan condong dalam penerangan ***. Ia boleh mempunyai nilai seperti html, markdown, markdownV2. Aksara yang digunakan untuk memformat teks mesej diterangkan di sini. \ >Mari gunakan markdown.
disable_web_page_preview - Tunjukkan pratonton pautan. Untuk melumpuhkannya, hantar 1; jika tidak, hantar 0 atau biarkan kosong "".\ >Kami boleh menghantar sebarang nilai kerana teks mesej tidak mengandungi pautan.
protect_content — Bendera perlindungan kandungan. Hantar sebarang nilai selain 0, False, atau '' untuk mengaktifkan.\ >Kami tidak memerlukan perlindungan kandungan, jadi kami akan menghantar rentetan kosong ''.
disable_notification — Bendera pemberitahuan bunyi (lalai: 0). Hantar 1 untuk melumpuhkan pemberitahuan, 0 untuk mengaktifkannya.\ >Pemberitahuan ialah tetingkap timbul yang memaparkan teks mesej. Mari kita aktifkannya. -
Seterusnya, kami memasang fungsi. Ingat untuk menetapkan fungsi kepada pembolehubah — ini akan membolehkan anda menjejaki status penghantaran mesej.

Inilah yang kami dapat:
Selepas pelanggan menghantar kata kunci ujian kepada kami, kami membalas dengan memetik mesejnya.
Dalam ok kita melihat status penghantaran; seterusnya datang maklumat tentang mesej itu sendiri — IDnya, data pengirim, dan kandungan.
Contoh dengan parameter entities
Anda boleh menyimpan rentetan asal dalam pembolehubah, seperti yang ditunjukkan di bawah:
text = "qwert asdfg zxcvb poiuy lkjhg 12345"
Anda harus menulis parameter sebagai kamus dengan data dan menentukan pemformatan yang dikehendaki dengan menunjukkan fon:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"`` https://mavibot.ai"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]
Hantar parameter terakhir dalam fungsi yang anda gunakan. Parameter boleh dihantar kepada kedua-dua fungsi tg_send_message dan tg_send_message_1:
x = tg_send_message(platform_id, text, None, None, None, False, False, False, None, entities)
Untuk menetapkan teks dengan pemisah baris kepada pembolehubah, nyatakan nilai seperti berikut:
text = "Baris pertama teks" + "\n" + "Baris kedua teks" + "\n" + "Baris ketiga"
Cara menghantar mesej dengan menentukan bot Telegram tertentu
tg_send_message_1(token, platform_id, text, client_message_id, reply_markup, parse_mode, disable_web_page_preview, protect_content, disable_notification, message_thread_id, entities, business_connection_id)
| Parameter | Penerangan |
|---|---|
| **!** token | Token bot Telegram yang diperoleh daripada BotFather |
| **!** platform_id | ID pengguna Telegram yang mana mesej harus dihantar * |
| **!** text | Teks mesej |
| client_message_id | ID mesej yang akan dipetik |
| reply_markup | Tetapan butang ** |
| parse_mode | Pemformatan teks tebal dan condong dalam penerangan ***. Ia boleh mempunyai nilai seperti html, markdown, markdownV2. |
| disable_web_page_preview | Tunjukkan pratonton pautan. Untuk melumpuhkannya, hantar 1; jika tidak, hantar 0 atau biarkan kosong "". |
| protect_content | Bendera perlindungan kandungan. Hantar sebarang nilai selain 0, False, atau '' untuk mengaktifkan. |
| disable_notification | Bendera pemberitahuan bunyi (lalai: 0). Hantar 1 untuk melumpuhkan pemberitahuan, 0 untuk mengaktifkannya. |
| message_thread_id | ID topik (tersedia untuk kumpulan super dengan fungsi forum diaktifkan) |
| entities | Ini membolehkan anda menyalin teks pra-format bersama semua gayanya dan hanya menentukan julat aksara di mana fon tertentu harus digunakan. Contoh boleh didapati dalam tg_request di bawah medan yang sepadan. Parameter mestilah kamus. |
| business_connection_id | Nilai ID Perniagaan digunakan semasa menyambungkan bot dan dipaparkan dalam saluran. Ia harus diberikan jika token bot disertakan dalam parameter dan mesej perlu dihantar melalui akaun pengguna yang dipautkan ke bot. |
Contoh
Contoh menghantar parameter:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://mavibot.ai"},{"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 ditetapkan kepada pembolehubah yang berasingan.
Cara mengedit teks dalam mesej Telegram
Sila ambil perhatian!
Fungsi pengeditan mesej hanya tersedia untuk mesej baharu dan yang baru dihantar.
Tetingkap masa di mana pengeditan mesej dibenarkan ditentukan oleh utusan itu sendiri dan bergantung pada beban/aktiviti bot anda; ia mungkin dipendekkan untuk pengeditan.
Menurut sokongan teknikal utusan, jangka masa optimum untuk mengedit mesej ialah 48 jam.
tg_edit_message_text(platform_id, message_id, text, reply_markup, parse_mode, disable_web_page_preview, entities)
| Parameter | Penerangan |
|---|---|
| **!** platform_id | ID pengguna Telegram yang mana mesej harus dihantar * |
| **!** message_id | ID mesej yang akan diedit. ID ini mesti disimpan terlebih dahulu semasa menghantar mesej. |
| **!** text | Teks mesej |
| reply_markup | Tetapan butang ** |
| parse_mode | Pemformatan teks tebal dan condong dalam penerangan ***. Ia boleh mempunyai nilai seperti html, markdown, markdownV2. |
| disable_web_page_preview | Tunjukkan pratonton pautan. Untuk melumpuhkannya, hantar 1; jika tidak, hantar 0 atau biarkan kosong "". |
| entities | Ini membolehkan anda menyalin teks pra-format bersama semua gayanya dan hanya menentukan julat aksara di mana fon tertentu harus digunakan. Contoh boleh didapati dalam tg_request di bawah medan yang sepadan. Parameter mestilah kamus. |
Cara menghantar reaksi kepada mesej
tg_set_reaction(platform_id, message_id, reaction)
| Parameter | Penerangan |
|---|---|
| **!** platform_id | ID sembang Telegram |
| **!** message_id | ID mesej |
| **!** reaction | Reaksi yang diperlukan dihantar sebagai rentetan. |
Contoh
Contoh kod untuk menyalin:
react = tg_set_reaction(platform_id, 1556, '👌')
Contoh dalam kalkulator:

Cara mengedit penerangan lampiran
tg_edit_message_caption(platform_id, message_id, caption, reply_markup, parse_mode, entities, show_caption_above_media)
| Parameter | Penerangan |
|---|---|
| **!** platform_id | ID pengguna Telegram yang mana mesej harus dihantar * |
| **!** message_id | ID mesej yang akan diedit |
| **!** caption | Teks penerangan |
| reply_markup | Tetapan butang ** |
| parse_mode | Pemformatan teks tebal dan condong dalam penerangan ***. Ia boleh mempunyai nilai seperti html, markdown, markdownV2. |
| entities |
Ini membolehkan anda menyalin teks pra-format bersama semua gayanya dan hanya menentukan julat aksara di mana fon tertentu harus digunakan. Contoh boleh didapati dalam tg_request di bawah medan yang sepadan. Parameter mestilah kamus. Contoh menunjukkan hanya kamus, manakala teks mesej itu sendiri ditetapkan kepada pembolehubah yang berasingan. |
| show_caption_above_media | Mengambil nilai True; jika parameter ini ditentukan, teks mesej akan dipaparkan di atas lampiran. |
Cara mengedit lampiran media dalam mesej
| Parameter | Penerangan |
|---|---|
| **!** platform_id | ID pengguna Telegram yang mana mesej harus dihantar * |
| **!** message_id | ID mesej yang akan diedit. ID ini mesti disimpan terlebih dahulu semasa menghantar mesej. |
| **!** media |
Kamus yang menerangkan fail media:
di mana <file_to_send> disyorkan untuk menjadi file_id yang diperoleh melalui webhook Telegram penuh. Untuk butiran lanjut, parameter untuk kamus diterangkan dalam dokumentasi Telegram rasmi. |
| reply_markup | Tetapan butang ** |
Cara mengedit papan kekunci sebaris dalam mesej
| Parameter | Penerangan |
|---|---|
| **!** platform_id | ID pengguna Telegram yang mana mesej harus dihantar * |
| **!** message_id | ID mesej yang akan diedit. ID ini mesti disimpan terlebih dahulu semasa menghantar mesej. |
| **!** reply_markup | Tetapan butang ** |
Anda hanya boleh mengedit papan kekunci sebaris.
Contoh: pengeditan mesej dengan API Telegram
Anda boleh mencari contoh terperinci bekerja dengan fungsi API Telegram untuk mengedit mesej di bawah.
Cara menyalin mesej
tg_copy_message(platform_id, from_chat_id, message_id, reply_to_message_id, reply_markup, parse_mode, protect_content, disable_notification, caption, message_thread_id, entities, show_caption_above_media)
| Parameter | Penerangan |
|---|---|
| **!** platform_id | ID pengguna Telegram KE mana mesej harus disalin * |
| **!** from_chat_id | ID pengguna Telegram DARI mana mesej harus disalin * |
| **!** message_id | ID mesej yang akan disalin |
| reply_to_message_id | ID mesej asal jika mesej yang disalin adalah komen |
| reply_markup | Tetapan butang ** |
| parse_mode |
Pemformatan teks tebal dan condong dalam penerangan ***. Ia boleh mempunyai nilai seperti html, markdown, markdownV2. |
| protect_content | Bendera perlindungan kandungan. Hantar sebarang nilai selain 0, False, atau '' untuk mengaktifkan. |
| disable_notification | Bendera pemberitahuan bunyi (lalai: 0). Hantar 1 untuk melumpuhkan pemberitahuan, 0 untuk mengaktifkannya. |
| caption - | Penerangan sehingga 1024 aksara. |
| message_thread_id | ID topik (tersedia untuk kumpulan super dengan fungsi forum diaktifkan) |
| entities | Ini membolehkan anda menyalin teks pra-format bersama semua gayanya dan hanya menentukan julat aksara di mana fon tertentu harus digunakan. Contoh boleh didapati dalam tg_request di bawah medan yang sepadan. Parameter mestilah kamus. Contoh menghantar parameter: entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":**"https://mavibot.ai"}**,{"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 ditetapkan kepada pembolehubah yang berasingan. |
| show_caption_above_media | Mengambil nilai True; jika parameter ini ditentukan, teks mesej akan dipaparkan di atas lampiran. |
Cara menghantar semula mesej
tg_forward_message(platform_id, from_chat_id, message_id, protect_content, disable_notification, message_thread_id)
| Parameter | Penerangan |
|---|---|
| **!** platform_id | ID pengguna Telegram KE mana mesej harus dihantar * |
| **!** from_chat_id | ID pengguna Telegram DARI mana mesej harus dihantar * |
| **!** message_id | ID mesej yang akan dihantar semula |
| protect_content | Bendera perlindungan kandungan. Hantar sebarang nilai selain 0, False, atau '' untuk mengaktifkan. |
| disable_notification | Bendera pemberitahuan bunyi (lalai: 0). Hantar 1 untuk melumpuhkan pemberitahuan, 0 untuk mengaktifkannya. |
| message_thread_id | ID topik (tersedia untuk kumpulan super dengan fungsi forum diaktifkan) |
Cara memadam mesej
tg_delete_message(platform_id, message_id)
! Gunakan kaedah ini untuk memadam mesej, termasuk mesej perkhidmatan, dengan sekatan berikut:
- Mesej hanya boleh dipadam jika ia dihantar kurang daripada 48 jam yang lalu.
- Mesej dengan dadu dalam sembang peribadi hanya boleh dipadam jika ia dihantar lebih daripada 24 jam yang lalu.
- Bot boleh memadam mesej keluar dalam sembang peribadi, kumpulan, dan kumpulan super.
- Bot boleh memadam mesej masuk dalam sembang peribadi.
- Bot dengan kebenaran can_post_messages boleh memadam mesej keluar dalam saluran.
- Jika bot adalah pentadbir kumpulan, ia boleh memadam sebarang mesej di sana.
- Jika bot mempunyai kebenaran can_delete_messages dalam kumpulan super atau saluran, ia boleh memadam sebarang mesej di sana.
| Parameter | Penerangan |
|---|---|
| **!** platform_id | ID pengguna Telegram * |
| **!** message_id | ID mesej yang akan dipadam |
Cara memadam berbilang mesej
tg_delete_messages(platform_id, message_ids)
! Gunakan kaedah ini untuk memadam mesej, termasuk mesej perkhidmatan, dengan sekatan berikut:
- Mesej hanya boleh dipadam jika ia dihantar kurang daripada 48 jam yang lalu.
- Mesej dengan dadu dalam sembang peribadi hanya boleh dipadam jika ia dihantar lebih daripada 24 jam yang lalu.
- Bot boleh memadam mesej keluar dalam sembang peribadi, kumpulan, dan kumpulan super.
- Bot boleh memadam mesej masuk dalam sembang peribadi.
- Bot dengan kebenaran can_post_messages boleh memadam mesej keluar dalam saluran.
- Jika bot adalah pentadbir kumpulan, ia boleh memadam sebarang mesej di sana.
- Jika bot mempunyai kebenaran can_delete_messages dalam kumpulan super atau saluran, ia boleh memadam sebarang mesej di sana.
| Parameter | Penerangan |
|---|---|
| **!** platform_id | ID pengguna Telegram |
| **!** message_ids | Tatasusunan ID mesej yang akan dipadam. Maksimum 100 item. |
Contoh: penghantaran mesej dengan API Telegram
Contoh kod untuk menyalin
Contoh 1
/*Lebih mudah untuk menentukan teks dalam pembolehubah terlebih dahulu*/
text='Menulis-menulis-menulis teks'
/*Fungsi hantar mesej*/
soob=tg_send_message(platform_id, text)
/*Simpan ID mesej yang dihantar*/
soob_id=soob['result']['message_id']
Contoh 2
id_group=-1001847103100
text='Menguji penghantaran mesej melalui kaedah API. Contohnya, *teks tebal*'
opts = {"inline_keyboard": [[{"text": "👍","callback_data":1}, {"text": "👎","callback_data":2}]]}
disable_web_page_preview=1
protect_content=''
disable_notification=1
parse_mode='markdown'
soob=tg_send_message(id_group, text,client_message_id, opts, parse_mode, disable_web_page_preview, protect_content, disable_notification)
Contoh: pengeditan mesej dengan API Telegram
Contoh konfigurasi
Jadi, mari hantar mesej kepada diri sendiri dengan papan kekunci sebaris:

Seterusnya, edit teks mesej:

Dan edit butang:

Mari cuba edit mesej dengan imej. Untuk melakukan ini, hantar mesej dengan imej dan simpan ID mesej yang dihantar. Baca arahan terperinci tentang cara mendapatkan URL imej di sini:

Sekarang, mari edit imej dan penerangannya:

Contoh kod untuk menyalin
/*Lebih mudah untuk menentukan parameter dalam pembolehubah terlebih dahulu.*/
text='Pakej mana yang anda ingin pilih?'
opts = {"inline_keyboard": [[{"text": "Pakej 1","callback_data":1}, {"text": "Pakej 2","callback_data":2}]]}
/*Fungsi hantar mesej*/
soob=tg_send_message(platform_id, text, None, opts)
/*Simpan ID mesej yang dihantar*/
soob_id=soob['result']['message_id']
/*Edit mesej*/
text='Pakej mana yang anda minati?'
tg_edit_message_text(platform_id, soob_id, text, opts)
/*Edit papan kekunci sebaris*/
opts = {"inline_keyboard": [[{"text": "Standard","callback_data":1}, {"text": "Premium","callback_data":2}]]}
tg_edit_message_reply_markup(platform_id, soob_id, opts)
/*Hantar imej dengan penerangan*/
soob=tg_send_photo(platform_id, "AgACAgIAAxkBAAIPpWO4T7jhOgYHq6uR8rjnq9rIvBs-AAJlwDEb5fHASaGdhzgWjyn7AQADAgADeAADLQQ", "Ini adalah imej")
/*Simpan ID mesej yang dihantar*/
soob_id=soob['result']['message_id']
/*Edit imej*/
media='{"type": "photo", "media": "AgACAgIAAxkBAAIPrmO4UiH7Tazqn-3IbFVzPKNsVEZmAAJ1wDEb5fHASWcNXKah-egvAQADAgADeQADLQQ"}'
tg_edit_message_media(platform_id, soob_id, media)
/*Edit penerangan imej*/
tg_edit_message_caption(platform_id, soob_id, 'Ini adalah SAYA!')
Contoh: penyalinan mesej dengan API Telegram
Contoh
Mari hantar mesej dan simpan IDnya.

Dan salin mesej yang dihantar sebelum ini.

Contoh kod untuk menyalin
/*Lebih mudah untuk menentukan parameter dalam pembolehubah terlebih dahulu.*/
text='Pakej mana yang anda ingin pilih?'
opts = {"inline_keyboard": [[{"text": "Pakej 1","callback_data":1}, {"text": "Pakej 2","callback_data":2}]]}
/*Fungsi hantar mesej*/
soob=tg_send_message(platform_id, text, None, opts)
/*Simpan ID mesej yang dihantar*/
soob_id=soob['result']['message_id']
/*Salin mesej yang dihantar*/
tg_copy_message('5081438490', '1840834360', soob_id, None, opts, None, None, 1)