So senden Sie Nachrichten mit einem Telegram Business-Konto
tg_send_message(platform_id, text, client_message_id, reply_markup, parse_mode, disable_web_page_preview, protect_content, disable_notification, message_thread_id, entities)
Parameter:
| Parameter | Beschreibung |
|---|---|
| **!** platform_id | Telegram-Benutzer-ID, an die eine Nachricht gesendet werden soll * |
| **!** text | Nachrichtentext |
| client_message_id | Nachrichten-ID, die zitiert werden soll |
| reply_markup | Schaltflächeneinstellungen ** |
| parse_mode | Fett- und Kursivschrift-Formatierung in der Beschreibung ***. Mögliche Werte: html, markdown, markdownV2. |
| disable_web_page_preview | Linkvorschau anzeigen. Zum Deaktivieren 1 übergeben, andernfalls 0 oder leer "" übergeben. |
| protect_content | Inhaltsschutz-Flag. Übergeben Sie einen beliebigen Wert außer 0, False oder '' zum Aktivieren. |
| disable_notification | Tonbenachrichtigungs-Flag (Standard: 0). Übergeben Sie 1 zum Deaktivieren der Benachrichtigung, 0 zum Aktivieren. |
| message_thread_id | Themen-ID (verfügbar für Supergruppen mit aktivierter Forum-Funktionalität) |
| entities | Damit können Sie vorformatierten Text zusammen mit allen seinen Stilen kopieren und einfach den Zeichenbereich angeben, in dem eine bestimmte Schriftart angewendet werden soll. Ein Beispiel finden Sie in der tg_request unter dem entsprechenden Feld. Der Parameter muss ein Dictionary sein. Siehe Beispiel-Tab als Referenz. |
**Ausführliches Beispiel**
Betrachten wir ein einfaches Beispiel mit einem Satz erforderlicher Parameter:

Die platform_id gibt die Kennung eines bestimmten Clients an.
Sehen Sie sich dasselbe Beispiel an, jedoch unter Verwendung von Variablen:

In diesem Beispiel enthält die Variable soob die Antwort des Servers nach dem Senden einer Nachricht.

Wenn Sie die message_id aus der empfangenen Antwort speichern, können Sie später mit dieser Nachricht arbeiten (bearbeiten, löschen, weiterleiten, kommentieren).
Bei der Verwendung aller Parameter treten oft Schwierigkeiten auf. Betrachten wir das folgende Beispiel:
-
Deklarieren Sie zunächst alle in der Funktion verwendeten Parameter. Denken Sie daran, dass Parameter nicht nur als Werte, sondern auch als Variablen übergeben werden können, was oft bequemer und übersichtlicher ist. Variablen wie platform_id und client_message_id können aus der Profilkarte des Clients abgerufen werden.
platform_id — Telegram-Client-ID, an die die Nachricht gesendet werden soll *\ >Wir antworten im selben Chat, in dem der Client schreibttext - Nachrichtentext. \ >Wir verwenden Textformatierung - z.B. Fett-Hervorhebung.
client_message_id - Nachrichten-ID, die zitiert werden soll\ >In Chats wird dieser Variable ihr Wert automatisch zugewiesen.
reply_markup — Schaltflächeneinstellungen **. \ >Weisen wir es der Variable opts zu.
parse_mode — Fett- und Kursivschrift-Formatierung in der Beschreibung ***. Mögliche Werte: html, markdown, markdownV2. Die zur Formatierung des Nachrichtentextes verwendeten Zeichen werden hier beschrieben. \ >Verwenden wir markdown.
disable_web_page_preview - Linkvorschau anzeigen. Zum Deaktivieren 1 übergeben, andernfalls 0 oder leer "" übergeben.\ >Wir können jeden Wert übergeben, da der Nachrichtentext keinen Link enthält.
protect_content — Inhaltsschutz-Flag. Übergeben Sie einen beliebigen Wert außer 0, False oder '' zum Aktivieren.\ >Wir benötigen keinen Inhaltsschutz, also übergeben wir einen leeren String ''.
disable_notification — Tonbenachrichtigungs-Flag (Standard: 0). Übergeben Sie 1 zum Deaktivieren der Benachrichtigung, 0 zum Aktivieren.\ >Eine Benachrichtigung ist ein Popup-Fenster, das den Nachrichtentext anzeigt. Aktivieren wir es. -
Als nächstes setzen wir die Funktion zusammen. Denken Sie daran, die Funktion einer Variablen zuzuweisen – so können Sie den Status des Nachrichtenversands verfolgen.

