Telegram-Chat- und Messenger-Einstellungen

tg_set_group_title(platform_id, title)

Ändert den Titel einer Telegram-Gruppe.

Parameter

tg_set_chat_description(platform_id, description)

Ändert die Beschreibung eines Telegram-Chats.

Parameter

tg_set_chat_photo(platform_id, photo)

Legt ein neues Profilfoto für einen Telegram-Chat fest.

Parameter

tg_delete_chat_photo(platform_id)

Entfernt das aktuelle Profilfoto aus einem Telegram-Chat.

Parameter

tg_ban_chat_sender_chat(platform_id, sender_chat_id)

Sperrt einen Absender-Chat, sodass er keine Nachrichten in einem Telegram-Chat posten kann.

Parameter

Hinweis

Nach der Sperrung kann der Besitzer des Absender-Chats keine Nachrichten mehr im Namen dieses Chats im angegebenen Telegram-Chat posten, bis die Sperre aufgehoben wird.

Gleichzeitig kann der Besitzer des gesperrten Chats nicht im Namen seiner/ihrer anderen Chats schreiben, bis er/sie gesperrt ist.

tg_unban_chat_sender_chat(platform_id, sender_chat_id)

Entsperrt einen zuvor gesperrten Absender-Chat in einem Telegram-Chat.

Parameter

tg_create_chat_invite_link(platform_id, member_limit, hours, request, name)

Erstellt einen neuen Einladungslink für einen Telegram-Chat.

Parameter

Wichtig

Wenn der Parameter member_limit angegeben ist, wird der Parameter request automatisch auf False gesetzt.

Um von Benutzern die Einreichung von Beitrittsanfragen zu verlangen, lassen Sie den Parameter member_limit leer.

Bei Übergabe des Parameters member_limit wird der Wert des Parameters request automatisch auf False geändert. Wenn Sie Beitrittsanträge annehmen müssen, lassen Sie den Parameter member_limit leer.

Einladungslink für Chat erstellen

tg_revoke_chat_invite_link(platform_id, invite_link)

Widerruft einen vorhandenen Einladungslink für einen Telegram-Chat.

Parameter

tg_export_chat_link(platform_id)

Erstellt einen neuen primären Einladungslink für einen Telegram-Chat.

Parameter

Warnung

Diese Methode generiert einen neuen primären Einladungslink für den Chat.

Alle zuvor generierten primären Einladungslinks werden inaktiv. Der neu generierte Link ist der einzige aktive primäre Einladungslink, bis zusätzliche Einladungslinks erstellt werden.

Verwenden Sie diese Methode mit Vorsicht.

tg_approve_chat_join_request(chat_id, user_id)

Genehmigt eine ausstehende Beitrittsanfrage für eine Telegram-Gruppe oder einen Kanal.

Parameter

Anfrageannahme:

tg_decline_chat_join_request(chat_id, user_id)

Lehnt eine ausstehende Beitrittsanfrage für eine Telegram-Gruppe oder einen Kanal ab.

Parameter

tg_ban_chat_member(chat_id, user_id, hours)

Sperrt einen Benutzer aus einem Telegram-Chat.

Parameter

Hinweis

Wenn der Stunden-Wert 366 Tage überschreitet, wird der Benutzer dauerhaft gesperrt.

tg_unban_chat_member(chat_id, user_id)

Entsperrt einen Benutzer in einem Telegram-Chat.

Parameter

tg_get_chat_member(chat_id, user_id)

Ruft Informationen über den Mitgliedschaftsstatus eines Benutzers in einem Telegram-Chat ab.

Parameter

tg_get_chat_member_count(platform_id)

Gibt die Gesamtzahl der Mitglieder in einem Telegram-Chat zurück.

Parameter

some_client_in_list(list_id, recepient)

Überprüft, ob ein Telegram-Benutzer in der angegebenen Liste enthalten ist.

Parameter

tg_send_chat_action(platform_id, bot_action, message_thread_id)

