ВКонтакте
Обрабатывайте сообщения вашего сообщества ВКонтакте в чат-центре Wikibot с помощью бота
Подключение канала
Вы можете подключить сообщество ВКонтакте в качестве одного из каналов в чат-центре Wikibot, чтобы получать сообщения от подписчиков и отвечать на них с помощью нашего бота или самостоятельно из личного кабинета.
Ваше сообщество ВКонтакте будет «лицом» и будет принимать вопросы от пользователей, а Wikibot — «головой», которая отвечает на вопросы и отправляет ответы во ВКонтакте.
Все настройки выполняются от имени администратора сообщества. Если у вас нет прав администратора, обратитесь к владельцу сообщества.
В сообществе перейдите в Управление → Сообщения и включите сообщения сообщества.
Там же откройте Настройки для бота и включите возможности ботов. Без этого не будут работать кнопки — например, кнопочное меню.
По желанию включите кнопку «Начать». Тогда при первом обращении пользователь увидит её, а в ответ получит приветственное сообщение, которое вы укажете при настройке канала.
Перейдите в Управление → Работа с API → Ключи доступа и нажмите Создать ключ.
Отметьте четыре права доступа:
- Управление сообществом
- Сообщения сообщества
- Фотографии
- Документы
Храните ключ в безопасном месте — он даёт прямой доступ к сообщениям вашего сообщества. Не передавайте его третьим лицам и не публикуйте в открытых источниках.
- Перейдите в личный кабинет и авторизуйтесь.
- Выберите бота, для которого настраиваете связку, и "провалитесь" в него.
- В меню навигации слева выберите Чат-центр → Управление и перейдите на вкладку Каналы.
- Найдите канал ВКонтакте и включите переключатель.
В поле Ключ доступа сообщества вставьте скопированный ключ.
При необходимости укажите приветственное сообщение — его получит пользователь, нажавший кнопку «Начать».
Нажмите Сохранить.
Если ключ верный, под полем появится название вашего сообщества со ссылкой на него. Это подтверждение, что Wikibot подключился именно к тому сообществу, которое вы хотели.
Напишите сообщение вашему сообществу с личной страницы — оно появится в разделе Чаты личного кабинета.
Ваша интеграция готова.
Все обращения, поступающие в сообщения вашего сообщества, попадают в чат-центр Wikibot. Сначала на сообщения отвечает бот — он ведёт диалог до тех пор, пока не потребуется подключение оператора. Следить за обращениями и подключаться к ним можно в разделе Чаты личного кабинета.
Если сообщения не приходят
Чтобы получать сообщения, во ВКонтакте должен быть включён Long Poll API. Wikibot включает его самостоятельно — именно для этого ключу нужно право «Управление сообществом».
Если это право не было выдано, канал всё равно сохранится, но в карточке канала появится предупреждение. В этом случае включите Long Poll API вручную:
- В сообществе перейдите в Управление → Работа с API → Long Poll API.
- Включите Long Poll API и выберите версию API 5.199.
- На вкладке Типы событий отметьте «Входящее сообщение» и «Событие callback-кнопки».
Одного переключателя недостаточно — без отмеченных типов событий сообщения приходить не будут.
Проще всего пересоздать ключ доступа, отметив все четыре права. Тогда Wikibot настроит всё сам.
Что умеет канал
Вложения. Пользователь может присылать фотографии, файлы, голосовые сообщения и стикеры — они будут видны оператору в чат-центре. Оператор и бот, в свою очередь, могут отправлять пользователю изображения и файлы.
Ответы на сообщения. Если пользователь отвечает на конкретное сообщение или пересылает его, бот видит процитированный текст и учитывает его в ответе. Оператор тоже может ответить на конкретное сообщение — во ВКонтакте это будет выглядеть как обычная цитата.
Кнопочное меню. Если у бота настроено кнопочное меню, оно работает и во ВКонтакте: пользователь видит кнопки под сообщением и переходит по разделам нажатиями.
ВКонтакте разрешает не больше 10 кнопок под одним сообщением, а надпись на кнопке — не длиннее 40 символов. Более длинные надписи будут сокращены, поэтому при настройке меню держите их короткими.
Ограничения
Бот не может написать первым. Так устроен ВКонтакте: отправить сообщение пользователю можно только после того, как он сам написал сообществу или разрешил сообщения от него.
Только личные диалоги. Сообщения из групповых бесед, куда добавлен бот, в чат-центр не попадают. Обрабатываются только личные обращения в сообщения сообщества.
Ответы приходят обычным текстом. ВКонтакте не поддерживает форматирование в сообщениях, поэтому ответы бота приходят без выделения жирным, списков и заголовков. Длинные ответы автоматически разбиваются на несколько сообщений.
Не все вложения поддерживаются. Видео, товары, записи со стены и опросы ВКонтакте не отдаёт по прямой ссылке — такие вложения оператор увидит как «Неподдерживаемое сообщение ВКонтакте». Текст сообщения при этом сохраняется.
Если вы удалите или отзовёте ключ доступа в настройках сообщества, канал автоматически отключится, и обращения перестанут поступать. Чтобы восстановить работу, создайте новый ключ и вставьте его в настройках канала.