Перейти к основному содержимому
Версия: 4.12

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

Доступы​

подсказка

Для управления каналами пользователь должен находиться в группе с правами Администратор или Управление каналами.

Требования​

  • Сервер должен быть доступен из Интернета по доменному имени, а не по IP-адресу
  • Сервер должен принимать HTTPS-подключения с валидным (не самоподписанным) SSL-сертификатом

1. Создание канала в IQChannels​

Для работы с WhatsApp через EDNA необходимо создать отдельный канал:

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

2. Получение API-ключа в EDNA​

Для подключения потребуется API-ключ, сгенерированный в личном кабинете EDNA:

  1. Зайдите на https://app.edna.ru/

  2. В меню слева выберите раздел Интеграция
    image2022-3-27_9-3-42.png

  3. Перейдите на вкладку «Тестирование»
    image2022-3-27_9-41-30.png

  4. В блоке Ваш API-ключ нажмите «Сгенерировать новый API-ключ»

  5. Скопируйте полученный ключ — он потребуется при настройке канала в IQChannels

    Не закрывайте вкладку EDNA — она понадобится на следующем шаге!

3. Настройка канала в IQChannels​

  1. Перейдите в созданный WhatsApp (EDNA) канал
  2. Откройте вкладку «Настройки»
  3. Заполните следующие параметры:
    • API URL: https://app.edna.ru/
    • API-ключ: вставьте ранее скопированный ключ
    • Каскад: выберите из выпадающего списка (данные подгружаются из EDNA)
    • Webhook URL: формируется автоматически — его необходимо будет скопировать и зарегистрировать в EDNA

4. Регистрация Webhook URL в EDNA​

  1. Вернитесь в EDNA в раздел Интеграция
    image2022-3-27_9-3-42.png

  2. Перейдите на вкладку «Тестирование»
    image2022-3-27_9-41-30.png

  3. Вставьте скопированный Webhook URL из IQChannels в оба поля (для входящих и исходящих сообщений)
    image2022-3-27_9-49-22.png

Один и тот же Webhook URL используется в обоих полях.

5. Проверка работоспособности​

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

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

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