Page History

Содержание

Требования

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

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

1) Создание

...

канала

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

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

2)

...

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

...

EDNA

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

1. Зайдите в сообщество в ВКличный кабинет EDNA https://app.edna.ru/.
2. В правом меню слева перейдите в раздел Управление Интеграция.
   Image Removed
3. В настройках перейдите в подраздел Работа с API.
   Image Removed
4. На странице Ключи доступа нажмите Создать ключ.
   Image Removed
5. При создании ключа укажите разрешения:
   – Доступ к сообщениям
   – Доступ к фотографиям
   – Доступ к документам
   Последние нужны для возможности отправки фотографий и файлов в переписке.
   Image Removed
6. Image Added
7. На странице Интеграция перейдите на вкладку Тестирование:
   Image Added
8. В поле Ваш API-ключ нажмите кнопку справа и выберите Сгенерировать новый API-ключ. 
9. Создайте ключ и Создайте ключ и сохраните/ скопируйте его. Его потребуется указать в панели управления IQChannels. Панель пока не закрывайте, она нам еще пригодится!

3) Настройка доступа к

...

WhatsApp (EDNA) в IQChannels

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

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

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

1. EDNA.
2. Каскад выберите из выпадающего списка (список каскадов автоматически загружается из EDNA).
3. В поле «Webhook URL» формируется автоматически URL для получения новых сообщений из EDNA. Его нужно зарегистрировать в личном кабинете EDNA.

4) Регистрация «Webhook URL» в EDNA

1. Вернитесь в личный кабинет EDNA, раздел Интеграция. 
2. В меню слева перейдите в раздел Интеграция.
   Image Added
3. На странице Интеграция перейдите на вкладку Тестирование:
   Image Added
4. На вкладке Тестирование заполните адрес Webhook URL в поля:
   Image Added
   *один и тот же Webhook URL используется в обоих полях в EDNA
5. Перейдите в сообщество в ВК.
6. Перейдите в Управление → Работа с API → Callback API.
   Image Removed
7. На этой странице нужно указать Адрес и Секретный ключ. Эти значения нужно взять из настроек канала в IQChannels.
8. Для получения Адреса и Секретного ключа:
9. Перейдите в Проект → Каналы → Канал ВК → Настройки в IQChannels.
   Image Removed
10. Прокрутите страницу вниз до блока Подтверждение сервера.
    Image Removed
11. Скопируйте значения Адреса сервера и Секретного ключа в форму Подтверждения сервера в ВК.
    Image Removed
12. Нажмите Сохранить секретный ключ.
13. Нажмите Подтвердить адрес сервера.
    Image Removed
Готово, канал настроен. Если требуется, настройке маршрутизацию обращений для нового канала в Проекте в IQChannels.

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

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

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

Важная информация

При получении сообщения от контакта WhatsApp, вы можете ответить на него в течение 24х часов. Потом обращение считается закрытым, инициатором переписки в WhatsApp оператор не может выступать.