Sendet eine Chat-Aktion (wie Tippen oder Hochladen einer Datei) an einen Telegram-Chat.

Parameter

Hinweis

Diese Funktion wird bei der Arbeit mit Telegram Business-Konten unterstützt.

typing für Textnachrichten,
&#xNAN;upload_photo für Fotos,
&#xNAN;record_video oder upload_video für Videos,
&#xNAN;record_voice oder upload_voice für Sprachnotizen,
&#xNAN;upload_document für allgemeine Dokumente,
&#xNAN;choose_sticker für Sticker,
&#xNAN;find_location für Standortdaten,
&#xNAN;record_video_note oder upload_video_note für Video-Notizen.

tg_answer_callback_query(callback_query_id, text, show_alert, cache_time)

Sendet eine Antwort auf eine Callback-Abfrage, die ausgelöst wird, wenn ein Benutzer in Telegram auf eine Inline-Schaltfläche klickt.

Parameter

Wichtig

Diese Funktion kann nur als Reaktion auf einen Klick eines Benutzers auf eine Inline-Callback-Schaltfläche in Telegram verwendet werden.

Beispiel

Die folgende Inline-Tastatur sendet unterschiedliche Callback-Werte, wenn auf jede Schaltfläche geklickt wird:

[{"line":0,"index_in_line":0,"text":"111","type":"inline","callback":"first"}, {"line":1,"index_in_line":0,"text":"222","type":"inline","callback":"second"}, {"line":2,"index_in_line":0,"text":"333","type":"inline","callback":"third"}]

Nach dem Klicken auf eine Schaltfläche kommt ein Callback mit dem Text an, der im entsprechenden Feld enthalten ist. Wenn Sie auf die Schaltfläche „111“ klicken, erhalten Sie einen Callback mit dem Text „first“.

Erstellen wir einen Start-Block und geben den gewünschten Text im Trigger an. In unserem Fall: "first"

Wenn Sie im Feld Übereinstimmungen die Option Fehler und Ungenauigkeiten ignorieren auswählen, kann dieser Block später für alle ähnlichen Varianten wiederverwendet werden, die sich um 1–2 Zeichen unterscheiden. Zum Beispiel, um dem Benutzer für die Abgabe einer Bewertung mit einer solchen Schaltfläche zu danken.

Als nächstes verwenden Sie im Rechner die Funktion tg_answer_callback_query und übergeben die folgenden Parameter:
callback_query_id - Diese ID ermöglicht es Ihnen, den Benutzer zu identifizieren, der die Schaltfläche gedrückt hat, und ihm eine Alert-Benachrichtigung anzuzeigen
text - Text der Alert-Benachrichtigung.

Codebeispiel zum Kopieren:

tg_answer_callback_query('#{callback_query_id}', "Sie haben die Schaltfläche 111 gedrückt")

Beachten Sie! Der Parameter callback_query_id sollte genau wie im Beispiel gezeigt übergeben werden, d.h. innerhalb von '#{}'

Wenn alles richtig eingerichtet ist, führt das Drücken der Schaltfläche zu einer Alert-Benachrichtigung mit dem angegebenen Text. In der mobilen Version wird der Name des Bots als Kopfzeile über dem Text angezeigt.

Wenn Sie stattdessen eine einfache Popup-Nachricht anzeigen möchten, übergeben Sie False als dritten Parameter, wie im folgenden Beispiel gezeigt:
tg_answer_callback_query('#{callback_query_id}', "Sie haben die Schaltfläche 222 gedrückt", False)

tg_callback_url_open(callback_query_id, url, cache_time)

Öffnet einen Telegram-Bot über einen Deep Link als Reaktion auf einen Inline-Button-Callback.

Parameter

Wichtig

Diese Funktion kann nur als Reaktion auf einen Klick eines Benutzers auf eine Inline-Callback-Schaltfläche in Telegram verwendet werden.

In der Callback-Schaltflächenantwort können Sie einen Übergang zum Bot mit dem Tag tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX') hinzufügen.

Verwenden wir zum Beispiel die folgenden Schaltflächen:

