Mesajlarda ek gönderme işlevleri

! Bu işlevler, herhangi bir türde dosya göndermenize olanak tanır. Önerilen форматlar: GIF, PDF, ZIP en fazla 2GB.

! Telegram işletme hesabıyla çalışır

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

Parametreler:

! platform_id — mesajın gönderilmesi gereken Telegram’daki istemci kimliği *

! document - Telegram sunucusundaki belgeye bağlantı. Bağlantının tg_request aracılığıyla nasıl alınacağı açıklanmıştır burada.

caption - açıklama, en fazla 1024 karakter

reply_markup — düğme ayarları **

parse_mode — açıklamadaki metin biçimlendirmesi (kalın veya italik) ***. Olası değerler: html, markdown, markdownV2. ссылка

reply_to_message_id - Yanıt verilecek mesajın kimliği (yani, alıntı)

protect_content — içeriği kopyalanmaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin.

disable_notification — ses bildirimini kontrol etme bayrağı (varsayılan: 0). 1 - bildirim olmadan gönder, 0 - bildirimle gönder

message_thread_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir) entities — önceden biçimlendirilmiş metni stilleriyle yeniden kullanmanıza olanak tanır. Biçimlendirme için karakter ofsetini ve aralığını tanımlamanız yeterlidir. Örnek, tg_request içinde ilgili alanda mevcuttur. Bir sözlük olmalıdır. Parametreyi geçirme örneği: 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"}] Bu örnekte yalnızca sözlük gösterilmiştir; gerçek mesaj metni ayrı bir değişkende tanımlanır.

Bir düğme kümesi açıklamasını basitleştirmek için aşağıdakini kullanabilirsiniz küçük numara.

! Bu işlevler, herhangi bir türde dosya göndermenize olanak tanır. Önerilen форматlar: GIF, PDF, ZIP en fazla 2GB.

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

Parametreler:

! platform_id — mesajın gönderilmesi gereken Telegram’daki istemci kimliği *

! document_list - belgelerden oluşan bir dizi. Böyle bir dizinin nasıl oluşturulacağına dair örnek aşağıda verilmiştir

disable_notification — ses bildirimini kontrol etme bayrağı (varsayılan: 0). 1 - bildirim olmadan gönder, 0 - bildirimle gönder

protect_content — içeriği kopyalanmaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin.

reply_to_message_id - Yanıt verilecek mesajın kimliği (yani, alıntı)

message_thread_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

document_list dizisini oluşturma örneği: '[["Belge bağlantısı", "caption", "parse_mode"], ["Belge bağlantısı 2"], ["Belge bağlantısı 3", "caption"]]'

Tek bir belge için veri biçimlendirme örneği ["Belge bağlantısı", "caption", "parse_mode"]

Parametrelerin sırası önemlidir! Bir belge dizisi oluştururken tırnak işaretleri " " çıkarılabilir.

document_list dizisi için parametre açıklaması: ! Belge bağlantısı - Telegram sunucusundaki belge bağlantısı. Bağlantının з tg_request aracılığıyla nasıl alınacağı açıklanmıştır burada caption — açıklama en fazla 1024 karakter parse_mode — açıklamanın biçimlendirilmesi, yani metnin kalın veya italik olarak vurgulanması ***

Bir belgeyi gönderme, satır içi düğmeler ekleme ve belgeye açıklama ekleme örneğini inceleyelim:

1. Önce, belgenizin bağlantısını alın. Bunu nasıl yapacağınıza dair ayrıntılı açıklama burada bulunabilir.

2. Bir blok oluşturun ve değişkenleri ekrandaki gibi ayarlayın:

   
3. Bloğu kendimize gönderelim ve çalışmamızın sonucuna bakalım:

Şimdi birden fazla belge göndermeye bakalım.

1. Burada da her belge için dahili bir Telegram bağlantısı almanız ve bir dizi oluşturmanız gerekir. lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'

2. Son olarak, belgeleri göndermek için işlevi bir araya getirin:

