Bot kullanımı
Telegram bot açıklamasıyla (tam ve kısa) nasıl çalışılır
Karşılama mesajını yapılandırmak için
tg_set_bot_description(description, language_code) - botla yapılan sohbet boşken gösterilen bot açıklaması
Parametreler:
description
Bot açıklaması olarak boş bir dize göndermek, mevcut açıklamayı kaldırı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 kısa açıklaması olmayan tüm kullanıcılara uygulanır.
Örnek
Karşılama mesajı ve bot menüsünü 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 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 botun kısa açıklaması.
Parametreler:
description
Bot açıklaması olarak boş bir dize göndermek, mevcut açıklamayı kaldırı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 kısa açıklaması olmayan tüm kullanıcılara uygulanı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.
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 kısa açıklaması olmayan tüm kullanıcılara uygulanı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.
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 kısa açıklaması olmayan tüm kullanıcılara uygulanı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)
! commands
Komutlar, liste listesi biçiminde bot komutlarıdır; her iç liste 2 öğeden oluşur:
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 dili için özel olarak atanmış komutları olmayan tüm kullanıcılara uygulanır.
scope
Komutların oluşturulacağı kullanıcı kapsamını tanımlayan bir parametre. Varsayılan değer 'default'.
platform_id
Telegram içindeki sohbet kimliği *.
Yalnızca scope parametresinin belirli değerleri için geçerlidir.
user_id
Telegram içindeki kullanıcı kimliği *.
Yalnızca scope parametresinin belirli değerleri için geçerlidir.
Örnek
command = [["count", "kullanıcının 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şkende tutulur. Bu komutları doğrudan işlevin içine de ekleyebilirsiniz.
tg_set_command('[["count", "kullanıcının 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 '/' simgesini yazın. Her şey doğru şekilde yapılandırıldıysa, kullanılabilir komutların bir öneri listesini göreceksiniz. Komutlar kalın olarak görünecek, açıklamaları ise sağ tarafta gösterilecektir.
Komutları kullanmak için, komut 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)
language
ISO 639-1'e göre iki harfli bir dil kodu, örn. 'ru' veya 'en'. Belirtilmezse, belirli diline özel komutları olmayan ve verilen alan içindeki tüm kullanıcılara uygulanan komutlar gösterilir.
scope
Komutların hangi kullanıcı kapsamı için gösterileceğini tanımlayan bir parametre (isteğe bağlı parametre; kullanılmazsa, varsayılan değer 'default' uygulanır).
platform_id
Telegram içindeki sohbet kimliği *.
Yalnızca scope parametresinin belirli değerleri için geçerlidir.
user_id
Telegram içindeki kullanıcı kimliği *.
Yalnızca scope parametresi.
Dil parametresini kullanmak istemiyor ancak scope parametresini kullanmanız gerekiyorsa, ilk parametreyi boş olarak belirttiğinizden emin olun, örnekte olduğu gibi:
tg_get_command('', scope)
Örnek
command = tg_get_command('', 'all_chat_administrators')
Bu işlevi bir değişkene atayın; değişken, parametrede belirtilen kullanıcı kapsamı için komutlarla birlikte sunucunun yanıtını içerecektir.
{"ok":true,"result":[{"command":"count","description":"kullanıcının sayısını döndür"},{"command":"unpin","description":"tüm mesajların sabitlemesini kaldır"}]}
İşlev parametresiz çağrılırsa, scope şu değere ayarlanır: 'default'.
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
language
ISO 639-1'e göre iki harfli bir dil kodu, örn. 'ru' veya 'en' (isteğe bağlı parametre; belirtilmezse, verilen kapsam içindeki ve dilleri için özel komutları olmayan tüm kullanıcılara uygulanan komutlar silinir).
scope
Komutların silineceği kullanıcı kapsamını tanımlayan bir parametre. Belirtilmezse, varsayılan değer 'default' uygulanır.
platform_id
Sohbet kimliği (isteğe bağlı parametre, yalnızca scope parametresinin belirli değerleri için geçerlidir).
user_id
Kullanıcı kimliği (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, ilk parametre için boş bir değer belirttiğinizden emin olun, örnekte olduğu gibi:
tg_delete_command('', scope)
tg_delete_command() gibi bir komut, varsayılan kapsam değerini kullanarak dil parametresini belirtmeden komutları siler.
Örnek
Hesap makinesinde parametrelerle işlevi ç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 tür mesajlara tepki vermeniz gerekir: '/command_name' – burada command_name komuttur.
Gruplar ve sohbetlerde, mesajlar şu şekilde görünür: '/command_name@bot_username' – burada command_name komut ve @bot_username botun kullanıcı adıdır.
Kapsam değerleri listesi:
'default'
Varsayılan parametre, komutların botla olan özel mesajlarda çalışacağı anlamına gelir.
'all_private_chats'
Tüm özel sohbetler: komutlar, botun eklendiği özel sohbetlerde herkes için kullanılabilir.
'all_group_chats'
Tüm grup ve süper grup sohbetleri: komutlar, botun eklendiği bu tür sohbetlerde herkes için 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, belirtmeniz gerekir platform_id).
'chat_administrators'
Belirli bir sohbetin yöneticileri için komutlar (bu seçeneği seçerseniz, belirtmeniz gerekir platform_id).
'chat_member'
Belirli bir sohbetin belirli bir üyesi için komutlar (bu seçeneği seçerseniz, her ikisini de belirtmeniz gerekir platform_id ve user_id; belirtilen kullanıcı, verilen sohbetin bir üyesi olmalıdır).
Dil parametresini kullanmak istemiyor ancak scope parametresini kullanmanız gerekiyorsa, ilk parametre için boş bir değer belirttiğinizden emin olun, örnekte olduğu gibi:
tg_delete_command('', scope)
Last updated