ВК-канал: создание и настройка
Для управления каналами требуется, чтобы пользователь был в группе с полномочиями Администратор или Управление каналами.
Требования
- Сервер должен быть доступен из Интернета по публичному доменному имени, не по IP-адресу. Это может быть Nginx или другой прокси-сервер.
- Сервер должен поддерживать входящие HTTPS-подключения и иметь валидный, не самоподписанный сертификат.
1. Подготовка сообщества ВК
IQChannels поддерживает обмен сообщениями с сообществом во ВКонтакте:
-
Создайте сообщество, если его ещё не существует (ВК → Сообщества → Создать сообщество).
-
Включите сообщения сообщества: сообщество → Управление → Настройки → Сообщения.
-
Создайте ключ доступа к API: сообщество → Управление → Работа с API → Ключи доступа → Создать ключ. Ключ должен быть создан со следующими правами:
- Доступ к сообщениям сообщества
- Доступ к фотографиям сообщества
- Доступ к документам сообщества
Последние два права нужны для возможности отправки фотографий и файлов в переписке.
Сообщество готово, перейдите к созданию канала.
2. Создание ВК-канала в IQChannels
- Перейдите во вкладку «Каналы» в сегменте
- Нажмите кнопку «Создать канал» в правом верхнем углу
- Заполните форму создания канала, укажите тип канала ВКонтакте
- Подтвердите создание канала
3. Карточка «Настройка VK»
Перейдите на страницу созданного канала → вкладка «Настройки». В карточке «Настройка VK» укажите:
| Поле | Описание |
|---|---|
| ID группы | Значение group_id, указанное на странице «Callback API / Настройки сервера» в управлении сообществом, например 1234567890 |
| Ключ доступа | Ключ доступа к API сообщества, созданный на шаге 1 (страница «Ключи доступа») |
| Строка подтверждения | Строка, которую должен вернуть сервер, указанная на странице «Callback API / Настройки сервера», например a8cda0c7 |
Нажмите «Сохранить». При корректно заполненных настройках на карточке отображается бейдж «Готово».
Значения group_id и строки подтверждения находятся в управлении сообществом ВК: Настройки → Работа с API → Callback API.
4. Карточка «Подтверждение сервера»
После сохранения настроек подтвердите сервер в ВК. Для подтверждения сервера используйте параметры из карточки:
| Поле | Описание |
|---|---|
| Адрес сервера | Webhook-адрес IQChannels, на который ВК будет присылать события |
| Секретный ключ | Ключ для проверки подписи событий |
Порядок действий:
- Скопируйте Адрес сервера и Секретный ключ из карточки «Подтверждение сервера»
- Перейдите в сообщество ВК: Настройки → Работа с API → Callback API
- Укажите скопированные значения и сохраните
- Подтвердите адрес сервера
5. Карточка «Типы событий»
События, которые VK будет присылать на адрес сервера. Для работы канала в ВК включите типы событий:
- Входящее сообщение
- Исходящее сообщение
- Разрешение на получение
- Запрет на получение
Для настройки перейдите в сообщество ВК: Настройки → Работа с API → Callback API → Типы событий — и включите перечисленные события.
6. Версия API ВКонтакте
IQChannels работает с API ВКонтакте версии 5.131 — версия зафиксирована в коннекторе.
При проверке и отладке запросов (в тестовых инструментах ВК) явно указывайте параметр v=5.131 и не используйте автоматический выбор «последней» версии API.
Это позволяет:
- исключить несовместимость при выходе новых версий API;
- обеспечить стабильную работу коннектора без доработок при изменениях в методах API;
- снизить риск некорректной обработки событий Callback API.
Изменение версии API выполняется централизованно, при обновлении коннектора IQChannels, после анализа изменений и проверки совместимости.
7. Разрешённые домены для передачи медиафайлов
Для корректной работы обмена медиафайлами (изображения, стикеры, документы, видео и другие вложения) ВКонтакте использует не только основной домен API, но и автоматически генерируемые CDN- и media-домены.
Если на стороне клиента действует политика информационной безопасности (например, ДИБ разрешает сетевое взаимодействие только с ограниченным перечнем доменов), необходимо заранее проверить, что данные доменные маски разрешены для исходящих подключений.
Без этого загрузка и отправка вложений может работать некорректно: сообщения будут передаваться, но изображения, стикеры, документы и другие медиафайлы могут не загружаться или не отображаться.
Необходимо добавить в список разрешённых следующие маски:
*.vkuserphoto.ru— загрузка фотографий*.vk.ru— загрузка стикеров*.vk.com— основное API и серверы загрузки*.userapi.com— базовое хранилище контента*.vk-cdn.net— тяжёлые файлы и видео*.vk.me— медиафайлы мессенджера
Рекомендуется согласовать данный перечень с подразделением информационной безопасности (ДИБ) клиента до начала тестирования канала.
При возникновении проблем с передачей вложений в первую очередь необходимо проверить наличие доступа именно к этим доменным маскам.
8. Вкладка «Правило автоматической идентификации клиентов»
На странице канала доступна вкладка «Правило автоматической идентификации клиентов» (помечена бейджем beta).
Для корректной работы автоматической идентификации клиентов со стороны CRM/ДБО должен быть реализован протокол Search Client API.
Настройки вкладки:
- флаг «Идентификация неавторизованных клиентов при обращении» — включает автоматическую идентификацию;
- «Идентификатор:» — тип идентификатора, доступно значение «Телефон»;
- «Вопрос, который задается при отсутствии идентификатора» — сообщение клиенту с просьбой указать телефон (подсказка в поле: «Введите, пожалуйста, телефон для идентификации»).
9. Проверка канала
Для проверки канала:
- Перейдите в сообщество в ВК и напишите сообщение сообществу
- В IQChannels должно появиться новое открытое обращение из канала ВК
- В случае ошибки посмотрите логи IQChannels