Telegram bot açıklaması (tam ve kısa) ile nasıl çalışılır

Karşılama mesajını yapılandırmak için

tg_set_bot_description(description, language_code) - bot ile sohbet boşken gösterilen bot açıklaması

Parametreler:

Parametre Açıklama
description Bot açıklaması olarak boş bir dize göndermek, mevcut açıklamayı kaldıracaktır.
language_code

Metin yerelleştirmesi için ISO 639-1 standardına göre iki harfli bir dil kodu.

Boş bırakılırsa, kısa açıklama, belirli bir kısa açıklaması olmayan tüm kullanıcılara uygulanacaktır.
Örnek

Karşılama mesajı ve bot menüsü yapılandırma örneği:

Başlatmadan sonra (bu, bir yönetici komutu kullanılarak bir kez yapılmalıdır):

Kopyalamak için kod örneği:

tg_set_bot_description('Hoş geldiniz! Ben sizin sanal asistanınız Yurgram.🤖') command = [["private_office", "Kişisel Hesap"]] tg_set_command(command, '', 'default')

Kısa önizleme açıklamasını yapılandırmak için

tg_set_bot_short_description(description, language_code) - botun profil sayfasında görünen ve kullanıcılar botu paylaştığında bağlantıyla birlikte gönderilen kısa bot açıklaması.

Parametreler:

Parametre Açıklama
description Bot açıklaması olarak boş bir dize göndermek, mevcut açıklamayı kaldıracaktır.
language_code

Metin yerelleştirmesi için ISO 639-1 standardına göre iki harfli bir dil kodu.

Boş bırakılırsa, kısa açıklama, belirli bir kısa açıklaması olmayan tüm kullanıcılara uygulanacaktır.

Mevcut açıklamayı almak için

tg_get_bot_description(language_code) - belirtilen kullanıcı dili için mevcut bot açıklamasını almak için bu yöntemi kullanın.

Parametre Açıklama
language_code

Metin yerelleştirmesi için ISO 639-1 standardına göre iki harfli bir dil kodu.

Boş bırakılırsa, kısa açıklama, belirli bir kısa açıklaması olmayan tüm kullanıcılara uygulanacaktır.

Mevcut kısa açıklamayı almak için

tg_get_bot_short_description(language_code) - belirtilen kullanıcı dili için botun mevcut kısa açıklamasını almak için bu yöntemi kullanın.

Parametre Açıklama
language_code

Metin yerelleştirmesi için ISO 639-1 standardına göre iki harfli bir dil kodu.

Boş bırakılırsa, kısa açıklama, belirli bir kısa açıklaması olmayan tüm kullanıcılara uygulanacaktır.

Bot için komutlar nasıl yapılandırılır

Komutları yapılandırmak için

tg_set_command(commands, language, scope, platform_id, user_id)

Parametre Açıklama
**!** commands

Her biri 2 öğeden oluşan iç içe listelerden oluşan bir liste biçimindeki bot komutları:

1 – komut adı, 2 – açıklaması (100 komut sınırı vardır).
language

ISO 639-1'e göre iki harfli bir dil kodu, örn. 'ru' veya 'en'.

Belirtilmezse, komutlar, dillerine özel olarak atanmış komutları olmayan tüm kullanıcılar için geçerli olacaktır.
scope Komutların oluşturulduğu kullanıcı kapsamını tanımlayan bir parametre. Varsayılan değer 'default' şeklindedir.
platform_id

Telegram içindeki sohbet tanımlayıcısı *.

Yalnızca scope parametresinin belirli değerleri için geçerlidir.
user_id

Telegram içindeki kullanıcı tanımlayıcısı *.

Yalnızca scope parametresinin belirli değerleri için geçerlidir.
Örnek

command = [["count", "kullanıcı sayısını döndür"],["unpin", "tüm mesajların sabitlemesini kaldır"]] tg_set_command(command, '', 'all_chat_administrators')

Bu örnekte, komutlar ayrı bir değişkene yerleştirilmiştir. Bu komutları doğrudan fonksiyona da ekleyebilirsiniz.

tg_set_command('[["count", "kullanıcı sayısını döndür"],["unpin", "tüm mesajların sabitlemesini kaldır"]]', '', 'all_chat_administrators')

Komutları çağırmak için mesaj giriş alanına '/' sembolünü yazın. Her şey doğru yapılandırıldıysa, kullanılabilir komutların bir öneri listesini göreceksiniz. Komutlar kalın harflerle görünecek ve açıklamaları sağ tarafta gösterilecektir.

Komutları kullanmak için, komutları içeren mesajlara bir tepki yapılandırın.

Bot için komutlar nasıl görüntülenir

tg_get_command()

Komutları görüntülemek için

tg_get_command(language, scope, platform_id, user_id)

