Telegram sohbet ve mesajlaşma ayarları
MaviBot'ta platform kimlikleriyle çalışmak
MaviBot'ta tüm Telegram varlıkları (kullanıcılar, gruplar, kanallar) genel bir platform_id değişkeniyle tanımlanır. Bu değişken, varlık türleri arasında ayrım yapmaz.
Sorun: şu gibi işlevleri kullanmak için kabul et veya reddet gibi belirli varlık türleri gerektiren işlevleri kullanmak için hem sohbet kimliğini hem de kullanıcı kimliğini ayrı ayrı bilmeniz gerekir.
Çözüm: Bir geri çağırma veya mesaj aldığınızda, platform_id değerini hemen iki ayrı, amacına uygun adlandırılmış değişkende saklayın:
chat_id– grup/kanalın kimliğini saklamak için.user_id– tekil kullanıcının kimliğini saklamak için.
Bu, uygulama mantığınızda daha sonra doğru kimliğe başvurmanızı sağlar.
Telegram botu üzerinden sohbet adını değiştirme
Açıklama
tg_set_group_title(platform_id, title) -
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
! title
yeni sohbet adı
Telegram botu üzerinden sohbet açıklamasını değiştirme
Açıklama
tg_set_chat_description(platform_id, description)
! platform_id
Telegram içindeki sohbet kimliği *
! description
yeni sohbet adı
Telegram'da bir grup/sohbete avatar ayarlama
Açıklama
tg_set_chat_photo(platform_id, photo)
! platform_id
Telegram içindeki sohbet kimliği *, avatar ayarlamak istediğiniz
! fotoğraf
bağlantı fotoğrafı
Telegram'da bir grup/sohbette avatarı silme
Açıklama
tg_delete_chat_photo(platform_id)
! platform_id
Telegram içindeki sohbet kimliği *, avatar ayarlamanız gereken
Bir Telegram grubunu yasaklama
Açıklama
tg_ban_chat_sender_chat(platform_id, sender_chat_id)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *yasaklamanız gereken,
! sender_chat_id
yasaklanacak sohbet kimliği
Aynı zamanda, yasaklanan sohbet sahibi yasak kaldırılana kadar diğer sohbetleri adına yazamaz.
Telegram grubunun yasağını kaldırma
Açıklama
tg_unban_chat_sender_chat(platform_id, sender_chat_id)
Parametre:
! platform_id
Telegram içindeki sohbet kimliği *, yasağını kaldırdığınız
! sender_chat_id
yasağını kaldırdığınız sohbet kimliği
Telegram sohbetine katılmak için davet bağlantısı oluşturma
Açıklama
tg_create_chat_invite_link(platform_id, member_limit, hours, request, name)
Parametre:
! platform_id
Telegram'daki sohbet kimliği *
member_limit
katılımcı sayısı sınırı
hours
Bağlantının sona erme süresi (saat cinsinden)
request
Bağlantıya tıklandıktan sonra sohbete katılma isteği oluşturulması gerektiğini belirten bir parametre.
name
bağlantı adı
şu parametreyi aktarırken member_limit parametresinin değeri otomatik olarak request olarak değiştirilir. Üyelik başvurularını kabul etmeniz gerekiyorsa, Falseparametresini member_limit boş bırakın.
Sohbet davet bağlantısı oluşturma
Telegram'da sohbet davet bağlantısını silme
Açıklama
tg_revoke_chat_invite_link(platform_id, invite_link)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
! invite_link
silmeniz gereken bağlantı
Tüm mevcut bağlantıları etkisizleştirip tek bir bağlantıyla değiştirme
Açıklama
tg_export_chat_link(platform_id)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
! invite_link
silmeniz gereken bağlantı
Sonuç olarak, başka yollarla ek bağlantılar oluşturulana kadar gruba girmenin tek yolu bu bağlantı olacaktır.
Dikkatli kullanın. Grubunuza ait mevcut tüm giriş bağlantıları etkisiz hale gelecektir.
Telegram kanalında/sohbetinde isteği kabul edip kullanıcı ekleme
Telegram kanalında/sohbetinde isteği reddetme
Telegram'da kullanıcıyı engelleme
Telegram'da kullanıcının engelini kaldırma
Telegram'da abonelik durumunu kontrol etme
Kanal/sohbetteki üye sayısını belirleme
Açıklama
tg_get_chat_member_count(platform_id)
Parametreler:
! platform_id
Telegram'daki sohbet kimliği *
Bir sohbet üyesinin belirli bir listede olup olmadığını kontrol etme
some_client_in_list(list_id, recepient)
Parametreler:
! list_id
liste numarası
! recepient
Telegram içindeki kullanıcının kimliği *. Sohbet istemcileri için bu değer chat_member_id değişkenindedir.
Botun eylemlerini kullanıcıya gösterme (yazıyor/seçiyor, çıkartma ve benzeri)
Açıklama
tg_send_chat_action(platform_id, bot_action, message_thread_id)
! Telegram business hesabıyla çalışır
Parametreler:
! platform_id
Telegram'daki sohbet kimliği *
! bot_action
listeden botun eylemi
message_thread_id
konu kimliği (forum işlevi mevcutsa süpergruplar için kullanılabilir).
Mevcut eylemler listesi bot_action
typing metin mesajları için, upload_photo fotoğraflar için, record_video veya upload_video videolar için, record_voice veya upload_voice sesli notlar için, upload_document normal belgeler için, choose_sticker çıkartmalar için, find_location konum verileri için, record_video_note veya upload_video_note video notu için.
Bu bildirim, bot tarafından bir yanıt alınana kadar, ancak en fazla 5 saniye boyunca gösterilir.
Kullanıcıya Uyarı bildirimi gösterme
Açıklama
tg_answer_callback_query(callback_query_id, text,show_alert,cache_time)
! callback_query_id (gerekli)
Bu kimlik, düğmeye tıklayan kişiyi tanımlamanıza ve ona Uyarı bildirimini göstermenize olanak tanır.
! text (gerekli)
Uyarı bildirimi metni.
show_alert
Kaybolan bildirimin göstergesi (False — solan ipucu tarzı bildirim, True — kalıcı pencere bildirimi)
cache_time
Bir geri çağırma isteğinin sonucunun istemci tarafında önbelleğe alınabileceği maksimum süre, saniye cinsinden. Telegram uygulamaları 3.14 sürümünden itibaren önbelleğe almayı destekler. Varsayılan değer 0'dır.
Örnek
Uyarı bildirimleri yalnızca Telegram'da geri çağırma düğmesine tıklanması sonucunda gösterilir.
Örneğin, aşağıdaki düğmeleri kullanıyoruz:
[{"line":0,"index_in_line":0,"text":"111","type":"inline","callback":"first"}, {"line":1,"index_in_line":0,"text":"222","type":"inline","callback":"second"}, {"line":2,"index_in_line":0,"text":"333","type":"inline","callback":"third"}]
Bir düğmeye tıkladıktan sonra, ilgili alanda bulunan metinle bir geri çağırma gelir. “111” düğmesine tıkladığınızda, “first" metniyle bir geri çağırma alırsınız.
Bir Start bloğu oluşturalım ve tetikleyicide istenen metni belirtelim. Bizim durumumuzda: "first
Eğer Eşleşmeler alanında Hataları ve yanlışlıkları yok saymayıseçerseniz, bu blok daha sonra 1–2 karakter fark eden benzer tüm varyantlar için yeniden kullanılabilir. Örneğin, kullanıcıya böyle bir düğmeyle puan verdiği için teşekkür etmek gibi.
Sonra, hesap makinesinde tg_answer_callback_query işlevini kullanın ve aşağıdaki parametreleri aktarın: callback_query_id - bu kimlik, düğmeye basan kullanıcıyı belirlemenize ve onlara Uyarı bildirimini göstermenize olanak tanır text - metin Uyarı bildirimi.
Kopyalamak için kod örneği:
tg_answer_callback_query('#{callback_query_id}', "111 düğmesine bastınız")
Dikkat edin! callback_query_id parametresi örnekte gösterildiği gibi, yani '#{}' içinde tam olarak aktarılmalıdır
Her şey doğru şekilde ayarlanmışsa, düğmeye basmak belirtilen metinle bir Uyarı bildirimi oluşturur. Mobil sürümde, botun adı metnin üzerinde başlık olarak görünecektir.
Bunun yerine basit bir açılır pencere mesajı göstermek istiyorsanız, False aşağıdaki örnekte gösterildiği gibi üçüncü parametre olarak aktarın: tg_answer_callback_query('#{callback_query_id}', "222 düğmesini geçtiğiniz", False)
Geri çağırma düğmesi yanıtları olarak etiketli bir bot yönlendirmesi ekleme
Açıklama
tg_callback_url_open(callback_query_id, url, cache_time)
Parametreler:
! callback_query_id
Bu kimlik, düğmeye tıklayan kişiyi tanımlamanıza ve ona Uyarı bildirimini göstermenize olanak tanır.
! url
Botu ve bir parametreyi gösteren URL (format: t.me/your_bot?start=XXXX, where your_bot - botun adıdır)
cache_time
Bir geri çağırma isteğinin sonucunun istemci tarafında önbelleğe alınabileceği maksimum süre, saniye cinsinden. Telegram uygulamaları 3.14 sürümünden itibaren önbelleğe almayı destekler. Varsayılan değer 0'dır.
Örnek
Geri çağırma düğmesi yanıtında, tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX') kullanarak etiketle botta bir geçiş ekleyebilirsiniz
Örneğin, aşağıdaki düğmeleri kullanalım:
[{"line":0,"index_in_line":0,"text":"111","type":"inline","callback":"first"}, {"line":1,"index_in_line":0,"text":"222","type":"inline","callback":"second"}, {"line":2,"index_in_line":0,"text":"333","type":"inline","callback":"third"}]
Bir düğmeye tıkladıktan sonra, ilgili alanda bulunan metinle bir geri çağırma gelir. “111” düğmesine tıkladığınızda, “first" metniyle bir geri çağırma alırsınız.
Birincil koşul kontrolü olan bir blok oluşturun ve koşulda istenen metni belirtin. Bizim durumumuzda: “first”:
Eğer Eşleşme seçeneği alanında Hataları ve yanlışlıkları yok sayseçerseniz, bu blok daha sonra 1–2 karakter fark eden benzer tüm varyantlar için yeniden kullanılabilir. Örneğin, kullanıcıya böyle bir düğmeyle puan verdiği için teşekkür etmek gibi.
Sonra, bloğun hesaplayıcısında tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX') belirtin:
Bir süpergrupta veya kanalda bir kullanıcıyı yönetici yapma
Gerekli parametre: promote_options_list
Aşağıdaki izinler promote_options_list :
is_anonymous — yöneticinin sohbet içindeki varlığını gizler,
can_manage_chat — yönetici sohbet etkinlik günlüğüne, sohbet istatistiklerine, kanallardaki mesaj istatistiklerine erişebilir, kanal üyelerini görüntüleyebilir, süpergruplardaki anonim yöneticileri görebilir ve yavaş modunu aşabilir. Bu izin seviyesi, sonraki ayrıcalıklardan herhangi biri belirtilirse varsayılan olarak verilir
can_post_messages — yönetici kanal gönderileri oluşturabilir (yalnızca kanallar)
can_edit_messages — yönetici diğer kullanıcıların mesajlarını düzenleyebilir ve mesajları sabitleyebilir (yalnızca kanallar)
can_delete_messages — yönetici diğer kullanıcıların mesajlarını silebilir
can_manage_video_chats — yönetici görüntülü sohbetleri yönetebilir,
can_restrict_members — yönetici üyeleri kısıtlayabilir, sohbette onları yasaklayıp yasaklarını kaldırabilir,
can_promote_members — yönetici, kendi ayrıcalıklarının bir alt kümesiyle yeni yöneticiler atayabilir veya doğrudan ya da dolaylı olarak atadığı yöneticileri düşürebilir (örneğin, kendisinin atadığı yöneticiler)
can_change_info — yönetici sohbet başlığını, fotoğrafını ve diğer ayarları değiştirebilir
can_invite_users — yönetici sohbete yeni kullanıcılar davet edebilir
can_pin_messages — yönetici mesajları sabitleyebilir (yalnızca süpergruplar).
Örnek
Örnek: Bir kullanıcıyı süpergrupta yönetici yapma:
Bu örnekte, belirtilen izinlere ek olarak can_manage_chat izni varsayılan olarak verilecektir.
Kopyalanacak kod örneği
Telegram'da bir bot kullanarak yönetici unvanını değiştirme
Açıklama
tg_set_administrator_title(platform_id, user_id, title)
Parametreler:
ÖNEMLİ!
Bu yalnızca bot tarafından süpergrupta yönetici olarak terfi ettirilen kullanıcılar için çalışır
Kopyalamak için kod örneği:
Normal sohbet üyeleri veya belirli Telegram kullanıcıları için genel kısıtlamalar
Açıklama
tg_chat_permission(platform_id, permission, media_permissions)
Parametreler:
! platform_id
Telegram içindeki sohbetin kimliği *
! permission
kısıtlama listesinden alınan değerlerden oluşan bir dizi (aşağıya bakın).
1 = eyleme izin verilir
0 = eylem yasaktır
Dizi indeksi, kısıtlama listesindeki konuma karşılık gelir
! media_permissions
medyayla ilgili izinleri tanımlayan bir dizi değer (ayrıntılar aşağıda).
1 = eyleme izin verilir
0 = eylem yasaktır
Dizi indeksi, medya izinleri listesindeki konuma karşılık gelir
Gerekli parametre için kısıtlama listesi permission
için kısıtlama listesi permission: 1. ! can_send_messages - metin mesajları, kişiler, konumlar ve mekanlar gönderme izni. 2. ! can_send_media_messages - ses, belge, fotoğraf, video, video notu ve sesli not gönderme izni. Şunu gerektirir can_send_messages 3. ! can_send_polls - anket gönderme izni. Şunu gerektirir can_send_messages 4. ! can_send_other_messages - animasyon, oyun, çıkartma gönderme ve yerleşik botları kullanma izni. Şunu gerektirir can_send_media_messages 5. ! can_add_web_page_previews - mesajlara web sayfası önizlemeleri ekleme izni. Şunu gerektirir can_send_media_messages 6. ! can_change_info - sohbet başlığını, fotoğrafını ve diğer ayarları değiştirme izni. Bu, herkese açık süpergruplarda yok sayılır. 7. ! can_invite_users - kullanıcı davet etme izni 8. ! can_pin_messages - mesajları sabitleme izni. Bu, herkese açık süpergruplarda yok sayılır. 9. can_manage_topics - forum gruplarında konu oluşturma izni. Yanlış türde bir grupta kullanılırsa, işlev başarısız olur ve bir hata döndürür.
Gerekli parametre için değer listesi media_permissions
Medya ile ilgili izinleri verme değerleri media_permissions:
1. can_send_audios - ses dosyaları gönderme izni 2. can_send_documents - belge gönderme izni 3. can_send_photos - fotoğraf gönderme izni 4. can_send_videos - video gönderme izni 5. can_send_video_notes - yuvarlak video mesajları gönderme izni 6. can_send_voice_notes - sesli mesaj gönderme izni
Normal sohbet kullanıcıları veya belirli Telegram kullanıcıları için Telegram Kişisel kısıtlamaları
Açıklama
tg_restrict_chat_member(platform_id, user_id, minutes, permission, media_permissions).
Parametreler:
! platform_id
Telegram'daki sohbet kimliği *
! user_id
Telegram'daki kullanıcı kimliği *
minutes
kısıtlamanın etkin kalacağı dakika sayısı. Bir değer belirtmezseniz, varsayılan değer 3600olur, bu da 60 saateeşittir. Bunu 0olarak ayarlarsanız, kısıtlama kalıcı olur
permission
değerlerden oluşan bir dizi izin kısıtlama listesi.
media_permissions
medyayla ilgili izinleri verme değerlerinin listesi
Gerekli parametre için kısıtlama listesi permission
için kısıtlama listesi permission: 1. ! can_send_messages - metin mesajları, kişiler, konumlar ve mekanlar gönderme izni. 2. ! can_send_media_messages - ses, belge, fotoğraf, video, video notu ve sesli not gönderme izni. Şunu gerektirir can_send_messages 3. ! can_send_polls - anket gönderme izni. Şunu gerektirir can_send_messages 4. ! can_send_other_messages - animasyon, oyun, çıkartma gönderme ve yerleşik botları kullanma izni. Şunu gerektirir can_send_media_messages 5. ! can_add_web_page_previews - mesajlara web sayfası önizlemeleri ekleme izni. Şunu gerektirir can_send_media_messages 6. ! can_change_info - sohbet başlığını, fotoğrafını ve diğer ayarları değiştirme izni. Bu, herkese açık süpergruplarda yok sayılır. 7. ! can_invite_users - kullanıcı davet etme izni 8. ! can_pin_messages - mesajları sabitleme izni. Bu, herkese açık süpergruplarda yok sayılır. 9. can_manage_topics - forum gruplarında konu oluşturma izni. Yanlış türde bir grupta kullanılırsa, işlev başarısız olur ve bir hata döndürür.
Gerekli parametre için değer listesi media_permissions
Medya ile ilgili izinleri verme değerleri media_permissions:
1. can_send_audios - ses dosyaları gönderme izni 2. can_send_documents - belge gönderme izni 3. can_send_photos - fotoğraf gönderme izni 4. can_send_videos - video gönderme izni 5. can_send_video_notes - yuvarlak video mesajları gönderme izni 6. can_send_voice_notes - sesli mesaj gönderme izni
Örnek
Kullanıcının 3 dakika boyunca her şeyden kısıtlandığı işlevin kullanımına örnek:
Kullanıcı sohbete girdiğinde, sohbette mesaj gönderemeyeceğine dair bir bildirim görür. Bir zaman sınırı ayarlanmışsa, bu kısıtlamanın süresini de görür.
Kopyalamak için kod örneği:
Mesajı sabitleme
Açıklama
tg_pin_chat_message(platform_id, message_id, disable_notification)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
message_id
sabitlemesi gereken mesaj kimliği
disable_notification
Parametre, yeni sabitlenmiş bir mesaj hakkında tüm sohbet üyelerine bir bildirim gönderilip gönderilmeyeceğini belirler (kanallarda ve özel sohbetlerde bildirimler her zaman devre dışıdır). Bildirim göndermek istemiyorsanız, parametreyi disable_notification şuna ayarlayın 1. Aksi takdirde, şuna ayarlayın 0.
Mesajın sabitlemesini kaldırma
Açıklama
tg_unpin_chat_message(platform_id, message_id)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
message_id
Sabitlemesi kaldırılması gereken mesajın kimliği. message_id sağlanmazsa, en son sabitlenmiş mesaj (gönderim tarihine göre) sabitlemeden kaldırılır
Tüm sabitlenmiş mesajların sabitlemesini kaldırma
Açıklama
tg_unpin_all(platform_id)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
DİKKAT!
Telegram'ın mesajı sabitleme/sabitlemesini kaldırma işlevleri için bir sınırlaması vardır.
Kullanım için zaman sınırlamaları tg_pin_chat_message / tg_unpin_chat_message / tg_unpin_all MaviBot sistemi tarafından AYARLANMAZ.
Bir mesajı sabitlemek için izin verilen süre geçmişse, işlev yine de true döndürür, ancak Telegram değişikliği uygulamaz.
Sabitlenmiş mesajların önbellekte kalabileceğini, bu yüzden görsel olarak hemen kaybolmayabileceklerini de unutmamak önemlidir.
Telegram'da anket oluşturma
Açıklama
tg_send_poll(platform_id, question, options, is_anonymous, allows_multiple_answers, reply_markup, disable_notification, protect_content, token, reply_to_message_id, message_thread_id, business_connection_id)
Parametreler:
! platform_id
Telegram'daki sohbet kimliği *
! question
question
! options
cevap seçeneklerinden oluşan bir dizi
is_anonymous
1 - anonim anket, '' - anonim değil
allows_multiple_answers
1 - birden fazla cevap kullanılabilir, '' - tek cevap
reply_markup
klavye veya '' - klavyesiz
disable_notification
sesli bildirimle gönderim bayrağı (varsayılan 0) 1 – alınırken bildirimi kapat, 0 – bildirimle gönder
protect_content
kopyalama ve ekran görüntülerine karşı korumak için 1, '' koruma yok
token
bot jetonu; sağlanmazsa, mevcut olan kullanılır
reply_to_message_id
alıntılanan mesajın kimliği
message_thread_id
konu kimliği (forum işlevi varsa süpergruplarda kullanılabilir)
business_connection_id
bot bağlanırken kullanılan değer (Business ID). Kanallarda görünür. Bot jetonu kullanılıyorsa ve mesajın bot'a bağlı bir kullanıcı hesabı üzerinden gönderilmesi gerekiyorsa sağlanmalıdır
Bilmek önemli!
Notlar
1. İşlev, Telegram'dan message_idiçeren bir yanıt döndürür. Bunu kaydetmek daha iyidir. message_id kullanarak anketi tg_stop_poll ile durdurabilir (aşağıdaki açıklamaya bakın) ve sonucu alabilirsiniz.
2. Bir kullanıcı bir mesajlaşma uygulamasında anket eklerse, sohbetine bir geri çağırma gönderilir:
poll_added - değişmez kısım YOUR QUESTION - anketteki soru metni
Bir ankete kanalda eklenme durumunda geri çağırma örneği
Bir ankete sohbette eklenme durumunda geri çağırma örneği
poll_added sonrasındaki ikinci geri çağırma rakamlar içerir - bu, anketi ekleyen Telegram'daki kullanıcının kimliğinden başka bir şey değildir.
Anket bot tarafından oluşturulduğunda geri çağırma gelmez.
3. Kanalda yalnızca anonim anketler oluşturulabilir
Dikkat, gruba yalnızca anonim anketler göndermeniz önerilir!
4. Anket oluşturulduktan sonra, hangi ankete geri çağırma geldiğini anlamak için kimliğini değişkende saklayın.
Örnek
Müşteri geri bildirimi büyümemizin anahtarıdır. Anketler, bu geri bildirimi toplamak ve onu somut iş sonuçlarına dönüştürmek için basit bir yöntem sunar.
Kopyalamak için kod örneği:
Telegram'da anket oluşturma işlevi:
Telegram'da oluşturduğumuz anket
Telegram'da bilgi yarışması oluşturma
Açıklama
tg_send_quiz_poll(platform_id, question, options, explanation, correct_option_id, is_anonymous, reply_markup, parse_mode, protect_content, disable_notification, token, reply_to_message_id, message_thread_id )
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
! question
question
! options
cevap seçeneklerinden oluşan bir dizi
! explanation
bir kullanıcı yanlış cevabı seçtiğinde veya bilgi yarışması tarzı ankette lamba simgesine tıkladığında gösterilen metin, öğe ayrıştırmasından sonra en fazla iki satır sonu ile 0–200 karakter.
! correct_option_id
doğru cevap numarası, numaralandırma 1'den başlar
is_anonymous
1 - anonim anket, '' - anonim değil
reply_markup
klavye veya '' - klavyesiz
parse_mode
açıklama biçimi: markdown, htmlya da '' (biçimlendirme olmaması için boş dize)
protect_content
kopyalama ve ekran görüntülerine karşı korumak için 1, '' koruma yok
disable_notification
sesli bildirimle gönderim bayrağı (varsayılan 0) 1 – alınırken bildirimi kapat, 0 – bildirimle gönder
token
bot jetonu; sağlanmazsa, mevcut olan kullanılır
reply_to_message_id
alıntılanan mesaj kimliği
message_thread_id
konu kimliği (aktif forum özelliklerine sahip süpergruplarda kullanılabilir)
Bilmek önemli!
Notlar
1. Şunu kaydedin message_id
API işlevi, Telegram'dan bir message_idiçeren bir yanıt döndürür. Bu kimliği mutlaka kaydedin; çünkü şu işlemler için gereklidir:
şu işlevi kullanarak bilgi yarışmasını sonlandırmak
tg_stop_pollişlevi (aşağıdaki açıklamaya bakın).Sonuçları almak.
2. Geri çağırma poll_added
Bir kullanıcı bir kanalaanket eklerse, bot bir geri çağırma alır:
Biçim:
poll_added+ Anket sorusuBir grup sohbetine eklenirse: geri çağırma ayrıca Telegram Kullanıcı Kimliği anketi ekleyen kişinin bilgisini de içerir.
Bot tarafından oluşturulursa: Hayır poll_added geri çağırma gönderilmez.
3. Kanal kısıtlaması
Yalnızca anonim bilgi yarışmaları kanallarda oluşturulabilir.
4. Geri çağırma poll_answer (Kullanıcı oylaması)
Bir kullanıcı bir özel sohbete veya groupgönderilen bir bilgi yarışmasında oy kullandığında, bu istemciyle botun diyaloğuna bir geri çağırma gönderilir:
Biçim:
poll_answer+ Anket Kimliği + [Cevap indeksi]Örnek:
poll_answer 5325838371359031648 [3]Not: cevap numaralandırması 0.
[3]ile başlar, kullanıcının dördüncü cevap seçeneğini seçtiği anlamına gelir.
5. Anonim olmayan grup anketleri için webhook
için anonim olmayan anketler botun yönetici olduğu gruplarda, her oy içinbir webhook gönderilir. Bunu aldıktan sonra bot, poll_answer geri çağırmayı (4. maddede olduğu gibi) ilgili istemciyle olan diyaloğuna iletecektir.
6. Etkinleştirme gereksinimi ve en iyi uygulama
Gereksinim: bir bot bir konuşma başlatamaz. Bir istemci botla hiç iletişime geçmediyse, oyuna yanıt olarak onlara doğrudan mesaj gönderemezsiniz, ta ki onlar önce botu etkinleştirene kadar (örneğin, bir
/startkomutu göndererek).
Öneri: bu sınırlamadan kaçınmak için, gruplara yalnızca anonim bilgi yarışmaları gönderilmesi şiddetle önerilir.
7. Anketlerinizi takip edin
Bir bilgi yarışması oluşturduktan hemen sonra, benzersiz Anket Kimliği kimliğini bir değişkende saklayın. Bu, gelen bir geri çağırmanın hangi belirli ankete ait olduğunu belirlemenizi sağlar.
Anketi sonlandırma
Açıklama
tg_stop_poll(platform_id, message_id)
Parametreler:
! platform_id
Telegram'daki sohbet kimliği *
! message_id
anket/bilgi yarışması mesaj kimliği. Webhook'tan alınabilir
Bu fonksiyonu bir anketi/yarışmayı sonlandırmak için çağırmak, son sonuçları içeren bir sözlük döndürür.
Telegram'da konularla nasıl çalışılır
Önemli: ana grup konusu bir ID'ye sahip değildir ve onunla çalışmak için ayrı fonksiyonlar gerektirir.
Grubun Genel Konusu nasıl yeniden adlandırılır
Açıklama
tg_edit_general_forum_topic(platform_id, topic_name)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
! topic_name
yeni konu adı
bot_name
isteğe bağlı parametre: bot adı.
Konularla çalışırken, hangi botun fonksiyonu çalıştıracağını belirtebilirsiniz. Bu, projeniz birden fazla Telegram botu kullanıyorsa yararlıdır. Bot adını "Kanallar" bölümünde, "Grup ID" alanında bulun.
Örnek
Grupların Genel Konusu, tg_edit_general_forum_topic() fonksiyonu kullanılarak değiştirilebilir. İki zorunlu parametre gerektirir: sohbet ID'si ve Grup Konusu için yeni ad:
Kopyalama için kod örneği
Genel Konu sohbetini yeniden adlandır/
answer = tg_edit_general_forum_topic(-1001839380031, 'General')
Genel Konu nasıl kapatılır
Açıklama
tg_close_general_forum_topic(platform_id)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
bot_name
isteğe bağlı parametre: bot adı.
Konularla çalışırken, hangi botun fonksiyonu çalıştıracağını belirtebilirsiniz. Bu, projeniz birden fazla Telegram botu kullanıyorsa yararlıdır. Bot adını "Kanallar" bölümünde, "Grup ID" alanında bulun.
Kopyalama için kod örneği
/Genel Konu sohbetini kapat/
answer = tg_close_general_forum_topic(-1001839380031)
Daha önce kapatılmış bir Genel Konu nasıl yeniden açılır
Açıklama
tg_reopen_general_forum_topic(platform_id)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
bot_name
isteğe bağlı parametre: bot adı.
Konularla çalışırken, hangi botun fonksiyonu çalıştıracağını belirtebilirsiniz. Bu, projeniz birden fazla Telegram botu kullanıyorsa yararlıdır. Bot adını "Kanallar" bölümünde, "Grup ID" alanında bulun.
Kopyalama için kod örneği
/Genel Konu sohbetini yeniden aç/
answer = tg_reopen_general_forum_topic(-1001839380031)
Genel Konu nasıl gizlenir
Açıklama
tg_hide_general_forum_topic(platform_id)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
bot_name
isteğe bağlı parametre: bot adı.
Konularla çalışırken, hangi botun fonksiyonu çalıştıracağını belirtebilirsiniz. Bu, projeniz birden fazla Telegram botu kullanıyorsa yararlıdır. Bot adını "Kanallar" bölümünde, "Grup ID" alanında bulun.
Genel Konu sohbeti, Konu katılımcıları için kapatılabilir (okuyabilirler ama yazamazlar) ve yeni kullanıcılar için Telegram'ın genel sohbet listesinden gizlenebilir.
Kopyalama için kod örneği
/Genel Konu sohbetini gizle/
answer = tg_hide_general_forum_topic(-1001839380031)
Genel Konuyu nasıl gösterilir veya görünürlüğü nasıl geri yüklenir
Açıklama
tg_unhide_general_forum_topic(platform_id)
Parametreler:
! platform_id
Telegram içindeki konu ID'si *
bot_name
isteğe bağlı parametre: bot adı.
Konularla çalışırken, hangi botun fonksiyonu çalıştıracağını belirtebilirsiniz. Bu, projeniz birden fazla Telegram botu kullanıyorsa yararlıdır. Bot adını "Kanallar" bölümünde, "Grup ID" alanında bulun.
Önemli!
Bu fonksiyon Genel Konu'yu yeniden açmaz; yalnızca görünür hale getirir.
Kopyalama için kod örneği
/Genel Konu sohbetini göster/
answer = tg_unhide_general_forum_topic(-1001839380031)
Telegram'da nasıl yeni bir konu oluşturulur
Açıklama
tg_create_forum_topic(platform_id, name, icon, icon_color)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
! name
yeni konu adı
icon
konu için ayarlanacak emoji ID'si. String olarak iletilir. Yalnızca tg_get_forum_icon işlevini kullanın.
icon_color
ile alınan listeden emojileri kullanabilirsiniz. emoji rengi; listeden: 7322096, 16766590, 13338331, 9367192, 16749490, 16478047. Tüm emojiler renk değişikliklerini desteklemez.
bot_name
isteğe bağlı parametre: bot adı.
Konularla çalışırken, hangi botun fonksiyonu çalıştıracağını belirtebilirsiniz. Bu, projeniz birden fazla Telegram botu kullanıyorsa yararlıdır. Bot adını "Kanallar" bölümünde, "Grup ID" alanında bulun.
Belirlenen renk değiştirilemez; renk yalnızca konu oluşturulurken atanabilir.
Çalıştırıldığında fonksiyon, konu ID'si de dahil olmak üzere yeni konunun parametrelerini içeren bir yanıt döndürür (çeşitli fonksiyonlar için gereklidir).
Kopyalama için kod örneği
Ek bir konu sohbeti oluşturmak için
answer = tg_create_forum_topic(-1001839380031, 'second_bot_topic', None, 7322096)
Oluşturulan ek konu sohbeti ID'sini kaydetmek için
answer={"ok":true,"result":{"message_thread_id":254,"name":"second_bot_topic","icon_color":7322096}}/
idtema1=answer['result']['message_thread_id']
Bir konuyu düzenleme. Bir konuyu yeniden adlandırma ve/veya emoji değiştirme nasıl yapılır
Açıklama
tg_edit_forum_topic(platform_id, message_thread_id, name, icon)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
! message_thread_id
ek konu sohbeti ID'si
name
yeni konu adı
icon
konu için ayarlanacak emoji ID'si. String olarak iletilir. Yalnızca tg_get_forum_icon işlevini kullanın.
bot_name
isteğe bağlı parametre: bot adı.
Konularla çalışırken, hangi botun fonksiyonu çalıştıracağını belirtebilirsiniz. Bu, projeniz birden fazla Telegram botu kullanıyorsa yararlıdır. Bot adını "Kanallar" bölümünde, "Grup ID" alanında bulun.
Seçili bir konu nasıl kapatılır
Açıklama
Bir konuyu kapatmak, onu salt okunur yapmak anlamına gelir; kapalı bir konuda yazmak izin verilmez.
tg_close_forum_topic(platform_id, message_thread_id)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
! message_thread_id
ek konu sohbeti ID'si
bot_name
isteğe bağlı parametre: bot adı.
Konularla çalışırken, hangi botun fonksiyonu çalıştıracağını belirtebilirsiniz. Bu, projeniz birden fazla Telegram botu kullanıyorsa yararlıdır. Bot adını "Kanallar" bölümünde, "Grup ID" alanında bulun.
Daha önce kapatılmış bir konu nasıl yeniden açılır
Açıklama
tg_reopen_forum_topic(platform_id, message_thread_id)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
! message_thread_id
ek konu sohbeti ID'si
bot_name
isteğe bağlı parametre: bot adı.
Konularla çalışırken, hangi botun fonksiyonu çalıştıracağını belirtebilirsiniz. Bu, projeniz birden fazla Telegram botu kullanıyorsa yararlıdır. Bot adını "Kanallar" bölümünde, "Grup ID" alanında bulun.
Bir konuyu ve içindeki tüm mesajları nasıl silinir
Açıklama
tg_delete_forum_topic(platform_id, message_thread_id)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
! message_thread_id
ek konu sohbeti ID'si
bot_name
isteğe bağlı parametre: bot adı.
Konularla çalışırken, hangi botun fonksiyonu çalıştıracağını belirtebilirsiniz. Bu, projeniz birden fazla Telegram botu kullanıyorsa yararlıdır. Bot adını "Kanallar" bölümünde, "Grup ID" alanında bulun.
Bir konudaki tüm sabitlenmiş mesajların sabitlemesi nasıl kaldırılır
Açıklama
tg_unpin_topic_messages(platform_id, message_thread_id)
Parametreler:
! platform_id
Telegram içindeki sohbet kimliği *
! message_thread_id
ek konu sohbeti ID'si
bot_name
isteğe bağlı parametre: bot adı.
Konularla çalışırken, hangi botun fonksiyonu çalıştıracağını belirtebilirsiniz. Bu, projeniz birden fazla Telegram botu kullanıyorsa yararlıdır. Bot adını "Kanallar" bölümünde, "Grup ID" alanında bulun.
Bir Telegram Konusu için emoji listesini nasıl alınır
Açıklama
Emoji listesi nasıl alınır
tg_get_forum_icon() – bu fonksiyon, forum konu simgeleri olarak kullanılabilecek emojilerin bir listesini döndürür. Sonuç bir değişkene atanmalıdır, çünkü her anahtarın bir emoji olduğu ve karşılık gelen değerinin emoji'nin benzersiz tanımlayıcısı olduğu bir sözlük döndürür (id).
Parametreler: yok.
Emoji listesinin içeriği
Bir Konu sohbeti için emoji listesini almak üzere, komutu ilgili sohbete gönderin.
Fonksiyon, yanıtında emoji listesini döndürecektir. Bu, değişkenin answer değeri olarak bir sözlük içereceği anlamına gelir.
{'📰': '5434144690511290129', '💡': '5312536423851630001', '⚡️': '5312016608254762256', '🎙': '5377544228505134960', '🔝': '5418085807791545980', '🗣': '5368697802761185083', '🆒': '5420216386448270341', '❗️': '5379748062124056162', '📝': '5357193964787081133', '📆': '5433614043006903194', '📁': '5357315181649076022', '🔎': '5309965701241379366', '📣': '5309984423003823246', '🔥': '5312241539987020022', '❤️': '5312138559556164615', '❓': '5377316857231450742', '📈': '5350305691942788490', '📉': '5350713563512052787', '💎': '5309958691854754293', '💰': '5350452584119279096', '💸': '5309929258443874898', '\U0001fa99': '5377690785674175481', '💱': '5310107765874632305', '⁉️': '5377438129928020693', '🎮': '5309950797704865693', '💻': '5350554349074391003', '📱': '5409357944619802453', '🚗': '5312322066328853156', '🏠': '5312486108309757006', '💘': '5310029292527164639', '🎉': '5310228579009699834', '‼️': '5377498341074542641', '🏆': '5312315739842026755', '🏁': '5408906741125490282', '🎬': '5368653135101310687', '🎵': '5310045076531978942', '🔞': '5420331611830886484', '📚': '5350481781306958339', '👑': '5357107601584693888', '⚽️': '5375159220280762629', '🏀': '5384327463629233871', '📺': '5350513667144163474', '👀': '5357121491508928442', '\U0001fae6': '5357185426392096577', '🍓': '5310157398516703416', '💄': '5310262535021142850', '👠': '5368741306484925109', '✈️': '5348436127038579546', '\U0001f9f3': '5357120306097956843', '🏖': '5310303848311562896', '⛅️': '5350424168615649565', '🦄': '5413625003218313783', '🛍': '5350699789551935589', '👜': '5377478880577724584', '🛒': '5431492767249342908', '🚂': '5350497316203668441', '🛥': '5350422527938141909', '🏔': '5418196338774907917', '🏕': '5350648297189023928', '🤖': '5309832892262654231', '\U0001faa9': '5350751634102166060', '🎟': '5377624166436445368', '🏴\u200d☠️': '5386395194029515402', '🗳': '5350387571199319521', '🎓': '5357419403325481346', '🔭': '5368585403467048206', '🔬': '5377580546748588396', '🎶': '5377317729109811382', '🎤': '5382003830487523366', '🕺': '5357298525765902091', '💃': '5357370526597653193', '\U0001fa96': '5357188789351490453', '💼': '5348227245599105972', '\U0001f9ea': '5411138633765757782', '👨\u200d👩\u200d👧\u200d👦': '5386435923204382258', '👶': '5377675010259297233', '🤰': '5386609083400856174', '💅': '5368808634392257474', '🏛': '5350548830041415279', '\U0001f9ee': '5355127101970194557', '🖨': '5386379624773066504', '👮\u200d♂️': '5377494501373780436', '\U0001fa7a': '5350307998340226571', '💊': '5310094636159607472', '💉': '5310139157790596888', '\U0001f9fc': '5377468357907849200', '\U0001faaa': '5418115271267197333', '🛃': '5370947704199323325', '🍽': '5350344462612570293', '🐟': '5384574037701696503', '🎨': '5310039132297242441', '🎭': '5350658016700013471', '🎩': '5357504778685392027', '🔮': '5350367161514732241', '🍹': '5350520238444126134', '🎂': '5310132165583840589', '☕️': '5350392020785437399', '🍣': '5350406176997646350', '🍔': '5350403544182694064', '🍕': '5350444672789519765', '\U0001f9a0': '5312424913615723286', '💬': '5417915203100613993', '🎄': '5312054580060625569', '🎃': '5309744892677727325'}
Last updated