3. Ve çalışmanın sonucuna bakın:

Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden kendi bağlantılarınızı oluşturduğunuzdan emin olun

Tek bir belge göndermek için kod örneği:

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

Birden fazla belge göndermek için kod örneği:

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

! Bu işlev, .OGG türünde ve OPUS ile kodlanmış, boyutu 2 GB’a kadar olan ses dosyalarının gönderilmesine olanak tanır.

! Yalnızca Telegram işletme hesabıyla çalışır

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

Parametreler:

! platform_id — mesajın gönderileceği Telegram istemci kimliği *

! voice - .OGG biçimindeki sesli mesaja bağlantı

caption - açıklama en fazla 1024 karakter

reply_markup — düğme ayarları **

parse_mode — açıklamadaki metin biçimlendirmesi, kalın veya italik ***. Olası değerler: html, markdown, markdownV2.

reply_to_message_id - Yanıt verilecek mesajın kimliği (yani, alıntı)

protect_content — içeriğin kopyalanmasını önleme bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin.

disable_notification — bildirim sesiyle mesaj gönderme bayrağı (varsayılan 0’dır) 1 - alındığında bildirimi kapat, 0 - bildirimle gönder

message_thread_id — konu kimliği (forum özelliği etkinse süper gruplarda kullanılabilir). entities —bu parametre ile biçimlendirilmiş metni tüm özellikleriyle kolayca kopyalayabilir ve hangi karakterden hangi karaktere kadar belirli bir stille gösterileceğini belirtebilirsiniz. tg_request içinde ilgili alanda bir örnek görebilirsiniz. Parametre bir sözlük olmalıdır. Parametre geçirme örneği: 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"}] Örnek yalnızca bir sözlük gösterir; mesaj metninin kendisi bir değişkende tanımlanır.

Düğme seti açıklamasını basitleştirmek için aşağıdakini kullanabilirsiniz küçük numara

! Bu işlev, maksimum 2 GB boyutunda .MP3 veya .M4A türünde ses dosyalarının gönderilmesine olanak tanır.

! Telegram işletme hesabıyla çalışır

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

Parametreler:

! platform_id — mesajın gönderileceği Telegram istemci kimliği *

! audio_list - ses dosyalarından oluşan bir dizi (detaylar aşağıda)

disable_notification — mesajın bildirimli veya bildirimsiz gönderilmesini kontrol eden bayrak (varsayılan: 0). 1 — bildirim olmadan gönder, 0 — bildirimle gönder

protect_content — içeriği kopyalanmaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin.

reply_to_message_id - Yanıt verilecek mesajın kimliği (yani, alıntı)

message_thread_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

audio_list dizisini oluşturma örneği: '[["Ses bağlantısı 1", "caption", "parse_mode"], ["Ses bağlantısı 2"], ["Ses bağlantısı 3", "caption"]]'

Tek bir ses örneği: ["Ses bağlantısı", "caption", "parse_mode"]

Parametrelerin sırası önemlidir! Ses dosyaları dizisi oluşturulurken "" tırnak işaretleri çıkarılabilir

Parametre açıklaması: ! Ses bağlantısı - .OGG biçimindeki bir ses dosyasına bağlantı caption — açıklama (en fazla 1024 karakter) parse_mode — başlıktaki metin biçimlendirmesi, kalın veya italik ***

Yukarıda belirtildiği gibi, işlev .OGG dosyalarıyla çalışır. Bu nedenle, ilk görev bu biçimde bir ses kaydı elde etmektir. Eğer bir .MP3 dosyanız varsa, onu .OGG’ye dönüştürebilirsiniz https://t.me/mp3toolsbot botunu kullanarak.

Sonra, ortaya çıkan dosyayı botta kendinize gönderin ve şu algoritmayı izleyerek file_id alın burada açıklanmıştır.

Şimdi işlevi bir araya getirelim:

Harika! Aferin!

Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden kendi bağlantılarınızı oluşturduğunuzdan emin olun

Bir mesaj gizlilik ayarları nedeniyle gönderilemezse, aşağıdaki hata döndürülür:

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

