Zum Inhalt

Telegram-Bot-Integration

In dieser Anleitung wird erklärt, wie Sie Ihren Telegram-Bot mit dem Panel „chat.smsbat.com“ verbinden.

1. Den Bot zum Panel hinzufügen

Navigieren Sie im Dashboard zu Meine Konten -> Telegram-Bots.

  1. Klicken Sie auf Bot hinzufügen.
  2. Geben Sie die Telegram-Bot-Daten (Name, Token) ein und speichern Sie sie im System.
  3. Gehen Sie nach dem Speichern zu den Bot-Einstellungen und rufen Sie dessen ID ab, um die Rückruf-URL zu formulieren.

2. Integrationsoptionen mit Chat.SMSBAT

Option 2.1: Rückrufe von Telegram an Omni Chat weiterleiten

In diesem Ablauf empfängt Ihr Server den Telegram-Webhook direkt und leitet die Nutzlast dann an SMSBAT weiter.

sequenceDiagram
    participant Client as Client Server
    participant Tg as Telegram
    participant Proxy as SMSBAT Proxy
    participant Chat as Omni Chat
    actor Operator

    Client->>Tg: Send data to bot
    Tg->>Client: Callback from Telegram
    Client->>Proxy: Forward Telegram callback to SMSBAT
    Proxy->>Chat: Reaction to trigger message
    Operator->>Chat: Review and respond
    Chat->>Tg: Interaction with Telegram

Anforderungen: – Stellen Sie sicher, dass das Clientsystem die eingehenden Rückrufe direkt an den Webhook „chat.smsbat.com“ weiterleitet. - Geben Sie den genauen Text/die genaue Aktion der Schaltfläche „Chat starten“ an. - Geben Sie den genauen Text/die genaue Aktion der Schaltfläche „Chat beenden“ an.

Option 2.2: Proxy-Logik zurück zum Client

In diesem Ablauf wird SMSBAT als direkter Webhook in Telegram festgelegt. SMSBAT empfängt das Ereignis und leitet den Rückruf dann per Proxy an Ihr System zurück.

sequenceDiagram
    participant Client as Client Server
    participant Tg as Telegram
    participant Proxy as SMSBAT Proxy
    participant Chat as Omni Chat
    actor Operator

    Client->>Tg: Send data to bot
    Tg->>Proxy: Callback on events from Telegram
    Proxy->>Client: Forward Telegram callback to Client
    Proxy->>Chat: Reaction to trigger message
    Operator->>Chat: Review and respond
    Chat->>Tg: Operator interaction with Telegram

Anforderungen: – Geben Sie die generierte Rückruf-URL an, die nach dem Hinzufügen des Bots formuliert wurde. Die URL sieht folgendermaßen aus: https://restapi.smsbat.com/api/tg_callback/{ID} - Geben Sie den genauen Text/die genaue Aktion der Schaltfläche „Chat starten“ an. - Geben Sie den genauen Text/die genaue Aktion der Schaltfläche „Chat beenden“ an.