Das haben wir bekommen:
Nachdem der Client uns das Schlüsselwort test gesendet hat, antworten wir, indem wir seine Nachricht zitieren.
In ok sehen wir den Sendestatus; danach folgen Informationen über die Nachricht selbst – ihre ID, Absenderdaten und Inhalt.
Beispiel mit dem entities-Parameter
Sie können den ursprünglichen String in einer Variablen speichern, wie unten gezeigt:
text = "qwert asdfg zxcvb poiuy lkjhg 12345"
Sie sollten den Parameter als Dictionary mit den Daten schreiben und die gewünschte Formatierung durch Angabe der Schriftarten festlegen:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"`` https://mavibot.ai"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]
Übergeben Sie den Parameter zuletzt in der von Ihnen verwendeten Funktion. Der Parameter kann sowohl an die Funktionen tg_send_message als auch tg_send_message_1 übergeben werden:
x = tg_send_message(platform_id, text, None, None, None, False, False, False, None, entities)
Um einer Variablen Text mit Zeilenumbrüchen zuzuweisen, geben Sie den Wert wie folgt an:
text = "Erste Textzeile" + "\n" + "Zweite Textzeile" + "\n" + "Dritte Zeile"
So senden Sie eine Nachricht unter Angabe eines bestimmten Telegram-Bots
tg_send_message_1(token, platform_id, text, client_message_id, reply_markup, parse_mode, disable_web_page_preview, protect_content, disable_notification, message_thread_id, entities, business_connection_id)
| Parameter | Beschreibung |
|---|---|
| **!** token | Telegram-Bot-Token, erhalten von BotFather |
| **!** platform_id | Telegram-Benutzer-ID, an die eine Nachricht gesendet werden soll * |
| **!** text | Nachrichtentext |
| client_message_id | Nachrichten-ID, die zitiert werden soll |
| reply_markup | Schaltflächeneinstellungen ** |
| parse_mode | Fett- und Kursivschrift-Formatierung in der Beschreibung ***. Mögliche Werte: html, markdown, markdownV2. |
| disable_web_page_preview | Linkvorschau anzeigen. Zum Deaktivieren 1 übergeben, andernfalls 0 oder leer "" übergeben. |
| protect_content | Inhaltsschutz-Flag. Übergeben Sie einen beliebigen Wert außer 0, False oder '' zum Aktivieren. |
| disable_notification | Tonbenachrichtigungs-Flag (Standard: 0). Übergeben Sie 1 zum Deaktivieren der Benachrichtigung, 0 zum Aktivieren. |
| message_thread_id | Themen-ID (verfügbar für Supergruppen mit aktivierter Forum-Funktionalität) |
| entities | Damit können Sie vorformatierten Text zusammen mit allen seinen Stilen kopieren und einfach den Zeichenbereich angeben, in dem eine bestimmte Schriftart angewendet werden soll. Ein Beispiel finden Sie in der tg_request unter dem entsprechenden Feld. Der Parameter muss ein Dictionary sein. |
| business_connection_id | Der Wert Business-ID wird beim Verbinden des Bots verwendet und in Kanälen angezeigt. Er sollte angegeben werden, wenn ein Bot-Token in den Parametern enthalten ist und die Nachricht über ein mit dem Bot verknüpftes Benutzerkonto gesendet werden muss. |
Beispiel
Beispiel für die Übergabe des Parameters:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://mavibot.ai"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]
Das Beispiel zeigt nur das Dictionary, während der Nachrichtentext selbst einer separaten Variablen zugewiesen wird.
So bearbeiten Sie Text in einer Telegram-Nachricht
Bitte beachten!
Die Funktion zum Bearbeiten von Nachrichten ist nur für neue und kürzlich gesendete Nachrichten verfügbar.
Das Zeitfenster, in dem die Nachrichtenbearbeitung erlaubt ist, wird vom Messenger selbst festgelegt und hängt von der Auslastung/Aktivität Ihres Bots ab; es kann für die Bearbeitung verkürzt werden.
Laut technischem Support des Messengers beträgt der optimale Zeitrahmen für die Bearbeitung einer Nachricht 48 Stunden.
tg_edit_message_text(platform_id, message_id, text, reply_markup, parse_mode, disable_web_page_preview, entities)
| Parameter | Beschreibung |
|---|---|
| **!** platform_id | Telegram-Benutzer-ID, an die eine Nachricht gesendet werden soll * |
| **!** message_id | Nachrichten-ID, die bearbeitet werden soll. Diese ID muss zuvor beim Senden der Nachricht gespeichert werden. |
| **!** text | Nachrichtentext |
| reply_markup | Schaltflächeneinstellungen ** |
| parse_mode | Fett- und Kursivschrift-Formatierung in der Beschreibung ***. Mögliche Werte: html, markdown, markdownV2. |
| disable_web_page_preview | Linkvorschau anzeigen. Zum Deaktivieren 1 übergeben, andernfalls 0 oder leer "" übergeben. |
| entities | Damit können Sie vorformatierten Text zusammen mit allen seinen Stilen kopieren und einfach den Zeichenbereich angeben, in dem eine bestimmte Schriftart angewendet werden soll. Ein Beispiel finden Sie in der tg_request unter dem entsprechenden Feld. Der Parameter muss ein Dictionary sein. |
So senden Sie eine Reaktion auf eine Nachricht
tg_set_reaction(platform_id, message_id, reaction)
| Parameter | Beschreibung |
|---|---|
| **!** platform_id | Telegram-Chat-ID |
| **!** message_id | Nachrichten-ID |
| **!** reaction | Die gewünschte Reaktion wird als String übergeben. |
Beispiel
Codebeispiel zum Kopieren:
react = tg_set_reaction(platform_id, 1556, '👌')
Beispiel im Rechner:

