Сообщество ВКонтакте — подключение кнопкой

Во ВКонтакте ботом работает ваше сообщество. Раньше для этого приходилось самому создавать ключ в настройках сообщества, подтверждать его по СМС и вставлять в кабинет. Теперь сообщество можно подключить кнопкой: ВКонтакте покажет ваши сообщества, вы выберете одно и разрешите доступ в окне — ключ и приём событий настроятся сами.

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

Что нужно заранее

  • Вы администратор сообщества. Чужое сообщество подключить нельзя: ВКонтакте не покажет его в списке.
  • В сообществе включены «Сообщения сообщества» и «Возможности ботов», отмечено «Разрешать добавлять сообщество в чаты» (Управление → Сообщения и «Настройки для бота»). Это настройки самого сообщества, окно разрешений их не меняет.
  • Вы вошли в кабинет, а во ВКонтакте — в ту учётную запись, с которой администрируете сообщество.

Как подключить

  1. Откройте в кабинете «Боты» → «Добавить бота». Над формой есть блок «ВКонтакте — одной кнопкой»; нажмите «Подключить через ВКонтакте».
  2. Откроется ВКонтакте. Разрешите 24Репосту видеть список ваших сообществ. Ключ вашей страницы мы не сохраняем: он нужен только для этого списка и сразу забывается.
  3. В кабинете выберите сообщество из списка.
  4. ВКонтакте покажет окно разрешений этого сообщества. Нажмите «Разрешить»; если окно позволяет снять какое-то право, оставьте все.
  5. Вы вернётесь на карточку сообщества. Оно сразу действует. Дальше всё так же, как после ручного подключения: свяжите учётную запись ВКонтакте (карточка подскажет как) и добавьте сообщество в беседы.

Окно просит четыре права, и каждое нужно для своего:

Право Для чего
Управление сообществом включить приём событий и нужные события в самом сообществе
Сообщения сообщества получать и отправлять сообщения в беседах; без этого права сообщество не подключается
Фотографии пересылать картинки в беседы
Документы пересылать файлы и голосовые сообщения

Публикацию на стену сообщества эта кнопка не добавляет: ВКонтакте открывает её сервисам отдельным правом. Пока стена сообщества работает только как источник.

Если что-то не получилось

Кабинет объясняет, что случилось, на странице «Добавить бота».

Что написал кабинет Что делать
«Вы не разрешили доступ…» Нажмите кнопку ещё раз и разрешите доступ — либо подключите сообщество по ключу вручную.
«Эта ссылка устарела или уже использована…» Подключение занимает не больше десяти минут. Ссылку нельзя обновлять или открывать в другом браузере. Нажмите кнопку заново.
«Во ВКонтакте не нашлось сообществ, где вы администратор…» Вы вошли во ВКонтакте не в ту учётную запись, или администратор сообщества другой человек.
«ВКонтакте не ответил…» Повторите через минуту. Если повторяется, напишите в поддержку и назовите код из скобок.
«У ключа нет права «сообщения сообщества»…» Ключ выдан без этого права, например оно было снято в окне. Подключите заново и оставьте все права.
«ВКонтакте выдал ключ другого сообщества…» Ничего не сохранено. Повторите подключение.
«Этот токен уже подключён…» Это сообщество уже есть в списке «Боты».

Что мы храним

  • Ключ сообщества хранится зашифрованным, как токены ботов, и после сохранения не показывается.
  • Ключ вашей страницы, код возврата из ВКонтакте и служебные метки подключения не сохраняются нигде: ни в базе, ни в журналах.
  • Отключить сообщество можно двумя способами: в кабинете на карточке — «Отключить бота от сервиса»; во ВКонтакте — Управление → Работа с API → Ключи доступа → «Удалить ключ» у приложения «24Репост».