Telegram Business hesabı kullanarak mesaj gönderme

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:

Parametre Açıklama
**!** platform_id Mesajın gönderileceği Telegram kullanıcı kimliği *
**!** text Mesaj metni
client_message_id Alıntı yapılacak mesaj kimliği
reply_markup Buton ayarları **
parse_mode Açıklamada 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, aksi halde 0 veya boş "" bırakın.
protect_content İçerik koruma bayrağı. Etkinleştirmek için 0, False veya '' dışında herhangi bir değer girin.
disable_notification Sesli bildirim bayrağı (varsayılan: 0). Bildirimi devre dışı bırakmak için 1, etkinleştirmek için 0 girin.
message_thread_id Konu kimliği (forum işlevi etkinleştirilmiş süper gruplar için kullanılabilir)
entities Bu, önceden biçimlendirilmiş metni tüm stilleriyle birlikte kopyalamanıza ve belirli bir yazı tipinin uygulanması gereken karakter aralığını belirtmenize olanak tanır. Bir örnek, tg_request altında ilgili alanda bulunabilir. Parametre bir sözlük olmalıdır. Referans için örnek sekmesine bakın.
**Detaylı örnek**

Gerekli parametrelerle basit bir örnek ele alalım:

platform_id, belirli bir müşterinin tanımlayıcısını belirtir.

Aynı örneği değişkenler kullanarak görelim:

Bu örnekte, soob değişkeni, mesaj gönderildikten sonra sunucunun yanıtını içerecektir.

Alınan yanıttan message_id'yi kaydederseniz, bu daha sonra bu mesajla çalışmanıza (düzenleme, silme, iletme, yorum yapma) olanak tanır.

Tüm parametreleri kullanırken genellikle zorluklar ortaya çıkar. Aşağıdaki örneği ele alalım:

  • İlk olarak, fonksiyonda kullanılan tüm parametreleri bildirin. Parametrelerin yalnızca değer olarak değil, aynı zamanda değişken olarak da geçirilebileceğini unutmayın; bu genellikle daha kullanışlı ve nettir. platform_id ve client_message_id gibi değişkenler müşterinin profil kartından alınabilir.
    platform_id — Mesajın gönderileceği Telegram müşteri kimliği *\ >Müşterinin yazdığı sohbette yanıtlayacağız

    text - mesaj metni. \ >Metin biçimlendirmesi kullanıyoruz - örneğin, kalın vurgulama.

    client_message_id - Alıntı yapılacak mesaj kimliği\ >Sohbetlerde bu değişkene değeri otomatik olarak atanır.
    reply_markup — Buton ayarları **. \ >Bunu opts değişkenine atayalım.
    parse_mode — Açıklamada kalın ve italik metin biçimlendirmesi ***. html, markdown, markdownV2 gibi değerler alabilir. Mesaj metnini biçimlendirmek için kullanılan karakterler burada açıklanmıştır. \ >markdown kullanalım.
    disable_web_page_preview - Bağlantı önizlemesini göster. Devre dışı bırakmak için 1, aksi halde 0 veya boş "" bırakın.\ >Mesaj metni bağlantı içermediğinden herhangi bir değer geçebiliriz.
    protect_content — İçerik koruma bayrağı. Etkinleştirmek için 0, False veya '' dışında herhangi bir değer girin.\ >İçerik korumasına ihtiyacımız yok, bu yüzden boş bir dize geçeceğiz ''.
    disable_notification — Sesli bildirim bayrağı (varsayılan: 0). Bildirimi devre dışı bırakmak için 1, etkinleştirmek için 0 girin.\ >Bildirim, mesaj metnini görüntüleyen bir açılır penceredir. Etkinleştirelim.

  • Ardından, fonksiyonu birleştiriyoruz. Fonksiyonu bir değişkene atamayı unutmayın; bu, mesaj gönderme durumunu izlemenize olanak tanır.

İşte elde ettiğimiz:

Müşteri bize test anahtar kelimesini gönderdikten sonra, mesajını alıntılayarak yanıtlıyoruz.

ok içinde gönderme durumunu görüyoruz; ardından mesajın kendisi hakkında bilgi geliyor - kimliği, gönderen verileri ve içeriği.