[{"line":0,"index_in_line":0,"text":"111","type":"inline","callback":"first"}, {"line":1,"index_in_line":0,"text":"222","type":"inline","callback":"second"}, {"line":2,"index_in_line":0,"text":"333","type":"inline","callback":"third"}]

Nach dem Klicken auf eine Schaltfläche kommt ein Callback mit dem Text an, der im entsprechenden Feld enthalten ist. Wenn Sie auf die Schaltfläche „111“ klicken, erhalten Sie einen Callback mit dem Text „first“.

Erstellen Sie einen Block mit einer primären Bedingungsprüfung und geben Sie den gewünschten Text in der Bedingung an. In unserem Fall: „first“:

Wenn Sie im Feld Übereinstimmungsoption die Option Fehler und Ungenauigkeiten ignorieren auswählen, kann dieser Block später für alle ähnlichen Varianten wiederverwendet werden, die sich um 1–2 Zeichen unterscheiden. Zum Beispiel, um dem Benutzer für die Abgabe einer Bewertung mit einer solchen Schaltfläche zu danken.

Geben Sie als nächstes im Rechner des Blocks tg_callback_url_open('#{callback_query_id}', 't.me/bot_name?start=XXXX') an:

tg_promote_user(platform_id, user_id, promote_options_list)

Befördert einen Telegram-Benutzer mit den angegebenen Berechtigungen zum Administrator in einer Supergruppe oder einem Kanal.

Parameter

Hinweis

Nur die in promote_options_list enthaltenen Berechtigungen werden dem Benutzer gewährt.

Die folgenden Berechtigungen können in der promote_options_list angegeben werden:

1. is_anonymous — verbirgt die Anwesenheit des Administrators im Chat,
2. can_manage_chat — der Administrator kann auf das Chat-Ereignisprotokoll, Chat-Statistiken, Nachrichtenstatistiken in Kanälen zugreifen, Kanalmitglieder anzeigen, anonyme Administratoren in Supergruppen anzeigen und den Slow-Mode umgehen. Diese Berechtigungsstufe wird standardmäßig gewährt, wenn eines der folgenden Privilegien angegeben wird
3. can_post_messages — der Administrator kann Kanalbeiträge erstellen (nur Kanäle)
4. can_edit_messages — der Administrator kann Nachrichten anderer Benutzer bearbeiten und Nachrichten anheften (nur Kanäle)
5. can_delete_messages — der Administrator kann Nachrichten anderer Benutzer löschen
6. can_manage_video_chats — der Administrator kann Video-Chats verwalten,
7. can_restrict_members — der Administrator kann Mitglieder einschränken, sie im Chat sperren/entsperren,
8. can_promote_members — der Administrator kann neue Administratoren mit einer Teilmenge seiner eigenen Privilegien ernennen oder Administratoren degradieren, die er direkt oder indirekt ernannt hat (z. B. von ihm ernannte Administratoren)
9. can_change_info — der Administrator kann den Chat-Titel, das Foto und andere Einstellungen ändern
10. can_invite_users — der Administrator kann neue Benutzer zum Chat einladen
11. can_pin_messages — der Administrator kann Nachrichten anheften (nur Supergruppen).

Beispiel: Beförderung eines Benutzers zum Administrator in einer Supergruppe:

In diesem Beispiel wird zusätzlich zu den angegebenen Berechtigungen standardmäßig die Berechtigung can_manage_chat gewährt.

Codebeispiel zum Kopieren

Beispiel 1. 
promote_options_list = '["can_promote_members","can_change_info","can_invite_users"]' 
tg_promote_user(platform_id, user_id, promote_options_list)

Beispiel 2. 
promote_options_list = '["can_manage_chat","can_post_messages","can_edit_messages","can_delete_messages","can_manage_video_chats","can_promote_members","can_restrict_members","can_invite_users","can_pin_messages"]' 
result=tg_promote_user(platform_id, reply_from, promote_options_list)  

tg_set_administrator_title(platform_id, user_id, title)

