Пуш-уведомления iOS (APNs)
Настройка доставки пуш-уведомлений на iOS-устройства клиентов через Apple Push Notification service (APNs) в карточке настроек канала.
Где настраивается
Карточка «Настройка APNS пуш-уведомлений (iOS)» находится в настройках канала внутреннего чата: Сегмент → Каналы → канал внутреннего чата → Настройки. Изменение настроек требует права «Управление каналами» (manage_channels); без него поля карточки заблокированы.
Пока флаг «Включить iOS пуш-уведомления» снят, поля карточки неактивны — установите флаг, заполните поля и сохраните настройки.
Промышленная среда
Флаг «Промышленная среда (APNS production mode)» выбирает сервер Apple, через который отправляются пуши: промышленная среда (production) или песочница (sandbox/development). Промышленная среда используется для сборок приложения из App Store; отладочные сборки получают пуши через песочницу.
Тип ключа
Селектор «Тип:» выбирает способ подключения к APNs:
- «Сертификат P12» — устаревший способ, оставлен для совместимости с существующими сертификатами;
- «Ключ P8» — рекомендуемый современный способ.
Состав полей карточки меняется от выбранного типа.
Сертификат P12
Для типа «Сертификат P12» заполните поля:
| Поле | Что указать |
|---|---|
| «Сертификат в формате PEM» | Сертификат пуш-уведомлений, преобразованный в PEM-формат |
| «Ключ в формате PEM» | Ключ сертификата в PEM-формате |
| «Пароль для ключа» | Пароль ключа, если он установлен: «Необязательное значение, ключ может быть без пароля.» |
| «Тема» | «BundleID приложения, например, com.example.ExampleApp» |
Сертификат и ключ генерируются в центре разработчика Apple и преобразуются в PEM-формат (например, через OpenSSL); Apple публикует инструкцию Establishing a Certificate-Based Connection to APNs.
Ключ P8
Для типа «Ключ P8» заполните поля:
| Поле | Что указать |
|---|---|
| «Ключ P8:» | Содержимое ключа P8 из центра разработчика Apple |
| «Key Id:» | Идентификатор ключа: «KeyId from developer account (Certificates, Identifiers & Profiles -> Keys)» |
| «Team Id:» | Идентификатор команды: «TeamID from developer account (View Account -> Membership)» |
| «Тема» | «BundleID приложения, например, com.example.ExampleApp» |
Ключ P8 создаётся в центре разработчика Apple (developer.apple.com) в разделе Certificates, Identifiers & Profiles → Keys с включённой поддержкой Apple Push Notification service. После скачивания ключ удаляется с серверов Apple — сохраните файл. Key Id виден на странице ключа, Team Id — на странице управления учётной записью.
Проверка настроек
Кнопка «Тест» в карточке рядом с кнопкой «Сохранить» отправляет тестовый пуш — Тестовый пуш.
Истёкший или отозванный сертификат (ключ) не отключает доставку явно: пуши молча перестают доходить до устройств, а сервер продолжает попытки отправки. Следите за сроком действия сертификата и обновляйте его заранее.