Доступы:
Для управления каналами требуется, чтобы пользователь был в группе с полномочиями Администратор или Управление каналами
Требования
- Сервер должен быть доступен из Интернета по публичному доменному имени, не по IP-адресу. Это может быть Nginx или другой прокси-сервер.
- Сервер должен поддерживать входящие HTTPS подключения и иметь валидный, не самоподписанный сертификат.
1. Создание сообщества в ВК
1.1 Создание сообщества в ВК (если не существует)
IQChannels поддерживает обмен сообщений для сообщества во Вконтакте. Создайте сообщество, если его еще не существует. Для этого:
1 | Перейдите в раздел Сообщества в левом меню ВК | |
2 | Нажмите на кнопку Создать сообщество в правом верхнем углу | |
3 | Заполните форму создания сообщества | |
4 | Подтвердите создание сообщества. |
1.2 Включение сообщений в сообществе
По умолчанию сообщения в сообществе выключены. Для включения сообщений в сообществе:
1 | Зайдите в свое сообщество в ВК. | |
2 | В правом левом меню перейдите в раздел Управление. | |
3 | В разделе Настройки перейдите в подраздел Сообщения | |
4 | Включите сообщения сообщества |
2. Создание ВК-канала в IQChannels
2.1 Создание ВК-канала
В IQChannels требуется создать отдельный канал с типом Вконтакте для поддержки сообщений сообщества. Для этого:
1 | Перейдите во вкладку Каналы в сегменте | |
2 | Нажмите на кнопку Создать канал в правом верхнем углу | |
3 | Заполните форму создания канала, укажите тип канала Вконтакте | |
4 | Подтвердите создание канала |
2) Создание ключа доступа к API в ВК-сообществе
Для доступа сервера IQChannels к сообщениям сообщества требуется создать отдельный ключ доступа к API сообщества Вконтакте. Для этого:
- Зайдите в сообщество в ВК.
- В правом меню перейдите в раздел Управление.
- В настройках перейдите в подраздел Работа с API.
- На странице Ключи доступа нажмите Создать ключ.
- При создании ключа укажите разрешения:
– Доступ к сообщениям
– Доступ к фотографиям
– Доступ к документам
Последние нужны для возможности отправки фотографий и файлов в переписке. - Создайте ключ и сохраните/скопируйте его. Его потребуется указать в панели управления IQChannels.
3) Настройка доступа к ВК-сообществу в IQChannels
- Перейдите в раздел Каналы в Проекте в IQChannels.
- В проекте выберите ВК-канал и перейдите в его настройки.
- На этой странице нужно указать ID группы (сообщества) в ВК, ключ доступа и строку подтверждения.
- Укажите ключ доступа, который создали на предыдущем шаге Создание ключа доступа к API в ВК-сообществе.
- Для получения информации о группе и строке подтверждения:
- Перейдите в сообщество в ВК.
- Перейдите в раздел Управление в правом меню.
- Перейдите в подраздел Работа с API в правом меню.
- Перейдите на страницу Callback API в верхнем меню.
- На этой странице указаны group_id и строка, которую должен вернуть сервер. На скриншоте выше это "group_id": 1933... и f2b9...
- Скопируйте значения в форму настройки в IQChannels.
- Сохраните изменения.
4) Подтверждение сервера в ВК-сообществе
Последний шаг, требуется подтвердить сервер IQChannels в сообществе. Для этого:
- Перейдите в сообщество в ВК.
- Перейдите в Управление → Работа с API → Callback API.
- На этой странице нужно указать Адрес и Секретный ключ. Эти значения нужно взять из настроек канала в IQChannels.
- Для получения Адреса и Секретного ключа:
- Перейдите в Проект → Каналы → Канал ВК → Настройки в IQChannels.
- Прокрутите страницу вниз до блока Подтверждение сервера.
- Скопируйте значения Адреса сервера и Секретного ключа в форму Подтверждения сервера в ВК.
- Нажмите Сохранить секретный ключ.
- Нажмите Подтвердить адрес сервера.
- Готово, канал настроен. Если требуется, настройке маршрутизацию обращений для нового канала в Проекте в IQChannels.
- Перейдите в Проект → Каналы → Канал ВК → Настройки в IQChannels.
5) Проверка канала
Для проверки канала:
- Перейдите в сообщество в ВК,
- В правом меню нажмите Написать сообщение.
- Отправьте новое сообщение.
- В IQChannels должно появиться новое открытое обращение из канала ВК.
- В случае ошибки посмотрите логи IQChannels.