Parametre Açıklama
language ISO 639-1'e göre iki harfli bir dil kodu, örn. 'ru' veya 'en'.
Belirtilmezse, belirli bir alan içinde, dillerine özel komutları olmayan tüm kullanıcılara uygulanan komutlar gösterilecektir.
scope Komutların gösterilmesi gereken kullanıcı kapsamını tanımlayan bir parametre (isteğe bağlı parametre; kullanılmazsa varsayılan değer 'default' uygulanacaktır).
platform_id

Telegram içindeki sohbet tanımlayıcısı *.

Yalnızca scope parametresinin belirli değerleri için geçerlidir.
user_id

Telegram içindeki kullanıcı tanımlayıcısı *.

Yalnızca scope parametresinin belirli değerleri için geçerlidir.

Dil parametresini kullanmak istemiyor ancak scope parametresini kullanmanız gerekiyorsa, örnekte olduğu gibi ilk parametreyi boş bıraktığınızdan emin olun:

tg_get_command('', scope)

Örnek

command = tg_get_command('', 'all_chat_administrators')

Bu fonksiyonu bir değişkene atayın; değişken, parametrede belirtilen kullanıcı kapsamı için sunucunun komutlarla ilgili yanıtını içerecektir.

{"ok":true,"result":[{"command":"count","description":"kullanıcı sayısını döndür"},{"command":"unpin","description":"tüm mesajların sabitlemesini kaldır"}]}

Fonksiyon parametresiz çağrılırsa, kapsam 'default' olarak ayarlanacaktır.

command = tg_get_command()

Botta komutlar nasıl silinir

tg_delete_command()

Komutları silmek için

tg_delete_command(language, scope, platform_id, user_id), burada

Parametre Açıklama
language ISO 639-1'e göre iki harfli bir dil kodu, örn. 'ru' veya 'en' (isteğe bağlı parametre; belirtilmezse, belirli bir kapsam içinde, dillerine özel komutları olmayan tüm kullanıcılara uygulanan komutlar silinecektir).
scope Komutların silineceği kullanıcı kapsamını tanımlayan bir parametre.
Belirtilmezse, varsayılan değer 'default' uygulanacaktır.
platform_id Sohbet tanımlayıcısı (isteğe bağlı parametre, yalnızca scope parametresinin belirli değerleri için geçerlidir).
user_id Kullanıcı tanımlayıcısı (isteğe bağlı parametre, yalnızca scope parametresinin belirli değerleri için geçerlidir).

Dil parametresini kullanmak istemiyor ancak scope parametresini kullanmanız gerekiyorsa, örnekte olduğu gibi ilk parametre için boş bir değer belirttiğinizden emin olun:

tg_delete_command('', scope)

tg_delete_command() gibi bir komut, dil parametresini belirtmeden, varsayılan kapsam değerini kullanarak komutları silecektir.

Örnek

Hesap makinesinde parametrelerle fonksiyonu çağırarak ayarlanan komutları silebilirsiniz:

Kopyalamak için kod örneği:

tg_delete_command('', 'all_chat_administrators')

Komutlara tepkiler nasıl yapılandırılır

Botla özel sohbetteki komutlar için, şu şekildeki mesajlara tepki vermeniz gerekir: '/command_name' – burada command_name komuttur.

Gruplar ve sohbetlerdeki komutlar için mesajlar şu şekilde görünecektir: '/command_name@bot_username' – burada command_name komut ve @bot_username botun kullanıcı adıdır.

Kapsam değerleri listesi:

Parametre Değer
'default' Varsayılan parametre, komutların botla özel mesajlarda çalışacağı anlamına gelir.
'all_private_chats' Tüm özel sohbetler: komutlar, botun eklendiği özel sohbetlerdeki herkes tarafından kullanılabilir.
'all_group_chats' Tüm grup ve süper grup sohbetleri: komutlar, botun eklendiği bu tür sohbetlerdeki herkes tarafından kullanılabilir.
'all_chat_administrators' Botun eklendiği tüm grup ve süper grup sohbetlerinin yöneticileri için komutlar.
'chat' Belirli bir sohbet için komutlar (bu seçeneği seçerseniz, platform_id belirtmelisiniz).
'chat_administrators' Belirli bir sohbetin yöneticileri için komutlar (bu seçeneği seçerseniz, platform_id belirtmelisiniz).
'chat_member' Belirli bir sohbetin belirli bir üyesi için komutlar (bu seçeneği seçerseniz, hem platform_id hem de user_id belirtmelisiniz; belirtilen kullanıcı, verilen sohbetin bir üyesi olmalıdır).

Dil parametresini kullanmak istemiyor ancak scope parametresini kullanmanız gerekiyorsa, örnekte olduğu gibi ilk parametre için boş bir değer belirttiğinizden emin olun:

tg_delete_command('', scope)