Kā nosūtīt ziņojumus, izmantojot Telegram Business kontu

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)

Parametri:

Parametrs Apraksts
**!** platform_id Telegram lietotāja ID, kuram jānosūta ziņojums *
**!** text Ziņojuma teksts
client_message_id Ziņojuma ID, kas jācitē
reply_markup Pogu iestatījumi **
parse_mode Treknraksta un slīpraksta teksta formatēšana aprakstā ***. Tam var būt vērtības, piemēram, html, markdown, markdownV2.
disable_web_page_preview Rādīt saites priekšskatījumu. Lai to atspējotu, nododiet 1; pretējā gadījumā nododiet 0 vai atstājiet tukšu "".
protect_content Satura aizsardzības karodziņš. Nododiet jebkuru vērtību, izņemot 0, False vai '', lai iespējotu.
disable_notification Skaņas paziņojuma karodziņš (noklusējums: 0). Nododiet 1, lai atspējotu paziņojumu, 0, lai to iespējotu.
message_thread_id Tēmas ID (pieejams supergrupām ar iespējotu foruma funkcionalitāti)
entities Tas ļauj kopēt iepriekš formatētu tekstu kopā ar visiem tā stiliem un vienkārši norādīt rakstzīmju diapazonu, kurā jāpiemēro konkrēts fonts. Piemēru var atrast tg_request sadaļā zem atbilstošā lauka. Parametram jābūt vārdnīcai. Skatiet piemēru cilni atsaucei.
**Detalizēts piemērs**

Apskatīsim vienkāršu piemēru ar nepieciešamo parametru kopu:

Platform_id norāda konkrēta klienta identifikatoru.

Skatiet to pašu piemēru, bet izmantojot mainīgos:

Šajā piemērā mainīgais soob saturēs servera atbildi pēc ziņojuma nosūtīšanas.

Ja saglabāsiet message_id no saņemtās atbildes, tas ļaus vēlāk strādāt ar šo ziņojumu (rediģēt, dzēst, pārsūtīt, komentēt).

Bieži rodas grūtības, izmantojot visus parametrus. Apskatīsim šādu piemēru:

  • Vispirms deklarējiet visus funkcijā izmantotos parametrus. Atcerieties, ka parametrus var nodot ne tikai kā vērtības, bet arī kā mainīgos, kas bieži vien ir ērtāk un skaidrāk. Mainīgos, piemēram, platform_id un client_message_id, var iegūt no klienta profila kartes.
    platform_id — Telegram klienta ID, kuram jānosūta ziņojums *\ >Mēs atbildēsim tajā pašā tērzēšanas sarunā, kurā raksta klients

    text - ziņojuma teksts. \ >Mēs izmantojam teksta formatēšanu - piemēram, treknrakstu.

    client_message_id - Ziņojuma ID, kas jācitē\ >Tērzēšanas sarunās šim mainīgajam tiek automātiski piešķirta tā vērtība.
    reply_markup — pogu iestatījumi **. \ >Piešķirsim to mainīgajam opts.
    parse_mode — Treknraksta un slīpraksta teksta formatēšana aprakstā ***. Tam var būt vērtības, piemēram, html, markdown, markdownV2. Rakstzīmes, ko izmanto ziņojuma teksta formatēšanai, ir aprakstītas šeit. \ >Izmantosim markdown.
    disable_web_page_preview - Rādīt saites priekšskatījumu. Lai to atspējotu, nododiet 1; pretējā gadījumā nododiet 0 vai atstājiet tukšu "".\ >Mēs varam nodot jebkuru vērtību, jo ziņojuma teksts nesatur saiti.
    protect_content — Satura aizsardzības karodziņš. Nododiet jebkuru vērtību, izņemot 0, False vai '', lai iespējotu.\ >Mums nav nepieciešama satura aizsardzība, tāpēc nodosim tukšu virkni ''.
    disable_notification — Skaņas paziņojuma karodziņš (noklusējums: 0). Nododiet 1, lai atspējotu paziņojumu, 0, lai to iespējotu.\ >Paziņojums ir uznirstošs logs, kas parāda ziņojuma tekstu. Iespējosim to.

  • Pēc tam salieciet funkciju. Atcerieties piešķirt funkciju mainīgajam — tas ļaus izsekot ziņojuma nosūtīšanas statusam.

