Chatbot für ein Telegram Business-Konto

Sie können jetzt persönliche Geschäftsassistenten erstellen – spezielle Bots, die direkt in einzelne Telegram-Chats integriert werden. Diese Bots verarbeiten eingehende Anfragen automatisch und antworten im Namen des Kontoinhabers, wodurch der Zeitaufwand für Routineaufgaben drastisch reduziert und die Kommunikationseffizienz verbessert wird.

Anwendungsfälle:
Diese Assistenten können für verschiedene Zwecke konfiguriert werden, z. B.:

Bereitstellung von Produkt- oder Serviceberatungen.
Beantwortung häufig gestellter Fragen.
Durchführung einer Vielzahl anderer automatisierter Aufgaben.

Hauptmerkmal: nahtlose Kontrolle

Ein Benutzer kann jederzeit sofort zur manuellen Kommunikation zurückwechseln, ohne den Betrieb des Bots zu unterbrechen oder zu deaktivieren, was eine vollständige Kontrolle über den Chat gewährleistet.

Achtung!

Telegram Business-Konto hat ein 24-Stunden-Fenster.

Sobald ein Benutzer seine erste Nachricht sendet, hat der Bot ein 24-Stunden-Fenster, um zu antworten und das Gespräch fortzusetzen. Dieses Fenster wird jedes Mal zurückgesetzt, wenn der Benutzer antwortet.

Wenn der Benutzer antwortet: Das 24-Stunden-Fenster startet neu, was einen kontinuierlichen Dialog ermöglicht.

Wenn der Benutzer NICHT innerhalb von 24 Stunden antwortet: Das Fenster schließt sich. Der Bot wird daran gehindert, weitere Nachrichten zu senden, bis der Benutzer eine neue Nachricht sendet, um den Kontakt wiederherzustellen.

Den Bot verbinden

Schritt 1. Einrichtung im Bereich Messenger.

Wenn Sie zum ersten Mal einen Telegram-Bot verbinden.

Gehen Sie zunächst zum Tab „Kanäle“ im Bereich Mavibot, um den Telegram-Chatbot zu verbinden (falls noch nicht vorhanden).

Als nächstes verbinden wir den Telegram-Bot gemäß der Anleitung.

Wenn Telegram bereits verbunden ist.

Falls Sie bereits einen verbundenen Telegram-Bot haben, finden Sie diesen Bot in den Kanälen:

Klicken Sie dann auf die Einstellungsschaltfläche, woraufhin ein modales Fenster mit Token-Feldern usw. angezeigt wird:

Klicken Sie im geöffneten modalen Fenster auf FERTIG, um die Einstellungen Ihres Telegram-Bots zu aktualisieren (Sie müssen keine weiteren Einstellungen ändern):

An diesem Punkt ist die Arbeit mit den Kanälen abgeschlossen. Gehen Sie zu den Messenger-Einstellungen.

Schritt 2. Messenger-Einstellungen.

Um den Telegram-Chatbot mit Ihrem Geschäftskonto zu verbinden, gehen Sie zu Ihren Profileinstellungen, wo Sie den Tab „Telegram Business“ finden:

Als nächstes sehen Sie den Tab „Chatbots“, den Sie aufrufen müssen:

Geben Sie dann im neu geöffneten Tab den Link zum gewünschten Telegram-Bot oder seinen Benutzernamen ein (die Eingabe des Links wird bevorzugt).

Setzen Sie im selben Tab die Berechtigung (Kontrollkästchen „Auf Nachrichten antworten“) für den Chatbot, um auf Nachrichten zu antworten.

An diesem Punkt ist die Einrichtung des Chatbots im Geschäftskonto abgeschlossen. Fahren Sie fort.

Schritt 3. BotFather-Einstellungen.

Nachdem Sie den Chatbot mit dem Geschäftskonto verknüpft haben, müssen Sie die Einstellungen des Chatbots in BotFather aktualisieren, wo Sie ursprünglich den Telegram-Bot erstellt haben.

Öffnen Sie dazu den Chat mit BotFather und aktivieren Sie die Arbeit mit dem Geschäftskonto:

Gehen Sie zu den Bot-Einstellungen:

Klicken Sie dann auf die Schaltfläche „Business Mode“, um den Geschäftsmodus für den Chatbot zu aktivieren:

Fertig! Alle erforderlichen Chatbot-Einstellungen mit einem Geschäftskonto wurden abgeschlossen.

Jetzt finden Sie in den Kanaleinstellungen den Telegram-Bot und sehen die Geschäfts-ID sowie den Namen des Geschäftskontoinhabers:

Deaktivieren

Um den Chatbot mit Geschäftsmodus zu deaktivieren, gehen Sie zu den Kanälen und suchen Sie den Chatbot, in dem Sie diese Einstellung deaktivieren möchten. Klicken Sie auf die Einstellungsschaltfläche:

