Clawmatic

Подключение Telegram-бота

Пошаговое руководство по созданию Telegram-бота через BotFather и подключению к Clawmatic

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

Для работы агента Clawmatic необходим Telegram-бот. Создать его можно за пару минут через официального бота @BotFather.

Шаг 1: Создайте бота через BotFather

  1. Откройте Telegram и найдите @BotFather
  2. Отправьте команду /newbot
  3. Введите отображаемое имя бота (например, «ТехноМагазин Поддержка»)
  4. Введите username бота — должен заканчиваться на bot (например, technomagazin_support_bot)

BotFather вернёт сообщение с токеном — строку вида 7123456789:AAF.... Сохраните её — она понадобится для подключения.

Храните токен в безопасности. Не публикуйте его в открытом доступе. Если токен скомпрометирован, отзовите его через BotFather командой /revoke.

Шаг 2: Настройте бота (опционально)

Через BotFather можно настроить дополнительные параметры:

Описание и аватар

  • /setdescription — описание, которое видят пользователи при первом открытии бота
  • /setabouttext — текст в разделе «О боте»
  • /setuserpic — аватар бота

Команды

  • /setcommands — список команд бота (например, /start, /help)

Рекомендуем добавить как минимум:

start - Начать общение
help - Получить помощь

Шаг 3: Подключите бота к Clawmatic

  1. Войдите в личный кабинет
  2. Перейдите в раздел «Агенты» → «Создать агента» или откройте мастер создания
  3. На шаге «Подключение Telegram» вставьте токен бота
  4. Clawmatic автоматически проверит токен и настроит webhook

Что такое webhook

Webhook — это механизм, через который Telegram отправляет сообщения пользователей вашему агенту. Clawmatic настраивает его автоматически при подключении бота. Вам не нужно ничего настраивать вручную.

Технически, webhook направляется на URL вида:

https://api.clawmatic.ru/webhooks/telegram/{agent-id}

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

После подключения:

  1. Откройте вашего бота в Telegram
  2. Отправьте /start или любое сообщение
  3. Убедитесь, что агент ответил

Если ответа нет, проверьте:

  • Токен введён корректно
  • Агент запущен (статус «Активен» в дашборде)
  • Нет ошибок в логах агента

Переключение бота

Если нужно сменить Telegram-бота для существующего агента:

  1. Перейдите в настройки агента
  2. В разделе «Telegram» нажмите «Отключить бота»
  3. Вставьте токен нового бота
  4. Clawmatic перенастроит webhook автоматически

Несколько агентов

Каждый Telegram-бот можно подключить только к одному агенту Clawmatic. Для разных задач создавайте отдельных ботов через BotFather.

Количество агентов ограничено тарифным планом. Подробнее — на странице тарифов.