entities parametresi ile örnek

Orijinal dizeyi aşağıda gösterildiği gibi 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"}]

Parametreyi kullandığınız fonksiyonda en son geçirin. 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ı olan metni bir değişkene atamak için değeri aşağıdaki gibi belirtin:

text = "İlk metin satırı" + "\n" + "İkinci metin satırı" + "\n" + "Üçüncü satır"

Belirli bir Telegram botu belirterek mesaj gönderme

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)

Parametre Açıklama
**!** token BotFather'dan alınan Telegram bot tokeni
**!** platform_id Mesajın gönderileceği Telegram kullanıcı kimliği *
**!** text Mesaj metni
client_message_id Alıntı yapılacak mesaj kimliği
reply_markup Buton ayarları **
parse_mode Açıklamada 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, aksi halde 0 veya boş "" bırakın.
protect_content İçerik koruma bayrağı. Etkinleştirmek için 0, False veya '' dışında herhangi bir değer girin.
disable_notification Sesli bildirim bayrağı (varsayılan: 0). Bildirimi devre dışı bırakmak için 1, etkinleştirmek için 0 girin.
message_thread_id Konu kimliği (forum işlevi etkinleştirilmiş süper gruplar için kullanılabilir)
entities Bu, önceden biçimlendirilmiş metni tüm stilleriyle birlikte kopyalamanıza ve belirli bir yazı tipinin uygulanması gereken karakter aralığını belirtmenize olanak tanır. Bir örnek, tg_request altında ilgili alanda bulunabilir. Parametre bir sözlük olmalıdır.
business_connection_id İş Kimliği değeri, bot bağlanırken kullanılır ve kanallarda görüntülenir. Parametrelere bir bot tokeni dahil edilmişse ve mesajın bota bağlı bir kullanıcı hesabı üzerinden gönderilmesi gerekiyorsa sağlanmalıdır.
Örnek

Parametrenin geçirilmesine örnek:
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österirken, mesaj metninin kendisi ayrı bir değişkene atanır.

Telegram mesajındaki metni düzenleme

Lütfen dikkat!

Mesaj düzenleme işlevi yalnızca yeni ve yakın zamanda gönderilmiş mesajlar için kullanılabilir.

Mesaj düzenlemeye izin verilen 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 dilimi 48 saattir.

tg_edit_message_text(platform_id, message_id, text, reply_markup, parse_mode, disable_web_page_preview, entities)

Parametre Açıklama
**!** 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 Buton ayarları **
parse_mode Açıklamada 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, aksi halde 0 veya boş "" bırakın.
entities Bu, önceden biçimlendirilmiş metni tüm stilleriyle birlikte kopyalamanıza ve belirli bir yazı tipinin uygulanması gereken karakter aralığını belirtmenize olanak tanır. Bir örnek, tg_request altında ilgili alanda bulunabilir. Parametre bir sözlük olmalıdır.

Bir mesaja tepki gönderme

tg_set_reaction(platform_id, message_id, reaction)

Parametre Açıklama
**!** platform_id Telegram sohbet kimliği
**!** message_id Mesaj kimliği
**!** reaction Gerekli tepki bir dize olarak geçirilir.
Örnek

Kopyalama için kod örneği:

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

Hesap makinesinde örnek:

Bir ek açıklamasını düzenleme

tg_edit_message_caption(platform_id, message_id, caption, reply_markup, parse_mode, entities, show_caption_above_media)

Parametre Açıklama
**!** 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 Buton ayarları **
parse_mode Açıklamada kalın ve italik metin biçimlendirmesi ***. html, markdown, markdownV2 gibi değerler alabilir.
entities

Bu, önceden biçimlendirilmiş metni tüm stilleriyle birlikte kopyalamanıza ve belirli bir yazı tipinin uygulanması gereken karakter aralığını belirtmenize olanak tanır. Bir örnek, tg_request altında ilgili alanda bulunabilir. Parametre bir sözlük olmalıdır.

Parametrenin geçirilmesine örnek:
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österirken, 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 eklerini düzenleme

Parametre Açıklama
**!** 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önderilmiş bir fotoğrafı değiştirmek için JSON sözlüğü örneği:
media = '{"type": "photo", "media": "<file_to_send>"}'

