Перейти к основному содержимому

Создание первого Telegram бота

Цель​

Подключить Telegram бота к SMAIWER Platform для приёма сообщений от клиентов.

Предусловия​

Пошаговая инструкция​

Шаг 1: Создайте бота в Telegram​

  1. Откройте Telegram и найдите @BotFather
  2. Отправьте команду /newbot
  3. Введите название бота (например, Поддержка Компании)
  4. Введите username бота (например, company_support_bot)
Требования к username
  • Должен заканчиваться на bot или _bot
  • Только латинские буквы, цифры и подчёркивания
  • От 5 до 32 символов

Шаг 2: Скопируйте токен бота​

После создания BotFather отправит вам токен:

Done! Congratulations on your new bot.
Use this token to access the HTTP API:
1234567890:AABBccDDeeFFggHHiiJJkkLLmmNNooRRss
Безопасность

Никогда не публикуйте токен бота! Любой с токеном может управлять вашим ботом.

Шаг 3: Добавьте бота в SMAIWER​

  1. Войдите в панель управления
  2. Нажмите «Настройки Telegram бота» (иконка ⚙️)
  3. Вставьте токен в поле «Bot Token»
  4. Нажмите «Сохранить»

Шаг 4: Проверьте подключение​

После сохранения SMAIWER автоматически:

  • Проверит валидность токена
  • Установит webhook для получения сообщений
  • Отобразит информацию о боте

Статус бота должен измениться на «Подключён» (зелёный индикатор).

Шаг 5: Отправьте тестовое сообщение​

  1. Откройте вашего бота в Telegram
  2. Нажмите «Start» или отправьте любое сообщение
  3. Проверьте, что сообщение появилось в панели чатов SMAIWER

Ожидаемый результат​

  • Telegram бот подключён к SMAIWER
  • Входящие сообщения отображаются в панели чатов
  • Вы можете отвечать клиентам через панель

Возможные ошибки​

Неверный токен​

Причина: Токен скопирован с ошибкой или бот удалён.

Решение:

  1. Проверьте токен в BotFather (команда /mybots)
  2. Скопируйте токен заново
  3. Попробуйте создать нового бота

Webhook уже установлен​

Причина: Бот уже используется в другом сервисе.

Решение:

  • Удалите webhook: отправьте в BotFather /setwebhook и выберите бота
  • Или создайте нового бота

Сообщения не приходят​

Причина: Проблема с webhook или сетью.

Решение:

  1. Убедитесь, что сервер SMAIWER доступен по HTTPS
  2. Переподключите бота (сохраните токен заново)
  3. Проверьте логи в настройках организации

Дополнительная настройка​

Приветственное сообщение​

Настройте сообщение, которое бот отправит при первом обращении:

  1. Откройте «Настройки Telegram бота»
  2. Заполните поле «Приветственное сообщение»
  3. Сохраните изменения

Команды бота​

Настройте меню команд в BotFather:

/setcommands
/start - Начать диалог
/help - Помощь

Связанные руководства​