Hatanın nedeni: kullanıcının gizlilik ayarlarında “Sesli mesaj almayın” seçeneği vardır (herkesten ya da yalnızca belirli kullanıcılardan izin verilmiş olabilir):

Kullanıcı bu gizlilik kısıtlamasını devre dışı bıraksın bile, hata görünmeye devam eder.

Aslında, kullanıcı zaten izinleri etkinleştirmiş olsa bile, bu hatayı aşmanın tek yolu istemciyi Mavibot veritabanından tamamen kaldırmaktır.

Çözüm:

Kullanıcı gizlilik ayarlarını değiştirdikten sonra, 30–60 saniyelik bir bekleme yapmanız gerekir (mesajlaşma sunucuları değişiklikleri işleyene kadar) ve yalnızca bundan sonra bot aracılığıyla Telegram’a bir API isteği göndermelisiniz: https://api.telegram.org/bot<TOKEN>/getChat?chat_id=#{platform_id}

Bundan sonra kullanıcı verileri yenilenecek ve sesli mesajlar doğru şekilde gönderilecektir.

! Bu işlev, sesi olmayan GIF veya H.264/MPEG-4 AVC video dosyalarının maksimum 2 GB boyutunda gönderilmesine olanak tanır.

! Telegram işletme hesabıyla çalışır

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)

Parametreler:

! platform_id — mesajın gönderileceği Telegram istemci kimliği. *

! animation- animasyona bağlantı. tg_request aracılığıyla bağlantının nasıl alınacağı açıklanmıştır burada

caption - açıklama en fazla 1024 karakter

reply_markup — düğme yapılandırması **

parse_mode — başlıktaki metin biçimlendirmesi, kalın veya italik ***. Olası değerler: html, markdown, markdownV2

reply_to_message_id - Yanıt verilecek mesajın kimliği (yani, alıntı)

protect_content — içeriği kopyalanmaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin.

has_spoiler — spoiler’ı etkinleştirir. Etkinleştirmek için True olarak ayarlayın.

disable_notification — mesajı bildirimli veya bildirimsiz gönderme bayrağı (varsayılan: 0). 1 — bildirim olmadan gönder, 0 — bildirimle gönder

message_thread_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir) entities — bu parametre ile biçimlendirilmiş metni tüm özellikleriyle kolayca kopyalayabilir ve hangi karakterden hangi karaktere kadar belirli bir stille gösterileceğini belirtebilirsiniz. tg_request içinde ilgili alanda bir örnek kontrol edebilirsiniz. Parametre bir sözlük olmalıdır.

show_caption_above_media - True olarak ayarlanırsa, mesaj açıklaması medyanın üzerinde gösterilir Parametre geçirme örneği: 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"}] Bu örnekte yalnızca sözlük gösterilmiştir, mesaj metninin kendisi ise bir değişkende saklanır

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz küçük numara

İşi biraz zorlaştırıp kopyalama ve spoiler korumalı bir animasyon gönderelim.

Her zaman olduğu gibi süreç, seçilen animasyon için dahili Telegram bağlantısını elde etmekle başlar (ayrıntılar burada).

Son olarak, işlevi bir araya getirelim:

Ve çalışmanın sonucuna bakalım:

Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden kendi bağlantılarınızı oluşturduğunuzdan emin olun

! Bu işlev, boyutu 2 GB’a kadar olan MPEG4 dosyalarını göndermenize olanak tanır. (Diğer formatlar tg_send_document() kullanılarak dosya olarak gönderilebilir)

! Telegram business hesabıyla çalışır

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 )

Parametreler:

! platform_id — mesajın gönderileceği Telegram istemci kimliği *

! video - video bağlantısı. tg_request aracılığıyla bağlantıların nasıl alınacağını görmek için burada

caption - açıklama en fazla 1024 karakter

reply_markup — düğme ayarları **

parse_mode — başlıktaki metin biçimlendirmesi, kalın veya italik ***. Olası değerler: html, markdown, markdownV2.

reply_to_message_id - Yanıt verilecek mesajın kimliği (yani, alıntı)

