Создание ВК-канала

Содержание

Требования

• Сервер с IQChannels должен быть доступен из Интернета по публичному доменному имени, не по IP-адресу.
• Сервер должен поддерживать входящие HTTPS подключения и иметь валидный, не самоподписанный сертификат.

Создание сообщества в ВК

1) Создание сообщества в ВК (если не существует)

IQChannels поддерживает обмен сообщений для сообщества во Вконтакте. Создайте сообщество, если его еще не существует. Для этого:

1. Перейдите в раздел Сообщества в левом меню ВК.
2. Нажмите на кнопку Создать сообщество в правом верхнем углу.
3. Заполните форму создания сообщества.
   
4. Подтвердите создание сообщества.

2) Включение сообщений в сообществе

По умолчанию сообщения в сообществе выключены. Для включения сообщений в сообществе:

1. Зайдите в свое сообщество в ВК.
2. В правом левом меню перейдите в раздел Управление.
   
3. В разделе Настройки перейдите в подраздел Сообщения.
   
4. Включите сообщения сообщества.
   
5. Сохраните изменения.

Создание ВК-канала в IQChannels

1) Создание ВК-канала

В IQChannels требуется создать отдельный канал с типом Вконтакте для поддержки сообщений сообщества. Для этого:

1. Перейдите в раздел Каналы в проекте.
2. Нажмите на кнопку Создать канал в правом верхнем углу.
3. Заполните форму создания канала, укажите тип канала Вконтакте.
   
4. Подтвердите создание канала.

2) Создание ключа доступа к API в ВК-сообществе

Для доступа сервера IQChannels к сообщениям сообщества требуется создать отдельный ключ доступа к API сообщества Вконтакте. Для этого:

1. Зайдите в сообщество в ВК.
2. В правом меню перейдите в раздел Управление.
   
3. В настройках перейдите в подраздел Работа с API.
   
4. На странице Ключи доступа нажмите Создать ключ.
   
5. При создании ключа укажите разрешения:
   – Доступ к сообщениям
   – Доступ к фотографиям
   – Доступ к документам
   Последние нужны для возможности отправки фотографий и файлов в переписке.
   
6. Создайте ключ и сохраните/скопируйте его. Его потребуется указать в панели управления IQChannels.

3) Настройка доступа к ВК-сообществу в IQChannels

1. Перейдите в раздел Каналы в Проекте в IQChannels.
2. В проекте выберите ВК-канал и перейдите в его настройки.
   
3. На этой странице нужно указать ID группы (сообщества) в ВК, ключ доступа и строку подтверждения.
4. Укажите ключ доступа, который создали на предыдущем шаге Создание ключа доступа к API в ВК-сообществе.
5. Для получения информации о группе и строке подтверждения:
   1. Перейдите в сообщество в ВК.
   2. Перейдите в раздел Управление в правом меню.
      
   3. Перейдите в подраздел Работа с API в правом меню.
      
   4. Перейдите на страницу Callback API в верхнем меню.
      
   5. На этой странице указаны group_id и строка, которую должен вернуть сервер. На скриншоте выше это "group_id": 1933... и f2b9...
   6. Скопируйте значения в форму настройки в IQChannels.
      
   7. Сохраните изменения.
      

4) Подтверждение сервера в ВК-сообществе

Последний шаг, требуется подтвердить сервер IQChannels в сообществе. Для этого:

1. Перейдите в сообщество в ВК.
2. Перейдите в Управление → Работа с API → Callback API.
   
3. На этой странице нужно указать Адрес и Секретный ключ. Эти значения нужно взять из настроек канала в IQChannels.
4. Для получения Адреса и Секретного ключа:
   1. Перейдите в Проект → Каналы → Канал ВК → Настройки в IQChannels.
      
   2. Прокрутите страницу вниз до блока Подтверждение сервера.
      
   3. Скопируйте значения Адреса сервера и Секретного ключа в форму Подтверждения сервера в ВК.
      
   4. Нажмите Сохранить секретный ключ.
   5. Нажмите Подтвердить адрес сервера.
      
   6. Готово, канал настроен. Если требуется, настройке маршрутизацию обращений для нового канала в Проекте в IQChannels.

5) Проверка канала

Для проверки канала:

1. Перейдите в сообщество в ВК,
2. В правом меню нажмите Написать сообщение.
   
3. Отправьте новое сообщение.
   
4. В IQChannels должно появиться новое открытое обращение из канала ВК.
5. В случае ошибки посмотрите логи IQChannels.