Главная · Блог · Как сменить токен бота в Telegram, MAX и ВКонтакте и не потерять переписку
Как сменить токен бота в Telegram, MAX и ВКонтакте и не потерять переписку
Чтобы сменить токен бота в ЧБТ, откройте «Каналы» → «⋯» в строке канала → «Изменить ключ», вставьте новый токен в поле «Новый ключ (API-токен)» и нажмите «Сохранить ключ». Канал, открытые диалоги, контакты и сценарии остаются на месте, удалять и подключать канал заново не нужно. Если новый ключ не подошёл, ЧБТ вернёт прежний и покажет причину — канал не сломается. «Изменить ключ» есть у Telegram, MAX и ВКонтакте; менять ключ могут владелец и администраторы проекта. Ниже — где взять новый токен, порядок действий при утечке и что делать, если бот замолчал после смены.
Где взять новый токен
| Мессенджер | Где выпустить новый ключ |
|---|---|
| Telegram | @BotFather: /revoke отзывает старый токен и выдаёт новый; действующий токен — в /mybots → «API Token» |
| MAX | Кабинет MAX для бизнеса, настройки бота |
| ВКонтакте | Сообщество: «Управление» → «Работа с API» → «Ключи доступа», права «Сообщения сообщества» и «Управление сообществом» |
Новый токен должен быть от того же бота или того же сообщества. ЧБТ проверяет, что ключ рабочий, но не сравнивает, тот ли это бот. Вставите токен другого бота — контакты останутся в канале, но писать им будет бот, с которым они не переписывались, и сообщения не дойдут.
Плановая смена: порядок без простоя
- Выпустите новый ключ в кабинете площадки, старый пока не отзывайте (в MAX и ВКонтакте это возможно).
- В ЧБТ: «Каналы» → «⋯» → «Изменить ключ» → вставьте новый → «Сохранить ключ».
- Дождитесь статуса «Работает» у канала.
- Напишите боту с телефона: ответ должен прийти, сообщение — появиться в «Диалогах».
- Отзовите старый ключ в кабинете площадки и ещё раз напишите боту.
В Telegram /revoke отзывает старый токен сразу, поэтому вставляйте новый в ЧБТ сразу после команды — пока не вставите, бот молчит.
Что делает ЧБТ при сохранении: заново настраивает приём сообщений с новым ключом — вебхук Telegram, подписку на события MAX или Callback API ВКонтакте.
Утечка токена: что сделать сейчас
- Получите новый токен — в Telegram командой
/revoke, в MAX и ВКонтакте — новый ключ в кабинете площадки. - Вставьте его в ЧБТ через «Изменить ключ».
- Отзовите старый ключ там, где это не произошло само: удалите старый ключ сообщества ВКонтакте, обновите токен в кабинете MAX.
- Проверьте бота с телефона — ответ должен появиться в «Диалогах».
- Уберите токен из источника утечки — переписки, документа, кода.
Подрядчику, которому нужен доступ к боту, токен не нужен: добавьте его в проект ЧБТ с подходящей ролью — роль снимается одной кнопкой.
Если новый ключ не подошёл
В форме появится «Новый ключ не подошёл: … Оставили прежний.» — ЧБТ вернул старый ключ и восстановил его вебхук.
| Причина в сообщении | Что сделать |
|---|---|
| Ключ не принят площадкой | Скопируйте ключ целиком, без пробелов по краям |
| Ключ от другого мессенджера | Токен Telegram — только в Telegram-канал, MAX — в MAX |
| У ключа ВКонтакте нет прав «Сообщения сообщества» или «Управление сообществом» | Создайте ключ заново и отметьте оба права |
| Сеть или сбой площадки | Повторите через пару минут |
Если старый токен уже отозван, «прежний» ключ тоже не работает — вставьте рабочий новый как можно скорее.
«Изменить ключ» или удалить и подключить заново
| «Изменить ключ» | Удалить и подключить заново | |
|---|---|---|
| Канал | Тот же | Новый |
| Открытые диалоги | Продолжаются | Закрываются, переписка — только для чтения |
| Контакты, теги, сделки | На месте | На месте |
| Ответить в старом диалоге | Можно | Нельзя — разговор продолжится, когда клиент напишет снова |
| Настройки канала | Сохраняются | Настраиваются заново |
Удалять канал стоит, только если вы переходите на другого бота или другое сообщество.
Если бот замолчал после смены
| Симптом | Причина | Что сделать |
|---|---|---|
| Статус «Ошибка» с текстом про токен, владельцу пришло письмо «Бот … требует внимания» | Площадка отклонила ключ | Повторите «Изменить ключ» с действующим токеном |
| Статус «Работает», а в «Диалогах» пусто | Токен параллельно используется в другом сервисе, тот перехватил вебхук | Уберите токен оттуда и нажмите «Переустановить webhook» |
| У ответов пометка «не доставлено» | Отправка не проходит | Наведите на пометку — в подсказке текст ошибки площадки |
| Клиенты пишут, бот не может им ответить | Вставлен токен другого бота | Верните токен того бота, которому писали клиенты |
Письмо о проблеме с ключом приходит не чаще раза в сутки, если не выключены «Email-уведомления» или «Статус ботов». Подробные чеклисты: Telegram-бот молчит, бот MAX не отвечает, бот ВКонтакте не отвечает.
Сайт и почта
У чата на сайте токена мессенджера нет: виджет подключается кодом, который выдаёт ЧБТ, менять в нём нечего. У почты вместо токена — пароли приложения для IMAP и SMTP. Если пароль почты утёк, создайте новый пароль приложения в настройках почтового сервиса, удалите старый и переподключите почту в «Каналах» с новым паролем.
Токены каналов хранятся в ЧБТ зашифрованными и после подключения нигде не показываются — ни владельцу, ни операторам.
Как получить токен Telegram-ботаКак подключить бота MAXКак подключить бота ВКонтактеПочему Telegram-бот не отвечает