Сообщество ВКонтакте — подключение кнопкой
Во ВКонтакте ботом работает ваше сообщество. Раньше для этого приходилось самому создавать ключ в настройках сообщества, подтверждать его по СМС и вставлять в кабинет. Теперь сообщество можно подключить кнопкой: ВКонтакте покажет ваши сообщества, вы выберете одно и разрешите доступ в окне — ключ и приём событий настроятся сами.
Возможность открывает владелец сервиса. Пока она не открыта для вашей учётной записи, кнопки «Подключить через ВКонтакте» в кабинете нет: сообщество подключается по ключу вручную, как описано в разделе «Свои боты». Если хотите попробовать раньше других — напишите в поддержку.
Что нужно заранее
- Вы администратор сообщества. Чужое сообщество подключить нельзя: ВКонтакте не покажет его в списке.
- В сообществе включены «Сообщения сообщества» и «Возможности ботов», отмечено «Разрешать добавлять сообщество в чаты» (Управление → Сообщения и «Настройки для бота»). Это настройки самого сообщества, окно разрешений их не меняет.
- Вы вошли в кабинет, а во ВКонтакте — в ту учётную запись, с которой администрируете сообщество.
Как подключить
- Откройте в кабинете «Боты» → «Добавить бота». Над формой есть блок «ВКонтакте — одной кнопкой»; нажмите «Подключить через ВКонтакте».
- Откроется ВКонтакте. Разрешите 24Репосту видеть список ваших сообществ. Ключ вашей страницы мы не сохраняем: он нужен только для этого списка и сразу забывается.
- В кабинете выберите сообщество из списка.
- ВКонтакте покажет окно разрешений этого сообщества. Нажмите «Разрешить»; если окно позволяет снять какое-то право, оставьте все.
- Вы вернётесь на карточку сообщества. Оно сразу действует. Дальше всё так же, как после ручного подключения: свяжите учётную запись ВКонтакте (карточка подскажет как) и добавьте сообщество в беседы.
Окно просит четыре права, и каждое нужно для своего:
| Право | Для чего |
|---|---|
| Управление сообществом | включить приём событий и нужные события в самом сообществе |
| Сообщения сообщества | получать и отправлять сообщения в беседах; без этого права сообщество не подключается |
| Фотографии | пересылать картинки в беседы |
| Документы | пересылать файлы и голосовые сообщения |
Публикацию на стену сообщества эта кнопка не добавляет: ВКонтакте открывает её сервисам отдельным правом. Пока стена сообщества работает только как источник.
Если что-то не получилось
Кабинет объясняет, что случилось, на странице «Добавить бота».
| Что написал кабинет | Что делать |
|---|---|
| «Вы не разрешили доступ…» | Нажмите кнопку ещё раз и разрешите доступ — либо подключите сообщество по ключу вручную. |
| «Эта ссылка устарела или уже использована…» | Подключение занимает не больше десяти минут. Ссылку нельзя обновлять или открывать в другом браузере. Нажмите кнопку заново. |
| «Во ВКонтакте не нашлось сообществ, где вы администратор…» | Вы вошли во ВКонтакте не в ту учётную запись, или администратор сообщества другой человек. |
| «ВКонтакте не ответил…» | Повторите через минуту. Если повторяется, напишите в поддержку и назовите код из скобок. |
| «У ключа нет права «сообщения сообщества»…» | Ключ выдан без этого права, например оно было снято в окне. Подключите заново и оставьте все права. |
| «ВКонтакте выдал ключ другого сообщества…» | Ничего не сохранено. Повторите подключение. |
| «Этот токен уже подключён…» | Это сообщество уже есть в списке «Боты». |
Что мы храним
- Ключ сообщества хранится зашифрованным, как токены ботов, и после сохранения не показывается.
- Ключ вашей страницы, код возврата из ВКонтакте и служебные метки подключения не сохраняются нигде: ни в базе, ни в журналах.
- Отключить сообщество можно двумя способами: в кабинете на карточке — «Отключить бота от сервиса»; во ВКонтакте — Управление → Работа с API → Ключи доступа → «Удалить ключ» у приложения «24Репост».