So bearbeiten Sie eine Anhangsbeschreibung
tg_edit_message_caption(platform_id, message_id, caption, reply_markup, parse_mode, entities, show_caption_above_media)
| Parameter | Beschreibung |
|---|---|
| **!** platform_id | Telegram-Benutzer-ID, an die eine Nachricht gesendet werden soll * |
| **!** message_id | Nachrichten-ID, die bearbeitet werden soll |
| **!** caption | Beschreibungstext |
| reply_markup | Schaltflächeneinstellungen ** |
| parse_mode | Fett- und Kursivschrift-Formatierung in der Beschreibung ***. Mögliche Werte: html, markdown, markdownV2. |
| entities |
Damit können Sie vorformatierten Text zusammen mit allen seinen Stilen kopieren und einfach den Zeichenbereich angeben, in dem eine bestimmte Schriftart angewendet werden soll. Ein Beispiel finden Sie in der tg_request unter dem entsprechenden Feld. Der Parameter muss ein Dictionary sein. Das Beispiel zeigt nur das Dictionary, während der Nachrichtentext selbst einer separaten Variablen zugewiesen wird. |
| show_caption_above_media | Nimmt den Wert True an; wenn dieser Parameter angegeben ist, wird der Nachrichtentext über dem Anhang angezeigt. |
So bearbeiten Sie Medienanhänge in einer Nachricht
| Parameter | Beschreibung |
|---|---|
| **!** platform_id | Telegram-Benutzer-ID, an die eine Nachricht gesendet werden soll * |
| **!** message_id | Nachrichten-ID, die bearbeitet werden soll. Diese ID muss zuvor beim Senden der Nachricht gespeichert werden. |
| **!** media |
Ein Dictionary, das die Mediendatei beschreibt:
wobei <file_to_send> empfohlen wird, die file_id zu verwenden, die über den vollständigen Telegram-Webhook abgerufen wurde. Weitere Details zu den Parametern des Dictionarys finden Sie in der offiziellen Telegram-Dokumentation. |
| reply_markup | Schaltflächeneinstellungen ** |
So bearbeiten Sie eine Inline-Tastatur in einer Nachricht
| Parameter | Beschreibung |
|---|---|
| **!** platform_id | Telegram-Benutzer-ID, an die eine Nachricht gesendet werden soll * |
| **!** message_id | Nachrichten-ID, die bearbeitet werden soll. Diese ID muss zuvor beim Senden der Nachricht gespeichert werden. |
| **!** reply_markup | Schaltflächeneinstellungen ** |
Sie können nur eine Inline-Tastatur bearbeiten.
Beispiel: Nachrichtenbearbeitung mit Telegram API
Ein detailliertes Beispiel für die Arbeit mit Telegram-API-Funktionen zum Bearbeiten von Nachrichten finden Sie unten.
So kopieren Sie eine Nachricht
tg_copy_message(platform_id, from_chat_id, message_id, reply_to_message_id, reply_markup, parse_mode, protect_content, disable_notification, caption, message_thread_id, entities, show_caption_above_media)
| Parameter | Beschreibung |
|---|---|
| **!** platform_id | Telegram-Benutzer-ID, AN die eine Nachricht kopiert werden soll * |
| **!** from_chat_id | Telegram-Benutzer-ID, VON der eine Nachricht kopiert werden soll * |
| **!** message_id | Nachrichten-ID, die kopiert werden soll |
| reply_to_message_id | Ursprüngliche Nachrichten-ID, wenn die kopierte Nachricht ein Kommentar ist |
| reply_markup | Schaltflächeneinstellungen ** |
| parse_mode |
Fett- und Kursivschrift-Formatierung in der Beschreibung ***. Mögliche Werte: html, markdown, markdownV2. |
| protect_content | Inhaltsschutz-Flag. Übergeben Sie einen beliebigen Wert außer 0, False oder '' zum Aktivieren. |
| disable_notification | Tonbenachrichtigungs-Flag (Standard: 0). Übergeben Sie 1 zum Deaktivieren der Benachrichtigung, 0 zum Aktivieren. |
| caption - | Beschreibung bis zu 1024 Zeichen. |
| message_thread_id | Themen-ID (verfügbar für Supergruppen mit aktivierter Forum-Funktionalität) |
| entities | Damit können Sie vorformatierten Text zusammen mit allen seinen Stilen kopieren und einfach den Zeichenbereich angeben, in dem eine bestimmte Schriftart angewendet werden soll. Ein Beispiel finden Sie in der tg_request unter dem entsprechenden Feld. Der Parameter muss ein Dictionary sein. Beispiel für die Übergabe des Parameters: entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":**"https://mavibot.ai"}**,{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}] Das Beispiel zeigt nur das Dictionary, während der Nachrichtentext selbst einer separaten Variablen zugewiesen wird. |
| show_caption_above_media | Nimmt den Wert True an; wenn dieser Parameter angegeben ist, wird der Nachrichtentext über dem Anhang angezeigt. |
So leiten Sie eine Nachricht weiter
tg_forward_message(platform_id, from_chat_id, message_id, protect_content, disable_notification, message_thread_id)
| Parameter | Beschreibung |
|---|---|
| **!** platform_id | Telegram-Benutzer-ID, AN die eine Nachricht gesendet werden soll * |
| **!** from_chat_id | Telegram-Benutzer-ID, VON der eine Nachricht gesendet werden soll * |
| **!** message_id | Weiterleitungsnachrichten-ID |
| protect_content | Inhaltsschutz-Flag. Übergeben Sie einen beliebigen Wert außer 0, False oder '' zum Aktivieren. |
| disable_notification | Tonbenachrichtigungs-Flag (Standard: 0). Übergeben Sie 1 zum Deaktivieren der Benachrichtigung, 0 zum Aktivieren. |
| message_thread_id | Themen-ID (verfügbar für Supergruppen mit aktivierter Forum-Funktionalität) |
So löschen Sie eine Nachricht
tg_delete_message(platform_id, message_id)
! Verwenden Sie diese Methode zum Löschen einer Nachricht, einschließlich Dienstnachrichten, mit den folgenden Einschränkungen:
- Eine Nachricht kann nur gelöscht werden, wenn sie vor weniger als 48 Stunden gesendet wurde.
- Nachrichten mit Würfeln in einem privaten Chat können nur gelöscht werden, wenn sie vor mehr als 24 Stunden gesendet wurden.
- Bots können ausgehende Nachrichten in privaten Chats, Gruppen und Supergruppen löschen.
- Bots können eingehende Nachrichten in privaten Chats löschen.
- Bots mit der Berechtigung can_post_messages können ausgehende Nachrichten in Kanälen löschen.
- Wenn ein Bot Administrator einer Gruppe ist, kann er dort jede Nachricht löschen.
- Wenn ein Bot die Berechtigung can_delete_messages in einer Supergruppe oder einem Kanal hat, kann er dort jede Nachricht löschen.
| Parameter | Beschreibung |
|---|---|
| **!** platform_id | Telegram-Benutzer-ID * |
| **!** message_id | Nachrichten-ID, die gelöscht werden soll |
So löschen Sie mehrere Nachrichten
tg_delete_messages(platform_id, message_ids)
! Verwenden Sie diese Methode zum Löschen einer Nachricht, einschließlich Dienstnachrichten, mit den folgenden Einschränkungen:
- Eine Nachricht kann nur gelöscht werden, wenn sie vor weniger als 48 Stunden gesendet wurde.
- Nachrichten mit Würfeln in einem privaten Chat können nur gelöscht werden, wenn sie vor mehr als 24 Stunden gesendet wurden.
- Bots können ausgehende Nachrichten in privaten Chats, Gruppen und Supergruppen löschen.
- Bots können eingehende Nachrichten in privaten Chats löschen.
- Bots mit der Berechtigung can_post_messages können ausgehende Nachrichten in Kanälen löschen.
- Wenn ein Bot Administrator einer Gruppe ist, kann er dort jede Nachricht löschen.
- Wenn ein Bot die Berechtigung can_delete_messages in einer Supergruppe oder einem Kanal hat, kann er dort jede Nachricht löschen.
| Parameter | Beschreibung |
|---|---|
| **!** platform_id | Telegram-Benutzer-ID |
| **!** message_ids | Ein Array von Nachrichten-IDs, die gelöscht werden sollen. Maximal 100 Elemente. |
Beispiel: Nachrichtenversand mit Telegram API
Codebeispiel zum Kopieren
Beispiel 1
/*Es ist praktisch, den Text vorher in einer Variablen zu definieren*/
text='Schreiben-schreiben-schreibender Text'
/*Funktion zum Senden einer Nachricht*/
soob=tg_send_message(platform_id, text)
/*Gesendete Nachrichten-ID speichern*/
soob_id=soob['result']['message_id']
Beispiel 2
id_group=-1001847103100
text='Testen des Nachrichtenversands über die API-Methode. Zum Beispiel *fetter Text*'
opts = {"inline_keyboard": [[{"text": "👍","callback_data":1}, {"text": "👎","callback_data":2}]]}
disable_web_page_preview=1
protect_content=''
disable_notification=1
parse_mode='markdown'
soob=tg_send_message(id_group, text,client_message_id, opts, parse_mode, disable_web_page_preview, protect_content, disable_notification)
Beispiel: Nachrichtenbearbeitung mit Telegram API
Beispiel der Konfiguration
Senden wir uns also eine Nachricht mit einer Inline-Tastatur:

