Создание WhatsApp-канала через шлюз EDNA

Содержание

Требования

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

Создание WhatsApp (EDNA) канала в IQChannels

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

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

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

2) Получение ключа доступа к API в EDNA

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

1. Зайдите в личный кабинет EDNA https://app.edna.ru/.
2. В меню cktdf перейдите в раздел Интеграция.
   
3. На странице Интеграция переходим на вкладку Тестирование:
   
4. В поле Ваш API-ключ нажмите кнопку справа и выберите Сгенерировать новый API-ключ. 
5. Создайте ключ и скопируйте его. Его потребуется указать в панели управления IQChannels. Панель пока не закрывайте, она нам еще пригодится!

3) Настройка доступа к WhatsApp (EDNA) в IQChannels

1. Перейдите в раздел Каналы в Проекте в IQChannels.
2. В проекте зайдите в созданный WhatsApp (EDNA) канал и перейдите в его настройки.
3. На этой странице нужно указать адрес API EDNA (https://app.edna.ru/), API-ключ и Каскад.
4. У кажите API-ключ, который создали на предыдущем шаге Получение ключа доступа к API в EDNA.
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.