Про ботів для груп Telegram

ConnectiveOne дозволяє створювати ботів, які можуть слухати та відповідати в групах Telegram. Це дозволяє автоматизувати роботу в групах, обробляти команди та передавати повідомлення операторам.

Контекст і проблема

У багатьох випадках потрібна автоматизація роботи в групах Telegram:

  • Бот, який виконує команди в групах (/command@mybot)
  • Бот, який розпізнає звернення до себе (@mybot зверни увагу)
  • Бот, який слухає всі повідомлення в групі та передає їх операторам

Боти для груп вирішують цю задачу, дозволяючи автоматизувати роботу та надавати операторську підтримку в групах.

Основні концепції

Типи ботів для груп

Бот з командами:

  • Реагує на команди типу /command@mybot
  • Виконує конкретні дії за командами
  • Використовує action для обробки команд

Бот зі зверненнями:

  • Розпізнає звернення до себе через @mybot
  • Може зберігати інформацію або передавати операторам
  • Використовує перевірку тексту повідомлення

Бот-слухач:

  • Слухає всі повідомлення в групі
  • Передає повідомлення в операторську панель
  • Дозволяє операторам відповідати від імені бота

Налаштування Group Privacy

Для того, щоб бот міг слухати всі повідомлення в групі, потрібно вимкнути "Group Privacy" в BotFather:

  1. Відкрити BotFather
  2. Обрати бота
  3. "Bot Settings" → "Group Privacy"
  4. Вимкнути "Group Privacy"

Варіанти підходів

Команди vs звернення vs слухач

Команди:

  • ✅ Плюси: Чітка структура, легко обробляти
  • ❌ Мінуси: Обмежена гнучкість

Звернення:

  • ✅ Плюси: Більш природна взаємодія
  • ❌ Мінуси: Потрібна обробка тексту

Слухач:

  • ✅ Плюси: Повний контроль, можливість операторської підтримки
  • ❌ Мінуси: Потрібна налаштування Group Privacy

Чому використовуємо різні підходи: Кожен підхід підходить для різних сценаріїв використання та потреб клієнтів.

Прийняті рішення

Використання Action для обробки

Для обробки команд та звернень використовуються Action блоки, які:

  • Аналізують текст повідомлення
  • Визначають тип команди або звернення
  • Повертають події для переходу по сценарію

Передача в операторську панель

Для передачі повідомлень в операторську панель використовується action operator_panel__connect_to_operator_with_msg, який дозволяє:

  • Створити чат в операторській панелі
  • Передати дані про повідомлення та користувача
  • Дозволити оператору відповідати від імені бота

Наслідки для користувачів і імплементації

Для інтеграторів

При створенні ботів для груп важливо:

  1. Налаштувати Group Privacy — для ботів-слухачів вимкнути Group Privacy в BotFather
  2. Створити Action для обробки — для команд та звернень
  3. Налаштувати передачу в операторську панель — якщо потрібна операторська підтримка
  4. Обробити різні типи повідомлень — текстові, медіа, команди

Типові помилки

Помилка: Бот не реагує на команди
Проблема: Не налаштовані команди в BotFather або неправильна обробка в Action
Рішення: Перевірити налаштування команд та Action обробку

Помилка: Бот не бачить повідомлення в групі
Проблема: Не вимкнено Group Privacy
Рішення: Вимкнути Group Privacy в BotFather

Помилка: Оператор не може відповідати від імені бота
Проблема: Не налаштована передача в операторську панель
Рішення: Використати operator_panel__connect_to_operator_with_msg для створення чату

Приклади використання

Обробка команди

const action_handle_command = function() {
    const j = this.getCurrentStateJSON();
    const command = j.user_request?.text || '';
    
    if (command === '/start@mybot') {
        return 'start';
    } else if (command === '/help@mybot') {
        return 'help';
    }
    
    return 'unknown';
};

Перевірка звернення

const action_check_mention = function() {
    const j = this.getCurrentStateJSON();
    const message = j.user_request?.text || '';
    const bot_username = 'mybot';
    
    if (message.includes(`@${bot_username}`)) {
        return 'mentioned';
    }
    
    return 'not_mentioned';
};

Пов'язані документи