Funktionen zum Senden von Anhängen in Nachrichten

! Mit diesen Funktionen können Sie Dateien beliebigen Typs senden. Empfohlene Formate: GIF, PDF, ZIP bis zu 2 GB.

! Arbeit mit Telegram Business-Konto

tg_send_document(platform_id, document, caption, reply_markup, parse_mode,reply_to_message_id, protect_content, disable_notification, message_thread_id, entities)

Parameter:

! platform_id — Client-Kennung in Telegram, an die die Nachricht gesendet werden muss *

! document - Link zum Dokument auf dem Telegram-Server. Das Abrufen des Links über tg_request wird hier erklärt.

caption - Beschreibung, bis zu 1024 Zeichen

reply_markup — Schaltflächeneinstellungen **

parse_mode — Textformatierung in der Beschriftung (fett oder kursiv) ***. Mögliche Werte: html, markdown, markdownV2. ссылка

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

protect_content — Flag zum Schutz des Inhalts vor Kopieren. Um es zu aktivieren, übergeben Sie einen beliebigen Wert außer 0, False oder leeren Anführungszeichen ''.

disable_notification — Flag zur Steuerung von Tonbenachrichtigungen (Standard: 0).
1 - ohne Benachrichtigung senden, 0 - mit Benachrichtigung senden

message_thread_id — Thread-Kennung (verfügbar in Supergruppen mit Forum-Funktionalität)

entities — ermöglicht die Wiederverwendung von vorformatiertem Text mit Stilen. Definieren Sie einfach den Zeichen-Offset und den Bereich für die Formatierung. Ein Beispiel finden Sie in tg_request im entsprechenden Feld. 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://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

In diesem Beispiel wird nur das Dictionary gezeigt, während der eigentliche Nachrichtentext in einer separaten Variable definiert ist.

Um die Beschreibung eines Schaltflächensatzes zu vereinfachen, können Sie den folgenden Lifehack verwenden.

! Mit diesen Funktionen können Sie Dateien beliebigen Typs senden. Empfohlene Formate: GIF, PDF, ZIP bis zu 2 GB.

