Push-уведомления для вашего приложения: один API, одна платформа
Отправляйте push-уведомления пользователям приложения через тот же REST API, что и SMS, WhatsApp и RCS, а тем, кто не открыл приложение, пишите по другому каналу.
curl -X POST https://api.broadnet.me/push/message/send \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"userRefs": ["user-10293"],
"title": "Your order has shipped",
"body": "Tap to track your parcel.",
"deepLink": "https://example.com/orders/8842",
"category": "UTILITY",
"priority": "HIGH",
"ttl": 3600
}'Запрос на отправку push-уведомления в API OmniChannels.ai. Значения условные.
Короткий ответ
Обновлено
OmniChannels.ai — сервис push-уведомлений и API для мобильных приложений. Вы вызываете POST /push/message/send с заголовком, текстом и аудиторией: ID пользователей, токены устройств, топики или сегмент. Уведомления могут содержать изображения, deep link и кнопки действий, использовать сохранённые шаблоны, отправляться по расписанию и сначала проверяться пробным запуском. При подключении наша команда настраивает ваш проект Firebase Cloud Messaging и, для iOS, ключи APNs.
Что умеет API push-уведомлений
Адресация по пользователю, токену, топику или сегменту
Используйте собственные ID пользователей (userRefs), конкретные токены устройств FCM, топики FCM или сегмент по стране, городу, языку и тегам.
Расширенные уведомления
Добавляйте изображение по HTTPS, deep link, который открывается по нажатию, и кнопки действий, например «Подтвердить» или «Перенести».
Сохранённые шаблоны
Создавайте шаблоны, просматривайте, отправляйте тестово и публикуйте с историей версий, а затем отправляйте по templateId со своими переменными.
Приоритет, время жизни и расписание
Помечайте срочные сообщения высоким приоритетом, задавайте время жизни (TTL), заменяйте старые уведомления через collapse key или планируйте отправку.
Пробный запуск перед отправкой
Установите dryRun в true, чтобы проверить запрос целиком, ничего не доставляя реальным пользователям.
Управление пакетами
Просматривайте список пакетов отправки и их детали, ставьте их на паузу, возобновляйте или отменяйте через эндпоинты пакетов.
Уведомления по геолокации
Геозоны (geofence) могут запускать уведомления по местоположению. Наша команда включает геозоны для вашего приложения по запросу.
Статусы доставки через вебхук
Отслеживайте статусы доставки на URL вебхука, указанном в вашем аккаунте, так же, как и для других каналов.
Push, SMS или WhatsApp: что выбрать?
Push доходит до тех, у кого установлено ваше приложение. SMS и WhatsApp доходят до номера телефона. Большинство компаний используют все три канала в таком порядке приоритета для каждого сообщения.
| Канал | Кого охватывает | Для чего лучше всего | Примечание |
|---|---|---|---|
| Push-уведомление | Пользователи, установившие приложение и зарегистрировавшие устройство | События в приложении: статус заказа, напоминания, предложения в приложении, возврат пользователей | Используйте первым шагом, когда пользователь есть в вашем приложении. |
| Клиенты с согласием, по номеру телефона | Живое общение, шаблоны, поддержка и чеки | Используйте, когда нужны диалог или медиа. | |
| SMS | Любой мобильный номер | OTP-коды, срочные оповещения и клиенты без приложения или WhatsApp | Используйте как универсальный резерв. |
Как начать отправлять push-уведомления
Push работает через Firebase Cloud Messaging и, для iOS, через Apple APNs, поэтому сначала нужен короткий этап подключения.
- 1
Подключите приложение
Наша команда подключает ваш проект Firebase Cloud Messaging и, для iOS, ключи APNs, и выдаёт вам ID приложения.
- 2
Зарегистрируйте устройства под вашими ID пользователей
Приложение регистрирует каждое устройство под вашим идентификатором userRef, чтобы вы отправляли сообщения людям, а не токенам.
- 3
Проверьте запрос пробным запуском
Вызовите POST /push/message/send с dryRun в true и убедитесь, что запрос корректен, прежде чем его увидят реальные пользователи.
- 4
Отправьте или запланируйте
Отправляйте на userRefs, токены, топики или сегмент либо планируйте отправку. Повторяющиеся сообщения сохраняйте как шаблоны.
- 5
Добавьте резервный канал
Решите, каким сообщениям нужен второй канал, например SMS для OTP или уведомления о доставке, и задайте порядок для каждого сценария.
Когда push — подходящий канал?
Подходит, если
- У вас есть мобильное приложение, и вы хотите писать установившим его пользователям, не зная их номеров телефонов.
- Сообщения связаны с событиями в приложении: статус заказа, напоминание о записи, оповещение по аккаунту.
- Вам нужны один API и один формат вебхуков для push, SMS, WhatsApp и других каналов.
- Вы хотите отправлять по собственному ID пользователя, а не управлять токенами устройств.
Что важно знать перед стартом
- Push доходит только до тех, кто установил приложение и разрешил уведомления.
- Документированный API охватывает мобильные push через FCM и APNs. Обо всём остальном спросите нашу команду, прежде чем строить на этом планы.
- Не полагайтесь только на push для OTP-кодов и критичных оповещений: добавьте резерв по SMS или голосу.
- Геозоны включаются для вашего приложения по запросу.
Вопросы о сервисе push-уведомлений
Что такое сервис push-уведомлений?
Сервис push-уведомлений доставляет короткие сообщения с ваших серверов на устройства пользователей, даже когда приложение закрыто. На Android доставка идёт через Firebase Cloud Messaging, на iOS — через Apple APNs. Сервис вроде OmniChannels.ai работает поверх обоих и даёт вам один API.
Как работает API push-уведомлений?
Приложение регистрирует каждое устройство и получает токен. Затем ваш бэкенд вызывает API с аудиторией и содержимым, а сервис передаёт уведомление в FCM или APNs для доставки. В OmniChannels.ai вы вызываете POST /push/message/send и можете адресовать пользователей по собственным ID.
Чем push-уведомления отличаются от SMS?
Push доходит до тех, кто установил приложение и разрешил уведомления, и требует интернета. SMS доходит до любого мобильного номера без приложения. Push подходит для обновлений в приложении и вовлечения. SMS подходит для OTP-кодов, срочных оповещений и клиентов без вашего приложения.
Можно ли отправить push-уведомление сегменту пользователей?
Да. Кроме ID пользователей, токенов устройств и топиков, API принимает объект сегмента с критериями вроде страны, города, языка и тегов вместе с ID вашего приложения. Отправку можно запланировать и пометить названием кампании.
Можно ли протестировать push-уведомление перед отправкой?
Да. Установите dryRun в true, чтобы проверить запрос, ничего не доставляя. Для шаблонов можно посмотреть превью на тестовых данных и отправить тест на своё устройство, прежде чем публиковать версию.
Можно ли добавить изображения, ссылки и кнопки?
Да. Уведомления могут содержать изображение по HTTPS, deep link, который открывается по нажатию, произвольные данные для приложения и кнопки действий, у каждой из которых есть ID, название и действие. Также можно отправлять сообщения только с данными и беззвучные.
Что делать, если пользователь не открывал приложение или отключил уведомления?
Push до него не дойдёт. Для важных сообщений настройте резерв по другому каналу, например SMS или WhatsApp. Порядок резерва задаётся для каждого сценария, а статусы доставки приходят в одном формате вебхука.
Как начать?
Закажите демо. При подключении наша команда настраивает ваш проект Firebase и ключи APNs, выдаёт ID приложения, и вы можете вызывать API со своим токеном. Документация для разработчиков перечисляет все эндпоинты push.
Руководства по теме
- ОмниканальностьСтратегия fallback: резервные каналы WhatsApp, RCS и SMS12 мин чтения
- SMS и OTPWhatsApp, SMS или RCS: какой канал выбрать для OTP и рассылок8 мин чтения
- ИнтеграцииРуководство по интеграции API сообщений: REST, SMPP, вебхуки9 мин чтения
- Соответствие требованиямСогласие на рассылки (opt-in): WhatsApp, SMS и email8 мин чтения
- ОмниканальностьЧто такое омниканальные сообщения? Архитектура, примеры, выгоды10 мин чтения
Узнайте больше о платформе
Добавьте push в свой стек сообщений
Расскажите о своём приложении. Мы подключим FCM и APNs и покажем push рядом с SMS и WhatsApp.
Расскажите о вашем стеке и о том, что вы хотите подключить. Инженер по решениям свяжется с вами.