Legt einen benutzerdefinierten Administrator-Titel für einen Telegram-Supergruppen-Administrator fest.

Parameter

Wichtig

• Der Titel muss zwischen 0 und 16 Zeichen lang sein.
• Emojis sind im Titel nicht erlaubt.
• Diese Funktion funktioniert nur für Administratoren, die vom Bot befördert wurden.

Beispiel

result = tg_set_administrator_title(platform_id, reply_from, "firetitle")

tg_chat_permission(platform_id, permission, media_permissions)

Legt die Standardberechtigungen für Mitglieder in einem Telegram-Chat fest.

Parameter

Hinweis

Die Reihenfolge der Werte in beiden Arrays muss mit der Reihenfolge der entsprechenden Berechtigungslisten übereinstimmen. Jedes Array-Element steuert eine bestimmte Berechtigung:

• 1 — Berechtigung wird gewährt.
• 0 — Berechtigung wird verweigert.

Liste der Einschränkungen für permission:

1. ! can_send_messages - Berechtigung zum Senden von Textnachrichten, Kontakten, Standorten und Veranstaltungsorten.
2. ! can_send_media_messages - Berechtigung zum Senden von Audio, Dokumenten, Fotos, Videos, Video-Notizen und Sprachnotizen. Erfordert can_send_messages
3. ! can_send_polls - Berechtigung zum Senden von Umfragen. Erfordert can_send_messages
4. ! can_send_other_messages - Berechtigung zum Senden von Animationen, Spielen, Stickern und zur Verwendung von Inline-Bots. Erfordert can_send_media_messages
5. ! can_add_web_page_previews - Berechtigung zum Hinzufügen von Webseitenvorschauen zu Nachrichten. Erfordert can_send_media_messages
6. ! can_change_info - Berechtigung zum Ändern des Chat-Titels, Fotos und anderer Einstellungen. Dies wird in öffentlichen Supergruppen ignoriert.
7. ! can_invite_users - Berechtigung zum Einladen von Benutzern
8. ! can_pin_messages - Berechtigung zum Anheften von Nachrichten. Dies wird in öffentlichen Supergruppen ignoriert.
9. can_manage_topics - Berechtigung zum Erstellen von Themen in Forum-Gruppen. Bei Verwendung in einer Gruppe des falschen Typs schlägt die Funktion fehl und gibt einen Fehler zurück.

Werte zum Gewähren medienbezogener Berechtigungen media_permissions:

1. can_send_audios - Berechtigung zum Senden von Audiodateien
2. can_send_documents - Berechtigung zum Senden von Dokumenten
3. can_send_photos - Berechtigung zum Senden von Fotos
4. can_send_videos - Berechtigung zum Senden von Videos
5. can_send_video_notes - Berechtigung zum Senden von runden Video-Nachrichten
6. can_send_voice_notes - Berechtigung zum Senden von Sprachnachrichten

tg_restrict_chat_member(platform_id, user_id, minutes, permission, media_permissions).

Parameter:

Liste der Einschränkungen für permission:

1. ! can_send_messages - Berechtigung zum Senden von Textnachrichten, Kontakten, Standorten und Veranstaltungsorten.
2. ! can_send_media_messages - Berechtigung zum Senden von Audio, Dokumenten, Fotos, Videos, Video-Notizen und Sprachnotizen. Erfordert can_send_messages
3. ! can_send_polls - Berechtigung zum Senden von Umfragen. Erfordert can_send_messages
4. ! can_send_other_messages - Berechtigung zum Senden von Animationen, Spielen, Stickern und zur Verwendung von Inline-Bots. Erfordert can_send_media_messages
5. ! can_add_web_page_previews - Berechtigung zum Hinzufügen von Webseitenvorschauen zu Nachrichten. Erfordert can_send_media_messages
6. ! can_change_info - Berechtigung zum Ändern des Chat-Titels, Fotos und anderer Einstellungen. Dies wird in öffentlichen Supergruppen ignoriert.
7. ! can_invite_users - Berechtigung zum Einladen von Benutzern
8. ! can_pin_messages - Berechtigung zum Anheften von Nachrichten. Dies wird in öffentlichen Supergruppen ignoriert.
9. can_manage_topics - Berechtigung zum Erstellen von Themen in Forum-Gruppen. Bei Verwendung in einer Gruppe des falschen Typs schlägt die Funktion fehl und gibt einen Fehler zurück.

