Перейти к содержанию
wisebot.studio/wisebot

Подключение Telegram#

Telegram — кроссплатформенный мессенджер. Приложение позволяет обмениваться текстовыми, голосовыми и видеосообщениями, фотографиями и файлами многих форматов. Также позволяет совершать аудио- и видеозвонки, организовывать конференции и прямые эфиры, хранить неограниченное количество файлов, создавать и использовать ботов.

Эта пошаговая инструкция поможет вам подключить чат-бот Wisebot в Telegram для автоматизации различных задач, от простых бытовых до сложных бизнес-процессов.

Этапы интеграции:

Шаг 1. Создание Telegram-бота#

  1. Откройте Telegram и найдите бота @BotFather.
  2. Начните диалог с BotFather и используйте команду /newbot, чтобы создать нового бота.
  3. Укажите имя бота.
  4. Укажите идентификатор username. Идентификатор должен заканчиваться на bot.

После создания бота BotFather предоставит вам access_token. Сохраните этот токен, он понадобится в дальнейшем. Если вы потеряли токен, отправьте команду /token в чат с BotFather и он пришлет вам новый токен.

Подключение Telegram

💡 Если вы хотите использовать своего бота в групповой беседе, рекомендуется включить режим конфиденциальности группы, введя /setprivacy. Тогда бот будет прослушивать только те сообщения, которые начинаются с /bot.

🔍 Дополнительную информацию можно найти в официальном руководстве Telegram Bot API.

Шаг 2. Настройка интеграции в Wisebot#

  1. Откройте Wisebot и убедитесь, что настраиваете нужного бота. В боковом меню должно отображаться его имя.
  2. Перейдите в раздел Настройки → Учетные данные, либо откройте в проекте файл credentials.yml.

  3. Выберите вкладку со средой развертывания Development или Production.

    Подключение Telegram

  4. Добавьте конфигурацию для Telegram:

    telegram:
  access_token: "YOUR_TELEGRAM_TOKEN"  # Токен, полученный от BotFather
  verify: "your_bot_username"         # Username бота (без @)
  webhook_url: "https://your-domain.com/dev/123434/webhooks/telegram/webhook"  # URL для вебхука
  parse_mode: "MarkdownV2" # для поддержки Markdown-разметки в ответах для Telegram
    • Замените YOUR_TELEGRAM_TOKEN на access_token, полученный от BotFather.
    • Замените your_bot_username на username вашего бота.
    • Укажите значение dev или prod, в зависимости от того, для какой среды выполняется настройка.
    • Замените значение 123434 на значение из строки socket_path: /dev/GA457rtLJ88dH1fon/socket.io/

  5. Нажмите Сохранить и подтвердите перезапуск инстанса для выбранного окружения.

    Подключение Telegram

Шаг 3. Настройка стартового сообщения#

В начале разговора пользователь нажмет кнопку «Старт» в Telegram. Это приведёт к отправке сообщения с содержанием /start. Чтобы ваш бот смог ответить на стартовое сообщение:

  1. Создайте намерение.
  2. Добавьте это намерение в историю или правило.

Пример стартового сообщения:

Подключение Telegram

💡 Помимо текстовых ответов Telegram API поддерживает кнопки и быстрые ответы, изображения, аудио и прочее.

Проверьте интеграцию. Откройте Telegram и найдите своего бота по username. Начните диалог с ботом и убедитесь, что он отвечает правильно.