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:

Parameter Beschreibung
description Die Übergabe einer leeren Zeichenfolge als Bot-Beschreibung entfernt die vorhandene Beschreibung.
language_code

Ein zweistelliger Sprachcode gemäß dem ISO-639-1-Standard für die Textlokalisierung.

Wenn leer gelassen, wird die Kurzbeschreibung auf alle Benutzer angewendet, für die keine spezifische Kurzbeschreibung festgelegt ist.
Beispiel

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:

Parameter Beschreibung
description Die Übergabe einer leeren Zeichenfolge als Bot-Beschreibung entfernt die vorhandene Beschreibung.
language_code

Ein zweistelliger Sprachcode gemäß dem ISO-639-1-Standard für die Textlokalisierung.

Wenn leer gelassen, wird die Kurzbeschreibung auf alle Benutzer angewendet, für die keine spezifische Kurzbeschreibung festgelegt ist.

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.

Parameter Beschreibung
language_code

Ein zweistelliger Sprachcode gemäß dem ISO-639-1-Standard für die Textlokalisierung.

Wenn leer gelassen, wird die Kurzbeschreibung auf alle Benutzer angewendet, für die keine spezifische Kurzbeschreibung festgelegt ist.

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.

Parameter Beschreibung
language_code

Ein zweistelliger Sprachcode gemäß dem ISO-639-1-Standard für die Textlokalisierung.

Wenn leer gelassen, wird die Kurzbeschreibung auf alle Benutzer angewendet, für die keine spezifische Kurzbeschreibung festgelegt ist.

So konfigurieren Sie Befehle für den Bot

So konfigurieren Sie Befehle

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

Parameter Beschreibung
**!** commands

Bot-Befehle in Form einer Liste von Listen, jede verschachtelte Liste besteht aus 2 Elementen:

1 – der Befehlsname, 2 – seine Beschreibung (es gibt ein Limit von 100 Befehlen).
language

Ein zweistelliger Sprachcode gemäß ISO 639-1, z. B. 'ru' oder 'en'.

Wenn nicht angegeben, gelten die Befehle für alle Benutzer, deren Sprache keine speziell zugewiesenen Befehle hat.
scope Ein Parameter, der den Benutzerbereich definiert, für den die Befehle erstellt werden. Der Standardwert ist 'default'.
platform_id

Chat-Identifikator innerhalb von Telegram *.

Gilt nur für bestimmte Werte des scope-Parameters.
user_id

Benutzeridentifikator innerhalb von Telegram *.

Gilt nur für bestimmte Werte des scope-Parameters.
Beispiel

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)

Parameter Beschreibung
language Ein zweistelliger Sprachcode gemäß ISO 639-1, z. B. 'ru' oder 'en'.
Wenn nicht angegeben, werden Befehle angezeigt, die für alle Benutzer im angegebenen Bereich gelten, die keine dedizierten Befehle für ihre Sprache haben.
scope Ein Parameter, der den Benutzerbereich definiert, für den die Befehle angezeigt werden sollen (optionaler Parameter; wenn nicht verwendet, wird der Standardwert 'default' angewendet).
platform_id

Chat-Identifikator innerhalb von Telegram *.

Gilt nur für bestimmte Werte des scope-Parameters.
user_id

Benutzeridentifikator innerhalb von Telegram *.

Gilt nur für bestimmte Werte des scope-Parameters.

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)

Beispiel

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

Parameter Beschreibung
language Ein zweistelliger Sprachcode gemäß ISO 639-1, z. B. 'ru' oder 'en' (optionaler Parameter; wenn nicht angegeben, werden Befehle gelöscht, die für alle Benutzer im angegebenen Bereich gelten, die keine dedizierten Befehle für ihre Sprache haben).
scope Ein Parameter, der den Benutzerbereich definiert, für den die Befehle gelöscht werden.
Wenn nicht angegeben, wird der Standardwert 'default' angewendet.
platform_id Chat-Identifikator (optionaler Parameter, gilt nur für bestimmte Werte des scope-Parameters).
user_id Benutzeridentifikator (optionaler Parameter, gilt nur für bestimmte Werte des scope-Parameters).

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.

Beispiel

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:

Parameter Wert
'default' Der Standardparameter impliziert, dass die Befehle in privaten Nachrichten mit dem Bot funktionieren.
'all_private_chats' Alle privaten Chats: Befehle sind für alle in privaten Chats verfügbar, in denen der Bot hinzugefügt wurde.
'all_group_chats' Alle Gruppen- und Supergruppen-Chats: Befehle sind für alle in diesen Chat-Typen verfügbar, in denen der Bot hinzugefügt wurde.
'all_chat_administrators' Befehle für Administratoren aller Gruppen- und Supergruppen-Chats, in denen der Bot hinzugefügt wurde.
'chat' Befehle für einen bestimmten Chat (wenn Sie diese Option wählen, sollten Sie die platform_id angeben).
'chat_administrators' Befehle für Administratoren eines bestimmten Chats (wenn Sie diese Option wählen, sollten Sie die platform_id angeben).
'chat_member' Befehle für ein bestimmtes Mitglied eines bestimmten Chats (wenn Sie diese Option wählen, sollten Sie sowohl platform_id als auch user_id angeben; der angegebene Benutzer muss Mitglied des angegebenen Chats sein).

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)