tg_send_some_document(platform_id, document_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

Parameter:

! platform_id — Client-Kennung in Telegram, an die die Nachricht gesendet werden muss *

! document_list - ein Array von Dokumenten. Ein Beispiel für die Erstellung eines solchen Arrays finden Sie unten

disable_notification — Flag zur Steuerung von Tonbenachrichtigungen (Standard: 0).
1 - ohne Benachrichtigung senden, 0 - mit Benachrichtigung senden

protect_content — Flag zum Schutz des Inhalts vor Kopieren. Um es zu aktivieren, übergeben Sie einen beliebigen Wert außer 0, False oder leeren Anführungszeichen ''.

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

message_thread_id — Thread-Kennung (verfügbar in Supergruppen mit Forum-Funktionalität)

Beispiel für die Erstellung eines document_list-Arrays:
'[["Dokumentenlink", "Beschriftung", "parse_mode"], ["Dokumentenlink 2"], ["Dokumentenlink 3", "Beschriftung"]]'

Beispiel für die Datenformatierung für ein einzelnes Dokument
["Dokumentenlink", "Beschriftung", "parse_mode"]

Die Reihenfolge der Parameter ist wichtig! Beim Erstellen eines Dokumentenarrays können die Anführungszeichen " " weggelassen werden.

Beschreibung der Parameter für das document_list-Array:
! Dokumentenlink - Dokumentenlink vom Telegram-Server. Das Abrufen des Links über tg_request wird hier erklärt.
caption — Beschreibung bis zu 1024 Zeichen
parse_mode — Formatierung der Beschreibung, d. h. Hervorhebung von Text in fett oder kursiv ***

Gehen wir ein Beispiel zum Senden eines einzelnen Dokuments durch, wobei wir Inline-Schaltflächen und eine Beschreibung zum Dokument hinzufügen:

1. Holen Sie sich zuerst den Link zu Ihrem Dokument. Eine detaillierte Erklärung, wie das geht, finden Sie hier.

2. Erstellen Sie einen Block und setzen Sie die Variablen wie im Screenshot gezeigt:
   

   

3. Senden Sie den Block an sich selbst und sehen Sie das Ergebnis unserer Arbeit:

Betrachten wir nun das Senden mehrerer Dokumente.

1. Auch hier müssen Sie einen internen Telegram-Link für jedes Dokument abrufen und ein Array bilden.
   lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Dokument1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Dokument2"]]'
2. Setzen Sie schließlich die Funktion zum Senden von Dokumenten zusammen:

3. Und überprüfen Sie das Ergebnis der Arbeit:

Denken Sie daran, dass Links für jeden Bot einzigartig sind. Stellen Sie daher sicher, dass Sie Ihre eigenen Links generieren

Codebeispiel zum Senden eines einzelnen Dokuments:

lnkdoc= "BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ"
opts = {"inline_keyboard": [[{"text": "Ausgezeichnet","callback_data":"Antwort1"}, {"text": "Nicht akzeptiert","callback_data":"Antwort2"}]]}
soob=tg_send_document(platform_id, lnkdoc, "Dokument senden", opts) 

Codebeispiel zum Senden mehrerer Dokumente:

lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Dokument1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Dokument2"]]'
soob=tg_send_some_document(platform_id, lnkdoc)

! Diese Funktion ermöglicht das Senden von Sprachdateien im .OGG-Format, codiert mit OPUS, bis zu 2 GB Größe.

! Arbeit nur mit Telegram Business-Konto

tg_send_voice(platform_id, voice, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, disable_notification, message_thread_id, entities)

Parameter:

! platform_id — Client-Kennung in Telegram, an die die Nachricht gesendet werden soll *

! voice - Link zur Sprachnachricht im .OGG-Format

caption - Beschreibung bis zu 1024 Zeichen

reply_markup — Schaltflächeneinstellungen **

parse_mode — Textformatierung in der Beschreibung fett oder kursiv ***. Mögliche Werte: html, markdown, markdownV2.

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

protect_content — Flag zum Schutz des Inhalts vor Kopieren. Um es zu aktivieren, übergeben Sie einen beliebigen Wert außer 0, False oder leeren Anführungszeichen ''.

disable_notification — Flag zum Senden einer Nachricht mit oder ohne Tonbenachrichtigung (Standard: 0). 1 - Benachrichtigung beim Empfang deaktivieren, 0 - mit Benachrichtigung senden

message_thread_id — Themenkennung (verfügbar in Supergruppen, wenn die Forum-Funktion aktiviert ist).

entities — mit diesem Parameter können Sie einfach formatierten Text mit all seinen Funktionen kopieren und angeben, ab welchem Zeichen bis zu welchem Zeichen er mit einem bestimmten Stil angezeigt wird. Ein Beispiel finden Sie in tg_request im entsprechenden Feld. Der Parameter muss ein Dictionary sein.

Beispiel für die Parameterübergabe:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

Das Beispiel zeigt nur ein Dictionary, während der Nachrichtentext selbst in einer Variable definiert ist.

Um die Beschreibung des Schaltflächensatzes zu vereinfachen, können Sie den folgenden Lifehack verwenden.

! Diese Funktion ermöglicht das Senden von Audiodateien im .MP3- oder .M4A-Format mit einer maximalen Größe von 2 GB.

! Arbeit mit Telegram Business-Konto

tg_send_some_audio(platform_id, audio_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

Parameter:

! platform_id — Client-Kennung in Telegram, an die die Nachricht gesendet werden soll *

! audio_list - ein Array von Audiodateien (Details unten)

disable_notification — Flag zum Senden der Nachricht mit oder ohne Tonbenachrichtigung (Standard: 0). 1 — ohne Benachrichtigung senden, 0 — mit Benachrichtigung senden

protect_content — Flag zum Schutz des Inhalts vor Kopieren. Um es zu aktivieren, übergeben Sie einen beliebigen Wert außer 0, False oder leeren Anführungszeichen ''.

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

message_thread_id — Themen-ID (verfügbar in Supergruppen mit Forum-Funktionalität)

Beispiel für die Erstellung eines audio_list-Arrays:
'[["Audio-Link 1", "Beschriftung", "parse_mode"], ["Audio-Link 2"], ["Audio-Link 3", "Beschriftung"]]'

Beispiel für eine einzelne Audiodatei:
["Audio-Link", "Beschriftung", "parse_mode"]

Die Reihenfolge der Parameter ist wichtig! Beim Erstellen des Arrays von Audiodateien können die Anführungszeichen "" weggelassen werden

Parameterbeschreibung:
! Audio-Link - Link zu einer Audiodatei im .OGG-Format
caption — Beschreibung (bis zu 1024 Zeichen)
parse_mode — Textformatierung in der Beschriftung fett oder kursiv ***

Wie oben erwähnt, arbeitet die Funktion mit .OGG-Dateien. Daher besteht die erste Aufgabe darin, eine Audioaufnahme in diesem Format zu erhalten.
Wenn Sie eine .MP3-Datei haben, können Sie sie mit dem Bot https://t.me/mp3toolsbot in .OGG konvertieren.

Senden Sie als Nächstes die resultierende Datei an sich selbst im Bot, um die file_id gemäß dem hier beschriebenen Algorithmus zu erhalten.

Setzen Sie nun die Funktion zusammen:

Großartig! Gut gemacht!

Denken Sie daran, dass Links für jeden Bot einzigartig sind. Stellen Sie daher sicher, dass Sie Ihre eigenen Links generieren

tg_send_voice(platform_id, "CQACAgIAAxkBAAER70Bi8VkgNhegB-msqDWXm2qHi3n9-AAC-iAAAk6giUvIXkW-XzBN0ikE")

Wenn eine Nachricht aufgrund von Datenschutzeinstellungen nicht gesendet werden kann, wird der folgende Fehler zurückgegeben:

{"ok":false,"error_code":400,"description":"Bad Request: user restricted receiving of voice messages"}

Ursache des Fehlers: Die Datenschutzeinstellungen des Benutzers enthalten die Option "Sprachnachrichten nicht empfangen" (entweder von allen oder nur von bestimmten Benutzern erlauben):

Selbst wenn der Benutzer diese Datenschutzbeschränkung deaktiviert, wird der Fehler weiterhin angezeigt.

! Diese Funktion ermöglicht das Senden von GIF- oder H.264/MPEG-4 AVC-Videos ohne Ton mit einer maximalen Größe von 2 GB.

! Arbeiten mit Telegram Business-Konto

tg_send_animation(platform_id, animation, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media)

Parameter:

!** platform_id** — Telegram-Client-ID, an die die Nachricht gesendet werden soll. *

!** animation**- Link zur Animation. Wie Sie einen Link über tg_request erhalten, wird hier erklärt

caption - Beschreibung bis zu 1024 Zeichen

reply_markup — Tastenkonfiguration **

parse_mode — Textformatierung in der Beschreibung fett oder kursiv ***. Mögliche Werte: html, markdown, markdownV2

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

protect_content — Flag zum Schutz des Inhalts vor Kopieren. Zum Aktivieren einen anderen Wert als 0, False oder leere Anführungszeichen '' übergeben.

has_spoiler — aktiviert Spoiler. Zum Aktivieren True setzen.

disable_notification — Flag zum Senden der Nachricht mit oder ohne Tonbenachrichtigung (Standard: 0). 1 — ohne Benachrichtigung senden, 0 — mit Benachrichtigung senden

message_thread_id — Thread-ID (verfügbar in Supergruppen mit Forum-Funktionalität)

entities — mit diesem Parameter können Sie einfach formatierten Text mit allen seinen Merkmalen kopieren und angeben, von welchem Zeichen bis zu welchem Zeichen es mit einem bestimmten Stil angezeigt wird. Ein Beispiel finden Sie in tg_request im entsprechenden Feld. Der Parameter sollte ein Wörterbuch sein.

show_caption_above_media - wenn auf True gesetzt, wird die Nachrichtenbeschreibung über dem Medium angezeigt

Beispiel für die Parameterübergabe:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

In diesem Beispiel wird nur das Wörterbuch gezeigt, während der Nachrichtentext selbst in einer Variable gespeichert ist

Um Tastenbeschreibungen zu vereinfachen, können Sie den folgenden Lifehack verwenden

Machen wir die Aufgabe komplexer und senden eine Animation mit Kopier- und Spoiler-Schutz.

Wie immer beginnt der Prozess mit dem Erhalt des internen Telegram-Links für die ausgewählte Animation (Details hier).

Abschließend setzen wir die Funktion zusammen:

Und überprüfen das Ergebnis der Arbeit:

Denken Sie daran, dass Links für jeden Bot einzigartig sind. Stellen Sie daher sicher, dass Sie Ihre eigenen Links generieren

animation="CgACAgIAAxkBAAIQDWO9Dbb0QODBmI_CUMhKHoWch7MDAAJBIQACtjXoScUjA-n5kGCYLQQ"
caption = "Frohes Neues Jahr!"
soob=tg_send_animation(platform_id, animation, caption, None, None, None, True,True)

! Diese Funktion ermöglicht das Senden von MPEG4-Dateien mit einer Größe von bis zu 2 GB.
(Andere Formate können als Dateien mit tg_send_document() gesendet werden)

! Arbeiten mit Telegram Business-Konto

tg_send_video(platform_id, video, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media, cover)

Parameter:

!** platform_id** — Telegram-Client-ID, an die die Nachricht gesendet werden soll *

!** video** - Videolink. Wie Sie Links über tg_request erhalten, finden Sie hier

caption - Beschreibung bis zu 1024 Zeichen

reply_markup — Tasteneinstellungen **

parse_mode — Textformatierung in der Beschreibung fett oder kursiv ***. Mögliche Werte: html, markdown, markdownV2.

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

protect_content — Flag zum Schutz des Inhalts vor Kopieren. Zum Aktivieren einen anderen Wert als 0, False oder leere Anführungszeichen '' übergeben.

has_spoiler — aktiviert Spoiler. Zum Aktivieren True setzen

disable_notification — Flag zum Senden der Nachricht mit einer Tonbenachrichtigung (Standard: 0).
1 — ohne Benachrichtigung senden, 0 — mit Benachrichtigung senden

message_thread_id — Thread-ID (verfügbar in Supergruppen mit Forum-Funktionalität)

entities — mit diesem Parameter können Sie einfach formatierten Text mit allen seinen Merkmalen kopieren und angeben, von welchem Zeichen bis zu welchem Zeichen es mit einem bestimmten Stil angezeigt wird. Ein Beispiel finden Sie in tg_request im entsprechenden Feld. Der Parameter sollte ein Wörterbuch sein.

show_caption_above_media - wenn auf True gesetzt, wird der Nachrichtentext über dem Medium angezeigt.

cover - Videocover-Bild in der Nachricht. Die URL über tg_request erhalten Sie hier.

Beispiel für die Parameterübergabe:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

In diesem Beispiel wird nur das Wörterbuch gezeigt, während der Nachrichtentext selbst in einer Variable gespeichert ist

Um Tastenbeschreibungen zu vereinfachen, können Sie den folgenden Lifehack verwenden

! Arbeiten mit Telegram Business-Konto

tg_send_some_video(platform_id, video_list, disable_notification, protect_content, reply_to_message_id, has_spoiler, message_thread_id)

Parameter:

!** platform_id** — Telegram-Client-ID, an die die Nachricht gesendet werden soll *

!** video_list** - ein Array von Videodateien (Details unten)

disable_notification — Flag zum Senden der Nachricht mit einer Tonbenachrichtigung (Standard: 0).
1 — ohne Benachrichtigung senden, 0 — mit Benachrichtigung senden

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

has_spoiler — aktiviert Spoiler-Formatierung (optional; auf True setzen zum Aktivieren)

message_thread_id — Thread-ID (verfügbar in Supergruppen mit Forum-Funktionalität)

Beispiel für den Aufbau eines Video-Arrays video_list:
'[["Videolink1", "Beschreibung", "parse_mode"], ["Videolink2"], ["Videolink3", "Beschreibung"]]'

Beispiel für den Aufbau eines einzelnen Audios:
["Videolink", "Beschreibung", "parse_mode"]

Die Reihenfolge der Parameter ist wichtig! Beim Aufbau des Videodatei-Arrays können Anführungszeichen "" weggelassen werden

Parameterbeschreibung: \ !** Videolink** — interne Telegram-Video-URL. Das Abrufen des Links über tg_request wird hier beschrieben.
caption — Textbeschreibung bis zu 1024 Zeichen
parse_mode — Textformatierung in der Beschreibung fett oder kursiv ***. Mögliche Werte: html, markdown, markdownV2.

Beginnen Sie also damit, den Link zu der Datei zu erhalten, die Sie senden möchten, und füllen Sie dann die erforderlichen Funktionsparameter aus:

Nach der Überprüfung erhalten wir das Video:

Denken Sie daran, dass Links für jeden Bot einzigartig sind. Stellen Sie daher sicher, dass Sie Ihre eigenen Links generieren

video="BAACAgIAAxkBAAIQFmO9Ycbt5JDIr9HKQh-XkhS9FqTxAALQIwACtjXoSXKlqfbH-I_gLQQ"
soob=tg_send_video(platform_id, video

! Ab Version 4.0 unterstützt Telegram das Senden von runden MPEG4-Videos mit einer Dauer von bis zu einer Minute.

! Arbeiten mit Telegram Business-Konto

tg_send_video_note(platform_id, video_note, reply_markup, protect_content, reply_to_message_id, disable_notification, message_thread_id)

Parameter:

!** platform_id** — Telegram-Client-ID, an die die Nachricht gesendet werden soll *

!** video_note** - Videolink. Wie Sie den Link über tg_request erhalten, wird hier beschrieben
reply_markup — Tasteneinstellungen **

protect_content — Flag zum Schutz des Inhalts vor Kopieren. Zum Aktivieren einen anderen Wert als 0, False oder leere Anführungszeichen '' übergeben

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

disable_notification — Flag zum Senden der Nachricht mit einer Tonbenachrichtigung (Standard: 0).
1 — ohne Benachrichtigung senden, 0 — mit Benachrichtigung senden

message_thread_id — Thread-ID (verfügbar in Supergruppen mit Forum-Funktionalität)

Um Tastenbeschreibungen zu vereinfachen, können Sie den folgenden Lifehack verwenden

Wenn Sie ein quadratisches Video haben, können Sie es mit dem Bot https://t.me/roundNoteBot in ein rundes umwandeln:

Sobald Sie das runde Video haben, senden Sie es sich selbst im Bot, um den Link zu erhalten (Details hier), und richten Sie dann die Funktion zum Senden des runden Videos ein:

Denken Sie daran, dass Links für jeden Bot einzigartig sind. Stellen Sie daher sicher, dass Sie Ihre eigenen Links generieren

tg_send_video_note(platform_id, 'DQACAgIAAxkBAAER6cVi6OzIezJo9FWu6WyZPzDgQX8B3QACcxsAArR3SUtRizDeiHWLNikE','','1')

! Arbeiten mit Telegram Business-Konto

tg_send_venue(platform_id, latitude, longitude, title, address, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

Parameter:

! platform_id — Telegram-Client-ID, an das die Nachricht gesendet werden soll *

! latitude — Breitengrad

! longitude — Längengrad

! title — Titel

! address — Adresse

protect_content — Flag zum Schutz des Inhalts vor Kopieren. Zum Aktivieren einen beliebigen Wert außer 0, False oder leere Anführungszeichen '' übergeben

disable_notification — Flag zum Senden der Nachricht mit einer Tonbenachrichtigung (Standard: 0).
1 — ohne Benachrichtigung senden, 0 — mit Benachrichtigung senden

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

reply_markup — Schaltflächeneinstellungen **

message_thread_id — Thread-ID (verfügbar in Supergruppen mit Forenfunktion)

Um die Beschreibungen von Schaltflächensätzen zu vereinfachen, können Sie den folgenden Lifehack verwenden

Lassen Sie uns zunächst die Koordinaten des Ortes bestimmen. Sie können diese mit Google Maps erhalten

Konvertieren Sie als Nächstes die erhaltenen Koordinaten mit einem beliebigen Online-Koordinatenkonverter von Dezimalgrad in das geografische Format:

Fahren wir nun mit dem Ausfüllen der Funktionsparameter fort und erhalten das gewünschte Ergebnis:

soob=tg_send_venue(platform_id, "48°52′", "2°4′", "Dreams come true!", "Paris, Eiffel Tower") 

! Arbeiten mit Telegram Business - Konto

Telegram bietet eine schnelle Möglichkeit, Kontakte aus Ihrem Adressbuch zu teilen. Der Messenger unterstützt das Senden von vCard — einer elektronischen Visitenkarte

Die Funktion tg_send_contact ermöglicht das Senden einer Telefonnummer mit einem Vornamen (oder Organisationsnamen) sowie das Hinzufügen von Schaltflächen und das Aktivieren des Inhaltsschutzes für die Nachricht.

tg_send_contact(platform_id, phone, first_name, last_name, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

! - erforderlicher Funktionsparameter

Parameter:

! platform_id — Telegram-Client-ID, an das die Nachricht gesendet werden soll *

! phone — Telefonnummer im internationalen Format. Zum Beispiel für Russland: +7XXXXXXXXXX

! first_name und last_name - Vorname und Nachname

protect_content — Flag zum Schutz des Inhalts vor Kopieren. Zum Aktivieren einen beliebigen Wert außer 0, False oder leere Anführungszeichen '' übergeben

disable_notification — Flag zum Senden der Nachricht mit einer Tonbenachrichtigung (Standard: 0).
1 — ohne Benachrichtigung senden, 0 — mit Benachrichtigung senden

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

reply_markup — Schaltflächeneinstellungen **

message_thread_id — Thread-ID (verfügbar in Supergruppen mit Forenfunktion)

Um die Beschreibungen von Schaltflächensätzen zu vereinfachen, können Sie den folgenden Lifehack verwenden

Füllen Sie die Parameter aus: Telefonnummer, Vorname und Nachname.

Sehen Sie sich das Ergebnis an:

soob=tg_send_contact(platform_id, "+79999999999", "Ann", "Test", 1) 

! Arbeiten mit Telegram Business - Konto

tg_send_sticker(platform_id, sticker_id, protect_content, disable_notification, reply_to_message_id, reply_markup, message_thread_id)

Parameter:

! platform_id — Telegram-Client-ID, an das die Nachricht gesendet werden soll *

! sticker_id - Sticker-ID. Wie man einen Link über tg_request erhält, wird hier erklärt

protect_content — Flag zum Schutz des Inhalts vor Kopieren. Zum Aktivieren einen beliebigen Wert außer 0, False oder leere Anführungszeichen '' übergeben

disable_notification — Flag zum Senden der Nachricht mit einer Tonbenachrichtigung (Standard: 0).
1 — ohne Benachrichtigung senden, 0 — mit Benachrichtigung senden

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

reply_markup — Schaltflächeneinstellungen **

message_thread_id — Thread-ID (verfügbar in Supergruppen mit Forenfunktion)

Um die Beschreibungen von Schaltflächensätzen zu vereinfachen, können Sie den folgenden Lifehack verwenden

Das Senden eines Stickers unterscheidet sich nicht vom Senden eines anderen Anhangs:\

1. Holen Sie sich den internen Telegram-Link (Details hier)\
2. Füllen Sie die Funktionsparameter aus\
3. Senden Sie den Block an sich selbst und überprüfen Sie das Ergebnis

Ergebnis:

Denken Sie daran, dass Links für jeden Bot eindeutig sind. Stellen Sie daher sicher, dass Sie Ihre eigenen Links generieren

soob=tg_send_sticker(platform_id, 'CAACAgIAAxkBAAEawJ5jmNeyat8uPGBMP3JzubRNXGjH3wACrw4AAsYg4UqePobN94_jkywE')

! Das Foto sollte nicht größer als 10 MB sein. Die Gesamtbreite und -höhe sollten 10.000 Pixel nicht überschreiten. Das Breiten-Höhen-Verhältnis sollte 20 nicht überschreiten.

! Arbeiten mit Telegram Business - Konto

tg_send_photo(platform_id, photo, caption, reply_markup, parse_mode, reply_to_message_id, protect_content, has_spoiler, disable_notification, message_thread_id, entities, show_caption_above_media)

Parameter:

! platform_id — Telegram-Client-ID, an das die Nachricht gesendet werden soll *

! photo - Link zum Bild. Wie man einen Link über tg_request erhält, wird hier erklärt.

caption - Beschreibung bis zu 1024 Zeichen

reply_markup — Schaltflächeneinstellungen **

parse_mode — Textformatierung in der Bildunterschrift fett oder kursiv ***

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

protect_content — Flag zum Schutz des Inhalts vor Kopieren. Zum Aktivieren einen beliebigen Wert außer 0, False oder leere Anführungszeichen '' übergeben

has_spoiler — aktiviert die Spoiler-Formatierung, setzen Sie True zum Aktivieren

disable_notification — Flag zum Senden der Nachricht mit einer Tonbenachrichtigung (Standard: 0).
1 — ohne Benachrichtigung senden, 0 — mit Benachrichtigung senden

message_thread_id — Thread-ID (verfügbar in Supergruppen mit Forenfunktion)

entities — Mit diesem Parameter können Sie einfach formatierten Text mit all seinen Eigenschaften kopieren und angeben, ab welchem Zeichen bis zu welchem Zeichen er mit einem bestimmten Stil angezeigt wird. Ein Beispiel finden Sie in tg_request im entsprechenden Feld. Der Parameter sollte ein Dictionary sein.

show_caption_above_media - Wenn auf True gesetzt, wird der Nachrichtentext über dem Medium angezeigt

Beispiel für das Senden des Parameters:
entities = [{"offset":0,"length":5,"type":"bold"},{"offset":6,"length":4,"type":"text_link","url":"https://salebot.zmservice.ru"},{"offset":11,"length":9,"type":"strikethrough"},{"offset":21,"length":6,"type":"spoiler"},{"offset":29,"length":12,"type":"code"}]

In diesem Beispiel wird nur das Dictionary gezeigt, während der Nachrichtentext selbst in einer Variable gespeichert ist

Um die Beschreibungen von Schaltflächensätzen zu vereinfachen, können Sie den folgenden Lifehack verwenden

! Das Foto sollte nicht größer als 10 MB sein. Die Gesamtbreite und -höhe sollten 10.000 Pixel nicht überschreiten. Das Breiten-Höhen-Verhältnis sollte 20 nicht überschreiten.

! Arbeiten mit Telegram Business - Konto

tg_send_some_photo(platform_id, image_list, disable_notification=0, protect_content=False, reply_to_message_id=0, has_spoiler=False,message_thread_id)

Parameter:

! platform_id — Telegram-Client-ID, an das die Nachricht gesendet werden soll *

! image_list - Array von Bilddateien (Details unten)

disable_notification — Flag zum Senden der Nachricht mit einer Tonbenachrichtigung (Standard: 0).
1 — ohne Benachrichtigung senden, 0 — mit Benachrichtigung senden

protect_content — Flag zum Schutz des Inhalts vor Kopieren (optionaler Parameter, zum Aktivieren 1 als Wert übergeben)

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

has_spoiler — aktiviert die Spoiler-Formatierung (optional; setzen Sie True zum Aktivieren)

message_thread_id — Thread-ID (verfügbar in Supergruppen mit Forenfunktion)

Beispiel image_list:

'[["Bildlink 1", "Bildunterschrift", "parse_mode"], ["Bildlink 2"], ["Bildlink 3", "Bildunterschrift"]]'

Datenbeispiel für ein einzelnes Bild:
["Bildlink 1", "Bildunterschrift", "parse_mode"]

Die Reihenfolge der Parameter ist wichtig! Beim Erstellen des Arrays von Bilddateien können Anführungszeichen "" weggelassen werden

Parameterbeschreibung:

! Bildlink 1 - Bildlink. Wie man einen Link über tg_request erhält, wird hier erklärt

Bildunterschrift — Bildunterschrift bis zu 1024 Zeichen

parse_mode — Textformatierung in der Bildunterschrift fett oder kursiv ***

Schauen wir uns ein Beispiel für eine Funktion zum Senden mehrerer Bilder an:

Erstellen Sie zunächst ein Bild-Array

Füllen Sie als Nächstes die Funktionsparameter aus

Senden Sie den Block an sich selbst und genießen Sie das Ergebnis

Denken Sie daran, dass Links für jeden Bot einzigartig sind. Stellen Sie daher sicher, dass Sie Ihre eigenen Links für das Video generieren

image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)

tg_send_dice(platform_id, emoji, reply_markup, disable_notification, reply_to_message_id, protect_content, message_thread_id)

! Arbeit mit Telegram Business - Konto

Parameter:

! platform_id — Telegram-Client-ID, an die die Nachricht gesendet werden soll *

emoji - das zu sendende Emoji. Wenn Sie den Parameter leer lassen, wird standardmäßig ein Würfel gesendet. Sie können entweder das Emoji selbst als Zeichenfolge oder das Schlüsselwort, das es darstellt, übergeben

reply_markup — Tasteneinstellungen **

disable_notification — Flag zum Senden der Nachricht mit einer Tonbenachrichtigung (Standard: 0).
1 — ohne Benachrichtigung senden, 0 — mit Benachrichtigung senden

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

protect_content — Flag zum Schutz des Inhalts vor dem Kopieren. Zum Aktivieren übergeben Sie einen beliebigen Wert außer 0, False oder leere Anführungszeichen ''

message_thread_id — Thread-ID (verfügbar in Supergruppen mit Forenfunktionalität)

Um die Beschreibung der Tasteneinstellungen zu vereinfachen, können Sie den folgenden Lifehack verwenden

Mögliche Emoji-Liste: \

1. 'darts' oder '🎯', Werte von 1 bis 6 \
2. 'dice' oder '🎲', Werte von 1 bis 6 \
3. 'bowling' oder '🎳', Werte von 1 bis 6 \
4. 'basketball' oder '🏀', Werte von 1 bis 5 \
5. 'football' oder '⚽', Werte von 1 bis 5 \
6. 'slots' oder '🎰', Werte von 1 bis 64

Wenn ein Client eines dieser Emojis an den Bot sendet, erhalten Sie außerdem einen Callback mit Informationen über die Punktzahl und welches Emoji verwendet wurde.

Die einfachste Option ist, die Funktion mit nur einem erforderlichen Parameter aufzurufen:

In diesem Fall erhält der Client einen Würfel:

Wenn der Client den Würfel wirft (durch Klicken auf das erhaltene Emoji), erhält der Bot einen Callback mit der Anzahl der geworfenen Punkte:

Sie können mit dieser Funktion experimentieren. Erstellen wir zum Beispiel einen Spielautomaten und fügen eine Punkte-Schaltfläche hinzu. Wenn die Schaltfläche gedrückt wird, erhalten wir die Gesamtpunktzahl des Clients:

Erstes Beispiel:

soob=tg_send_dice(platform_id)

Zweites Beispiel:

/* Erstes Beispiel */
tg_send_message(platform_id,'Klicken Sie auf den Spielautomaten, um Ihr Glück zu versuchen!')
opts='{"inline_keyboard": [[{"text": " 👓 ","callback_data":"Play"}]]}'
soob=tg_send_dice(platform_id, 'slots', opts)

/* Zweiter Block - Textnachricht */
 #{res[1]} Punkte geworfen
/* Zweiter Block - Rechner */
res=splitter('#{question}', ' ')
balls=if(balls==None,0,balls) + int(res[1])

/* Dritter Block - Textnachricht */
Sie haben insgesamt #{balls} Punkte

! Arbeit mit Telegram Business - Konto

Eine Methode zum Senden einer Gruppe von Fotos, Videos, Dokumenten oder Audiodateien als Album. Bei Erfolg wird ein Array der gesendeten Dateien zurückgegeben.

Hinweis: Dokumente und Audiodateien können nicht mit anderen Dateitypen gruppiert werden!

tg_send_media_group(platform_id, media_list, disable_notification, protect_content, reply_to_message_id, message_thread_id)

Parameter:

! platform_id — Telegram-Client-ID, an die die Nachricht gesendet werden soll

! media_list - ein Array, das 2 bis 10 Fotos, Videos, Dokumente oder Audiodateien enthält (Details unten);

disable_notification — Flag zum Senden der Nachricht mit einer Tonbenachrichtigung (Standard: 0).
1 — ohne Benachrichtigung senden, 0 — mit Benachrichtigung senden

protect_content — Flag zum Schutz des Inhalts vor dem Kopieren. Zum Aktivieren übergeben Sie einen beliebigen Wert außer 0, False oder leere Anführungszeichen ''

reply_to_message_id - ID der Nachricht, auf die geantwortet werden soll (d. h. Zitat)

message_thread_id — Thread-ID (verfügbar in Supergruppen mit Forenfunktionalität);

Inhalt der Elemente des media_list-Arrays:

! type - Dateityp, „photo“, „video“, „audio“ oder „document“

! media - zu sendende Datei. Übergeben Sie eine file_id, um eine Datei zu senden, die bereits auf den Telegram-Servern vorhanden ist (empfohlen), eine HTTP-URL, damit Telegram die Datei aus dem Internet abruft, oder «attach://<file_attach_name>», um eine neue Datei mit multipart/form-data unter dem Namen <file_attach_name> hochzuladen.

Lesen Sie mehr: https://core.telegram.org/bots/api#sending-files

caption — Titel der sendenden Datei, 0–1024 Zeichen.

parse_mode — Textformatierung in der Beschriftung fett oder kursiv

Lesen Sie mehr: https://core.telegram.org/bots/api#sending-files

Beispiel für ein media_list-Array:

[{"type": "photo", "media": "AgACAgIAAxkBAAIKa2W6HqQG151EaWOKnCyy8feBi8p_AAIH1zEbicvYSfi2QYj-CMreAQADAgADeAADNAQ", "caption": "Geistervideo"}, {"type": "video", "media": "BAACAgIAAxkBAAIKpGW6P_HGDoVz7u4blDF6925WO-hmAALVPQACicvYSYwIWCJKwKIWNAQ", “caption”: “Hasenvideo”}]

Schauen wir uns ein Beispiel für eine Funktion zum Senden mehrerer Bilder an:

Erstellen Sie zunächst ein Bildarray

Füllen Sie als Nächstes die Funktionsparameter aus

Senden Sie den Block an sich selbst und genießen Sie das Ergebnis

Denken Sie daran, dass Links für jeden Bot einzigartig sind. Stellen Sie daher sicher, dass Sie Ihre eigenen Links für das Video generieren

image_list='[["https://faktoria-print.ru/wp-content/uploads/2022/07/syre-dlya-bumagi.jpg"], ["https://www.solbum.ru/upload/medialibrary/2d1/2d18bd473d50fe9c2fe6a1eb401b4fe3.JPG"], ["https://www.solbum.ru/upload/medialibrary/bb7/bb786b67b57d9ab44ef5f7b8400810bb.jpg"], ["https://obumage.net/wp-content/uploads/2017/05/tual_bumaga.jpg"]]'
soob=tg_send_some_photo(platform_id, image_list)

In Telegram (sowohl für Geschäftskonten als auch für normale Konten) können Sie Anhänge über einen Link senden:

1. Sie können Anhänge jeder Größe senden und dabei die Dateigrößenbeschränkungen umgehen.
2. Sie können auch jeden beliebigen Anhangstyp senden, den Sie benötigen.

So geht's:

Kopieren Sie den Link zu einem Anhang, der bereits öffentlich zugänglich ist:

Fügen Sie dann den kopierten Link in die Anhangs-Funktion in Ihrem Block ein:

Fertig. Auf diese Weise können Sie Anhänge jeden Typs und jeder Größe senden.