Funkcijas pielikumu nosūtīšanai ziņojumos

! Šīs funkcijas ļauj nosūtīt jebkura veida failus. Ieteicamie formāti: GIF, PDF, ZIP līdz 2GB.

! Darbs ar Telegram biznesa kontu

tg_send_document(platform_id, document, caption, reply_markup, parse_mode,reply_to_message_id, protect_content, disable_notification, message_thread_id, entities)

Parametri:

! platform_id — klienta identifikators Telegram, kuram jānosūta ziņojums *

! document - saite uz dokumentu Telegram serverī. Saite iegūšana, izmantojot tg_request, ir aprakstīta šeit.

caption - apraksts, līdz 1024 rakstzīmēm

reply_markup — pogu iestatījumi **

parse_mode — teksta formatējums aprakstā (treknraksts vai slīpraksts) ***. Iespējamās vērtības: html, markdown, markdownV2. saite

reply_to_message_id - ziņojuma ID, uz kuru atbildēt (t.i., citāts)

protect_content — karodziņš satura aizsardzībai pret kopēšanu. Lai iespējotu, nodod jebkuru vērtību, kas nav 0, False vai tukšas pēdiņas ''.

disable_notification — karodziņš skaņas paziņojumu kontrolei (noklusējums: 0).
1 - nosūtīt bez paziņojuma, 0 - nosūtīt ar paziņojumu

message_thread_id — pavediena identifikators (pieejams supergrupās ar foruma funkcionalitāti)

entities — ļauj atkārtoti izmantot iepriekš formatētu tekstu ar stiliem. Vienkārši definējiet rakstzīmju nobīdi un diapazonu formatēšanai. Piemērs pieejams tg_request attiecīgajā laukā. 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://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

Šajā piemērā ir parādīta tikai vārdnīca, bet faktiskais ziņojuma teksts ir definēts atsevišķā mainīgajā.

Lai vienkāršotu pogu kopas aprakstu, varat izmantot šādu lifehack.

! Šīs funkcijas ļauj nosūtīt jebkura veida failus. Ieteicamie formāti: GIF, PDF, ZIP līdz 2GB.

