Mesaj gönderme ve düzenleme işlevleri
Telegram Business hesabı kullanarak mesaj nasıl gönderilir
tg_send_message(platform_id, text,client_message_id, reply_markup, parse_mode, disable_web_page_preview, protect_content, disable_notification, message_thread_id, entities)
Parametreler:
! platform_id
Mesajın gönderileceği Telegram kullanıcı kimliği *
! text
Mesaj metni
client_message_id
Alıntılanacak mesaj kimliği
reply_markup
Düğme ayarları **
parse_mode
Açıklamadaki kalın ve italik metin biçimlendirmesi ***. html, markdown, markdownV2 gibi değerler alabilir.
disable_web_page_preview
Bağlantı önizlemesini göster. Devre dışı bırakmak için 1 gönderin; aksi halde 0 gönderin ya da "" olarak boş bırakın.
protect_content
İçerik koruma bayrağı. Etkinleştirmek için 0, False veya '' dışında herhangi bir değer gönderin.
disable_notification
Sesli bildirim bayrağı (varsayılan: 0). Bildirimi kapatmak için 1, açmak için 0 gönderin.
message_thread_id
Konu kimliği (forum işlevi etkinleştirilmiş süper gruplar için kullanılabilir)
entities
Bu, tüm stilleriyle birlikte önceden biçimlendirilmiş metni kopyalamanıza ve yalnızca belirli bir yazı tipinin uygulanacağı karakter aralığını belirtmenize olanak tanır. Bir örnek, ilgili alan altındaki tg_request içinde bulunabilir. Parametre bir sözlük olmalıdır. Referans için örnek sekmesine bakın.
Ayrıntılı örnek
Gerekli parametreler kümesiyle basit bir örneği ele alalım:
platform_id, belirli bir istemcinin tanımlayıcısını belirtir.
Aynı örneğe bakalım, ancak değişkenler kullanarak:
Bu örnekte, değişken soob bir mesaj gönderildikten sonra sunucunun yanıtını içerecektir.
Eğer message_id ifadesini alınan yanıttan kaydederseniz, daha sonra bu mesajla çalışmanıza olanak tanır (düzenle, sil, yönlendir, yorum yap).
Tüm parametreleri kullanırken çoğu zaman zorluklar ortaya çıkar. Aşağıdaki örneği ele alalım:
Önce, fonksiyonda kullanılan tüm parametreleri tanımlayın. Unutmayın, parametreler yalnızca değer olarak değil, aynı zamanda çoğu zaman daha kullanışlı ve daha anlaşılır olan değişkenler olarak da geçirilebilir. platform_id ve client_message_id gibi değişkenler istemcinin profil kartından elde edilebilir. platform_id — mesajın gönderileceği Telegram istemci kimliği * >Müşterinin yazdığı aynı sohbette yanıt vereceğiz
text - mesaj metni. >Metin biçimlendirmesi kullanıyoruz - örneğin, kalın vurgulama.
client_message_id - Alıntılanacak mesaj kimliği >Sohbetlerde bu değişkene değeri otomatik olarak atanır. reply_markup — düğme ayarları **. >Bunu opts değişkenine atayalım. parse_mode — Açıklamadaki kalın ve italik metin biçimlendirmesi ***. html, markdown, markdownV2 gibi değerler alabilir. Mesaj metnini biçimlendirmek için kullanılan karakterler burada. >Markdown kullanalım. disable_web_page_preview - Bağlantı önizlemesini göster. Devre dışı bırakmak için 1 gönderin; aksi halde 0 gönderin ya da "" olarak boş bırakın. >Mesaj metninde bağlantı olmadığı için herhangi bir değer geçebiliriz. protect_content — İçerik koruma bayrağı. Etkinleştirmek için 0, False veya '' dışında herhangi bir değer gönderin. >İçerik korumasına ihtiyacımız yok, bu yüzden boş bir dize göndereceğiz ''. disable_notification — Sesli bildirim bayrağı (varsayılan: 0). Bildirimi kapatmak için 1, açmak için 0 gönderin. >Bildirim, mesaj metnini gösteren bir açılır penceredir. Hadi etkinleştirelim.
Sonra fonksiyonu bir araya getiriyoruz. Fonksiyonu bir değişkene atamayı unutmayın — bu, mesaj gönderme durumunu izlemenizi sağlar.
İşte elde ettiklerimiz: Müşteri bize test anahtar sözcüğünü gönderdiğinde, mesajını alıntılayarak yanıt veriyoruz.
İçinde ok gönderim durumunu görüyoruz; ardından mesajın kendisi hakkında bilgi geliyor — kimliği, gönderen verileri ve içeriği.
ile örnek entities parametresi Aşağıda gösterildiği gibi, orijinal dizeyi bir değişkende saklayabilirsiniz:
text = "qwert asdfg zxcvb poiuy lkjhg 12345"
Parametreyi verilerle birlikte bir sözlük olarak yazmalı ve yazı tiplerini belirterek istenen biçimlendirmeyi belirtmelisiniz:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":" https://mavibot.ai"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]
Kullandığınız fonksiyonda parametreyi en sona gönderin. Parametre hem tg_send_message hem de tg_send_message_1 fonksiyonlarına geçirilebilir:
x = tg_send_message(platform_id, text, None, None, None, False, False, False, None, entities)
Satır sonları içeren metni bir değişkene atamak için değeri şu şekilde belirtin:
text = "İlk metin satırı" + "\n" + "İkinci metin satırı" + "\n" + "Üçüncü satır"
Belirli bir Telegram botu belirterek mesaj nasıl gönderilir
tg_send_message_1(token, platform_id, text, client_message_id, reply_markup, parse_mode, disable_web_page_preview, protect_content, disable_notification, message_thread_id, entities, business_connection_id)
! token
BotFather'dan alınan Telegram bot belirteci
! platform_id
Mesajın gönderileceği Telegram kullanıcı kimliği *
! text
Mesaj metni
client_message_id
Alıntılanacak mesaj kimliği
reply_markup
Düğme ayarları **
parse_mode
Açıklamadaki kalın ve italik metin biçimlendirmesi ***. html, markdown, markdownV2 gibi değerler alabilir.
disable_web_page_preview
Bağlantı önizlemesini göster. Devre dışı bırakmak için 1 gönderin; aksi halde 0 gönderin ya da "" olarak boş bırakın.
protect_content
İçerik koruma bayrağı. Etkinleştirmek için 0, False veya '' dışında herhangi bir değer gönderin.
disable_notification
Sesli bildirim bayrağı (varsayılan: 0). Bildirimi kapatmak için 1, açmak için 0 gönderin.
message_thread_id
Konu kimliği (forum işlevi etkinleştirilmiş süper gruplar için kullanılabilir)
entities
Bu, tüm stilleriyle birlikte önceden biçimlendirilmiş metni kopyalamanıza ve yalnızca belirli bir yazı tipinin uygulanacağı karakter aralığını belirtmenize olanak tanır. Bir örnek, ilgili alan altındaki tg_request içinde bulunabilir. Parametre bir sözlük olmalıdır.
business_connection_id
Düğmenin İşletme Kimliği değeri, botu bağlarken kullanılır ve kanallarda gösterilir. Parametrelere bir bot belirteci dahil edilmişse ve mesajın botla bağlantılı bir kullanıcı hesabı üzerinden gönderilmesi gerekiyorsa sağlanmalıdır.
Örnek
Parametrenin geçirilme örneği:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://mavibot.ai"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]
Örnek yalnızca sözlüğü gösterir; mesaj metninin kendisi ayrı bir değişkene atanır.
Telegram mesajındaki metin nasıl düzenlenir
Lütfen dikkat edin!
Mesaj düzenleme işlevi yalnızca yeni ve yakın zamanda gönderilmiş mesajlar için kullanılabilir.
Mesaj düzenlemenin izin verildiği zaman aralığı, mesajlaşma uygulamasının kendisi tarafından belirlenir ve botunuzun yüküne/etkinliğine bağlıdır; düzenleme için kısaltılabilir.
Mesajlaşma uygulamasının teknik desteğine göre, bir mesajı düzenlemek için en uygun zaman aralığı 48 saattir.
tg_edit_message_text(platform_id, message_id, text, reply_markup, parse_mode, disable_web_page_preview, entities)
! platform_id
Mesajın gönderileceği Telegram kullanıcı kimliği *
! message_id
Düzenlenecek mesaj kimliği. Bu kimlik, mesaj gönderilirken önceden kaydedilmelidir.
! text
Mesaj metni
reply_markup
Düğme ayarları **
parse_mode
Açıklamadaki kalın ve italik metin biçimlendirmesi ***. html, markdown, markdownV2 gibi değerler alabilir.
disable_web_page_preview
Bağlantı önizlemesini göster. Devre dışı bırakmak için 1 gönderin; aksi halde 0 gönderin ya da "" olarak boş bırakın.
entities
Bu, tüm stilleriyle birlikte önceden biçimlendirilmiş metni kopyalamanıza ve yalnızca belirli bir yazı tipinin uygulanacağı karakter aralığını belirtmenize olanak tanır. Bir örnek, ilgili alan altındaki tg_request içinde bulunabilir. Parametre bir sözlük olmalıdır.
Bir mesaja tepki nasıl gönderilir
tg_set_reaction(platform_id, message_id, reaction)
! platform_id
Telegram sohbet kimliği
! message_id
Mesaj kimliği
! tepki
Gerekli tepki bir dize olarak geçirilir.
Örnek
Kopyalamak için kod örneği:
react = tg_set_reaction(platform_id, 1556, '👌')
Hesap makinesindeki örnek:
Bir ek açıklaması nasıl düzenlenir
tg_edit_message_caption(platform_id, message_id, caption, reply_markup, parse_mode, entities, show_caption_above_media)
! platform_id
Mesajın gönderileceği Telegram kullanıcı kimliği *
! message_id
Düzenlenecek mesaj kimliği
! caption
Açıklama metni
reply_markup
Düğme ayarları **
parse_mode
Açıklamadaki kalın ve italik metin biçimlendirmesi ***. html, markdown, markdownV2 gibi değerler alabilir.
entities
Bu, tüm stilleriyle birlikte önceden biçimlendirilmiş metni kopyalamanıza ve yalnızca belirli bir yazı tipinin uygulanacağı karakter aralığını belirtmenize olanak tanır. Bir örnek, ilgili alan altındaki tg_request içinde bulunabilir. Parametre bir sözlük olmalıdır.
Parametrenin geçirilme örneği:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://,mavibot.ai"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]
Örnek yalnızca sözlüğü gösterir; mesaj metninin kendisi ayrı bir değişkene atanır.
show_caption_above_media
True değerini alır; bu parametre belirtilirse, mesaj metni ekin üzerinde görüntülenir.
Bir mesajdaki medya ekleri nasıl düzenlenir
! platform_id
Mesajın gönderileceği Telegram kullanıcı kimliği *
! message_id
Düzenlenecek mesaj kimliği. Bu kimlik, mesaj gönderilirken önceden kaydedilmelidir.
! media
Medya dosyasını açıklayan bir sözlük:
Daha önce gönderilen bir fotoğrafı değiştirmek için JSON sözlüğü örneği:
media = '{"type": "photo", "media": "<file_to_send>"}'
burada <file_to_send> için, tam Telegram webhook.
Daha fazla ayrıntı için, sözlük parametreleri resmi Telegram dokümantasyonunda.
reply_markup
Düğme ayarları **
Bir mesajdaki satır içi klavye nasıl düzenlenir
Yalnızca bir satır içi klavyeyi düzenleyebilirsiniz.
Örnek: Telegram API ile mesaj düzenleme
Aşağıda, mesajları düzenlemek için Telegram API işlevleriyle çalışmaya dair ayrıntılı bir örnek bulabilirsiniz.
Bir mesaj nasıl kopyalanır
tg_copy_message(platform_id, from_chat_id, message_id, reply_to_message_id, reply_markup, parse_mode, protect_content, disable_notification, caption, message_thread_id, entities, show_caption_above_media)
! platform_id
Mesajın kopyalanacağı Telegram kullanıcı kimliği *
! from_chat_id
Mesajın kopyalanacağı Telegram kullanıcı kimliği *
! message_id
Kopyalanacak mesaj kimliği
reply_to_message_id
Kopyalanan mesaj bir yorum ise, orijinal mesaj kimliği
reply_markup
Düğme ayarları **
parse_mode
Açıklamadaki kalın ve italik metin biçimlendirmesi ***.
html, markdown, markdownV2 gibi değerler alabilir.
protect_content
İçerik koruma bayrağı. Etkinleştirmek için 0, False veya '' dışında herhangi bir değer gönderin.
disable_notification
Sesli bildirim bayrağı (varsayılan: 0). Bildirimi kapatmak için 1, açmak için 0 gönderin.
caption -
1024 karaktere kadar açıklama.
message_thread_id
Konu kimliği (forum işlevi etkinleştirilmiş süper gruplar için kullanılabilir)
entities
Bu, tüm stilleriyle birlikte önceden biçimlendirilmiş metni kopyalamanıza ve yalnızca belirli bir yazı tipinin uygulanacağı karakter aralığını belirtmenize olanak tanır. Bir örnek, ilgili alan altındaki tg_request içinde bulunabilir. Parametre bir sözlük olmalıdır.
Parametrenin geçirilme örneği:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://mavibot.ai"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]
Örnek yalnızca sözlüğü gösterir; mesaj metninin kendisi ayrı bir değişkene atanır.
show_caption_above_media
True değerini alır; bu parametre belirtilirse, mesaj metni ekin üzerinde görüntülenir.
Bir mesaj nasıl iletilir
tg_forward_message(platform_id, from_chat_id, message_id, protect_content, disable_notification, message_thread_id)
! platform_id
Mesajın gönderileceği Telegram kullanıcı kimliği *
! from_chat_id
Mesajın gönderileceği Telegram kullanıcı kimliği *
! message_id
İletilecek mesaj kimliği
protect_content
İçerik koruma bayrağı. Etkinleştirmek için 0, False veya '' dışında herhangi bir değer gönderin.
disable_notification
Sesli bildirim bayrağı (varsayılan: 0). Bildirimi kapatmak için 1, açmak için 0 gönderin.
message_thread_id
Konu kimliği (forum işlevi etkinleştirilmiş süper gruplar için kullanılabilir)
Bir mesaj nasıl silinir
tg_delete_message(platform_id, message_id)
! Aşağıdaki kısıtlamalarla birlikte, hizmet mesajları dahil bir mesajı silmek için bu yöntemi kullanın:
Bir mesaj yalnızca 48 saatten daha kısa bir süre önce gönderildiyse silinebilir.
Özel sohbetteki zarları içeren mesajlar yalnızca 24 saatten daha uzun bir süre önce gönderildilerse silinebilir.
Botlar özel sohbetlerde, gruplarda ve süpergruplarda giden mesajları silebilir.
Botlar özel sohbetlerde gelen mesajları silebilir.
Botlar can_post_messages iznine sahipse kanallardaki giden mesajları silebilir.
Bir bot bir grubun yöneticisi ise, oradaki herhangi bir mesajı silebilir.
Bir botun can_delete_messages izni bir süpergrup veya kanalda varsa, oradaki herhangi bir mesajı silebilir.
! platform_id
Telegram kullanıcı kimliği *
! message_id
Silinecek mesaj kimliği
Birden fazla mesaj nasıl silinir
tg_delete_messages(platform_id, message_ids)
! Aşağıdaki kısıtlamalarla birlikte, hizmet mesajları dahil bir mesajı silmek için bu yöntemi kullanın:
Bir mesaj yalnızca 48 saatten daha kısa bir süre önce gönderildiyse silinebilir.
Özel sohbetteki zarları içeren mesajlar yalnızca 24 saatten daha uzun bir süre önce gönderildilerse silinebilir.
Botlar özel sohbetlerde, gruplarda ve süpergruplarda giden mesajları silebilir.
Botlar özel sohbetlerde gelen mesajları silebilir.
Botlar can_post_messages iznine sahipse kanallardaki giden mesajları silebilir.
Bir bot bir grubun yöneticisi ise, oradaki herhangi bir mesajı silebilir.
Bir botun can_delete_messages izni bir süpergrup veya kanalda varsa, oradaki herhangi bir mesajı silebilir.
! platform_id
Telegram kullanıcı kimliği
! message_ids
Silinecek mesaj kimliklerinden oluşan bir dizi. En fazla 100 öğe.
Örnek: Telegram API ile mesaj gönderme
Örnek: Telegram API ile mesaj düzenleme
Yapılandırma örneği
Öyleyse, kendimize satır içi bir klavyeyle bir mesaj gönderelim:
Sonra, mesaj metnini düzenleyin:
Ve düğmeleri düzenleyin:
Bir görüntü içeren bir mesajı düzenlemeyi deneyelim. Bunun için, bir görüntüyle mesaj gönderin ve gönderilen mesaj kimliğini kaydedin. Görüntü URL'sini nasıl alacağınıza dair ayrıntılı talimatları okuyun burada:
Şimdi, görüntüyü ve açıklamasını düzenleyelim:
Örnek: Telegram API ile mesaj kopyalama
Last updated