Burada <file_to_send> öğesinin, tam Telegram webhook aracılığıyla elde edilen file_id olması önerilir.

Daha fazla ayrıntı için, sözlük parametreleri resmi Telegram belgelerinde açıklanmıştır.

reply_markup Buton ayarları **

Bir mesajdaki satır içi klavyeyi düzenleme

Parametre Açıklama
**!** 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.
**!** reply_markup Buton ayarları **

Yalnızca satır içi klavye düzenlenebilir.

Örnek: Telegram API ile mesaj düzenleme

Mesajları düzenlemek için Telegram API işlevleriyle çalışmaya ilişkin ayrıntılı bir örneği aşağıda bulabilirsiniz.

Bir mesajı kopyalama

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)

Parametre Açıklama
**!** 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 Buton ayarları **
parse_mode

Açıklamada 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 girin.
disable_notification Sesli bildirim bayrağı (varsayılan: 0). Bildirimi devre dışı bırakmak için 1, etkinleştirmek için 0 girin.
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, önceden biçimlendirilmiş metni tüm stilleriyle birlikte kopyalamanıza ve belirli bir yazı tipinin uygulanması gereken karakter aralığını belirtmenize olanak tanır. Bir örnek, tg_request altında ilgili alanda bulunabilir. Parametre bir sözlük olmalıdır.

Parametrenin geçirilmesine örnek:
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österirken, 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ı iletme

tg_forward_message(platform_id, from_chat_id, message_id, protect_content, disable_notification, message_thread_id)

Parametre Açıklama
**!** 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 girin.
disable_notification Sesli bildirim bayrağı (varsayılan: 0). Bildirimi devre dışı bırakmak için 1, etkinleştirmek için 0 girin.
message_thread_id Konu kimliği (forum işlevi etkinleştirilmiş süper gruplar için kullanılabilir)

Bir mesajı silme

tg_delete_message(platform_id, message_id)

! Bu yöntemi, aşağıdaki kısıtlamalarla birlikte servis mesajları da dahil olmak üzere bir mesajı silmek için kullanın:

  • Bir mesaj yalnızca 48 saatten daha kısa bir süre önce gönderilmişse silinebilir.
  • Özel sohbetlerdeki zar mesajları yalnızca 24 saatten daha uzun bir süre önce gönderilmişse silinebilir.
  • Botlar, özel sohbetlerde, gruplarda ve süper gruplarda giden mesajları silebilir.
  • Botlar, özel sohbetlerde gelen mesajları silebilir.
  • can_post_messages iznine sahip botlar, kanallarda giden mesajları silebilir.
  • Bir bot bir grubun yöneticisiyse, oradaki herhangi bir mesajı silebilir.
  • Bir bot bir süper grupta veya kanalda can_delete_messages iznine sahipse, oradaki herhangi bir mesajı silebilir.
Parametre Açıklama
**!** platform_id Telegram kullanıcı kimliği *
**!** message_id Silinecek mesaj kimliği

Birden çok mesajı silme

tg_delete_messages(platform_id, message_ids)

! Bu yöntemi, aşağıdaki kısıtlamalarla birlikte servis mesajları da dahil olmak üzere bir mesajı silmek için kullanın:

  • Bir mesaj yalnızca 48 saatten daha kısa bir süre önce gönderilmişse silinebilir.
  • Özel sohbetlerdeki zar mesajları yalnızca 24 saatten daha uzun bir süre önce gönderilmişse silinebilir.
  • Botlar, özel sohbetlerde, gruplarda ve süper gruplarda giden mesajları silebilir.
  • Botlar, özel sohbetlerde gelen mesajları silebilir.
  • can_post_messages iznine sahip botlar, kanallarda giden mesajları silebilir.
  • Bir bot bir grubun yöneticisiyse, oradaki herhangi bir mesajı silebilir.
  • Bir bot bir süper grupta veya kanalda can_delete_messages iznine sahipse, oradaki herhangi bir mesajı silebilir.
Parametre Açıklama
**!** platform_id Telegram kullanıcı kimliği
**!** message_ids Silinecek mesaj kimliklerinden oluşan bir dizi. Maksimum 100 öğe.

Örnek: Telegram API ile mesaj gönderme

