API-Funktionen erweitern die Möglichkeiten eines Bots in Telegram erheblich. Mit API-Funktionen können Sie mit Anhängen, Gruppen und Chats in Telegram arbeiten – zum Beispiel das automatische Sperren oder Entsperren von Benutzern und vieles mehr!
Quelle: Telegram Bot API
Wichtig!
Um zu verstehen, wie man mit API-Funktionen arbeitet, empfehlen wir dringend, die Regeln für die Angabe von Funktionen und Parametern im Rechner zu überprüfen.
NOTATION:
! — ein Ausrufezeichen kennzeichnet erforderliche Parameter
parameter=None — dies zeigt den Standardwert für den angegebenen Parameter an.
Es ist falsch, den Funktionstext einfach aus der Dokumentation zu kopieren, wie folgt: tg_send_message(platform_id, "Some text", client_message_id=61818138, reply_markup=None, parse_mode=None, disable_web_page_preview=0, protect_content=False)
Die Werte nach den Gleichheitszeichen stellen Standardwerte für jeden Parameter dar. Wenn Sie einen bestimmten Parameter nicht benötigen, aber einen darauf folgenden benötigen, können Sie den ungenutzten nicht einfach überspringen – stattdessen müssen Sie explizit seinen Standardwert übergeben.
Daher wäre die korrekte Verwendung: tg_send_message(platform_id, "Some text", 61818138, None, None, 0, True)
Wo erhalte ich die platform_id zum Senden von Benachrichtigungen?
- Sie müssen einen Telegram-Bot mit Ihrem Projekt verbunden haben.
- Senden Sie eine beliebige Nachricht an diesen Bot von dem Telegram-Konto, an das Sie Benachrichtigungen erhalten möchten.
- Wählen Sie in der Liste der Projekt-Clients den Client-Dialog aus, an den Sie Anfragen senden möchten.
- Kopieren Sie den ID-Wert aus dem Messenger-Feld.
- Der platform_id-Parameter kann ohne explizite Angabe numerischer Werte übergeben werden.
react = tg_set_reaction(platform_id, 1556, '👌')
Funktionen mit diesem Parameter funktionieren auch ohne explizite Angabe eines platform_id-Werts.
Wichtig: In den meisten Funktionen ist dieser Parameter erforderlich und darf nicht weggelassen werden.
2. Wenn Sie die Funktion in einem bestimmten Chat, Kanal oder einer Gruppe verwenden müssen, müssen Sie die platform_id als numerischen Wert angeben.
In der oben gezeigten Funktion tg_send_message(!platform_id, !text) wird der platform_id-Parameter mit Anführungszeichen um einen numerischen Wert übergeben:
tgmess = tg_send_message('1234566788', 'Hello!')
Wie definiert man Schaltflächen im reply_markup-Parameter
Beispiel für Antworttasten:
opts = {"keyboard": [[{"text": "Left"}, {"text": "Right"}]]}
Beispiel für Inline-Tasten:
opts = {"inline_keyboard": [[{"text": "Package 1","callback_data":1}, {"text": "Package 2","callback_data":2}]]}
Wie verwendet man Textformatierung (Markdown) im parse_mode-Parameter**?**
Der parse_mode-Parameter formatiert den gesamten Text oder Teile davon in kursiv oder fett. Mögliche Werte sind: html, markdown oder markdownV2.
- Wenn Sie html wählen:
für fettgedruckten Text verwenden Sie "<b>caption</b>"
für kursiven Text verwenden Sie "<i>caption</i>"
- Für Markdown:
für fettgedruckten Text verwenden Sie "*caption*"
für kursiven Text verwenden Sie "_caption_"
Beispiel für das Senden von kursivem Text:
tg_send_message(47615196, "<i>italic</i>",None,None,"html")
Beispiel für das Senden von fettgedrucktem Text:
tg_send_message(platform_id, '*test*', None, None, 'markdown')