Lūk, ko mēs ieguvām:
Pēc tam, kad klients mums nosūta atslēgvārdu test, mēs atbildam, citējot viņa ziņojumu.

ok mēs redzam nosūtīšanas statusu; nākamā ir informācija par pašu ziņojumu — tā ID, sūtītāja dati un saturs.

Piemērs ar entities parametru
Jūs varat saglabāt sākotnējo virkni mainīgajā, kā parādīts zemāk:

text = "qwert asdfg zxcvb poiuy lkjhg 12345"

Parametrs jāraksta kā vārdnīca ar datiem un jānorāda vēlamais formatējums, norādot fontus:

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"}]

Nododiet parametru pēdējo izmantotajā funkcijā. Parametru var nodot gan funkcijai tg_send_message, gan tg_send_message_1:

x = tg_send_message(platform_id, text, None, None, None, False, False, False, None, entities)

Lai piešķirtu mainīgajam tekstu ar rindiņu pārtraukumiem, norādiet vērtību šādi:

text = "Pirmā teksta rindiņa" + "\n" + "Otrā teksta rindiņa" + "\n" + "Trešā rindiņa"

Kā nosūtīt ziņojumu, norādot konkrētu Telegram botu

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)

Parametrs Apraksts
**!** token Telegram bota marķieris, kas iegūts no BotFather
**!** platform_id Telegram lietotāja ID, kuram jānosūta ziņojums *
**!** text Ziņojuma teksts
client_message_id Ziņojuma ID, kas jācitē
reply_markup Pogu iestatījumi **
parse_mode Treknraksta un slīpraksta teksta formatēšana aprakstā ***. Tam var būt vērtības, piemēram, html, markdown, markdownV2.
disable_web_page_preview Rādīt saites priekšskatījumu. Lai to atspējotu, nododiet 1; pretējā gadījumā nododiet 0 vai atstājiet tukšu "".
protect_content Satura aizsardzības karodziņš. Nododiet jebkuru vērtību, izņemot 0, False vai '', lai iespējotu.
disable_notification Skaņas paziņojuma karodziņš (noklusējums: 0). Nododiet 1, lai atspējotu paziņojumu, 0, lai to iespējotu.
message_thread_id Tēmas ID (pieejams supergrupām ar iespējotu foruma funkcionalitāti)
entities Tas ļauj kopēt iepriekš formatētu tekstu kopā ar visiem tā stiliem un vienkārši norādīt rakstzīmju diapazonu, kurā jāpiemēro konkrēts fonts. Piemēru var atrast tg_request sadaļā zem atbilstošā lauka. Parametram jābūt vārdnīcai.
business_connection_id Biznesa ID vērtība tiek izmantota, pieslēdzot botu, un tiek parādīta kanālos. Tā jānorāda, ja parametros ir iekļauts bota marķieris un ziņojums jānosūta caur lietotāja kontu, kas ir saistīts ar botu.
Piemērs

Parametra nodošanas piemērs:
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"}]

Piemērā ir parādīta tikai vārdnīca, bet pats ziņojuma teksts ir piešķirts atsevišķam mainīgajam.

Kā rediģēt tekstu Telegram ziņojumā

Lūdzu, ņemiet vērā!

Ziņojuma rediģēšanas funkcija ir pieejama tikai jauniem un nesen nosūtītiem ziņojumiem.

Laika logs, kurā ir atļauta ziņojuma rediģēšana, tiek noteikts pašā kurjerā un ir atkarīgs no jūsu bota slodzes/aktivitātes; rediģēšanai tas var tikt saīsināts.

Saskaņā ar kurjera tehnisko atbalstu, optimālais laika posms ziņojuma rediģēšanai ir 48 stundas.

tg_edit_message_text(platform_id, message_id, text, reply_markup, parse_mode, disable_web_page_preview, entities)

