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:

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 schreibt

    text - 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)

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)

So senden Sie eine Reaktion auf eine Nachricht

tg_set_reaction(platform_id, message_id, reaction)

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)

So bearbeiten Sie Medienanhänge in einer Nachricht

So bearbeiten Sie eine Inline-Tastatur in einer Nachricht

Sie können nur eine Inline-Tastatur bearbeiten.

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)

So leiten Sie eine Nachricht weiter

tg_forward_message(platform_id, from_chat_id, message_id, protect_content, disable_notification, message_thread_id)

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.

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.

Beispiel: Nachrichtenversand mit Telegram API

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

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:

/*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

Senden wir eine Nachricht und speichern ihre ID.

Und kopieren die zuvor gesendete Nachricht.

/*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)