Перейти до змісту

Інтеграція Telegram-бота

Ця інструкція пояснює, як підключити власного Telegram-бота до панелі оператора chat.smsbat.com.

1. Додавання бота до панелі

В панелі перейдіть у розділ My Accounts -> Telegram bots.

  1. Натисніть кнопку додавання бота.
  2. Заповніть дані Telegram-бота (ім'я, токен) та збережіть їх у системі.
  3. По завершенню перейдіть у налаштування бота і скопіюйте його ID, щоб сформувати посилання для Callback.

2. Варіанти інтеграції з Chat.SMSBAT

2.1. Відправка колбеків від Telegram безпосередньо в Omni Chat

У цьому варіанті ваш сервер отримує вебхуки безпосередньо від Telegram, а потім самостійно пересилає їх (проксіює) у SMSBAT.

sequenceDiagram
    participant Client as Клієнт
    participant Tg as Telegram
    participant Proxy as SMSBAT Proxy
    participant Chat as Chat
    actor Operator as Оператор

    Client->>Tg: Відправка даних для бота
    Tg->>Client: Колбек від телеграму
    Client->>Proxy: Передача колбеку телеграму на смсбат
    Proxy->>Chat: Реакція на тригерне повідомлення
    Operator->>Chat: Опрацювання чату
    Chat->>Tg: Взаємодія з телеграмом

Що необхідно: - Клієнт повинен налаштувати проксіювання вхідних колбеків у chat.smsbat.com. - Текст/дія (Action) кнопки початку чату. - Текст/дія (Action) кнопки завершення чату.

2.2. Відправка колбеків від Telegram до клієнта з перенаправленням

У цьому варіанті SMSBAT вказано як основний вебхук у Telegram. Отримавши подію, SMSBAT перенаправляє цей колбек на ваш сервер.

sequenceDiagram
    participant Client as Клієнт
    participant Tg as Telegram
    participant Proxy as SMSBAT Proxy
    participant Chat as Chat
    actor Operator as Оператор

    Client->>Tg: Відправка даних для бота
    Tg->>Proxy: Колбек на події від Telegram
    Proxy->>Client: Відправка колбеку телеграм до клієнта
    Proxy->>Chat: Реакція на тригерне повідомлення
    Operator->>Chat: Опрацювання чату
    Chat->>Tg: Взаємодія оператора з телеграмом

Що необхідно: - Клієнт має проксіювати колбек у систему. URL формується після додавання бота в панель і має вигляд: https://restapi.smsbat.com/api/tg_callback/{ID} - Текст/дія (Action) кнопки початку чату. - Текст/дія (Action) кнопки завершення чату.