Klicken Sie auf die Schaltfläche „Geschäftskonto deaktivieren“.

Wenn Sie Ihr Geschäftskonto deaktivieren, arbeitet der Chatbot im Standardmodus weiter.

Verfügbare Funktionen

(API) Funktion im Rechner:

tg_callback(platform_id , callback_message,group_id, tg_business)

Parameter:

! platform_id - Telegram-Client-ID

! callback_message - Rückrufnachricht

group_id - Telegram-Bot-ID

tg_business - für die Arbeit mit Geschäftskunden, nimmt den Wert „1“ an.

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:

! platform_id - Chatkennung innerhalb von Telegram *

! question - Frage

! options - Array von Antwortmöglichkeiten

is_anonymous - 1 - anonyme Umfrage, '' - nicht anonym

allows_multiple_answers - 1 - Mehrfachantworten erlaubt, '' - nur Einzelantwort

reply_markup - Tastatur oder '' - keine Tastatur

disable_notification — Flag zum Senden ohne Tonbenachrichtigung (Standard 0); 1 - leise senden, 0 - mit Benachrichtigung senden

protect_content - 1 - vor Kopieren und Screenshots schützen, '' - kein Schutz

token - Bot-Token; wenn nicht angegeben, wird das aktuelle verwendet

reply_to_message_id - ID der zitierten Nachricht

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

business_connection_id -verwendeter Wert beim Verbinden eines Bots (Geschäfts-ID, in Kanälen angezeigt); sollte übergeben werden, wenn das Bot-Token bereitgestellt wird und die Nachricht über das mit dem Bot verknüpfte Benutzerkonto gesendet werden muss

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 )

! platform_id - Chatkennung innerhalb von Telegram *

! question - Frage

! options - Array von Antwortmöglichkeiten

! explanation - Text, der angezeigt wird, wenn der Benutzer eine falsche Antwort auswählt oder auf das Glühbirnensymbol in einer Quiz-Umfrage tippt; 0–200 Zeichen, mit nicht mehr als zwei Zeilenumbrüchen nach der Entitätsanalyse.

! correct_option_id - Nummer der richtigen Antwort, beginnend mit 1.

is_anonymous -1 - anonyme Umfrage, '' - nicht anonym

reply_markup - Tastatur oder '' - keine Tastatur

parse_mode - Markdown oder HTML für explanation, oder '' für keine Formatierung.

protect_content - 1 vor Kopieren und Screenshots schützen, '' - kein Schutz.

disable_notification — Flag zum Senden ohne Tonbenachrichtigung (Standard 0); 1 - leise senden, 0 - mit Benachrichtigung senden

token - Bot-Token; wenn nicht angegeben, wird das aktuelle verwendet.

reply_to_message_id - ID der zitierten Nachricht

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

open_period - Zeit, die für die Beantwortung des Quiz/Tests erlaubt ist; numerischer Wert von 5 bis 600, in Sekunden.

business_connection_id - verwendeter Wert beim Verbinden eines Bots (Geschäfts-ID, in Kanälen angezeigt); sollte übergeben werden, wenn das Bot-Token bereitgestellt wird und die Nachricht über das mit dem Bot verknüpfte Benutzerkonto gesendet werden muss

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:

! token — Telegram-Bot-Token von BotFather

! platform_id — Kennung des Telegram-Clients, an den die Nachricht gesendet werden soll *

! text - Nachrichtentext

client_message_id - ID der zitierten Nachricht

reply_markup — Tastatureinstellungen **

parse_mode — Textformatierungsmodus für fett oder kursiv in der Nachrichtenbeschreibung ***. mögliche Werte: html, markdown, markdownV2

disable_web_page_preview - ob eine Linkvorschau angezeigt werden soll; setzen Sie 1 zum Deaktivieren, andernfalls 0 oder leer lassen ("")

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

disable_notification — Flag zum Senden ohne Tonbenachrichtigung (Standard 0); 1 - leise senden, 0 - mit Benachrichtigung senden

message_thread_id — Thread-Kennung (verfügbar in Supergruppen mit Forenfunktionalität) entities — ermöglicht das Kopieren von vorformatiertem Text mit allen Formatierungen; geben Sie Zeichenbereiche für jeden Formatierungsstil an. Ein Beispiel finden Sie im Feld tg_request. Der Parameter muss ein Wörterbuch enthalten.

business_connection_id - verwendeter Wert beim Verbinden eines Bots (Geschäfts-ID, in Kanälen angezeigt); sollte übergeben werden, wenn das Bot-Token bereitgestellt wird und die Nachricht über das mit dem Bot verknüpfte Benutzerkonto gesendet werden muss

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"}]

Im Beispiel wird nur das Wörterbuch gezeigt, während der Nachrichtentext selbst in einer separaten Variable definiert ist.