Werte zum Gewähren medienbezogener Berechtigungen media_permissions:

1. can_send_audios - Berechtigung zum Senden von Audiodateien
2. can_send_documents - Berechtigung zum Senden von Dokumenten
3. can_send_photos - Berechtigung zum Senden von Fotos
4. can_send_videos - Berechtigung zum Senden von Videos
5. can_send_video_notes - Berechtigung zum Senden von runden Video-Nachrichten
6. can_send_voice_notes - Berechtigung zum Senden von Sprachnachrichten

Beispiel für die Verwendung der Funktion, bei der der Benutzer für 3 Minuten von allem eingeschränkt wird:

Wenn der Benutzer den Chat betritt, sieht er eine Benachrichtigung, dass er im Chat keine Nachrichten senden kann.
Wenn eine Zeitbegrenzung festgelegt ist, sieht er auch die Dauer dieser Einschränkung.

Codebeispiel zum Kopieren:

permission = [0, 0, 0, 0, 0, 0, 0, 0] 
tg_restrict_chat_member(-1001607137668, 473737685, 3, permission)

tg_pin_chat_message(platform_id, message_id, disable_notification)

Pinnt eine Nachricht in einem Telegram-Chat an.

Parameter

Hinweis

Benachrichtigungen sind in Kanälen und privaten Chats immer deaktiviert, unabhängig vom Wert von disable_notification.

tg_unpin_chat_message(platform_id, message_id)

Löst eine Nachricht in einem Telegram-Chat.

Parameter

Hinweis

Wenn message_id nicht angegeben ist, löst die Funktion die neueste angepinnte Nachricht basierend auf ihrer Sendezeit.

tg_unpin_all(platform_id)

Parameter:

ACHTUNG!

Telegram hat eine Einschränkung für die Funktionen zum An-/Abpinnen von Nachrichten.

Die Zeitlimits für die Verwendung von **tg_pin_chat_message / tg_unpin_chat_message / tg_unpin_all **werden NICHT vom MaviBot-System festgelegt.

Wenn die erlaubte Zeit zum Pinnen einer Nachricht überschritten ist, gibt die Funktion trotzdem true zurück, aber Telegram wendet die Änderung nicht an.

Es ist auch wichtig zu beachten, dass angepinnte Nachrichten im Cache verbleiben können, sodass sie möglicherweise nicht sofort visuell verschwinden.

tg_send_poll(platform_id, question, options, is_anonymous, allows_multiple_answers, reply_markup, disable_notification, protect_content, token, reply_to_message_id, message_thread_id, business_connection_id)

Parameter:

Hinweise

1. Die Funktion gibt eine Antwort von Telegram mit message_id zurück. Es ist besser, diese zu speichern. Mit message_id können Sie die Umfrage mit tg_stop_poll beenden (siehe Beschreibung unten) und das Ergebnis abrufen.

2. Wenn ein Benutzer eine Umfrage in einem Messenger hinzufügt, wird ein Callback an den Chat gesendet:

poll_added - unveränderlicher Teil
IHRE FRAGE - Fragetext aus der Umfrage

Beispiel-Callback beim Hinzufügen einer Umfrage in einem Kanal

Beispiel-Callback beim Hinzufügen einer Umfrage in einem Chat

Der zweite Callback nach poll_added enthält Zahlen - dies ist nichts anderes als die Benutzer-ID in Telegram, der die Umfrage hinzugefügt hat.

Beim Erstellen einer Umfrage durch den Bot kommt kein Callback an.

3. In einem Kanal können nur anonyme Umfragen erstellt werden