Kopyalama için kod örneği

Örnek 1

/*Metni önceden bir değişkende tanımlamak kullanışlıdır*/
text='Yazma-yazma-yazma metni'
/*Mesaj gönderme fonksiyonu*/
soob=tg_send_message(platform_id, text)
/*Gönderilen mesaj kimliğini kaydet*/
soob_id=soob['result']['message_id']

Örnek 2

id_group=-1001847103100
text='API yöntemiyle mesaj göndermeyi test etme. Örneğin, *kalın metin*'
opts = {"inline_keyboard": [[{"text": "👍","callback_data":1}, {"text": "👎","callback_data":2}]]}
disable_web_page_preview=1
protect_content=''
disable_notification=1
parse_mode='markdown'
soob=tg_send_message(id_group, text,client_message_id, opts, parse_mode, disable_web_page_preview, protect_content, disable_notification) 


Örnek: Telegram API ile mesaj düzenleme

Yapılandırma örneği

Şimdi, kendimize satır içi klavyeli bir mesaj gönderelim:

Ardından, mesaj metnini düzenleyelim:

Ve butonları düzenleyelim:

Bir resim içeren bir mesajı düzenlemeyi deneyelim. Bunu yapmak için, bir resim içeren bir mesaj gönderin ve gönderilen mesaj kimliğini kaydedin. Resim URL'sini nasıl alacağınıza ilişkin ayrıntılı talimatları burada bulabilirsiniz:

Şimdi, resmi ve açıklamasını düzenleyelim:

Kopyalama için kod örneği
/*Parametreleri önceden bir değişkende tanımlamak kullanışlıdır.*/
text='Hangi paketi seçmek istersiniz?'
opts = {"inline_keyboard": [[{"text": "Paket 1","callback_data":1}, {"text": "Paket 2","callback_data":2}]]}
/*Mesaj gönderme fonksiyonu*/
soob=tg_send_message(platform_id, text, None, opts)
/*Gönderilen mesaj kimliğini kaydet*/
soob_id=soob['result']['message_id']

/*Mesajı düzenle*/
text='Hangi paketle ilgileniyorsunuz?'
tg_edit_message_text(platform_id, soob_id, text, opts)  

/*Satır içi klavyeyi düzenle*/
opts = {"inline_keyboard": [[{"text": "Standart","callback_data":1}, {"text": "Premium","callback_data":2}]]}
tg_edit_message_reply_markup(platform_id, soob_id, opts)


/*Açıklamalı resim gönder*/
soob=tg_send_photo(platform_id, "AgACAgIAAxkBAAIPpWO4T7jhOgYHq6uR8rjnq9rIvBs-AAJlwDEb5fHASaGdhzgWjyn7AQADAgADeAADLQQ", "Bu bir resimdir")
/*Gönderilen mesaj kimliğini kaydet*/
soob_id=soob['result']['message_id']

/*Resmi düzenle*/
media='{"type": "photo", "media": "AgACAgIAAxkBAAIPrmO4UiH7Tazqn-3IbFVzPKNsVEZmAAJ1wDEb5fHASWcNXKah-egvAQADAgADeQADLQQ"}'
tg_edit_message_media(platform_id, soob_id, media)
/*Resim açıklamasını düzenle*/
tg_edit_message_caption(platform_id, soob_id, 'Bu BENİM!')

Örnek: Telegram API ile mesaj kopyalama

Örnek

Bir mesaj gönderelim ve kimliğini kaydedelim.

Ve daha önce gönderilen mesajı kopyalayalım.

Kopyalama için kod örneği
/*Parametreleri önceden bir değişkende tanımlamak kullanışlıdır.*/
text='Hangi paketi seçmek istersiniz?'
opts = {"inline_keyboard": [[{"text": "Paket 1","callback_data":1}, {"text": "Paket 2","callback_data":2}]]}
/*Mesaj gönderme fonksiyonu*/
soob=tg_send_message(platform_id, text, None, opts)
/*Gönderilen mesaj kimliğini kaydet*/
soob_id=soob['result']['message_id']


/*Gönderilen mesajı kopyala*/
tg_copy_message('5081438490', '1840834360', soob_id, None, opts, None, None, 1)