Comment travailler avec une description de bot Telegram (complète et courte)
Pour configurer le message de bienvenue
tg_set_bot_description(description, language_code) - description du bot affichée lorsque la conversation avec le bot est vide
Paramètres :
Exemple de configuration d'un message de bienvenue et du menu du bot :
Après le lancement (cela doit être fait une fois à l'aide d'une commande administrateur) :
Exemple de code à copier :
tg_set_bot_description('Bienvenue ! Je suis votre assistant virtuel, Yurgram.🤖') command = [["private_office", "Espace personnel"]] tg_set_command(command, '', 'default')
Pour configurer la description courte de l'aperçu
tg_set_bot_short_description(description, language_code) - une description courte du bot qui apparaît sur la page de profil du bot et est envoyée avec le lien lorsque les utilisateurs partagent le bot.
Paramètres :
Pour obtenir la description actuelle
tg_get_bot_description(language_code) - utilisez cette méthode pour obtenir la description actuelle du bot pour la langue utilisateur spécifiée.
Pour obtenir la description courte actuelle
tg_get_bot_short_description(language_code) - utilisez cette méthode pour obtenir la description courte actuelle du bot pour la langue utilisateur spécifiée.
Comment configurer les commandes pour le bot
Pour configurer les commandes
tg_set_command(commands, language, scope, platform_id, user_id)
command = [["count", "retourner le nombre d'utilisateurs"],["unpin", "désépingler tous les messages"]] tg_set_command(command, '', 'all_chat_administrators')
Dans cet exemple, les commandes sont placées dans une variable séparée. Vous pouvez également ajouter ces commandes directement dans la fonction.
tg_set_command('[["count", "retourner le nombre d'utilisateurs"],["unpin", "désépingler tous les messages"]]', '', 'all_chat_administrators')
Pour appeler les commandes, tapez le symbole '/' dans le champ de saisie du message. Si tout a été configuré correctement, vous verrez une liste de suggestions des commandes disponibles. Les commandes apparaîtront en gras, avec leurs descriptions affichées à droite.
Pour utiliser les commandes, configurez une réaction aux messages contenant des commandes.
Comment afficher les commandes pour le bot
tg_get_command()
Pour afficher les commandes
tg_get_command(language, scope, platform_id, user_id)
Si vous ne souhaitez pas utiliser le paramètre language mais devez utiliser le paramètre scope, assurez-vous de spécifier d'abord un paramètre vide, comme dans l'exemple :
tg_get_command('', scope)
command = tg_get_command('', 'all_chat_administrators')
Attribuez cette fonction à une variable, et la variable contiendra la réponse du serveur avec les commandes pour le périmètre utilisateur spécifié dans le paramètre.
{"ok":true,"result":[{"command":"count","description":"retourner le nombre d'utilisateurs"},{"command":"unpin","description":"désépingler tous les messages"}]}
Si la fonction est appelée sans paramètres, le périmètre sera défini sur 'default'.
command = tg_get_command()
Comment supprimer les commandes dans le bot
tg_delete_command()
Pour supprimer les commandes
tg_delete_command(language, scope, platform_id, user_id), où
Si vous ne souhaitez pas utiliser le paramètre language mais devez utiliser le paramètre scope, assurez-vous de spécifier une valeur vide pour le premier paramètre, comme dans l'exemple :
tg_delete_command('', scope)
Une commande comme tg_delete_command() supprimera les commandes sans spécifier le paramètre language, en utilisant la valeur de périmètre par défaut.
Vous pouvez supprimer les commandes définies en appelant la fonction avec des paramètres dans la calculatrice :
Exemple de code à copier :
tg_delete_command('', 'all_chat_administrators')
Comment configurer les réactions aux commandes
Pour les commandes dans un chat privé avec le bot, vous devez réagir aux messages comme : '/command_name' – où command_name est la commande.
Pour les commandes dans les groupes et les chats, les messages apparaîtront comme : '/command_name@bot_username' – où command_name est la commande et @bot_username est le nom d'utilisateur du bot.
Liste des valeurs de périmètre :
Si vous ne souhaitez pas utiliser le paramètre language mais devez utiliser le paramètre scope, assurez-vous de spécifier une valeur vide pour le premier paramètre, comme dans l'exemple :
tg_delete_command('', scope)