Рекомендации
Для работы с пользователями VK, зарегистрируйте отдельную линию в 1С-Коннект (по отдельной линии для каждого VK-бота). Это позволит вам лучше администрировать настройки, мониторинг и управление процессов в будущем.
Для каждого VK-бота также рекомендуем регистрировать отдельную учетную запись API.
При подключении к линии VK-бота в сервисе создаётся отдельная техническая компания-клиент с названием “VK: <имя бота>”. В рамках этой компании регистрируются аккаунты пользователей VK. Просмотр списка пользователей этой компании доступен в кабинете администратора.
Для бана пользователя (принудительного блокирования), достаточно отключить ему линию 1С-Коннект в кабинете администратора. Обращения от таких пользователей перестают доставляться в линию 1С-Коннект.
По каждому пользователю из VK в 1С-Коннект:
Передаются: имя пользователя VK, в рассылках - кнопка перехода по ссылке, в цифровых меню - текстовые значения кнопок меню.
Не передаются: статус (онлайн/офлайн), аватар, телефон, информация о прочтении сообщений и рассылок, голосовые сообщения и звонки между сервисами.
Подключение VK-бота к линии 1С-Коннект
Подключение/отключение VK-ботов, управление подключенными ботами осуществляется с помощью специальной линии 1С-Коннект: Управление каналами. Необходимо найти и подключить данную линию.
Выберите в цифровом меню “VK”.
Выберите в цифровом меню “Подключить VK-бот”.
Выберите линию, к которой необходимо подключить VK-бот:
Подключение возможно к линиям вашей компании с типом доступности “Для клиентов и специалистов”.
Предлагаемые линий можно листать с помощью стрелочек.
Для подключения VK-бота, вам понадобится его токен. Чтобы создать токен API для бота, перейдите в настройки управления вашим сообществом, выберите раздел "Работа с API" и нажмите "Создать ключ".
Для выполнения этого действия необходима включенная двухфакторная аутентификация на вашей странице VK.
Для получения токена, предоставьте боту права на управление сообществом, доступ к сообщениям, фотографиям и документам. Выберите необходимы права:
Разрешить приложению доступ к управлению сообществом;
Разрешить приложению доступ к сообщениям сообщества;
Разрешить приложению доступ к фотографиям сообщества;
Разрешить приложению доступ к документам сообщества.
Скопируйте созданный ключ для дальнейшей привязки его к линии в 1С-Коннект. Для повторного просмотра ключа, нажмите "Показать" и подтвердите запрос в приложении VK.
Перейдите на вкладку "Long Poll API" и активируйте эту функцию.
Укажите следующие типы событий:
Входящее сообщение;
Исходящее сообщение.
Активируйте "Сообщения сообщества", далее в настройках бота включите "Возможности ботов".
Полученный токен введите в диалоге с мастером подключения VK-бота в линии 1С-Коннект: Управление каналами.
Мастер попросит вас перейти по специальной ссылке и ввести учетную запись API, которую будет использовать VK-бот при взаимодействии с 1С-Коннект.
Учетную запись API вы можете зарегистрировать в кабинете администратора 1С-Коннект.
После авторизации в приложение поступит сообщение о подключении VK-бота к линии.
Отключение интеграции VK и линии поддержки
По линии поддержки “1С-Коннект: Управление каналами” в цифровом меню выберите “VK”.
Выберите “Отключить VK-бот”.
Выберите линию, от которой необходимо отключить VK-бот.
Для подтверждения отключения VK-бота от линии, пройдите по специальной временной ссылке и введите учетную запись API, которая используется для данного бота.
После авторизации в приложение поступит сообщение об отключении VK-бота от линии.
Просмотр списка линий, подключенных к VK, и мониторинг их состояния
В диалоге по линии 1С-Коннект: Управление каналами выберите VK.
Выберите “Показать линии с VK-бот”.
В чате будет выведен список линий, подключенных к VK-боту, содержащий в себе название линии, название VK-бота, название клиента и состояние подключения.
Ограничения
Компания может подключить до 5 VK-ботов к своим линиям.
К одной линии можно подключить один VK-бот. К одному VK-боту можно подключить одну линию 1С-Коннект.
Из VK-бота в 1С-Коннект можно передавать:
Изображения в составе сообщения до 25 МБ, прикрепленые изображений как файл до 100 МБ;
Файлы - до 100 Мб каждый.
Из 1С-Коннект в VK-бот можно передавать:
Изображения размером до 100 Мб каждое.
Файлы 100 Мб для базовых функций, до 1 Гб для расширенных.
Сроки хранения файлов на стороне 1С-Коннект определяются тарифом компании, на стороне VK-бота - политикой разработчика Вконтакте.