WhatsApp-канал через шлюз EDNA: создание и настройка

Содержание

Требования

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

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

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

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

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

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

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

1. Зайдите в личный кабинет EDNA https://app.edna.ru/.
2. В меню слева перейдите в раздел Интеграция.
   
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. Каскад выберите из выпадающего списка (список каскадов автоматически загружается из EDNA).
6. В поле «Webhook URL» формируется автоматически URL для получения новых сообщений из EDNA. Его нужно зарегистрировать в личном кабинете EDNA.

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

1. Вернитесь в личный кабинет EDNA, раздел Интеграция. 
2. В меню слева перейдите в раздел Интеграция.
   
3. На странице Интеграция перейдите на вкладку Тестирование:
   
4. На вкладке Тестирование заполните адрес Webhook URL в поля:
   
   *один и тот же Webhook URL используется в обоих полях в EDNA.

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

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

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

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

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