Achtung, es wird empfohlen, nur anonyme Umfragen an eine Gruppe zu senden!

4. Speichern Sie nach dem Erstellen der Umfrage deren ID in einer Variable, um zu verstehen, auf welche Umfrage ein Callback eingegangen ist.

Kundenfeedback ist der Schlüssel zu unserem Wachstum. Umfragen bieten eine unkomplizierte Methode, dieses Feedback zu erfassen und in konkrete Geschäftsschlussfolgerungen zu übersetzen.

Codebeispiel zum Kopieren:

/* Beispiel zum Erstellen einer einfachen Umfrage */
options = ["white", "red", "blue", "green"]
poll1 = tg_send_poll(platform_id, 'What is your favorite color?', options, 1, '', '', 1, '')

Funktion zum Erstellen einer Umfrage in Telegram:

Die von uns erstellte Umfrage in Telegram

tg_send_quiz_poll(platform_id, question, options, explanation, correct_option_id, is_anonymous, reply_markup, parse_mode, protect_content, disable_notification, token, reply_to_message_id, message_thread_id )

Parameter:

Hinweise

1. Speichern Sie die message_id

Die API-Funktion gibt eine Telegram-Antwort zurück, die eine message_id enthält. Speichern Sie diese ID immer, da sie erforderlich ist, um:

• Das Quiz mit der Funktion tg_stop_poll zu beenden (siehe Beschreibung unten).
• Die endgültigen Ergebnisse abzurufen.

2. Callback poll_added

Wenn ein Benutzer eine Umfrage zu einem Kanal hinzufügt, erhält der Bot einen Callback:

• Format: poll_added + Umfragefrage
• Wenn zu einem Gruppenchat hinzugefügt: Der Callback enthält auch die Telegram-Benutzer-ID der Person, die die Umfrage hinzugefügt hat.

Wenn vom Bot erstellt: Es wird kein poll_added-Callback gesendet.

3. Kanaleinschränkung

In Kanälen können nur anonyme Quizze erstellt werden.

4. Callback poll_answer (Benutzerabstimmung)

Wenn ein Benutzer in einem Quiz abstimmt, das an einen privaten Chat oder eine Gruppe gesendet wurde, wird ein Callback an den Bot-Dialog mit diesem Client gesendet:

• Format: poll_answer + Umfrage-ID + [Antwortindex]
• Beispiel: poll_answer 5325838371359031648 [3]
• Hinweis: Die Antwortnummerierung beginnt bei 0. [3] bedeutet, dass der Benutzer die vierte Antwortmöglichkeit ausgewählt hat.

5. Webhook für nicht-anonyme Gruppenumfragen

Für nicht-anonyme Umfragen in Gruppen, in denen der Bot Administrator ist, wird ein Webhook für jede Stimme gesendet. Beim Empfang leitet der Bot den poll_answer-Callback (wie in Punkt 4) an seinen Dialog mit dem entsprechenden Client weiter.

6. Aktivierungsanforderung & bewährte Vorgehensweise

• Anforderung: Ein Bot kann kein Gespräch initiieren. Wenn ein Client den Bot noch nie kontaktiert hat, können Sie ihm als Reaktion auf seine Stimme keine Direktnachricht senden, bis er den Bot zuerst aktiviert (z. B. durch Senden eines /start-Befehls).

Empfehlung: Um diese Einschränkung zu vermeiden, wird dringend empfohlen, nur anonyme Quizze an Gruppen zu senden.

7. Verfolgen Sie Ihre Umfragen

Speichern Sie unmittelbar nach dem Erstellen eines Quiz dessen eindeutige Umfrage-ID in einer Variable. So können Sie identifizieren, auf welche spezifische Umfrage sich ein eingehender Callback bezieht.

Codebeispiel zum Kopieren.

options = ["white", "red", "blue", "green"] 
r = tg_send_quiz_poll(platform_id, "What color is a crocodile?", options, "That is the explanation", 4, '', '', '', '', 1)

Beispiel: Quiz-Erstellung.