Als nächstes bearbeiten wir den Nachrichtentext:

Und bearbeiten die Schaltflächen:

Versuchen wir, eine Nachricht mit einem Bild zu bearbeiten. Senden Sie dazu eine Nachricht mit einem Bild und speichern Sie die gesendete Nachrichten-ID. Lesen Sie die detaillierten Anweisungen zum Abrufen der Bild-URL hier:

Jetzt bearbeiten wir das Bild und seine Beschreibung:

Codebeispiel zum Kopieren
/*Es ist praktisch, die Parameter vorher in einer Variablen zu definieren.*/
text='Welches Paket möchten Sie wählen?'
opts = {"inline_keyboard": [[{"text": "Paket 1","callback_data":1}, {"text": "Paket 2","callback_data":2}]]}
/*Funktion zum Senden einer Nachricht*/
soob=tg_send_message(platform_id, text, None, opts)
/*Gesendete Nachrichten-ID speichern*/
soob_id=soob['result']['message_id']
/*Nachricht bearbeiten*/
text='Für welches Paket interessieren Sie sich?'
tg_edit_message_text(platform_id, soob_id, text, opts)
/*Inline-Tastatur bearbeiten*/
opts = {"inline_keyboard": [[{"text": "Standard","callback_data":1}, {"text": "Premium","callback_data":2}]]}
tg_edit_message_reply_markup(platform_id, soob_id, opts)
/*Bild mit Beschreibung senden*/
soob=tg_send_photo(platform_id, "AgACAgIAAxkBAAIPpWO4T7jhOgYHq6uR8rjnq9rIvBs-AAJlwDEb5fHASaGdhzgWjyn7AQADAgADeAADLQQ", "Dies ist ein Bild")
/*Gesendete Nachrichten-ID speichern*/
soob_id=soob['result']['message_id']
/*Bild bearbeiten*/
media='{"type": "photo", "media": "AgACAgIAAxkBAAIPrmO4UiH7Tazqn-3IbFVzPKNsVEZmAAJ1wDEb5fHASWcNXKah-egvAQADAgADeQADLQQ"}'
tg_edit_message_media(platform_id, soob_id, media)
/*Bildbeschreibung bearbeiten*/
tg_edit_message_caption(platform_id, soob_id, 'Das bin ICH!')
Beispiel: Nachrichtenkopie mit Telegram API
Beispiel
Senden wir eine Nachricht und speichern ihre ID.

Und kopieren die zuvor gesendete Nachricht.

Codebeispiel zum Kopieren
/*Es ist praktisch, die Parameter vorher in einer Variablen zu definieren.*/
text='Welches Paket möchten Sie wählen?'
opts = {"inline_keyboard": [[{"text": "Paket 1","callback_data":1}, {"text": "Paket 2","callback_data":2}]]}
/*Funktion zum Senden einer Nachricht*/
soob=tg_send_message(platform_id, text, None, opts)
/*Gesendete Nachrichten-ID speichern*/
soob_id=soob['result']['message_id']
/*Gesendete Nachricht kopieren*/
tg_copy_message('5081438490', '1840834360', soob_id, None, opts, None, None, 1)