protect_content — içeriği kopyalanmaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin.

has_spoiler — spoiler’ı etkinleştirir. Etkinleştirmek için True olarak ayarlayın

disable_notification — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0). 1 — bildirim olmadan gönder, 0 — bildirimle gönder

message_thread_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir) entities — bu parametre ile biçimlendirilmiş metni tüm özellikleriyle kolayca kopyalayabilir ve hangi karakterden hangi karaktere kadar belirli bir stille gösterileceğini belirtebilirsiniz. tg_request içinde ilgili alanda bir örnek kontrol edebilirsiniz. Parametre bir sözlük olmalıdır.

show_caption_above_media - True olarak ayarlanırsa, mesaj metni medyanın üzerinde gösterilir.

cover - mesajdaki video kapak görüntüsü. URL’nin tg_request aracılığıyla alınması burada. Parametre geçirme örneği: 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"}] Bu örnekte yalnızca sözlük gösterilmiştir, mesaj metninin kendisi ise bir değişkende saklanır

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz küçük numara

! Telegram işletme hesabıyla çalışır

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

Parametreler:

! platform_id — mesajın gönderileceği Telegram istemci kimliği *

! video_list - video dosyalarından oluşan bir dizi (detaylar aşağıda)

disable_notification — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0). 1 — bildirim olmadan gönder, 0 — bildirimle gönder

reply_to_message_id - Yanıt verilecek mesajın kimliği (yani, alıntı)

has_spoiler — spoiler biçimlendirmesini etkinleştirir (isteğe bağlı; etkinleştirmek için True olarak ayarlayın)

message_thread_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

video_list dizisi oluşturma örneği: '[["Video bağlantısı1", "caption", "parse_mode"], ["Video bağlantısı2"], ["Video bağlantısı3", "caption"]]'

Tek bir ses örneği oluşturma: ["Video bağlantısı", "caption", "parse_mode"]

Parametrelerin sırası önemlidir! Video dosyaları dizisi oluşturulurken "" tırnakları çıkarılabilir

Parametre açıklaması: ! Video bağlantısı — dahili Telegram video URL’si. tg_request aracılığıyla bağlantının nasıl alınacağı açıklanmıştır burada. caption — metin başlığı, en fazla 1024 karakter parse_mode — başlıktaki metin biçimlendirmesi, kalın veya italik ***. Olası değerler: html, markdown, markdownV2.

Öyleyse, göndermek istediğimiz dosyanın bağlantısını alarak başlayalım ve ardından gerekli işlev parametrelerini dolduralım:

Kontrol ettikten sonra videoyu alırız:

Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden kendi bağlantılarınızı oluşturduğunuzdan emin olun

! 4.0 sürümünden itibaren Telegram, süresi bir dakikaya kadar olan yuvarlak MPEG4 videoların gönderilmesini destekler.

! Telegram business hesabıyla çalışır

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

Parametreler:

! platform_id — mesajın gönderileceği Telegram istemci kimliği *

! video_note - video bağlantısı. tg_request aracılığıyla bağlantının nasıl alınacağı açıklanmıştır burada reply_markup — düğme ayarları **

protect_content — içeriğin kopyalanmasını önleme bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin

reply_to_message_id - Yanıt verilecek mesajın kimliği (yani, alıntı)

disable_notification — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0). 1 — bildirim olmadan gönder, 0 — bildirimle gönder

message_thread_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz küçük numara

Eğer kare bir videonuz varsa, onu https://t.me/roundNoteBot botunu kullanarak yuvarlak bir videoya dönüştürebilirsiniz:

Yuvarlak videoyu aldıktan sonra, bağlantıyı almak için onu botta kendinize gönderin (ayrıntılar burada), ve ardından yuvarlak videoyu göndermek için işlevi kurun:

Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden kendi bağlantılarınızı oluşturduğunuzdan emin olun

! Telegram business hesabıyla çalışır

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

Parametreler:

! platform_id — mesajın gönderileceği Telegram istemci kimliği *

! enlem — enlem