Parametrs Apraksts
**!** platform_id Telegram lietotāja ID, kuram jānosūta ziņojums *
**!** message_id Ziņojuma ID, kas jārediģē. Šis ID ir iepriekš jāsaglabā, nosūtot ziņojumu.
**!** text Ziņojuma teksts
reply_markup Pogu iestatījumi **
parse_mode Treknraksta un slīpraksta teksta formatēšana aprakstā ***. Tam var būt vērtības, piemēram, html, markdown, markdownV2.
disable_web_page_preview Rādīt saites priekšskatījumu. Lai to atspējotu, nododiet 1; pretējā gadījumā nododiet 0 vai atstājiet tukšu "".
entities Tas ļauj kopēt iepriekš formatētu tekstu kopā ar visiem tā stiliem un vienkārši norādīt rakstzīmju diapazonu, kurā jāpiemēro konkrēts fonts. Piemēru var atrast tg_request sadaļā zem atbilstošā lauka. Parametram jābūt vārdnīcai.

Kā nosūtīt reakciju uz ziņojumu

tg_set_reaction(platform_id, message_id, reaction)

Parametrs Apraksts
**!** platform_id Telegram tērzēšanas sarunas ID
**!** message_id Ziņojuma ID
**!** reaction Nepieciešamā reakcija tiek nodota kā virkne.
Piemērs

Koda piemērs kopēšanai:

react = tg_set_reaction(platform_id, 1556, '👌')

Piemērs kalkulatorā:

Kā rediģēt pielikuma aprakstu

tg_edit_message_caption(platform_id, message_id, caption, reply_markup, parse_mode, entities, show_caption_above_media)

Parametrs Apraksts
**!** platform_id Telegram lietotāja ID, kuram jānosūta ziņojums *
**!** message_id Ziņojuma ID, kas jārediģē
**!** caption Apraksta teksts
reply_markup Pogu iestatījumi **
parse_mode Treknraksta un slīpraksta teksta formatēšana aprakstā ***. Tam var būt vērtības, piemēram, html, markdown, markdownV2.
entities

Tas ļauj kopēt iepriekš formatētu tekstu kopā ar visiem tā stiliem un vienkārši norādīt rakstzīmju diapazonu, kurā jāpiemēro konkrēts fonts. Piemēru var atrast tg_request sadaļā zem atbilstošā lauka. Parametram jābūt vārdnīcai.

Parametra nodošanas piemērs:
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"}]

Piemērā ir parādīta tikai vārdnīca, bet pats ziņojuma teksts ir piešķirts atsevišķam mainīgajam.

show_caption_above_media Izmanto vērtību True; ja šis parametrs ir norādīts, ziņojuma teksts tiks parādīts virs pielikuma.

Kā rediģēt multivides pielikumus ziņojumā

Parametrs Apraksts
**!** platform_id Telegram lietotāja ID, kuram jānosūta ziņojums *
**!** message_id Rediģējamā ziņojuma ID. Šis ID ir iepriekš jāsaglabā, nosūtot ziņojumu.
**!** media

Vārdnīca, kas apraksta multivides failu:
JSON vārdnīcas piemērs, lai aizstātu iepriekš nosūtītu fotoattēlu:
media = '{"type": "photo", "media": "<file_to_send>"}'

kur <file_to_send> ieteicams izmantot file_id, kas iegūts, izmantojot pilnu Telegram tīmekļa āķi.

Sīkāka informācija par vārdnīcas parametriem ir aprakstīta oficiālajā Telegram dokumentācijā.

reply_markup Pogu iestatījumi **

Kā rediģēt iekļauto tastatūru ziņojumā

Parametrs Apraksts
**!** platform_id Telegram lietotāja ID, kuram jānosūta ziņojums *
**!** message_id Rediģējamā ziņojuma ID. Šis ID ir iepriekš jāsaglabā, nosūtot ziņojumu.
**!** reply_markup Pogu iestatījumi **

Varat rediģēt tikai iekļauto tastatūru.

Piemērs: ziņojuma rediģēšana, izmantojot Telegram API

Zemāk varat atrast detalizētu piemēru darbam ar Telegram API funkcijām ziņojumu rediģēšanai.

Kā kopēt ziņojumu

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)

Parametrs Apraksts
**!** platform_id Telegram lietotāja ID, UZ kuru jākopē ziņojums *
**!** from_chat_id Telegram lietotāja ID, NO kura jākopē ziņojums *
**!** message_id Kopējamā ziņojuma ID
reply_to_message_id Sākotnējā ziņojuma ID, ja kopētais ziņojums ir komentārs
reply_markup Pogu iestatījumi **
parse_mode

