So arbeiten Sie mit einer Telegram-Bot-Beschreibung (vollständig und kurz)

So konfigurieren Sie eine Begrüßungsnachricht

tg_set_bot_description(description, language_code) – Bot-Beschreibung, die angezeigt wird, wenn der Chat mit dem Bot leer ist

Parameter:

Beispiel für die Konfiguration einer Begrüßungsnachricht und eines Bot-Menüs:

Nach dem Start (dies sollte einmal mit einem Administratorbefehl erfolgen):

Codebeispiel zum Kopieren:

tg_set_bot_description('Willkommen! Ich bin Ihr virtueller Assistent, Yurgram.🤖') command = [["private_office", "Persönliches Konto"]] tg_set_command(command, '', 'default')

So konfigurieren Sie eine kurze Vorschaubeschreibung

tg_set_bot_short_description(description, language_code) – eine kurze Beschreibung des Bots, die auf der Profilseite des Bots erscheint und zusammen mit dem Link gesendet wird, wenn Benutzer den Bot teilen.

Parameter:

So rufen Sie die aktuelle Beschreibung ab

tg_get_bot_description(language_code) – verwenden Sie diese Methode, um die aktuelle Bot-Beschreibung für die angegebene Benutzersprache abzurufen.

So rufen Sie die aktuelle Kurzbeschreibung ab

tg_get_bot_short_description(language_code) – verwenden Sie diese Methode, um die aktuelle Kurzbeschreibung des Bots für die angegebene Benutzersprache abzurufen.

So konfigurieren Sie Befehle für den Bot

So konfigurieren Sie Befehle

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

command = [["count", "Anzahl der Benutzer zurückgeben"],["unpin", "Alle Nachrichten lösen"]] tg_set_command(command, '', 'all_chat_administrators')

In diesem Beispiel werden die Befehle in einer separaten Variable platziert. Sie können diese Befehle auch direkt in die Funktion einfügen.

tg_set_command('[["count", "Anzahl der Benutzer zurückgeben"],["unpin", "Alle Nachrichten lösen"]]', '', 'all_chat_administrators')

Um die Befehle aufzurufen, geben Sie das Symbol '/' in das Nachrichteneingabefeld ein. Wenn alles richtig konfiguriert wurde, sehen Sie eine Vorschlagsliste der verfügbaren Befehle. Die Befehle werden fett dargestellt, ihre Beschreibungen werden rechts angezeigt.

Um Befehle zu verwenden, konfigurieren Sie eine Reaktion auf Nachrichten, die Befehle enthalten.

So zeigen Sie Befehle für den Bot an

tg_get_command()

Befehle anzeigen

tg_get_command(language, scope, platform_id, user_id)

Wenn Sie den Sprachparameter nicht verwenden möchten, aber den Bereichsparameter benötigen, geben Sie unbedingt zuerst einen leeren Parameter an, wie im Beispiel:

tg_get_command('', scope)

command = tg_get_command('', 'all_chat_administrators')

Weisen Sie diese Funktion einer Variable zu, und die Variable enthält die Antwort des Servers mit Befehlen für den im Parameter angegebenen Benutzerbereich.

{"ok":true,"result":[{"command":"count","description":"Anzahl der Benutzer zurückgeben"},{"command":"unpin","description":"Alle Nachrichten lösen"}]}

Wenn die Funktion ohne Parameter aufgerufen wird, wird der Bereich auf 'default' gesetzt.

command = tg_get_command()

So löschen Sie Befehle im Bot

tg_delete_command()

Befehle löschen

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

Wenn Sie den Sprachparameter nicht verwenden möchten, aber den Bereichsparameter benötigen, geben Sie unbedingt einen leeren Wert für den ersten Parameter an, wie im Beispiel:

tg_delete_command('', scope)

Ein Befehl wie tg_delete_command() löscht Befehle ohne Angabe des Sprachparameters und verwendet den Standardbereichswert.

Sie können die festgelegten Befehle löschen, indem Sie die Funktion mit Parametern im Rechner aufrufen:

Codebeispiel zum Kopieren:

tg_delete_command('', 'all_chat_administrators')

So konfigurieren Sie Reaktionen auf Befehle

Für Befehle in einem privaten Chat mit dem Bot müssen Sie auf Nachrichten wie folgt reagieren: '/command_name' – wobei command_name der Befehl ist.

Für Befehle in Gruppen und Chats erscheinen Nachrichten als: '/command_name@bot_username' – wobei command_name der Befehl und @bot_username der Benutzername des Bots ist.

Liste der Bereichswerte:

Wenn Sie den Sprachparameter nicht verwenden möchten, aber den Bereichsparameter benötigen, geben Sie unbedingt einen leeren Wert für den ersten Parameter an, wie im Beispiel:

tg_delete_command('', scope)