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

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

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

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

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

• Шаг 1. Создание Telegram-бота
• Шаг 2. Настройка интеграции в Wisebot
• Шаг 3. Настройка стартового сообщения

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

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

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

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

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

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

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

   

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. Нажмите Сохранить и подтвердите перезапуск инстанса для выбранного окружения.

   

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

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

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

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

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