tg_send_some_document(platform_id, document_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

Parametri:

! platform_id — klienta identifikators Telegram, kuram jānosūta ziņojums *

! document_list - dokumentu masīvs. Šāda masīva izveides piemērs ir sniegts zemāk

disable_notification — karodziņš skaņas paziņojumu kontrolei (noklusējums: 0).
1 - nosūtīt bez paziņojuma, 0 - nosūtīt ar paziņojumu

protect_content — karodziņš satura aizsardzībai pret kopēšanu. Lai iespējotu, nodod jebkuru vērtību, kas nav 0, False vai tukšas pēdiņas ''.

reply_to_message_id - ziņojuma ID, uz kuru atbildēt (t.i., citāts)

message_thread_id — pavediena identifikators (pieejams supergrupās ar foruma funkcionalitāti)

Dokumentu masīva document_list izveides piemērs:
'[["Document link", "caption", "parse_mode"], ["Document link 2"], ["Document link 3", "caption"]]'

Datu formatēšanas piemērs vienam dokumentam
["Document link", "caption", "parse_mode"]

Parametru secība ir svarīga! Veidojot dokumentu masīvu, pēdiņas " " var izlaist.

Parametru apraksts dokumentu masīvam document_list:
! Document link - dokumenta saite no Telegram servera. Saite iegūšana, izmantojot tg_request, ir aprakstīta šeit
caption — apraksts līdz 1024 rakstzīmēm
parse_mode — apraksta formatējums, t.i., teksta izcelšana treknrakstā vai slīprakstā ***

Apskatīsim piemēru, kā nosūtīt vienu dokumentu, pievienojot inline pogas un aprakstu dokumentam:

1. Vispirms iegūstiet saiti uz savu dokumentu. Detalizēts skaidrojums, kā to izdarīt, ir atrodams šeit.

2. Izveidojiet bloku un iestatiet mainīgos, kā parādīts ekrānuzņēmumā:
   

   

3. Nosūtiet bloku sev un skatiet mūsu darba rezultātu:

Tagad apskatīsim vairāku dokumentu nosūtīšanu.

1. Šeit arī jāiegūst iekšējā Telegram saite katram dokumentam un jāizveido masīvs.
   lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'
2. Visbeidzot, salieciet kopā funkciju dokumentu nosūtīšanai:

3. Un pārbaudiet darba rezultātu:

Atcerieties, ka saites ir unikālas katram botam, tāpēc noteikti ģenerējiet savas saites

Koda piemērs viena dokumenta nosūtīšanai:

lnkdoc= "BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ"
opts = {"inline_keyboard": [[{"text": "Excellent","callback_data":"Answer1"}, {"text": "Not accepted","callback_data":"Answer2"}]]}
soob=tg_send_document(platform_id, lnkdoc, "Document sending", opts) 

Koda piemērs vairāku dokumentu nosūtīšanai:

lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'
soob=tg_send_some_document(platform_id, lnkdoc)

! Šī funkcija ļauj nosūtīt balss failus .OGG formātā, kas kodēti ar OPUS, līdz 2 GB lielumā.

! Darbs tikai ar Telegram biznesa kontu

tg_send_voice(platform_id, voice, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, disable_notification, message_thread_id, entities)

Parametri:

! platform_id — klienta identifikators Telegram, kuram jānosūta ziņojums *

! voice - saite uz balss ziņojumu .OGG formātā

caption - apraksts līdz 1024 rakstzīmēm

reply_markup — pogu iestatījumi **

parse_mode — teksta formatējums aprakstā treknrakstā vai slīprakstā ***. Iespējamās vērtības: html, markdown, markdownV2.

reply_to_message_id - ziņojuma ID, uz kuru atbildēt (t.i., citāts)

protect_content — karodziņš satura aizsardzībai pret kopēšanu. Lai iespējotu, nodod jebkuru vērtību, izņemot 0, False vai tukšas pēdiņas ''.

disable_notification — karodziņš ziņojuma nosūtīšanai ar skaņas paziņojumu (noklusējums ir 0) 1 - atspējot paziņojumu saņemšanas brīdī, 0 - nosūtīt ar paziņojumu

message_thread_id — tēmas identifikators (pieejams supergrupās, ja ir iespējota foruma funkcija).

entities — ar šo parametru varat vienkārši kopēt formatētu tekstu ar visām tā īpašībām un norādīt, no kuras rakstzīmes līdz kurai tas tiks parādīts ar noteiktu stilu. Piemēru varat apskatīt 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://salebot.zmservice.ru"},{"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 ziņojuma teksts ir definēts mainīgajā.

Lai vienkāršotu pogu kopas aprakstu, varat izmantot šādu lifehack

! Šī funkcija ļauj nosūtīt audio failus .MP3 vai .M4A formātā ar maksimālo izmēru 2GB.

! Darbs ar Telegram biznesa kontu

tg_send_some_audio(platform_id, audio_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

Parametri:

! platform_id — klienta identifikators Telegram, kuram jānosūta ziņojums *

! audio_list - audio failu masīvs (sīkāk zemāk)

disable_notification — karodziņš ziņojuma nosūtīšanai ar vai bez skaņas paziņojuma (noklusējums: 0). 1 — nosūtīt bez paziņojuma, 0 — nosūtīt ar paziņojumu

protect_content — karodziņš satura aizsardzībai pret kopēšanu. Lai iespējotu, nodod jebkuru vērtību, izņemot 0, False vai tukšas pēdiņas ''.

reply_to_message_id - ziņojuma ID, uz kuru atbildēt (t.i., citāts)

message_thread_id — tēmas ID (pieejams supergrupās ar foruma funkcionalitāti)

Audio_list masīva izveides piemērs:
'[["Audio link 1", "caption", "parse_mode"], ["Audio link 2"], ["Audio link 3", "caption"]]'

Viena audio piemērs:
["Audio link", "caption", "parse_mode"]

Parametru secība ir svarīga! Veidojot audio failu masīvu, pēdiņas "" var izlaist

Parametru apraksts:
! Audio link - saite uz audio failu .OGG formātā
caption — apraksts (līdz 1024 rakstzīmēm)
parse_mode — teksta formatējums aprakstā treknrakstā vai slīprakstā ***

Kā minēts iepriekš, funkcija darbojas ar .OGG failiem. Tāpēc pirmais uzdevums ir iegūt audio ierakstu šajā formātā.
Ja jums ir .MP3 fails, varat to pārveidot par .OGG, izmantojot https://t.me/mp3toolsbot botu.

Pēc tam nosūtiet iegūto failu sev botā, lai iegūtu file_id, ievērojot šeit aprakstīto algoritmu.

Tagad salieciet funkciju:

Lieliski! Labi padarīts!

Atcerieties, ka saites ir unikālas katram botam, tāpēc noteikti ģenerējiet savas saites

tg_send_voice(platform_id, "CQACAgIAAxkBAAER70Bi8VkgNhegB-msqDWXm2qHi3n9-AAC-iAAAk6giUvIXkW-XzBN0ikE")

Ja ziņojumu neizdodas nosūtīt privātuma iestatījumu dēļ, tiek atgriezta šāda kļūda:

{"ok":false,"error_code":400,"description":"Bad Request: user restricted receiving of voice messages"}

Kļūdas cēlonis: lietotāja privātuma iestatījumos ir opcija “Nesaņemt balss ziņojumus” (vai nu no visiem, vai tikai no noteiktiem lietotājiem):

Pat ja lietotājs atspējo šo privātuma ierobežojumu, kļūda joprojām turpinās parādīties.

! Šī funkcija ļauj nosūtīt GIF vai H.264/MPEG-4 AVC video bez skaņas ar maksimālo izmēru 2GB.

! Darbs ar Telegram biznesa kontu

tg_send_animation(platform_id, animation, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media)

Parametri:

! platform_id — Telegram klienta ID, kuram jānosūta ziņojums. *

! animation — saite uz animāciju. Kā iegūt saiti, izmantojot tg_request, ir paskaidrots šeit

caption — apraksts līdz 1024 rakstzīmēm

reply_markup — pogu konfigurācija **

parse_mode — teksta formatējums aprakstā treknrakstā vai slīprakstā ***. Iespējamās vērtības: html, markdown, markdownV2

reply_to_message_id — ziņojuma ID, uz kuru atbildēt (t.i., citāts)

protect_content — karogs satura aizsardzībai pret kopēšanu. Lai iespējotu, nodod jebkuru vērtību, kas nav 0, False vai tukšas pēdiņas ''.

has_spoiler — iespējo spoileri. Lai iespējotu, iestati True.

disable_notification — karogs ziņojuma nosūtīšanai ar vai bez skaņas paziņojuma (noklusējums: 0). 1 — nosūtīt bez paziņojuma, 0 — nosūtīt ar paziņojumu

message_thread_id — pavediena ID (pieejams supergrupās ar foruma funkcionalitāti)

entities — ar šo parametru jūs varat vienkārši nokopēt formatētu tekstu ar visām tā īpašībām un norādīt, no kuras rakstzīmes līdz kurai tas tiks parādīts ar noteiktu stilu. Piemēru varat pārbaudīt tg_request attiecīgajā laukā. Parametram jābūt vārdnīcai.

show_caption_above_media — ja iestatīts uz True, ziņojuma apraksts tiks parādīts virs multivides

Parametra nodošanas piemērs:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

Šajā piemērā ir parādīta tikai vārdnīca, bet pats ziņojuma teksts tiek glabāts mainīgajā

Lai vienkāršotu pogu komplektu aprakstus, varat izmantot šo lifehack

Padarīsim uzdevumu sarežģītāku un nosūtīsim animāciju ar kopēšanas un spoileru aizsardzību.

Kā vienmēr, process sākas ar iekšējās Telegram saites iegūšanu izvēlētajai animācijai (detaļas šeit).

Visbeidzot, salieciet funkciju:

Un pārbaudiet darba rezultātu:

Atcerieties, ka saites ir unikālas katram botam, tāpēc noteikti ģenerējiet savas saites

animation="CgACAgIAAxkBAAIQDWO9Dbb0QODBmI_CUMhKHoWch7MDAAJBIQACtjXoScUjA-n5kGCYLQQ"
caption = "Happy New Year!"
soob=tg_send_animation(platform_id, animation, caption, None, None, None, True,True)

! Šī funkcija ļauj nosūtīt MPEG4 failus līdz 2GB lielumā. (Citus formātus var nosūtīt kā failus, izmantojot tg_send_document())

! Darbs ar Telegram biznesa kontu

tg_send_video(platform_id, video, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media, cover)

Parametri:

! platform_id — Telegram klienta ID, kuram jānosūta ziņojums *

! video — video saite. Kā iegūt saites, izmantojot tg_request, skatīt šeit

caption — apraksts līdz 1024 rakstzīmēm

reply_markup — pogu iestatījumi **

parse_mode — teksta formatējums aprakstā treknrakstā vai slīprakstā ***. Iespējamās vērtības: html, markdown, markdownV2.

reply_to_message_id — ziņojuma ID, uz kuru atbildēt (t.i., citāts)

protect_content — karogs satura aizsardzībai pret kopēšanu. Lai iespējotu, nodod jebkuru vērtību, kas nav 0, False vai tukšas pēdiņas ''.

has_spoiler — iespējo spoileri. Lai iespējotu, iestati True

disable_notification — karogs ziņojuma nosūtīšanai ar skaņas paziņojumu (noklusējums: 0). 1 — nosūtīt bez paziņojuma, 0 — nosūtīt ar paziņojumu

message_thread_id — pavediena ID (pieejams supergrupās ar foruma funkcionalitāti)

entities — ar šo parametru jūs varat vienkārši nokopēt formatētu tekstu ar visām tā īpašībām un norādīt, no kuras rakstzīmes līdz kurai tas tiks parādīts ar noteiktu stilu. Piemēru varat pārbaudīt tg_request attiecīgajā laukā. Parametram jābūt vārdnīcai.

show_caption_above_media — ja iestatīts uz True, ziņojuma teksts tiks parādīts virs multivides.

cover — video vāka attēls ziņojumā. URL iegūšana, izmantojot tg_request, ir šeit.

Parametra nodošanas piemērs:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

Šajā piemērā ir parādīta tikai vārdnīca, bet pats ziņojuma teksts tiek glabāts mainīgajā

Lai vienkāršotu pogu komplektu aprakstus, varat izmantot šo lifehack

! Darbs ar Telegram biznesa kontu

tg_send_some_video(platform_id, video_list, disable_notification, protect_content, reply_to_message_id, has_spoiler, message_thread_id)

Parametri:

! platform_id — Telegram klienta ID, kuram jānosūta ziņojums *

! video_list — video failu masīvs (detaļas zemāk)

disable_notification — karogs ziņojuma nosūtīšanai ar skaņas paziņojumu (noklusējums: 0). 1 — nosūtīt bez paziņojuma, 0 — nosūtīt ar paziņojumu

reply_to_message_id — ziņojuma ID, uz kuru atbildēt (t.i., citāts)

has_spoiler — iespējo spoileru formatējumu (neobligāts; iestati True, lai aktivizētu)

message_thread_id — pavediena ID (pieejams supergrupās ar foruma funkcionalitāti)

Video masīva video_list veidošanas piemērs:
'[["Video link1", "caption", "parse_mode"], ["Video link2"], ["Video link3", "caption"]]'

Viena audio veidošanas piemērs:
["Video link", "caption", "parse_mode"]

Parametru secība ir svarīga! Veidojot video failu masīvu, pēdiņas "" var izlaist

Parametru apraksts:
! Video link — iekšējā Telegram video URL. Saites iegūšana, izmantojot tg_request, ir aprakstīta šeit.
caption — teksta apraksts līdz 1024 rakstzīmēm
parse_mode — teksta formatējums aprakstā treknrakstā vai slīprakstā ***. Iespējamās vērtības: html, markdown, markdownV2.

Tātad, sāciet, iegūstot saiti uz failu, kuru vēlaties nosūtīt, un pēc tam aizpildiet nepieciešamos funkcijas parametrus:

Pēc pārbaudes mēs iegūstam video:

Atcerieties, ka saites ir unikālas katram botam, tāpēc noteikti ģenerējiet savas saites

video="BAACAgIAAxkBAAIQFmO9Ycbt5JDIr9HKQh-XkhS9FqTxAALQIwACtjXoSXKlqfbH-I_gLQQ"
soob=tg_send_video(platform_id, video

! Sākot no versijas 4.0, Telegram atbalsta apaļu MPEG4 video sūtīšanu ar ilgumu līdz vienai minūtei.

! Darbs ar Telegram biznesa kontu

tg_send_video_note(platform_id, video_note, reply_markup, protect_content, reply_to_message_id, disable_notification, message_thread_id)

Parametri:

! platform_id — Telegram klienta ID, kuram jānosūta ziņojums *

! video_note — video saite. Kā iegūt saiti, izmantojot tg_request, ir aprakstīts šeit
reply_markup — pogu iestatījumi **

protect_content — karogs satura aizsardzībai pret kopēšanu. Lai iespējotu, nodod jebkuru vērtību, kas nav 0, False vai tukšas pēdiņas ''

reply_to_message_id — ziņojuma ID, uz kuru atbildēt (t.i., citāts)

disable_notification — karogs ziņojuma nosūtīšanai ar skaņas paziņojumu (noklusējums: 0). 1 — nosūtīt bez paziņojuma, 0 — nosūtīt ar paziņojumu

message_thread_id — pavediena ID (pieejams supergrupās ar foruma funkcionalitāti)

Lai vienkāršotu pogu komplektu aprakstus, varat izmantot šo lifehack

Ja jums ir kvadrātveida video, varat to pārveidot par apaļu, izmantojot botu https://t.me/roundNoteBot:

Kad jums ir apaļš video, nosūtiet to sev botā, lai iegūtu saiti (detaļas šeit), un pēc tam iestatiet funkciju apaļā video nosūtīšanai:

Atcerieties, ka saites ir unikālas katram botam, tāpēc noteikti ģenerējiet savas saites

tg_send_video_note(platform_id, 'DQACAgIAAxkBAAER6cVi6OzIezJo9FWu6WyZPzDgQX8B3QACcxsAArR3SUtRizDeiHWLNikE','','1')

! Darbs ar Telegram biznesa kontu

tg_send_venue(platform_id, latitude, longitude, title, address, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

Parametri:

! platform_id — Telegram klienta ID, uz kuru jānosūta ziņojums *

! latitude — platums

! longitude — garums

! title — nosaukums

! address — adrese

protect_content — karogs satura aizsardzībai pret kopēšanu. Lai iespējotu, norādiet jebkuru vērtību, kas nav 0, False vai tukšas pēdiņas ''

disable_notification — karogs ziņojuma nosūtīšanai ar skaņas paziņojumu (noklusējums: 0).
1 — sūtīt bez paziņojuma, 0 — sūtīt ar paziņojumu

reply_to_message_id - ziņojuma ID, uz kuru atbildēt (t.i., citēt)

reply_markup — pogu iestatījumi **

message_thread_id — pavediena ID (pieejams supergrupās ar foruma funkcionalitāti)

Lai vienkāršotu pogu komplektu aprakstus, varat izmantot šo lifehack

Tātad, sāksim ar vietas koordināšu noteikšanu. Tās var iegūt, izmantojot Google Maps

Pēc tam konvertējiet iegūtās koordinātas no decimālgrādiem uz ģeogrāfisko formātu, izmantojot jebkuru tiešsaistes koordināšu pārveidotāju:

Tagad aizpildīsim funkcijas parametrus un iegūsim vēlamo rezultātu:

soob=tg_send_venue(platform_id, "48°52′", "2°4′", "Dreams come true!", "Paris, Eiffel Tower") 

! Darbs ar Telegram biznesa kontu

Telegram nodrošina ātru veidu, kā kopīgot kontaktus no jūsu adrešu grāmatas. Messenger atbalsta vCard — elektroniskās vizītkartes sūtīšanu

Funkcija tg_send_contact ļauj nosūtīt tālruņa numuru ar vārdu (vai organizācijas nosaukumu), kā arī pievienot pogas un iespējot satura aizsardzību ziņojumam.

tg_send_contact(platform_id, phone, first_name, last_name, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

! - obligāts funkcijas parametrs

Parametri:

! platform_id — Telegram klienta ID, uz kuru jānosūta ziņojums *

! phone — tālruņa numurs starptautiskā formātā. Piemēram, Krievijai: +7XXXXXXXXXX

! first_name un last_name - vārds un uzvārds

protect_content — karogs satura aizsardzībai pret kopēšanu. Lai iespējotu, norādiet jebkuru vērtību, kas nav 0, False vai tukšas pēdiņas ''

disable_notification — karogs ziņojuma nosūtīšanai ar skaņas paziņojumu (noklusējums: 0).
1 — sūtīt bez paziņojuma, 0 — sūtīt ar paziņojumu

reply_to_message_id - ziņojuma ID, uz kuru atbildēt (t.i., citēt)

reply_markup — pogu iestatījumi **

message_thread_id — pavediena ID (pieejams supergrupās ar foruma funkcionalitāti)

Lai vienkāršotu pogu komplektu aprakstus, varat izmantot šo lifehack

Aizpildiet parametrus: tālruņa numuru, vārdu un uzvārdu.

Pārbaudiet rezultātu:

soob=tg_send_contact(platform_id, "+79999999999", "Ann", "Test", 1) 

! Darbs ar Telegram biznesa kontu

tg_send_sticker(platform_id, sticker_id, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

Parametri:

! platform_id — Telegram klienta ID, uz kuru jānosūta ziņojums *

! sticker_id - uzlīmes ID. Kā iegūt saiti, izmantojot tg_request, ir paskaidrots šeit

protect_content — karogs satura aizsardzībai pret kopēšanu. Lai iespējotu, norādiet jebkuru vērtību, kas nav 0, False vai tukšas pēdiņas ''

disable_notification — karogs ziņojuma nosūtīšanai ar skaņas paziņojumu (noklusējums: 0).
1 — sūtīt bez paziņojuma, 0 — sūtīt ar paziņojumu

reply_to_message_id - ziņojuma ID, uz kuru atbildēt (t.i., citēt)

reply_markup — pogu iestatījumi **

message_thread_id — pavediena ID (pieejams supergrupās ar foruma funkcionalitāti)

Lai vienkāršotu pogu komplektu aprakstus, varat izmantot šo lifehack

Uzlīmes sūtīšana neatšķiras no jebkura cita pielikuma sūtīšanas:\

1. Iegūstiet iekšējo Telegram saiti (detalizēti šeit) \
2. Aizpildiet funkcijas parametrus\
3. Nosūtiet bloku sev un pārbaudiet rezultātu

Rezultāts:

Atcerieties, ka saites ir unikālas katram botam, tāpēc noteikti ģenerējiet savas saites

soob=tg_send_sticker(platform_id, 'CAACAgIAAxkBAAEawJ5jmNeyat8uPGBMP3JzubRNXGjH3wACrw4AAsYg4UqePobN94_jkywE')

! Fotoattēls nedrīkst būt lielāks par 10 MB. Kopējais platums un augstums nedrīkst pārsniegt 10 000 pikseļu. Platuma un augstuma attiecība nedrīkst pārsniegt 20.

! Darbs ar Telegram biznesa kontu

tg_send_photo(platform_id, photo, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media)

Parametri:

! platform_id — Telegram klienta ID, uz kuru jānosūta ziņojums *

! photo - saite uz attēlu. Kā iegūt saiti, izmantojot tg_request, ir paskaidrots šeit.

caption - apraksts līdz 1024 rakstzīmēm

reply_markup — pogu iestatījumi **

parse_mode — teksta formatējums parakstā treknrakstā vai slīprakstā ***

reply_to_message_id - ziņojuma ID, uz kuru atbildēt (t.i., citēt)

protect_content — karogs satura aizsardzībai pret kopēšanu. Lai iespējotu, norādiet jebkuru vērtību, kas nav 0, False vai tukšas pēdiņas ''

has_spoiler — iespējo spoileru formatējumu, iestatiet uz True, lai aktivizētu

disable_notification — karogs ziņojuma nosūtīšanai ar skaņas paziņojumu (noklusējums: 0).
1 — sūtīt bez paziņojuma, 0 — sūtīt ar paziņojumu

message_thread_id — pavediena ID (pieejams supergrupās ar foruma funkcionalitāti)

entities — ar šo parametru varat vienkārši nokopēt formatētu tekstu ar visām tā īpašībām un norādīt, no kuras rakstzīmes līdz kurai tas tiks parādīts ar noteiktu stilu. Piemēru varat pārbaudīt tg_request attiecīgajā laukā. Parametram jābūt vārdnīcai.

show_caption_above_media - ja iestatīts uz True, ziņojuma teksts tiks parādīts virs multivides

Parametra nosūtīšanas piemērs:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

Šajā piemērā ir parādīta tikai vārdnīca, savukārt pats ziņojuma teksts tiek glabāts mainīgajā

Lai vienkāršotu pogu komplektu aprakstus, varat izmantot šo lifehack

! Fotoattēls nedrīkst būt lielāks par 10 MB. Kopējais platums un augstums nedrīkst pārsniegt 10 000 pikseļu. Platuma un augstuma attiecība nedrīkst pārsniegt 20.

! Darbs ar Telegram biznesa kontu

tg_send_some_photo(platform_id, image_list, disable_notification=0, protect_content=False, reply_to_message_id=0, has_spoiler=False,message_thread_id)

Parametri:

! platform_id — Telegram klienta ID, uz kuru jānosūta ziņojums *

! image_list - attēlu failu masīvs (detalizēti zemāk)

disable_notification — karogs ziņojuma nosūtīšanai ar skaņas paziņojumu (noklusējums: 0).
1 — sūtīt bez paziņojuma, 0 — sūtīt ar paziņojumu

protect_content — karogs satura aizsardzībai pret kopēšanu (neobligāts parametrs, lai iespējotu, norādiet 1 kā vērtību)

reply_to_message_id - ziņojuma ID, uz kuru atbildēt (t.i., citēt)

has_spoiler — iespējo spoileru formatējumu (neobligāts; iestatiet uz True, lai aktivizētu)

message_thread_id — pavediena ID (pieejams supergrupās ar foruma funkcionalitāti)

Piemērs image_list:

'[["Image link 1", "caption", "parse_mode"], ["Image link 2"], ["Image link 3", "caption"]]'

Datu piemērs vienam attēlam:
["Image link 1", "caption", "parse_mode"]

Parametru secība ir svarīga! Veidojot attēlu failu masīvu, pēdiņas "" var izlaist

Parametru apraksts:

! Image link 1 - attēla saite. Kā iegūt saiti, izmantojot tg_request, ir paskaidrots šeit

caption — paraksts līdz 1024 rakstzīmēm

parse_mode — teksta formatējums parakstā treknrakstā vai slīprakstā ***

Apskatīsim funkcijas piemēru vairāku attēlu nosūtīšanai:

vispirms izveidojiet attēlu masīvu

Pēc tam aizpildiet funkcijas parametrus

Nosūtiet bloku sev un izbaudiet rezultātu

Atcerieties, ka saites ir unikālas katram botam, tāpēc pārliecinieties, ka ģenerējat savas saites videoklipam

image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)

tg_send_dice(platform_id, emoji, reply_markup, disable_notification, reply_to_message_id, protect_content, message_thread_id)

! Darbs ar Telegram biznesa kontu

Parametri:

! platform_id — Telegram klienta ID, kuram jānosūta ziņojums *

emoji - nosūtāmā emocijzīme. Ja atstājat parametru tukšu, pēc noklusējuma tiks nosūtīts kauliņš. Varat nodot vai nu pašu emocijzīmi kā virkni, vai arī atslēgvārdu, ko izmanto tās attēlošanai

reply_markup — pogu iestatījums **

disable_notification — karogs ziņojuma nosūtīšanai ar skaņas paziņojumu (noklusējums: 0).
1 — nosūtīt bez paziņojuma, 0 — nosūtīt ar paziņojumu

reply_to_message_id -ID ziņojumam, uz kuru atbildēt (t.i., citāts)

protect_content — karogs satura aizsardzībai pret kopēšanu. Lai iespējotu, nododiet jebkuru vērtību, kas nav 0, False vai tukšas pēdiņas ''

message_thread_id — pavediena ID (pieejams supergrupās ar foruma funkcionalitāti)

Lai vienkāršotu pogu komplektu aprakstus, varat izmantot šādu lifehack

Iespējamo emocijzīmju saraksts: \

1. 'darts' vai '🎯', vērtības no 1 līdz 6 \
2. 'dice' vai '🎲', vērtības no 1 līdz 6 \
3. 'bowling' vai '🎳', vērtības no 1 līdz 6 \
4. 'basketball' vai '🏀', vērtības no 1 līdz 5 \
5. 'football' vai '⚽', vērtības no 1 līdz 5 \
6. 'slots' vai '🎰', vērtības no 1 līdz 64

Turklāt, ja klients nosūta botam kādu no šīm emocijzīmēm, jūs saņemsiet atzvanu, kas satur informāciju par punktu skaitu un to, kura emocijzīme tika izmantota.

Vienkāršākais variants ir izsaukt funkciju tikai ar vienu obligāto parametru:

Šajā gadījumā klients saņems kauliņu:

Ja klients metīs kauliņu (noklikšķinot uz saņemtās emocijzīmes), bots saņems atzvanu ar izmesto punktu skaitu:

Ar šo funkciju varat eksperimentēt. Piemēram, izveidosim spēļu automātu un pievienosim pogu Punkti. Nospiežot pogu, mēs saņemsim klienta kopējos punktus:

Pirmais piemērs:

soob=tg_send_dice(platform_id)

Otrais piemērs:

/* Pirmais piemērs */
tg_send_message(platform_id,'Noklikšķiniet uz spēļu automāta, lai izmēģinātu veiksmi!')
opts='{"inline_keyboard": [[{"text": " 👓 ","callback_data":"Play"}]]}'
soob=tg_send_dice(platform_id, 'slots', opts)

/* Otrais bloks - Teksta ziņojums */
 #{res[1]} punkti izmesti
/* Otrais bloks - Kalkulators */
res=splitter('#{question}', ' ')
balls=if(balls==None,0,balls) + int(res[1])

/* Trešais bloks - Teksta ziņojums */
Jums kopā ir #{balls} punkti

! Darbs ar Telegram biznesa kontu

Metode, lai nosūtītu fotoattēlu, videoklipu, dokumentu vai audio failu grupu kā albumu. Veiksmes gadījumā tiek atgriezts nosūtīto failu masīvs.

Piezīme: dokumentus un audio failus nevar grupēt ar citiem failu tipiem!

tg_send_media_group(platform_id, media_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

Parametri:

! platform_id — Telegram klienta ID, kuram jānosūta ziņojums

! media_list - masīvs, kas satur no 2 līdz 10 fotoattēliem, videoklipiem, dokumentiem vai audio failiem (sīkāk zemāk);

disable_notification — karogs ziņojuma nosūtīšanai ar skaņas paziņojumu (noklusējums: 0).
1 — nosūtīt bez paziņojuma, 0 — nosūtīt ar paziņojumu

protect_content — karogs satura aizsardzībai pret kopēšanu. Lai iespējotu, nododiet jebkuru vērtību, kas nav 0, False vai tukšas pēdiņas ''

reply_to_message_id - ID ziņojumam, uz kuru atbildēt (t.i., citāts)

message_thread_id — pavediena ID (pieejams supergrupās ar foruma funkcionalitāti);

media_list masīva elementu saturs:

! type - faila tips, “photo”, “video”, “audio” vai ”document”

! media - nosūtāmais fails. Nododiet file_id, lai nosūtītu failu, kas jau atrodas Telegram serveros (ieteicams), HTTP URL, lai Telegram iegūtu failu no interneta, vai «attach://<file_attach_name>», lai augšupielādētu jaunu failu, izmantojot multipart/form-data ar nosaukumu <file_attach_name>.

Lasīt vairāk: https://core.telegram.org/bots/api#sending-files

caption — nosūtāmā faila nosaukums, 0–1024 rakstzīmes.

parse_mode — teksta formatējums parakstā treknrakstā vai slīprakstā

Lasīt vairāk: https://core.telegram.org/bots/api#sending-files

media_list masīva piemērs:

[{"type": "photo", "media": "AgACAgIAAxkBAAIKa2W6HqQG151EaWOKnCyy8feBi8p__AAIH1zEbicvYSfi2QYj-CMreAQADAgADeAADNAQ", "caption": "spoku video"}, {"type": "video", "media": "BAACAgIAAxkBAAIKpGW6P__HGDoVz7u4blDF6925WO-hmAALVPQACicvYSYwIWCJKwKIWNAQ", “caption”: “zaķa video”}]

Apskatīsim funkcijas piemēru vairāku attēlu nosūtīšanai:

vispirms izveidojiet attēlu masīvu

Pēc tam aizpildiet funkcijas parametrus

Nosūtiet bloku sev un izbaudiet rezultātu

Atcerieties, ka saites ir unikālas katram botam, tāpēc pārliecinieties, ka ģenerējat savas saites videoklipam

image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)

Telegram (gan biznesa kontiem, gan parastajiem kontiem) varat nosūtīt pielikumus, izmantojot saiti:

1. Varat nosūtīt jebkura izmēra pielikumus, apejot faila lieluma ierobežojumus.
2. Varat arī nosūtīt jebkuru nepieciešamo pielikuma veidu.

Kā to izdarīt:

Nokopējiet saiti uz pielikumu, kas jau ir publiski pieejams:

Pēc tam ielīmējiet nokopēto saiti pielikuma funkcijā savā blokā:

Gatavs. Tādā veidā varat nosūtīt jebkura veida un izmēra pielikumus.