tg_stop_poll(platform_id, message_id)

Parameter:

Der Aufruf dieser Funktion zum Beenden einer Umfrage/eines Quiz gibt ein Wörterbuch mit den endgültigen Ergebnissen zurück.

tg_edit_general_forum_topic(platform_id, topic_name)

Parameter:

Das allgemeine Thema der Gruppe kann mit der Funktion tg_edit_general_forum_topic() geändert werden. Sie erfordert zwei obligatorische Parameter: die Chat-ID und den neuen Namen für das Gruppenthema:

/Allgemeines Thema umbenennen/
answer = tg_edit_general_forum_topic(-1001839380031, 'General')

tg_close_general_forum_topic(platform_id)

Parameter:

/Allgemeines Thema schließen/
answer = tg_close_general_forum_topic(-1001839380031)

tg_reopen_general_forum_topic(platform_id)

Parameter:

/Allgemeines Thema wieder öffnen/
answer = tg_reopen_general_forum_topic(-1001839380031)

tg_hide_general_forum_topic(platform_id)

Parameter:

Der Chat des allgemeinen Themas kann für die Teilnehmer des Themas geschlossen werden (sie können lesen, aber nicht schreiben) und für neue Benutzer aus der allgemeinen Chat-Liste von Telegram ausgeblendet werden.

/Allgemeines Thema ausblenden/
answer = tg_hide_general_forum_topic(-1001839380031)

tg_unhide_general_forum_topic(platform_id)

Parameter:

Wichtig!

Diese Funktion öffnet das allgemeine Thema nicht wieder; sie macht es nur sichtbar.

/Allgemeines Thema anzeigen/
answer = tg_unhide_general_forum_topic(-1001839380031)

tg_create_forum_topic(platform_id, name, icon, icon_color)

Parameter:

Die eingestellte Farbe kann nicht geändert werden; die Farbe kann nur beim Erstellen des Themas zugewiesen werden.

Bei der Ausführung gibt die Funktion eine Antwort zurück, die die Parameter des neuen Themas enthält, einschließlich der Themen-ID (erforderlich für verschiedene Funktionen).

Um einen zusätzlichen Themen-Chat zu erstellen
answer = tg_create_forum_topic(-1001839380031, 'second_bot_topic', None, 7322096)

Um die ID des erstellten zusätzlichen Themen-Chats zu speichern
answer={"ok":true,"result":{"message_thread_id":254,"name":"second_bot_topic","icon_color":7322096}}/
idtema1=answer['result']['message_thread_id']

tg_edit_forum_topic(platform_id, message_thread_id, name, icon)

Parameter:

answer = tg_edit_forum_topic(-1001839380031, 254)

Ein Thema zu schließen bedeutet, es schreibgeschützt zu machen; das Schreiben in einem geschlossenen Thema ist nicht erlaubt.

tg_close_forum_topic(platform_id, message_thread_id)

Parameter:

answer = tg_close_forum_topic(-1001839380031, 254)

tg_reopen_forum_topic(platform_id, message_thread_id)

Parameter:

answer = tg_reopen_forum_topic(-1001839380031, 254)

tg_delete_forum_topic(platform_id, message_thread_id)

Parameter:

answer = tg_delete_forum_topic(-1001839380031, 254)

tg_unpin_topic_messages(platform_id, message_thread_id)

Parameter:

answer = tg_unpin_topic_messages(-1001839380031, 254)

So erhalten Sie die Liste der Emojis

tg_get_forum_icon() – diese Funktion gibt eine Liste von Emojis zurück, die als Symbole für Forenthemen verwendet werden können. Das Ergebnis muss einer Variablen zugewiesen werden, da es ein Wörterbuch zurückgibt, in dem jeder Schlüssel ein Emoji und der entsprechende Wert die eindeutige Kennung (id) des Emojis ist.

Parameter: keine.

Um die Liste der Emojis für einen Themen-Chat zu erhalten, senden Sie den Befehl an den entsprechenden Chat.