! boylam — boylam

! title — başlık

! address — adres

protect_content — içeriğin kopyalanmasını önleme bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin

disable_notification — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0). 1 — bildirim olmadan gönder, 0 — bildirimle gönder

reply_to_message_id - Yanıt verilecek mesajın kimliği (yani, alıntı)

reply_markup — düğme ayarları **

message_thread_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz küçük numara

Öyleyse, önce yerin koordinatlarını belirleyerek başlayalım. Bunları şu araçla alabilirsiniz: Google Haritalar

Sonra, elde edilen koordinatları ondalık derecelerden coğrafi biçime herhangi bir çevrimiçi koordinat dönüştürücü:

Şimdi, işlev parametrelerini doldurmaya ve istenen sonucu elde etmeye geçelim:

! Telegram işletme hesabıyla çalışır

Telegram, adres defterinizden kişileri paylaşmak için hızlı bir yol sunar. Mesajlaşma uygulaması şunları göndermeyi destekler: vCard — elektronik bir kartvizit

tg_send_contact işlevi, bir telefon numarasını bir adla (veya kuruluş adıyla) göndermeye, ayrıca düğmeler eklemeye ve mesaj için içerik korumasını etkinleştirmeye olanak tanır.

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

! - gerekli işlev parametresi

Parametreler:

! platform_id — mesajın gönderileceği Telegram istemci kimliği *

! phone — uluslararası biçimde telefon numarası. Örneğin Rusya için: +7XXXXXXXXXX

! first_name ve last_name - ad ve soyad

protect_content — içeriğin kopyalanmasını önleme bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin

disable_notification — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0). 1 — bildirim olmadan gönder, 0 — bildirimle gönder

reply_to_message_id - Yanıt verilecek mesajın kimliği (yani, alıntı)

reply_markup — düğme ayarları **

message_thread_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz küçük numara

Parametreleri doldurun: telefon numarası, ad ve soyad.

Sonucu kontrol edin:

! Telegram işletme hesabıyla çalışır

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

Parametreler:

! platform_id — mesajın gönderileceği Telegram istemci kimliği *

! sticker_id - sticker kimliği. tg_request aracılığıyla bağlantının nasıl alınacağı açıklanmıştır burada

protect_content — içeriğin kopyalanmasını önleme bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin

disable_notification — mesajı sesli bildirimle gönderme bayrağı (varsayılan: 0). 1 — bildirim olmadan gönder, 0 — bildirimle gönder

reply_to_message_id - Yanıt verilecek mesajın kimliği (yani, alıntı)

reply_markup — düğme ayarları **

message_thread_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz küçük numara

Sticker göndermek, diğer ekleri göndermekten farklı değildir: 1. Dahili Telegram bağlantısını alın (ayrıntılar burada) 2. İşlev parametrelerini doldurun 3. Bloğu kendinize gönderin ve sonucu kontrol edin

Sonuç:

Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden kendi bağlantılarınızı oluşturduğunuzdan emin olun

! Fotoğraf 10 MB’tan büyük olmamalıdır. Toplam genişlik ve yükseklik 10.000 pikseli aşmamalıdır. Genişlik/yükseklik oranı 20’yi geçmemelidir.

! Telegram işletme hesabıyla çalışır

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)

Parametreler:

! platform_id — mesajın gönderileceği Telegram istemci kimliği *

! fotoğraf - görsele bağlantı. tg_request aracılığıyla bağlantının nasıl alınacağı açıklanmıştır burada.

caption - açıklama en fazla 1024 karakter

reply_markup — düğme ayarları **

parse_mode — başlıktaki metin biçimlendirmesi, kalın veya italik ***

reply_to_message_id - Yanıt verilecek mesajın kimliği (yani, alıntı)

protect_content — içeriğin kopyalanmasını önleme bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin

has_spoiler — spoiler biçimlendirmesini etkinleştirir, etkinleştirmek için True olarak ayarlayın

disable_notification — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0). 1 — bildirim olmadan gönder, 0 — bildirimle gönder

