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:

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)

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)

Cara menghantar reaksi kepada mesej

tg_set_reaction(platform_id, message_id, reaction)

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)

Cara mengedit lampiran media dalam mesej

Cara mengedit papan kekunci sebaris dalam mesej

Anda hanya boleh mengedit papan kekunci sebaris.

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)

Cara menghantar semula mesej

tg_forward_message(platform_id, from_chat_id, message_id, protect_content, disable_notification, message_thread_id)

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.

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.

Contoh: penghantaran mesej dengan API Telegram

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

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:

/*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

Mari hantar mesej dan simpan IDnya.

Dan salin mesej yang dihantar sebelum ini.

/*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)