Содержание
Требования
- Сервер должен быть доступен из Интернета по публичному доменному имени, не по IP-адресу. Это может быть Nginx или другой прокси-сервер.
- Сервер должен поддерживать входящие HTTPS подключения и иметь валидный, не самоподписанный сертификат.
Создание сообщества в ВК
1) Создание сообщества в ВК (если не существует)
IQChannels поддерживает обмен сообщений для сообщества во Вконтакте. Создайте сообщество, если его еще не существует. Для этого:
- Перейдите в раздел Сообщества в левом меню ВК.
- Нажмите на кнопку Создать сообщество в правом верхнем углу.
- Заполните форму создания сообщества.
- Подтвердите создание сообщества.
2) Включение сообщений в сообществе
По умолчанию сообщения в сообществе выключены. Для включения сообщений в сообществе:
- Зайдите в свое сообщество в ВК.
- В правом левом меню перейдите в раздел Управление.
- В разделе Настройки перейдите в подраздел Сообщения.
- Включите сообщения сообщества.
- Сохраните изменения.
Создание ВК-канала в IQChannels
1) Создание ВК-канала
В IQChannels требуется создать отдельный канал с типом Вконтакте для поддержки сообщений сообщества. Для этого:
- Перейдите в раздел Каналы в проекте.
- Нажмите на кнопку Создать канал в правом верхнем углу.
- Заполните форму создания канала, укажите тип канала Вконтакте.
- Подтвердите создание канала.
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.