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 menulis

    text - 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 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 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:
Contoh kamus JSON untuk menggantikan foto yang dihantar sebelum ini:
media = '{"type": "photo", "media": "<file_to_send>"}'

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)