Treknraksta un slīpraksta teksta formatēšana aprakstā ***.

Tas var būt html, markdown, markdownV2.

protect_content Satura aizsardzības karodziņš. Ievadiet jebkuru vērtību, izņemot 0, False vai '', lai iespējotu.
disable_notification Skaņas paziņojuma karodziņš (noklusējums: 0). Ievadiet 1, lai atspējotu paziņojumu, 0, lai to iespējotu.
caption - Apraksts līdz 1024 rakstzīmēm.
message_thread_id Tēmas ID (pieejams supergrupām ar iespējotu foruma funkcionalitāti)
entities Tas ļauj kopēt iepriekš formatētu tekstu kopā ar visiem tā stiliem un vienkārši norādīt rakstzīmju diapazonu, kurā jāpiemēro konkrēts fonts. Piemēru var atrast tg_request attiecīgajā laukā. Parametram jābūt vārdnīcai.

Parametra nodošanas piemērs:
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"}]

Piemērā ir parādīta tikai vārdnīca, savukārt pats ziņojuma teksts tiek piešķirts atsevišķam mainīgajam.
show_caption_above_media Pieņem vērtību True; ja šis parametrs ir norādīts, ziņojuma teksts tiks parādīts virs pielikuma.

Kā pārsūtīt ziņojumu

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

Parametrs Apraksts
**!** platform_id Telegram lietotāja ID, UZ kuru jānosūta ziņojums *
**!** from_chat_id Telegram lietotāja ID, NO kura jānosūta ziņojums *
**!** message_id Pārsūtāmā ziņojuma ID
protect_content Satura aizsardzības karodziņš. Ievadiet jebkuru vērtību, izņemot 0, False vai '', lai iespējotu.
disable_notification Skaņas paziņojuma karodziņš (noklusējums: 0). Ievadiet 1, lai atspējotu paziņojumu, 0, lai to iespējotu.
message_thread_id Tēmas ID (pieejams supergrupām ar iespējotu foruma funkcionalitāti)

Kā dzēst ziņojumu

tg_delete_message(platform_id, message_id)

! Izmantojiet šo metodi, lai dzēstu ziņojumu, ieskaitot sistēmas ziņojumus, ar šādiem ierobežojumiem:

  • Ziņojumu var dzēst tikai tad, ja tas ir nosūtīts mazāk nekā pirms 48 stundām.
  • Ziņojumus ar kauliņu privātajā tērzēšanā var dzēst tikai tad, ja tie ir nosūtīti vairāk nekā pirms 24 stundām.
  • Boti var dzēst izejošos ziņojumus privātajās tērzēšanās, grupās un supergrupās.
  • Boti var dzēst ienākošos ziņojumus privātajās tērzēšanās.
  • Boti ar atļauju can_post_messages var dzēst izejošos ziņojumus kanālos.
  • Ja bots ir grupas administrators, tas var dzēst jebkuru ziņojumu tajā.
  • Ja botam ir atļauja can_delete_messages supergrupā vai kanālā, tas var dzēst jebkuru ziņojumu tajā.
Parametrs Apraksts
**!** platform_id Telegram lietotāja ID *
**!** message_id Dzēšamā ziņojuma ID

Kā dzēst vairākus ziņojumus

tg_delete_messages(platform_id, message_ids)

! Izmantojiet šo metodi, lai dzēstu ziņojumu, ieskaitot sistēmas ziņojumus, ar šādiem ierobežojumiem:

  • Ziņojumu var dzēst tikai tad, ja tas ir nosūtīts mazāk nekā pirms 48 stundām.
  • Ziņojumus ar kauliņu privātajā tērzēšanā var dzēst tikai tad, ja tie ir nosūtīti vairāk nekā pirms 24 stundām.
  • Boti var dzēst izejošos ziņojumus privātajās tērzēšanās, grupās un supergrupās.
  • Boti var dzēst ienākošos ziņojumus privātajās tērzēšanās.
  • Boti ar atļauju can_post_messages var dzēst izejošos ziņojumus kanālos.
  • Ja bots ir grupas administrators, tas var dzēst jebkuru ziņojumu tajā.
  • Ja botam ir atļauja can_delete_messages supergrupā vai kanālā, tas var dzēst jebkuru ziņojumu tajā.
