Как подключить мобильный чат iOS
Как добавить канал
- Перейдите в раздел Настройки → Интеграции → Каналы и нажмите Создать.
- Выберите тип канала Мобильный чат → iOS.
- Выполните настройки на вкладках Параметры, Уведомления, Установка.
Настройка параметров канала
-
Перейдите на вкладку Параметры.
-
Укажите Название канала — будет отображаться в отчетах и бейджах рядом с тредом в персональной очереди агента.
к сведениюМаксимальное количество символов в названии — 50.
-
Укажите Название приложения — будет отображаться в отчетах, фильтрах и настройках администратора.
-
Выберите Тип доступа — авторизованный или неавторизованный. По умолчанию — авторизованный тип доступа.
-
Укажите Bundle ID — уникальный идентификатор вашего приложения в Apple Developer Account. Его можно узнать различными способами:
-
Поле Bundle Identifier в разделе General → Identify в вашем проекте Xcode.
-
Колонка Identifier в разделе Certificates, Identifiers & Profiles → Identifiers в Apple Developer Portal.
-
Поле Bundle ID в разделе Apps → Название вашего приложения → General → App Information → General Information в App Store Connect.
-
-
(Опционально) Укажите Параметры конфигурации. По умолчанию указаны оптимальные параметры.
Настройка пуш-уведомлений канала
-
Перейдите на вкладку Уведомления.
-
Переведите переключатель Push-уведомления в активное положение.
-
(Опционально) Переведите переключатель Отправка в тестовое (sandbox) окружение в активное положение для тестирования пуш-уведомлений в sandbox-окружении Apple.
-
Выберите способ подключения пуш-уведомлений — с помощью ключа .p8 или сертификата .p12.
подсказкаПо умо лчанию используется ключ .p8 — это также рекомендуемый вариант.
- APNs ключ (.p8)
- APNs сертификат (.p12)
-
Создайте ключ .p8:
-
Авторизуйтесь в Apple Developer Portal.
-
Перейдите в раздел Certificates, Identifiers & Profiles → Keys и нажмите и ли Create a key, если у вас ещё нет ключей.
-
Введите имя ключа в поле Key Name.
-
(Опционально) Введите описание ключа в поле Key Usage Description.
-
Установите флажок Apple Push Notifications service (APNs) и нажмите Configure в правой части строки.
-
В конфигурации ключа выберите Sandbox & Production в выпадающем меню Environment и нажмите Save.
-
Нажмите Continue, проверьте информацию о создаваемом ключе и нажмите Register.
-
На странице Download Your Key запишите Key ID, нажмите Download и сохраните ключ.
warningПовторно загрузить или просмотреть ключ нельзя — сохраните локальную копию в надёжном месте.
-
-
Запишите Team ID:
-
Авторизуйтесь в Apple Developer Portal.
-
Перейдите на раздел Membership — Team ID будет указан в разделе Membership Information.
-
-
Загрузите ключ .p8 в edna Chat Center
- Выберите APNS ключ (.p8).
- Укажите Key ID и Team ID, полученные ранее.
- Нажмите Прикрепить и выберите полученный ранее ключ .p8.
-
Создайте запрос сертификата:
- Откройте приложение Keychain Access на вашем Mac.
- Выберите пункт Request a Certificate from a Certificate Authority в меню Keychain Access → Certificate Assistant.
- Введите ваш email, имя и выберите Saved to disk и нажмите Continue.
- Сохраните файл с расширением
.certSigningRequest.
-
Создайте сертификат в Apple Developer Portal:
-
Авторизуйтесь в Apple Developer Portal.
-
Перейдите в раздел Certificates, Identifiers & Profiles → Certificates и нажмите .
-
Выберите вариант Apple Push Notification service SSL (Sandbox & Production) и нажмите Continue.
-
Выберите Bundle ID, соответствующий приложению для которого генерируется сертификат.
-
Загрузите файл с расширением
.certSigningRequest, созданный ранее в Keychain Access, и нажмите Continue. -
Нажмите Download и сохраните сертификат с расширением
.cer.
-
-
Экспортируйте сертификат .p12:
- Установите загруженный ранее сертификат с расширением
.cer, дважды кликнув по нему, в Keychain Access. - Откройте Keychain Access и перейдите в раздел My Certificates.
- Найдите сертификат, который начинается с Apple Push Services: bundle.id.
- Нажмите слева от сертификата, чтоб увидеть связанный с ним приватный клю ч.
- Выделите сертификат и связанный с ним приватный ключ и, нажав правой кнопкой мыши, выберите в контекстном меню Export 2 items....
- Выберите формат сертификата Personal Information Exchange (.p12), введите имя файла и выберите куда сохранить файл.
- Нажмите Save.
- Придумайте и введите пароль и нажмите OK.
- Установите загруженный ранее сертификат с расширением
-
Загрузите сертификат .p12 в edna Chat Center:
- Выберите APNS сертификат (.p12).
- Нажмите Прикрепить и выберите полученный ранее сертификат .p12.
- Введите пароль в поле Пароль сертификата.
-
(Опционально) Настройте содержимое пуш-уведомления с помощью поля Шаблон.
Как настроить шаблоны пуш-уведомлений
Настройка установки канала
На вкладке Установка вы найдёте поля ID провайдера (providerUid), Домен edna Chat Center, WebSocket URL, REST API URL, DataStore URL — эти данные потребуются для дальнейшей интеграции mobile SDK edna Chat Center и вашего iOS-приложения.
Значение поля ID провайдера (providerUid) уже сгенерировано — его нельзя изменить. Значение поля Домен edna Chat Center настраивается и может принимать два значения:
- домен сервиса, если вы используете edna Chat Center в облаке;
- внешний домен точки входа в интернет, если edna Chat Center развёрнут внутри вашей инфраструктуры.
Значения полей WebSocket URL, REST API URL, DataStore URL формируются на основе значения поля Домен edna Chat Center и не редактируются.