Каждый бот в Макс защищён собственным ключом доступа. По нему мы отправляем сообщения и принимаем ответы. Если ключ потерян, скомпрометирован или просто не подходит — его можно перевыпустить.
Где взять ключ
- Откройте business.max.ru/self.
- Войдите в свой аккаунт Макс.
- Выберите нужного бота из списка.
- На странице бота — раздел «Ключ доступа» или «Токен».
- Нажмите «Показать» и скопируйте.
Как заменить ключ
Если боялись утечки, увольнялся ответственный сотрудник, или просто хочется «сбросить» — действуйте так:
- В кабинете Макс на странице бота найдите кнопку «Сгенерировать новый ключ» (или «Перевыпустить»).
- Подтвердите — старый ключ перестанет работать сразу же.
- Скопируйте новый ключ.
- В нашем кабинете откройте настройки бота → «Заменить ключ» → вставьте новый → «Сохранить».
После замены сценарии, теги, история диалогов — всё остаётся на месте. Меняется только «пропуск» к API Макс.
Если ключ потерян
Если старый ключ невосстановимо потерян — это не проблема. Просто перевыпустите его (см. выше). У вас всегда есть доступ к кабинету Макс — а значит, к новому ключу.
Что делает ключ
- Авторизует наши запросы к API Макс — «мы имеем право отправлять от имени этого бота».
- Подписывает входящие webhook-и от Макс к нам.
- Не имеет отношения к личному аккаунту Макс пользователя.
Ключ — это пароль
Никому не пересылайте его «в открытую» в мессенджерах, не сохраняйте в публичных репозиториях. Если ключ попадёт в чужие руки — перевыпустите.
Часто задаваемые вопросы
Меняется ли ключ периодически сам? Нет, ключ выпускается один раз и работает, пока его не сбросят вручную.
Можно ли использовать один ключ для нескольких сервисов? Технически можно, но Макс будет слать webhook только по одному адресу — последнему, кто прописал свой URL. Поэтому в нашем сервисе ключ используется эксклюзивно.
Что произойдёт после перевыпуска? Старый ключ мгновенно перестаёт работать — сообщения перестанут идти, пока вы не вставите новый ключ в кабинет ЭТОЧАТБОТА.