Parametrs Apraksts
**!** platform_id Telegram lietotāja ID
**!** message_ids Dzēšamo ziņojumu ID masīvs. Maksimāli 100 vienību.

Piemērs: ziņojuma nosūtīšana, izmantojot Telegram API

Koda piemērs kopēšanai
  1. piemērs
/*Ir ērti iepriekš definēt tekstu mainīgajā*/
text='Rakstu-rakstu-rakstu tekstu'
/*Nosūtīt ziņojuma funkcija*/
soob=tg_send_message(platform_id, text)
/*Saglabāt nosūtītā ziņojuma ID*/
soob_id=soob['result']['message_id']

  1. piemērs
id_group=-1001847103100
text='Ziņojuma nosūtīšanas testēšana, izmantojot API metodi. Piemēram, *treknraksts*'
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) 


Piemērs: ziņojuma rediģēšana, izmantojot Telegram API

Konfigurācijas piemērs

Tātad, nosūtīsim sev ziņojumu ar iekļauto tastatūru:

Pēc tam rediģēsim ziņojuma tekstu:

Un rediģēsim pogas:

Mēģināsim rediģēt ziņojumu ar attēlu. Lai to izdarītu, nosūtiet ziņojumu ar attēlu un saglabājiet nosūtītā ziņojuma ID. Izlasiet detalizētus norādījumus par to, kā iegūt attēla URL šeit:

Tagad rediģēsim attēlu un tā aprakstu:

Koda piemērs kopēšanai
/*Ir ērti iepriekš definēt parametrus mainīgajā.*/
text='Kādu pakotni vēlaties izvēlēties?'
opts = {"inline_keyboard": [[{"text": "1. pakotne","callback_data":1}, {"text": "2. pakotne","callback_data":2}]]}
/*Nosūtīt ziņojuma funkcija*/
soob=tg_send_message(platform_id, text, None, opts)
/*Saglabāt nosūtītā ziņojuma ID*/
soob_id=soob['result']['message_id']

/*Rediģēt ziņojumu*/
text='Kura pakotne jūs interesē?'
tg_edit_message_text(platform_id, soob_id, text, opts)  

/*Rediģēt iekļauto tastatūru*/
opts = {"inline_keyboard": [[{"text": "Standarta","callback_data":1}, {"text": "Premium","callback_data":2}]]}
tg_edit_message_reply_markup(platform_id, soob_id, opts)


/*Nosūtīt attēlu ar aprakstu*/
soob=tg_send_photo(platform_id, "AgACAgIAAxkBAAIPpWO4T7jhOgYHq6uR8rjnq9rIvBs-AAJlwDEb5fHASaGdhzgWjyn7AQADAgADeAADLQQ", "Šis ir attēls")
/*Saglabāt nosūtītā ziņojuma ID*/
soob_id=soob['result']['message_id']

/*Rediģēt attēlu*/
media='{"type": "photo", "media": "AgACAgIAAxkBAAIPrmO4UiH7Tazqn-3IbFVzPKNsVEZmAAJ1wDEb5fHASWcNXKah-egvAQADAgADeQADLQQ"}'
tg_edit_message_media(platform_id, soob_id, media)
/*Rediģēt attēla aprakstu*/
tg_edit_message_caption(platform_id, soob_id, 'Tas esmu ES!')

Piemērs: ziņojuma kopēšana, izmantojot Telegram API

Piemērs

Nosūtīsim ziņojumu un saglabāsim tā ID.

Un kopēsim iepriekš nosūtīto ziņojumu.

Koda piemērs kopēšanai
/*Ir ērti iepriekš definēt parametrus mainīgajā.*/
text='Kādu pakotni vēlaties izvēlēties?'
opts = {"inline_keyboard": [[{"text": "1. pakotne","callback_data":1}, {"text": "2. pakotne","callback_data":2}]]}
/*Nosūtīt ziņojuma funkcija*/
soob=tg_send_message(platform_id, text, None, opts)
/*Saglabāt nosūtītā ziņojuma ID*/
soob_id=soob['result']['message_id']


/*Kopēt nosūtīto ziņojumu*/
tg_copy_message('5081438490', '1840834360', soob_id, None, opts, None, None, 1)