> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botflow.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Настройки бота

> Имя, описание и аватар бота, токен, активность, платное увеличение лимитов, перенос между воркспейсами и удаление.

Раздел «Настройки» на уровне бота собирает всё, что относится к самому боту: как он выглядит для подписчиков, его токен, активность, лимиты отправки и действия вроде переноса или удаления. Открывается в меню бота, группа «Настройка» → «Настройки».

<Info>
  Смотреть настройки может любой участник с доступом к боту. Менять имя, описание, аватар и активность
  могут менеджер бота и администратор компании. Перенос между воркспейсами и удаление доступны только
  владельцу или администратору компании.
</Info>

## Профиль бота

Карточка «Профиль» содержит три поля, которые описывают бота. Всё, что вы здесь меняете, отправляется в
Telegram и видно **всем подписчикам**, а не только внутри платформы.

<Columns cols={3}>
  <Card title="Имя" icon="signature">
    До 64 символов. Отображается как название бота в списке чатов и в шапке диалога.
  </Card>

  <Card title="Краткое описание" icon="align-left">
    До 120 символов. Показывается в превью бота, когда на него ссылаются через @упоминание.
  </Card>

  <Card title="Описание" icon="align-justify">
    До 512 символов. Показывается в пустом чате с ботом под заголовком «Что умеет этот бот?», пока
    подписчик ещё не нажал «Запустить».
  </Card>
</Columns>

Каждое поле редактируется отдельно: нажмите на карандаш рядом со значением, впишите текст и сохраните.
Под полем виден счётчик символов. Краткое описание и описание можно оставить пустыми, имя обязательно.

<Tip>
  Пока задано описание, на странице показывается блок «Превью в Telegram»: как выглядит пустой чат с
  ботом у подписчика, с заголовком «Что умеет этот бот?», текстом описания и кнопкой «Запустить».
  Так видно результат до того, как его увидят люди.
</Tip>

## Аватар

Кнопки «Сменить фото» и «Удалить фото» находятся рядом с аватаром бота. Поддерживаются PNG, JPEG и WebP.

<Warning>
  Фото, загруженное здесь, меняет то, как бот выглядит **внутри платформы**. Аватар, который подписчики
  видят в Telegram, задаётся только в @BotFather (команда `/setuserpic`): такое ограничение у Telegram
  Bot API. Чтобы картинки совпадали, поставьте одно и то же фото и здесь, и в @BotFather.
</Warning>

## Активность

Переключатель активности в шапке карточки бота включает и выключает бота на платформе. Когда бот выключен,
он не отвечает подписчикам и не участвует в рассылках; при этом подписчики, сценарии и история сохраняются.
Рядом с переключателем подписано текущее состояние: «Включён» или «Выключен».

## Токен бота

Карточка «Токен бота» показывает текущий токен в скрытом виде и позволяет заменить его кнопкой «Изменить
токен». Токен берётся из @BotFather.

Замена нужна, если вы отозвали токен в @BotFather или он попал не в те руки: вставьте новый токен
**того же** бота. При отзыве идентификатор бота не меняется, поэтому подписчики, сценарии и история
остаются на месте, а бот снова заработает уже на новом токене.

<Note>
  Сменить токен можно, даже когда бот отмечен как недоступный: это основной способ вернуть бота в строй
  после отзыва старого токена.
</Note>

## Если бот стал недоступен

Когда Telegram перестаёт принимать запросы бота, вверху страницы появляется предупреждение «Бот
недоступен» с примерной датой и причиной. Все действия с ботом на это время заблокированы.

| Причина                    | Что произошло                                  |
| -------------------------- | ---------------------------------------------- |
| Токен отозван у @BotFather | Старый токен больше не действует, нужен новый. |
| Бот заблокирован Telegram  | Telegram ограничил бота на своей стороне.      |
| Ошибки на webhook          | Telegram не смог доставлять боту обновления.   |
| Неизвестная причина        | Причину определить не удалось.                 |

В предупреждении есть кнопки: «Проверить ещё раз» (перепроверить доступность у Telegram), «Изменить токен»
(вставить новый токен того же бота) и «Удалить» (для администратора компании). После смены токена бот, как
правило, восстанавливается автоматически.

## Платное увеличение лимитов

По умолчанию Telegram ограничивает бота 30 сообщениями в секунду на все вызовы сразу: рассылки, ответы
оператора и авто-ответы воронки. Платное увеличение лимитов поднимает этот порог до 1000 сообщений в
секунду. Каждое сообщение сверх свободных 30 в секунду списывает 0.1 Telegram Star с баланса бота.

На карточке видно текущую нагрузку бота (среднее число сообщений в секунду за 7 дней) и баланс Stars,
поэтому можно оценить, есть ли смысл включать увеличение. При стабильно высокой нагрузке или больших
рассылках оно помогает; если нагрузка ниже свободного лимита, включать пока не нужно.

<Steps>
  <Step title="Включите опцию в @BotFather" icon="robot">
    @BotFather → Bot Settings → Allow Paid Broadcasts.
  </Step>

  <Step title="Положите Stars на баланс бота" icon="star">
    Минимум 10 000 Telegram Stars через @BotFather → Manage Bot → Balance.
  </Step>

  <Step title="Включите переключатель на карточке" icon="toggle-on">
    При включении платформа проверит баланс через Bot API. Если Stars закончатся во время отправки, она
    прервётся с понятной ошибкой, а событие попадёт в журнал.
  </Step>
</Steps>

## Перенос между воркспейсами

Если в компании больше одного воркспейса, бота можно перенести в другой. Карточка «Воркспейс» показывает
текущий воркспейс и кнопку «Перенести». Бот переедет в выбранный воркспейс внутри той же компании,
подписчики, сценарии и история сохранятся. Перенос доступен владельцу или администратору компании.

## Удаление бота

Кнопка «Удалить бота» в нижней карточке скрывает бота из всех списков. Подписчики и сценарии сохраняются
365 дней: этого достаточно, чтобы восстановить бота, если передумаете, добавив его по тому же токену.

<Warning>
  Если бот на момент удаления уже недоступен у Telegram, удаление окончательное и восстановить бота нельзя.
  Удаление доступно владельцу или администратору компании.
</Warning>

## Что дальше

<Columns cols={2}>
  <Card title="Настройки ИИ" icon="robot" href="/ru/ai-operator">
    Персона, база знаний, модель и бюджет виртуального оператора этого бота.
  </Card>

  <Card title="Рассылки" icon="paper-plane" href="/ru/broadcasts">
    Массовые и триггерные рассылки подписчикам бота, где и пригодится увеличение лимитов.
  </Card>
</Columns>
