Telegram API işlevleri

API işlevleri, Telegram’daki bir botun yeteneklerini önemli ölçüde genişletir. API işlevlerini kullanarak Telegram’daki ekler, gruplar ve sohbetlerle çalışabilirsiniz — örneğin kullanıcıları otomatik olarak engelleme veya engelini kaldırma ve çok daha fazlası!

Kaynak: Telegram bot API

Önemli!

API işlevleriyle nasıl çalışılacağını anlamak için, hesap makinesinde işlevlerin ve parametrelerin belirtilme kurallarını incelemenizi şiddetle tavsiye ederiz.

GÖSTERİM:

! — ünlem işareti, zorunlu parametreleri gösterir

parameter=None — bu, belirtilen parametrenin varsayılan değerini gösterir.

Şu yanlış belgelemelerden işlev metnini doğrudan kopyalamak, örneğin şu şekilde: tg_send_message(platform_id, "Some text", client_message_id=61818138, reply_markup=None, parse_mode=None, disable_web_page_preview=0, protect_content=False)

Eşittir işaretlerinden sonraki değerler, her parametre için varsayılan değerleri temsil eder. Bu nedenle, belirli bir parametreye ihtiyacınız yok ama ardından gelen bir parametreye ihtiyacınız varsa, kullanılmayanı sadece atlayamazsınız — bunun yerine, onun varsayılan değerini açıkça iletmelisiniz.

Böylece, doğru kullanım şu şekilde olur: tg_send_message(platform_id, "Some text", 61818138, None, None, 0, True)

Nereden bulabilirim platform_id bildirim göndermek için?

• Projenize bağlı bir Telegram botunuz olmalı.

• Bildirim almak istediğiniz Telegram hesabından bu bot’a herhangi bir mesaj gönderin.

• Proje istemcileri listesinden, istek göndermek istediğiniz istemci sohbetini seçin.

• Messenger alanındaki ID değerini kopyalayın.

Aşağıdaki öğeyi iletme örneği platform_id parametresi:

1. platform_id parametresi, sayısal değerler açıkça belirtilmeden iletilebilir.

platform_id herhangi bir değer olmadan sağlandı

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

Bu parametreye sahip işlevler, platform_id değeri açıkça belirtilmeden de çalışır. Önemli: Çoğu işlevde bu parametre zorunludur ve atlanmamalıdır.

2. İşlevi belirli bir sohbet, kanal veya grupta kullanmanız gerekiyorsa, platform_id’yi sayısal bir değer olarak belirtmelisiniz.

İşlevde tg_send_message(!platform_id, !text) yukarıda gösterildiği gibi, platform_id parametresi tırnak işaretleri içinde bir sayısal değer kullanılarak iletilir:

tgmess = tg_send_message('1234566788', 'Merhaba!')

reply_markup parametresinde düğmeler nasıl tanımlanır

Yanıt düğmelerine örnek:

opts = {"keyboard": [[{"text": "Sol"}, {"text": "Sağ"}]]}

Satır içi düğmelere örnek:

opts = {"inline_keyboard": [[{"text": "Paket 1","callback_data":1}, {"text": "Paket 2","callback_data":2}]]}

parse_mode parametresinde metin biçimlendirmesi (Markdown) nasıl kullanılır?

Düğmenin parse_mode parametresi, tüm metni veya bir kısmını italik veya kalınbiçiminde biçimlendirir. Şu değerleri alabilir: html, markdown veya markdownV2.

1. html’yi seçerseniz:

şunlar için kalın metiniçin şunu kullanın "<b>başlık</b>"

şunlar için italik metiniçin şunu kullanın "<i>başlık</i>"

1. Markdown için:

şunlar için kalın metiniçin şunu kullanın "*başlık*"

şunlar için italik metiniçin şunu kullanın "_başlık_"

İtalik metin gönderme örneği: tg_send_message(47615196, "<i>italic</i>",None,None,"html")

Kalın metin gönderme örneği: tg_send_message(platform_id, '*test*', None, None, 'markdown')