message_thread_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir) entities — bu parametre ile biçimlendirilmiş metni tüm özellikleriyle kolayca kopyalayabilir ve hangi karakterden hangi karaktere kadar belirli bir stille gösterileceğini belirtebilirsiniz. tg_request içinde ilgili alanda bir örnek kontrol edebilirsiniz. Parametre bir sözlük olmalıdır.

show_caption_above_media - True olarak ayarlanırsa, mesaj metni medyanın üzerinde gösterilir Parametre gönderme örneği: 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"}] Bu örnekte yalnızca sözlük gösterilmiştir, mesaj metninin kendisi ise bir değişkende saklanır

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz küçük numara

! Fotoğraf 10 MB’tan büyük olmamalıdır. Toplam genişlik ve yükseklik 10.000 pikseli aşmamalıdır. Genişlik/yükseklik oranı 20’yi geçmemelidir.

! Telegram business hesabıyla çalışır

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)

Parametreler:

! platform_id — mesajın gönderileceği Telegram istemci kimliği *

! image_list - görüntü dosyaları dizisi (aşağıda detaylar)

disable_notification — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0). 1 — bildirim olmadan gönder, 0 — bildirimle gönder

protect_content — içeriği kopyalanmaya karşı koruma bayrağı (isteğe bağlı parametre, etkinleştirmek için değer olarak 1 gönderin)

reply_to_message_id - Yanıt verilecek mesajın kimliği (yani, alıntı)

has_spoiler — spoiler biçimlendirmesini etkinleştirir (isteğe bağlı; etkinleştirmek için True olarak ayarlayın)

message_thread_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

image_list örneği:

'[["Görsel bağlantısı 1", "caption", "parse_mode"], ["Görsel bağlantısı 2"], ["Görsel bağlantısı 3", "caption"]]'

Tek bir görüntü için veri örneği: ["Görsel bağlantısı 1", "caption", "parse_mode"]

Parametre sırası önemlidir! Görüntü dosyaları dizisi oluşturulurken "" tırnakları çıkarılabilir

Parametre açıklaması:

! Görsel bağlantısı 1 - görsel bağlantısı. tg_request aracılığıyla bağlantının nasıl alınacağı açıklanmıştır burada

caption — başlık en fazla 1024 karakter

parse_mode — başlıktaki metin biçimlendirmesi, kalın veya italik ***

Birden fazla görüntü göndermek için bir işlev örneğine bakalım:

önce bir görüntü dizisi oluşturun

Sonra işlev parametrelerini doldurun

Bloğu kendinize gönderin ve sonucun tadını çıkarın

Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden video için kendi bağlantılarınızı oluşturduğunuzdan emin olun

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

! Telegram işletme hesabıyla çalışır

Parametreler:

! platform_id — mesajın gönderileceği Telegram istemci kimliği *

emoji - gönderilecek emoji. Parametreyi boş bırakırsanız, varsayılan olarak bir zar gönderilir. Hem emojinin kendisini bir dize olarak hem de onu temsil etmek için kullanılan anahtar kelimeyi gönderebilirsiniz

reply_markup — düğme ayarı **

disable_notification — mesajı bildirimli olarak gönderme bayrağı (varsayılan: 0). 1 — bildirim olmadan gönder, 0 — bildirimle gönder

reply_to_message_id -Yanıt verilecek mesajın kimliği (yani, alıntı)

protect_content — içeriğin kopyalanmasını önleme bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin

message_thread_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir)

Düğme seti açıklamalarını basitleştirmek için aşağıdakini kullanabilirsiniz küçük numara

Olası emoji listesi: 1) 'darts' veya '🎯', değerler 1’den 6’ya 2) 'dice' veya '🎲', değerler 1’den 6’ya 3) 'bowling' veya '🎳', değerler 1’den 6’ya 4) 'basketball' veya '🏀', değerler 1’den 5’e 5) 'football' veya '⚽', değerler 1’den 5’e 6) 'slots' veya '🎰', değerler 1’den 64’e

