Начало работы

Создать бота через @BotFather, взять токен, сделать первый запрос.

1. Создать бота через @BotFather

Боты создаются в чате Ostart, диалогом со встроенным помощником @BotFather. Открыть его: «Настройки профиля» → «Боты» → «Открыть @BotFather», либо найти его в списке людей и написать.

/newbot            — создать бота (спросит имя)
/mybots            — список ваших ботов
/token <имя>       — новый токен вместо старого
/deletebot <имя>   — удалить бота
/help              — подсказка

2. Имя бота

Выберите понятное имя от четырёх символов: буквы, цифры, пробел, дефис и подчёркивание. Занятые, служебные и недопустимые имена использовать нельзя — при необходимости сервис предложит выбрать другое.

3. Токен

Токен показывается один раз и хранится только хешем: потерянный не восстанавливается, а перевыпускается командой /token — старый при этом перестаёт работать. Обращайтесь с ним как с паролем: не кладите в репозиторий и не пишите в логи.

Удаление бота не переписывает историю: сказанное им остаётся в чатах.

4. Первый запрос

Проверить токен быстрее всего запросом о самом боте.

curl --header "Authorization: Bearer ВАШ_ТОКЕН" \
  "https://chat.ostart.ru/bot/v1/self/get"

{"ok":true,"userId":"0f9e…","nick":"Помощник","firstName":"Помощник"}

5. Добавить бота в чат

Созданный бот сразу существует как участник — добавьте его в нужный чат как обычного человека, и он начнёт получать события. Пока не добавили, чата для него не существует: запросы к нему отвечают 404. И видит он только то, что происходило с момента вступления.

6. Читать события

Дальше бот живёт в цикле: спрашивает events/get, обрабатывает событие, отвечает через messages/sendText.