Към съдържанието

Интеграция на Telegram Bot

Това ръководство обяснява как да свържете своя Telegram бот към панела chat.smsbat.com.

1. Добавяне на бота към панела

В таблото за управление (dashboard) отидете до Моите акаунти (My Accounts) -> Telegram bots.

  1. Кликнете върху Добавяне на бот (Add Bot).
  2. Попълнете данните за Telegram бота (име, токен) и го запазете в системата.
  3. След запазване отидете в настройките на бота и извлечете неговото ID, за да формулирате адреса за обратно извикване (callback URL).

2. Опции за интеграция с Chat.SMSBAT

Опция 2.1: Проксиране на обратни извиквания от Telegram към Omni Chat

В този процес вашият сървър получава уебхука (webhook) на Telegram директно и след това препраща полезния товар (payload) към SMSBAT.

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

    Client->>Tg: Изпращане на данни към бота
    Tg->>Client: Обратно извикване (Callback) от Telegram
    Client->>Proxy: Препращане на Telegram callback към SMSBAT
    Proxy->>Chat: Реакция за задействане (trigger) на съобщение
    Operator->>Chat: Преглед и отговор
    Chat->>Tg: Взаимодействие с Telegram

Изисквания: - Уверете се, че клиентската система препраща входящите обратни извиквания (callbacks) директно към уебхука chat.smsbat.com. - Предоставете точния текст/действие на бутона "Стартиране на чат" (Start Chat). - Предоставете точния текст/действие на бутона "Край на чата" (End Chat).

Опция 2.2: Проксирана логика обратно към клиента

При този поток SMSBAT е зададен като директен webhook в Telegram. SMSBAT получава събитието (event) и след това пренасочва (proxies) обратното извикване (callback) обратно към вашата система.

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

    Client->>Tg: Изпращане на данни към бота
    Tg->>Proxy: Обратно извикване при събития от Telegram
    Proxy->>Client: Препращане на Telegram callback към клиента
    Proxy->>Chat: Реакция за задействане (trigger) на съобщение
    Operator->>Chat: Преглед и отговор
    Chat->>Tg: Взаимодействие на оператор с Telegram

Изисквания: - Предоставете генерирания URL за обратно извикване (callback), формулиран след добавянето на бота. URL адресът ще изглежда така: https://restapi.smsbat.com/api/tg_callback/{ID} - Предоставете точния текст/действие на бутона "Стартиране на чат" (Start Chat). - Предоставете точния текст/действие на бутона "Край на чата" (End Chat).