Die Funktion gibt die Emoji-Liste in ihrer Antwort zurück. Das bedeutet, dass die Variable answer ein Wörterbuch als Wert enthält.

{'📰': '5434144690511290129', '💡': '5312536423851630001', '⚡️': '5312016608254762256', '🎙': '5377544228505134960', '🔝': '5418085807791545980', '🗣': '5368697802761185083', '🆒': '5420216386448270341', '❗️': '5379748062124056162', '📝': '5357193964787081133', '📆': '5433614043006903194', '📁': '5357315181649076022', '🔎': '5309965701241379366', '📣': '5309984423003823246', '🔥': '5312241539987020022', '❤️': '5312138559556164615', '❓': '5377316857231450742', '📈': '5350305691942788490', '📉': '5350713563512052787', '💎': '5309958691854754293', '💰': '5350452584119279096', '💸': '5309929258443874898', '\U0001fa99': '5377690785674175481', '💱': '5310107765874632305', '⁉️': '5377438129928020693', '🎮': '5309950797704865693', '💻': '5350554349074391003', '📱': '5409357944619802453', '🚗': '5312322066328853156', '🏠': '5312486108309757006', '💘': '5310029292527164639', '🎉': '5310228579009699834', '‼️': '5377498341074542641', '🏆': '5312315739842026755', '🏁': '5408906741125490282', '🎬': '5368653135101310687', '🎵': '5310045076531978942', '🔞': '5420331611830886484', '📚': '5350481781306958339', '👑': '5357107601584693888', '⚽️': '5375159220280762629', '🏀': '5384327463629233871', '📺': '5350513667144163474', '👀': '5357121491508928442', '\U0001fae6': '5357185426392096577', '🍓': '5310157398516703416', '💄': '5310262535021142850', '👠': '5368741306484925109', '✈️': '5348436127038579546', '\U0001f9f3': '5357120306097956843', '🏖': '5310303848311562896', '⛅️': '5350424168615649565', '🦄': '5413625003218313783', '🛍': '5350699789551935589', '👜': '5377478880577724584', '🛒': '5431492767249342908', '🚂': '5350497316203668441', '🛥': '5350422527938141909', '🏔': '5418196338774907917', '🏕': '5350648297189023928', '🤖': '5309832892262654231', '\U0001faa9': '5350751634102166060', '🎟': '5377624166436445368', '🏴\u200d☠️': '5386395194029515402', '🗳': '5350387571199319521', '🎓': '5357419403325481346', '🔭': '5368585403467048206', '🔬': '5377580546748588396', '🎶': '5377317729109811382', '🎤': '5382003830487523366', '🕺': '5357298525765902091', '💃': '5357370526597653193', '\U0001fa96': '5357188789351490453', '💼': '5348227245599105972', '\U0001f9ea': '5411138633765757782', '👨\u200d👩\u200d👧\u200d👦': '5386435923204382258', '👶': '5377675010259297233', '🤰': '5386609083400856174', '💅': '5368808634392257474', '🏛': '5350548830041415279', '\U0001f9ee': '5355127101970194557', '🖨': '5386379624773066504', '👮\u200d♂️': '5377494501373780436', '\U0001fa7a': '5350307998340226571', '💊': '5310094636159607472', '💉': '5310139157790596888', '\U0001f9fc': '5377468357907849200', '\U0001faaa': '5418115271267197333', '🛃': '5370947704199323325', '🍽': '5350344462612570293', '🐟': '5384574037701696503', '🎨': '5310039132297242441', '🎭': '5350658016700013471', '🎩': '5357504778685392027', '🔮': '5350367161514732241', '🍹': '5350520238444126134', '🎂': '5310132165583840589', '☕️': '5350392020785437399', '🍣': '5350406176997646350', '🍔': '5350403544182694064', '🍕': '5350444672789519765', '\U0001f9a0': '5312424913615723286', '💬': '5417915203100613993', '🎄': '5312054580060625569', '🎃': '5309744892677727325'}

answer = tg_get_forum_icon()