Belgeler nasıl gönderilir
Belge gönder tg_send_document()
! Bu işlevler her türden dosya göndermenize olanak tanır. Önerilen formatlar: GIF, PDF, ZIP en fazla 2GB.
! Telegram işletme hesabıyla çalışma
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 tanımlayıcısı *
! document - Telegram sunucusundaki belgeye bağlantı. tg_request üzerinden bağlantı alma burada açıklanmıştır.
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. bağlantı
reply_to_message_id - yanıtlanacak mesajın kimliği (yani alıntı)
protect_content — içeriği kopyalamaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak işareti '' dışında herhangi bir değer iletin.
disable_notification — sesli bildirimleri kontrol etme bayrağı (varsayılan: 0).
1 - bildirimsiz gönder, 0 - bildirimli gönder
message_thread_id — konu tanımlayıcısı (forum işlevselliğine sahip süper gruplarda kullanılabilir)
entities — önceden biçimlendirilmiş metni stillerle yeniden kullanmanızı sağlar. Biçimlendirme için karakter ofsetini ve aralığını tanımlamanız yeterlidir. Örnek, tg_request içinde ilgili alan altında mevcuttur. Bir sözlük olmalıdır.
Parametre iletme ö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österilirken, gerçek mesaj metni ayrı bir değişkende tanımlanır.
Düğme kümesinin açıklamasını basitleştirmek için aşağıdaki lifehack kullanabilirsiniz.
Birkaç belge veya başka dosyalar gönder tg_send_some_document()
! Bu işlevler her türden dosya göndermenize olanak tanır. Önerilen formatlar: 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 tanımlayıcısı *
! document_list - bir belge dizisi. Böyle bir dizinin nasıl oluşturulacağına dair örnek aşağıda verilmiştir
disable_notification — sesli bildirimleri kontrol etme bayrağı (varsayılan: 0).
1 - bildirimsiz gönder, 0 - bildirimli gönder
protect_content — içeriği kopyalamaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak işareti '' dışında herhangi bir değer iletin.
reply_to_message_id - yanıtlanacak mesajın kimliği (yani alıntı)
message_thread_id — konu tanımlayıcısı (forum işlevselliğine sahip süper gruplarda kullanılabilir)
document_list dizisi oluşturma örneği:
'[["Belge bağlantısı", "açıklama", "parse_mode"], ["Belge bağlantısı 2"], ["Belge bağlantısı 3", "açıklama"]]'
Tek bir belge için veri biçimlendirme örneği
["Belge bağlantısı", "açıklama", "parse_mode"]
Parametrelerin sırası önemlidir! Bir belge dizisi oluştururken tırnak işaretleri " " atlanabilir.
document_list dizisi için parametrelerin açıklaması:
! Belge bağlantısı - Telegram sunucusundan belge bağlantısı. tg_request üzerinden bağlantı alma burada açıklanmıştır
caption — en fazla 1024 karakter açıklama
parse_mode — açıklamanın biçimlendirilmesi, yani metnin kalın veya italik vurgulanması ***
Örnek
Tek bir belge gönderme, satır içi düğmeler ve belgeye açıklama ekleme örneğini inceleyelim:
-
İlk olarak, belgenizin bağlantısını alın. Bunun nasıl yapılacağına dair ayrıntılı açıklama burada bulunabilir.
-
Ekran görüntüsünde gösterildiği gibi bir blok oluşturun ve değişkenleri ayarlayın:

-
Bloğu kendimize gönderin ve çalışmamızın sonucunu görün:

Şimdi birden çok belge göndermeye bakalım.
- Burada da her belge için dahili bir Telegram bağlantısı almanız ve bir dizi oluşturmanız gerekir.
lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Belge1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Belge2"]]' - Son olarak, belge gönderme işlevini bir araya getirin:

- Ve çalışmanın sonucunu kontrol edin:

Kopyalamak için kod örneği
Bağlantıların her bot için benzersiz olduğunu unutmayın, bu nedenle 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": "Mükemmel","callback_data":"Answer1"}, {"text": "Kabul edilmedi","callback_data":"Answer2"}]]}
soob=tg_send_document(platform_id, lnkdoc, "Belge gönderme", opts)
Birkaç belge göndermek için kod örneği:
lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Belge1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Belge2"]]'
soob=tg_send_some_document(platform_id, lnkdoc)
Ses / sesli mesaj nasıl gönderilir
Sesli mesaj gönder tg_send_voice()
! Bu işlev, OPUS ile kodlanmış .OGG türündeki ses dosyalarını en fazla 2 GB boyutunda göndermenize 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önderilmesi gereken Telegram'daki istemci tanımlayıcısı *
! voice - .OGG formatındaki sesli mesaja bağlantı
caption - en fazla 1024 karakter açıklama
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ıtlanacak mesajın kimliği (yani alıntı)
protect_content — içeriğin kopyalanmasına karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak işareti '' dışında herhangi bir değer iletin.
disable_notification — mesajı sesli bildirimle gönderme bayrağı (varsayılan 0) 1 - alındığında bildirimi devre dışı bırak, 0 - bildirimle gönder
message_thread_id — konu tanımlayıcısı (forum özelliği etkinse süper gruplarda kullanılabilir).
entities — bu parametreyle, biçimlendirilmiş metni tüm özellikleriyle kolayca kopyalayabilir ve hangi karakterden hangi karaktere kadar belirli bir stille görüntüleneceğini belirtebilirsiniz. tg_request içinde ilgili alanda bir örnek kontrol edebilirsiniz. Parametre bir sözlük olmalıdır.
Parametre iletme ö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österirken, mesaj metninin kendisi bir değişkende tanımlanır.
Düğme kümesi açıklamasını basitleştirmek için aşağıdaki lifehack kullanabilirsiniz.
Birkaç sesli mesaj gönder tg_send_some_audio()
! Bu işlev, maksimum 2 GB boyutunda .MP3 veya .M4A türündeki ses dosyalarını göndermenize 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önderilmesi gereken Telegram'daki istemci tanımlayıcısı *
! audio_list - bir ses dosyası dizisi (aşağıda ayrıntılar)
disable_notification — mesajı sesli bildirimle veya bildirimsiz gönderme bayrağı (varsayılan: 0). 1 — bildirimsiz gönder, 0 — bildirimli gönder
protect_content — içeriği kopyalamaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak işareti '' dışında herhangi bir değer iletin.
reply_to_message_id - yanıtlanacak mesajın kimliği (yani alıntı)
message_thread_id — konu kimliği (forum işlevselliğine sahip süper gruplarda kullanılabilir)
audio_list dizisi oluşturma örneği:
'[["Ses bağlantısı 1", "açıklama", "parse_mode"], ["Ses bağlantısı 2"], ["Ses bağlantısı 3", "açıklama"]]'
Tek bir ses örneği:
["Ses bağlantısı", "açıklama", "parse_mode"]
Parametrelerin sırası önemlidir! Ses dosyaları dizisi oluşturulurken tırnak işaretleri "" atlanabilir
Parametre açıklamaları:
! Ses bağlantısı - .OGG formatında bir ses dosyasına bağlantı
caption — açıklama (en fazla 1024 karakter)
parse_mode — açıklamadaki metin biçimlendirmesi kalın veya italik ***
Örnek
Yukarıda belirtildiği gibi, işlev .OGG dosyalarıyla çalışır. Bu nedenle, ilk görev bu formatta bir ses kaydı elde etmektir.
.MP3 dosyanız varsa, https://t.me/mp3toolsbot botunu kullanarak .OGG'ye dönüştürebilirsiniz.
Ardından, burada açıklanan algoritmayı izleyerek file_id'yi almak için ortaya çıkan dosyayı botta kendinize gönderin.
Şimdi işlevi bir araya getirin:

Harika! Aferin!
Kopyalamak için örnek
Bağlantıların her bot için benzersiz olduğunu unutmayın, bu nedenle kendi bağlantılarınızı oluşturduğunuzdan emin olun
tg_send_voice(platform_id, "CQACAgIAAxkBAAER70Bi8VkgNhegB-msqDWXm2qHi3n9-AAC-iAAAk6giUvIXkW-XzBN0ikE")
Sesli mesaj gönderirken hata
Gizlilik ayarları nedeniyle bir mesaj 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 mesajları alma" seçeneği bulunur (herkesten veya yalnızca belirli kullanıcılardan izin verme):

Kullanıcı bu gizlilik kısıtlamasını devre dışı bıraksa bile hata görünmeye devam edecektir.
Aslında, kullanıcı izinleri zaten 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 duraklama beklemeli (mesajlaşma sunucularının değişiklikleri işlemesi için) ve ancak ondan sonra bot aracılığıyla Telegram'a bir API isteği göndermelisiniz:\ https://api.telegram.org/bot\\/getChat?chat_id=#{platform_id}
Bundan sonra kullanıcı verileri yenilenecek ve sesli mesajlar doğru şekilde gönderilecektir.
Animasyon nasıl gönderilir
Animasyon gönder tg_send_animation()
! Bu işlev, maksimum 2 GB boyutunda, sese sahip olmayan GIF veya H.264/MPEG-4 AVC videosu göndermeye izin verir.
! Telegram işletme hesabı ile çalışma
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önderilmesi gereken Telegram istemci kimliği. *
!** animation**- animasyon bağlantısı. tg_request aracılığıyla nasıl bağlantı alınacağı burada açıklanmıştır
caption - 1024 karaktere kadar açıklama
reply_markup — düğme yapılandırması **
parse_mode — başlıkta kalın veya italik metin biçimlendirmesi ***. Olası değerler: html, markdown, markdownV2
reply_to_message_id - yanıtlanacak mesajın kimliği (yani alıntı)
protect_content — içeriği kopyalamaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak işareti '' dışında herhangi bir değer iletin.
has_spoiler — spoiler'ı etkinleştirir. Etkinleştirmek için True olarak ayarlayın.
disable_notification — mesajı sesli bildirimli veya bildirimsiz gönderme bayrağı (varsayılan: 0). 1 — bildirimsiz gönder, 0 — bildirimli gönder
message_thread_id — iş parçacığı kimliği (forum işlevselliğine sahip 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örüntüleneceğini belirtebilirsiniz. tg_request'te ilgili alanda bir örnek kontrol edebilirsiniz. Parametre bir sözlük olmalıdır.
show_caption_above_media - True olarak ayarlanırsa, mesaj başlığı medyanın üzerinde görüntülenir
Parametre iletme ö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österilirken, mesaj metninin kendisi bir değişkende saklanır
Düğme seti açıklamalarını basitleştirmek için aşağıdaki lifehack kullanabilirsiniz
Örnek
Görevi daha karmaşık hale getirelim ve kopyalama ve spoiler korumalı bir animasyon gönderelim.
Her zamanki gibi süreç, seçilen animasyon için dahili Telegram bağlantısının alınmasıyla başlar (ayrıntılar burada).

Son olarak, işlevi bir araya getirin:

Ve çalışmanın sonucunu kontrol edin:

Kopyalamak için kod örneği
Bağlantıların her bot için benzersiz olduğunu unutmayın, bu nedenle kendi bağlantılarınızı oluşturduğunuzdan emin olun
animation="CgACAgIAAxkBAAIQDWO9Dbb0QODBmI_CUMhKHoWch7MDAAJBIQACtjXoScUjA-n5kGCYLQQ"
caption = "Happy New Year!"
soob=tg_send_animation(platform_id, animation, caption, None, None, None, True,True)
Video nasıl gönderilir
Telegram API kullanarak video gönder tg_send_video()
! Bu işlev, 2 GB'a kadar boyuttaki MPEG4 dosyalarını göndermenize olanak tanır.
(Diğer biçimler tg_send_document() kullanılarak dosya olarak gönderilebilir)
! Telegram işletme hesabı ile çalışma
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önderilmesi gereken Telegram istemci kimliği *
!** video** - video bağlantısı. tg_request aracılığıyla bağlantıların nasıl alınacağını burada görün
caption - 1024 karaktere kadar açıklama
reply_markup — düğme ayarları **
parse_mode — başlıkta kalın veya italik metin biçimlendirmesi ***. Olası değerler: html, markdown, markdownV2.
reply_to_message_id - yanıtlanacak mesajın kimliği (yani alıntı)
protect_content — içeriği kopyalamaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak işareti '' dışında herhangi bir değer iletin.
has_spoiler — spoiler'ı etkinleştirir. Etkinleştirmek için True olarak ayarlayın
disable_notification — mesajı sesli bildirimli gönderme bayrağı (varsayılan: 0).
1 — bildirimsiz gönder, 0 — bildirimli gönder
message_thread_id — iş parçacığı kimliği (forum işlevselliğine sahip 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örüntüleneceğini belirtebilirsiniz. tg_request'te 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örüntülenir.
cover - mesajdaki video kapak resmi. tg_request aracılığıyla URL alma burada.
Parametre iletme ö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österilirken, mesaj metninin kendisi bir değişkende saklanır
Düğme seti açıklamalarını basitleştirmek için aşağıdaki lifehack kullanabilirsiniz
Telegram API kullanarak birden çok video gönder tg_send_some_video()
! Telegram işletme hesabı ile çalışma
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önderilmesi gereken Telegram istemci kimliği *
!** video_list** - bir video dosyaları dizisi (aşağıda ayrıntılar)
disable_notification — mesajı sesli bildirimli gönderme bayrağı (varsayılan: 0).
1 — bildirimsiz gönder, 0 — bildirimli gönder
reply_to_message_id - yanıtlanacak 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 — iş parçacığı kimliği (forum işlevselliğine sahip süper gruplarda kullanılabilir)
video_list video dizisi oluşturma örneği:
'[["Video link1", "caption", "parse_mode"], ["Video link2"], ["Video link3", "caption"]]'
Tek ses oluşturma örneği:
["Video link", "caption", "parse_mode"]
Parametrelerin sırası önemlidir! Video dosyaları dizisini oluştururken tırnak işaretleri "" atlanabilir
Parametre açıklaması: \ !** Video link** — dahili Telegram video URL'si. tg_request aracılığıyla bağlantı alma burada açıklanmıştır.
caption — 1024 karaktere kadar metin başlığı
parse_mode — başlıkta kalın veya italik metin biçimlendirmesi ***. Olası değerler: html, markdown, markdownV2.
Örnek
Öyleyse, göndermek istediğimiz dosyanın bağlantısını alarak başlayın ve ardından gerekli işlev parametrelerini doldurun:


Kontrol ettikten sonra videoyu alıyoruz:

Kopyalamak için kod örneği
Bağlantıların her bot için benzersiz olduğunu unutmayın, bu nedenle kendi bağlantılarınızı oluşturduğunuzdan emin olun
video="BAACAgIAAxkBAAIQFmO9Ycbt5JDIr9HKQh-XkhS9FqTxAALQIwACtjXoSXKlqfbH-I_gLQQ"
soob=tg_send_video(platform_id, video
Yuvarlak video nasıl gönderilir
Yuvarlak video gönder tg_send_video_note()
! Sürüm 4.0'dan itibaren Telegram, süresi bir dakikaya kadar olan yuvarlak MPEG4 videolarının gönderilmesini destekler.
! Telegram işletme hesabı ile çalışma
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önderilmesi gereken Telegram istemci kimliği *
!** video_note** - video bağlantısı. tg_request aracılığıyla bağlantının nasıl alınacağı burada açıklanmıştır
reply_markup — düğme ayarları **
protect_content — içeriği kopyalamaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak işareti '' dışında herhangi bir değer iletin
reply_to_message_id - yanıtlanacak mesajın kimliği (yani alıntı)
disable_notification — mesajı sesli bildirimli gönderme bayrağı (varsayılan: 0).
1 — bildirimsiz gönder, 0 — bildirimli gönder
message_thread_id — iş parçacığı kimliği (forum işlevselliğine sahip süper gruplarda kullanılabilir)
Düğme seti açıklamalarını basitleştirmek için aşağıdaki lifehack kullanabilirsiniz
Örnek
Kare bir videonuz varsa, https://t.me/roundNoteBot botunu kullanarak onu yuvarlak bir videoya dönüştürebilirsiniz:

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

Kopyalamak için kod örneği
Bağlantıların her bot için benzersiz olduğunu unutmayın, bu nedenle kendi bağlantılarınızı oluşturduğunuzdan emin olun
tg_send_video_note(platform_id, 'DQACAgIAAxkBAAER6cVi6OzIezJo9FWu6WyZPzDgQX8B3QACcxsAArR3SUtRizDeiHWLNikE','','1')
Konum nasıl gönderilir
Coğrafi konum gönder tg_send_venue()
! Telegram işletme hesabı ile çalışma
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 *
! latitude — enlem
! longitude — boylam
! title — başlık
! address — adres
protect_content — içeriği kopyalamaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak işareti '' dışında herhangi bir değer girin
disable_notification — mesajı sesli bildirimle gönderme bayrağı (varsayılan: 0).
1 — bildirimsiz gönder, 0 — bildirimli gönder
reply_to_message_id - Yanıtlanacak mesajın kimliği (yani alıntı)
reply_markup — düğme ayarları **
message_thread_id — iş parçacığı kimliği (forum işlevselliğine sahip süper gruplarda kullanılabilir)
Düğme seti açıklamalarını basitleştirmek için aşağıdaki lifehack kullanabilirsiniz
Örnek
Öyleyse, yerin koordinatlarını belirleyerek başlayalım. Bunları Google Maps kullanarak alabilirsiniz

Ardından, elde edilen koordinatları herhangi bir çevrimiçi koordinat dönüştürücü kullanarak ondalık dereceden coğrafi formata dönüştürün:

Şimdi, fonksiyon parametrelerini doldurmaya ve istenen sonucu elde etmeye geçelim:


Kopyalamak için kod örneği
soob=tg_send_venue(platform_id, "48°52′", "2°4′", "Dreams come true!", "Paris, Eiffel Tower")
Kişi nasıl gönderilir
Kişi gönder tg_send_contact()
! Telegram işletme hesabı ile çalışma
Telegram, adres defterinizden kişileri paylaşmanın hızlı bir yolunu sağlar. Mesajlaşma uygulaması vCard — elektronik kartvizit göndermeyi destekler
tg_send_contact işlevi, bir telefon numarasını ad (veya kuruluş adı) ile göndermenin yanı sıra düğme 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 fonksiyon parametresi
Parametreler:
! platform_id — Mesajın gönderileceği Telegram istemci kimliği *
! phone — uluslararası formatta telefon numarası. Örneğin, Rusya için: +7XXXXXXXXXX
! first_name ve last_name - ad ve soyad
protect_content — içeriği kopyalamaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak işareti '' dışında herhangi bir değer girin
disable_notification — mesajı sesli bildirimle gönderme bayrağı (varsayılan: 0).
1 — bildirimsiz gönder, 0 — bildirimli gönder
reply_to_message_id - Yanıtlanacak mesajın kimliği (yani alıntı)
reply_markup — düğme ayarları **
message_thread_id — iş parçacığı kimliği (forum işlevselliğine sahip süper gruplarda kullanılabilir)
Düğme seti açıklamalarını basitleştirmek için aşağıdaki lifehack kullanabilirsiniz
Örnek
Parametreleri doldurun: telefon numarası, ad ve soyad.

Sonucu kontrol edin:

Kopyalamak için kod örneği
soob=tg_send_contact(platform_id, "+79999999999", "Ann", "Test", 1)
Çıkartma nasıl gönderilir
Çıkartma gönder tg_send_sticker()
! Telegram işletme hesabı ile çalışma
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 - çıkartma kimliği. tg_request aracılığıyla nasıl bağlantı alınacağı burada açıklanmıştır
protect_content — içeriği kopyalamaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak işareti '' dışında herhangi bir değer girin
disable_notification — mesajı sesli bildirimle gönderme bayrağı (varsayılan: 0).
1 — bildirimsiz gönder, 0 — bildirimli gönder
reply_to_message_id - Yanıtlanacak mesajın kimliği (yani alıntı)
reply_markup — düğme ayarları **
message_thread_id — iş parçacığı kimliği (forum işlevselliğine sahip süper gruplarda kullanılabilir)
Düğme seti açıklamalarını basitleştirmek için aşağıdaki lifehack kullanabilirsiniz
Örnek
Çıkartma göndermek, diğer herhangi bir eki göndermekten farklı değildir:\
- Dahili Telegram bağlantısını edinin (ayrıntılar burada)\
- Fonksiyon parametrelerini doldurun\
- Bloğu kendinize gönderin ve sonucu kontrol edin

Sonuç:

Kopyalamak için kod örneği
Bağlantıların her bot için benzersiz olduğunu unutmayın, bu nedenle kendi bağlantılarınızı oluşturduğunuzdan emin olun
soob=tg_send_sticker(platform_id, 'CAACAgIAAxkBAAEawJ5jmNeyat8uPGBMP3JzubRNXGjH3wACrw4AAsYg4UqePobN94_jkywE')
Fotoğraf nasıl gönderilir
captionparametresini anlama
captionparametresi, bir görsel için açıklayıcı metin sağlar (örneğin, kısa bir özet veya açıklama). Aşağıdaki şekilde çalışır:
- Tek bir görselle: bir açıklama sağlanırsa, mesaj hem görseli hem de açıklayıcı metni içerecektir.
- Birden çok görselle: her görselin kendi bireysel açıklaması olabilir. Bu durumda, her görsel kendi özel açıklamasıyla birlikte gönderilecektir.
Kullanıcı deneyimi: açıklama metni, genellikle bir kullanıcı görsele tıkladığında veya dokunduğunda ortaya çıkar.
Ayrıntılı teknik özellikler ve API davranışı için lütfen resmi Telegram belgelerine bakın.
Not: bir video eğitimini takip ediyorsanız, ayarlar ve arayüzler zamanla güncellenebileceğinden adımları dikkatlice inceleyin.
Fotoğraf gönder tg_send_photo()
! Fotoğraf 10 MB'tan büyük olmamalıdır. Toplam genişlik ve yükseklik 10.000 pikseli geçmemelidir. Genişlik-yükseklik oranı 20'yi geçmemelidir.
! Telegram işletme hesabı ile çalışma
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 *
! photo - Görsele bağlantı. tg_request aracılığıyla nasıl bağlantı alınacağı burada açıklanmıştır.
caption - 1024 karaktere kadar açıklama
reply_markup — düğme ayarları **
parse_mode — açıklamadaki metin biçimlendirmesi kalın veya italik ***
reply_to_message_id - Yanıtlanacak mesajın kimliği (yani alıntı)
protect_content — içeriği kopyalamaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak işareti '' dışında herhangi bir değer girin
has_spoiler — spoiler biçimlendirmesini etkinleştirir, etkinleştirmek için True olarak ayarlayın
disable_notification — mesajı sesli bildirimle gönderme bayrağı (varsayılan: 0).
1 — bildirimsiz gönder, 0 — bildirimli gönder
message_thread_id — iş parçacığı kimliği (forum işlevselliğine sahip 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örüntüleneceğ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örüntülenecektir
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österilirken, mesaj metninin kendisi bir değişkende saklanır
Düğme seti açıklamalarını basitleştirmek için aşağıdaki lifehack kullanabilirsiniz
Birden çok fotoğraf gönder tg_send_some_photo()
! Fotoğraf 10 MB'tan büyük olmamalıdır. Toplam genişlik ve yükseklik 10.000 pikseli geçmemelidir. Genişlik-yükseklik oranı 20'yi geçmemelidir.
! Telegram işletme hesabı ile çalışma
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 ayrıntılar)
disable_notification — mesajı sesli bildirimle gönderme bayrağı (varsayılan: 0).
1 — bildirimsiz gönder, 0 — bildirimli gönder
protect_content — içeriği kopyalamaya karşı koruma bayrağı (isteğe bağlı parametre, etkinleştirmek için değer olarak 1 girin)
reply_to_message_id - Yanıtlanacak 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 — iş parçacığı kimliği (forum işlevselliğine sahip 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örsel için veri örneği:
["Görsel bağlantısı 1", "caption", "parse_mode"]
Parametre sırası önemlidir! Görüntü dosyaları dizisini oluştururken tırnak işaretleri "" atlanabilir
Parametre açıklaması:
! Görsel bağlantısı 1 - görsel bağlantısı. tg_request aracılığıyla nasıl bağlantı alınacağı burada açıklanmıştır
caption — 1024 karaktere kadar açıklama
parse_mode — açıklamadaki metin biçimlendirmesi kalın veya italik ***
Örnek
Birden çok görsel göndermek için bir fonksiyon örneğine bakalım:
ilk olarak, bir görsel dizisi oluşturun

Ardından, fonksiyon parametrelerini doldurun

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

Kopyalamak için kod örneği
Her bot için bağlantıların benzersiz olduğunu unutmayın, bu nedenle video için kendi bağlantılarınızı oluşturduğunuzdan emin olun
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)
Zar nasıl gönderilir
Rastgele seçimli bir emoji gönder (Zar) tg_send_dice()
tg_send_dice(platform_id, emoji, reply_markup, disable_notification, reply_to_message_id, protect_content, message_thread_id)
! Telegram işletme hesabı ile ç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. Emojinin kendisini bir dize olarak veya onu temsil etmek için kullanılan anahtar kelimeyi iletebilirsiniz
reply_markup — düğme ayarları **
disable_notification — mesajı sesli bildirimle gönderme bayrağı (varsayılan: 0).
1 — bildirimsiz gönder, 0 — bildirimli gönder
reply_to_message_id -yanıtlanacak mesajın kimliği (yani alıntı)
protect_content — içeriği kopyalamaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak işareti '' dışında herhangi bir değer iletin
message_thread_id — iş parçacığı kimliği (forum işlevselliğine sahip süper gruplarda kullanılabilir)
Düğme seti açıklamalarını basitleştirmek için aşağıdaki lifehack kullanabilirsiniz
Olası emoji listesi: \
- 'darts' veya '🎯', 1'den 6'ya kadar değerler \
- 'dice' veya '🎲', 1'den 6'ya kadar değerler \
- 'bowling' veya '🎳', 1'den 6'ya kadar değerler \
- 'basketball' veya '🏀', 1'den 5'e kadar değerler \
- 'football' veya '⚽', 1'den 5'e kadar değerler \
- 'slots' veya '🎰', 1'den 64'e kadar değerler
Ek olarak, bir istemci bot'a bu emojilerden birini gönderirse, puan ve hangi emojinin kullanıldığı hakkında bilgi içeren bir geri arama alırsınız.
Örnek
En basit seçenek, işlevi yalnızca bir gerekli parametreyle çağırmaktır:

Bu durumda istemci bir zar alacaktır:

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

Bu işlevi deneyebilirsiniz. Örneğin, bir slot makinesi oluşturalım ve bir Puan düğmesi ekleyelim. Düğmeye basıldığında, istemcinin toplam puanını alacağız:



Kopyalamak için kod örneği
İlk örnek:
soob=tg_send_dice(platform_id)
İkinci örnek:
/* İlk örnek */
tg_send_message(platform_id,'Şansınızı denemek için slot makinesine tıklayın!')
opts='{"inline_keyboard": [[{"text": " 👓 ","callback_data":"Play"}]]}'
soob=tg_send_dice(platform_id, 'slots', opts)
/* İkinci blok - Metin Mesajı */
#{res[1]} puan atıldı
/* İkinci blok - Hesap Makinesi */
res=splitter('#{question}', ' ')
toplam=if(toplam==None,0,toplam) + int(res[1])
/* Üçüncü blok - Metin Mesajı */
Toplam #{toplam} puanınız var
Medya grubu nasıl gönderilir
Medya grubu gönder tg_send_media_group()
! Telegram işletme hesabı ile çalışır
Bir albüm olarak bir grup fotoğraf, video, belge veya ses dosyası 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 gruplandırılamaz!
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 fotoğraf, video, belge veya ses dosyası içeren bir dizi (aşağıda ayrıntılar);
disable_notification — mesajı sesli bildirimle gönderme bayrağı (varsayılan: 0).
1 — bildirimsiz gönder, 0 — bildirimli gönder
protect_content — içeriği kopyalamaya karşı koruma bayrağı. Etkinleştirmek için 0, False veya boş tırnak işareti '' dışında herhangi bir değer iletin
reply_to_message_id - yanıtlanacak mesajın kimliği (yani alıntı)
message_thread_id — iş parçacığı kimliği (forum işlevselliğine sahip 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 var olan bir dosyayı göndermek için bir file_id iletin (önerilir), Telegram'ın dosyayı İnternet'ten alması için bir HTTP URL'si veya multipart/form-data kullanarak yeni bir dosyayı <file_attach_name> adıyla yüklemek için «attach://<file_attach_name>».
Daha fazla bilgi: https://core.telegram.org/bots/api#sending-files
caption — gönderilen dosyanın başlığı, 0–1024 karakter.
parse_mode — başlıkta metin biçimlendirme kalın veya italik
Daha fazla bilgi: https://core.telegram.org/bots/api#sending-files
media_list dizisi örneği:
[{"type": "photo", "media": "AgACAgIAAxkBAAIKa2W6HqQG151EaWOKnCyy8feBi8p_AAIH1zEbicvYSfi2QYj-CMreAQADAgADeAADNAQ", "caption": "hayaletler videosu"}, {"type": "video", "media": "BAACAgIAAxkBAAIKpGW6P_HGDoVz7u4blDF6925WO-hmAALVPQACicvYSYwIWCJKwKIWNAQ", “caption”: “tavşan videosu”}]
Örnek
Birden çok resim göndermek için örnek bir işleve bakalım:
önce bir resim dizisi oluşturun

Ardından, işlev parametrelerini doldurun

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

Kopyalamak için kod örneği
Her bot için bağlantıların benzersiz olduğunu unutmayın, bu nedenle video için kendi bağlantılarınızı oluşturduğunuzdan emin olun
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)
Büyük dosya ekleri nasıl gönderilir
Örnek
Telegram'da (hem işletme hesapları hem de normal hesaplar için) bir bağlantı aracılığıyla ekler gönderebilirsiniz:
- Dosya boyutu sınırlamalarını aşarak herhangi bir boyuttaki ekleri gönderebilirsiniz.
- Ayrıca ihtiyacınız olan her türlü eki gönderebilirsiniz.
Nasıl yapılır:
Zaten herkese açık olan bir ekin bağlantısını kopyalayın:
Ardından, kopyalanan bağlantıyı bloğunuzdaki ek işlevine yapıştırın:
Tamamlandı. Bu şekilde her tür ve boyuttaki ekleri gönderebilirsiniz.