WhatsApp-канал через шлюз EDNA: создание и настройка
Доступы
подсказка
Для управления каналами пользователь должен находиться в группе с правами Администратор или Управление каналами.
Требования
- Сервер должен быть доступен из Интернета по доменному имени, а не по IP-адресу
- Сервер должен принимать HTTPS-подключения с валидным (не самоподписанным) SSL-сертификатом
1. Создание канала в IQChannels
Для работы с WhatsApp через EDNA необходимо создать отдельный канал:
- Перейдите в раздел «Каналы» в нужном сегменте
- Нажмите «Создать канал» в правом верхнем углу
- Укажите тип канала: WhatsApp (EDNA)
- Подтвердите создание
2. Получение API-ключа в EDNA
Для подключения потребуется API-ключ, сгенерированный в личном кабинете EDNA:
- Зайдите в личный кабинет EDNA (https://app.edna.ru/)
- В меню слева выберите раздел Интеграция
- Перейдите на вкладку «Тестирование»
- В блоке Ваш API-ключ нажмите «Сгенерировать новый API-ключ»
- Скопируйте полученный ключ — он потребуется при настройке канала в IQChannels
Не закрывайте вкладку EDNA — она понадобится на следующем шаге!
3. Настройка канала в IQChannels
- Перейдите в созданный WhatsApp (EDNA) канал
- Откройте вкладку «Настройки»
Карточка «Настройка WhatsApp (EDNA)»
| Поле | Описание |
|---|---|
| Адрес API | Адрес API сервера, полученный от EDNA (в поле отображается подсказка https://app.edna.io) |
| API-ключ | API-ключ в EDNA — вставьте ранее скопированный ключ |
| Каскад | Каскад, настроенный в личном кабинете EDNA (требуется для отправки сообщений из IQChannels). Выбирается из раскрывающегося списка; рядом с полем находится кнопка обновления списка каскадов |
Нажмите «Сохранить». При сохранённом адресе API на карточке отображается бейдж «Готово».
Карточка «Настройка сервера»
- Webhook URL — адрес, на который EDNA будет присылать новые сообщения. Формируется автоматически при создании канала; его нужно зарегистрировать в личном кабинете EDNA.
4. Регистрация Webhook URL в EDNA
- Вернитесь в EDNA в раздел Интеграция
- Перейдите на вкладку «Тестирование»
- Вставьте скопированный Webhook URL из IQChannels в оба поля (для входящих и исходящих сообщений)
Один и тот же Webhook URL используется в обоих полях.
5. Проверка работоспособности
- Откройте приложение WhatsApp
- Найдите контакт канала (указан в личном кабинете EDNA)
- Отправьте тестовое сообщение
- Убедитесь, что обращение отобразилось в интерфейсе IQChannels
- В случае проблем проверьте логи IQChannels
Важная информация
На сообщение, поступившее из WhatsApp, можно ответить только в течение 24 часов. После этого окно общения закрывается. Инициировать переписку оператор не может — только отвечать.