Ayrıca, bir istemci bu emojilerden birini bota gönderirse, puan ve hangi emojinin kullanıldığı hakkında bilgi içeren bir geri çağrı alırsınız.

En basit seçenek, işlevi yalnızca gerekli tek parametreyle çağırmaktır:

Bu durumda, istemci bir zar alır:

İstemci zarı atarsa (alınan emojiye tıklayarak), bot atılan puan sayısını içeren bir geri çağrı alır:

Bu işlevle deney yapabilirsiniz. Örneğin, bir slot makinesi oluşturalım ve bir Puanlar düğmesi ekleyelim. Düğmeye basıldığında, istemcinin toplam puanlarını alacağız:

İlk örnek:

İkinci örnek:

! Telegram işletme hesabıyla çalışır

Bir grup fotoğraf, video, belge veya ses dosyasını albüm olarak gönderme yöntemi. Başarılı olursa, gönderilen dosyaların bir dizisi döndürülür.

Not: belgeler ve ses dosyaları diğer dosya türleriyle birlikte gruplanamaz!

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

Parametreler:

! platform_id — mesajın gönderileceği Telegram istemci kimliği

! media_list - 2 ila 10 arasında fotoğraf, video, belge veya ses dosyası içeren bir dizi (detaylar aşağıda);

disable_notification — mesajı sesli bildirimle gönderme bayrağı (varsayılan: 0). 1 — bildirim olmadan gönder, 0 — bildirimle gönder

protect_content — içeriği kopyalanmaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak '' dışındaki herhangi bir değeri gönderin

reply_to_message_id - yanıtlanacak mesajın kimliği (yani, alıntı)

message_thread_id — konu kimliği (forum işlevi olan süper gruplarda kullanılabilir);

media_list dizisinin öğelerinin içeriği:

! type - dosya türü, “photo”, “video”, “audio” veya ”document”

! media - gönderilecek dosya. Telegram sunucularında zaten bulunan bir dosyayı göndermek için bir file_id gönderin (önerilir), dosyayı internetten almak için bir HTTP URL’si veya yeni bir dosya yüklemek için multipart/form-data ile <file_attach_name> adını kullanarak «attach://<file_attach_name>».

Daha fazlasını okuyun: https://core.telegram.org/bots/api#sending-files

caption — gönderilen dosyanın başlığı, 0–1024 karakter.

parse_mode — başlıktaki metin biçimlendirmesi, kalın veya italik

Daha fazlasını okuyun: https://core.telegram.org/bots/api#sending-files

media_list dizisi örneği:

[{"type": "photo", "media": "AgACAgIAAxkBAAIKa2W6HqQG151EaWOKnCyy8feBi8p_AAIH1zEbicvYSfi2QYj-CMreAQADAgADeAADNAQ", "caption": "ghosts video"}, {"type": "video", "media": "BAACAgIAAxkBAAIKpGW6P_HGDoVz7u4blDF6925WO-hmAALVPQACicvYSYwIWCJKwKIWNAQ", “caption”: “hare video”}]

Birden fazla görüntü göndermek için bir işlev örneğine bakalım:

önce bir görüntü dizisi oluşturun

Sonra işlev parametrelerini doldurun

Bloğu kendinize gönderin ve sonucun tadını çıkarın

Bağlantıların her bot için benzersiz olduğunu unutmayın, bu yüzden video için kendi bağlantılarınızı oluşturduğunuzdan emin olun

Telegram’da (hem işletme hesapları hem de normal hesaplar için), ekleri bir bağlantı aracılığıyla gönderebilirsiniz:

1. Her boyutta eki, dosya boyutu sınırlarını aşarak gönderebilirsiniz.

2. İhtiyacınız olan herhangi bir tür eki de gönderebilirsiniz.

Nasıl yapılır:

Zaten herkese açık erişimi olan bir eke ait bağlantıyı kopyalayın:

Ardından, kopyalanan bağlantıyı bloğunuzdaki ek işlevine yapıştırın:

Bitti. Bu şekilde, herhangi bir tür ve boyutta eki gönderebilirsiniz.