Что такое Push (Mobile Push)
Push-канал — отправка push-уведомлений в приложение компании на телефоне
Коротко: Push — канал для отправки push-уведомлений в установленное приложение компании на телефоне получателя.
Кому подходит
- Роль: Клиент, Менеджер рассылок
- Уровень: Новичок / Опытный
Что это
Push (Mobile Push) — канал для отправки push-уведомлений. Сообщения отправляются в установленное приложение компании на телефоне получателя.
Чтобы сообщение дошло, у получателя должно быть установлено приложение вашей компании и включены уведомления.
Если приложения нет — сообщение не отправится.
В каскаде Push (Mobile Push) работает так же, как и другие каналы: если у получателя нет приложения, сообщение автоматически уйдёт по следующему каналу в цепочке.
Перед началом
- У вас есть имя отправителя Push со статусом Активно — Имя отправителя для Push →.
- У вас есть контакты с токенами устройств.
- У получателей установлено приложение вашей компании.
- Вы открыли форму создания рассылки или шаблона.
Что содержит
| Элемент | Обязательность | Что содержит |
|---|---|---|
| Заголовок | Хотя бы одно из трёх | Тема уведомления |
| Текст сообщения | Хотя бы одно из трёх | Основное содержимое |
| Изображение | Хотя бы одно из трёх | Картинка уведомления |
При создании Push-сообщения настройте хотя бы один из блоков: изображение, заголовок или текст. Пустое уведомление не отправится.
Структура payload в API
При отправке через API используется объект notification:
{
"channel": 10,
"contact": "cpRLb7mHSWa8TVaebL5xe7:APA91bGSly-XOYRzXu2DQZcxOR2Y4eL_Glx61-9ngx7MhhsgkjGi_2Zv8AzKyJgYlWQLg7lkectMPpNttcBeW6kOyKQS4H0hRyrZLMXzC7dSh_cnZb4jAs",
"senderId": "push_dev",
"payload": {
"notification": {
"title": "Заголовок",
"body": "Текст уведомления",
"image": "https://example-file-for-download.png"
}
}
}| Поле | Обязательность | Что указать |
|---|---|---|
notification.title | Хотя бы одно из трёх | Заголовок |
notification.body | Хотя бы одно из трёх | Текст |
notification.image | Хотя бы одно из трёх | URL изображения |
Как настроить
В форме создания рассылки выберите канал Push.
- Нажмите на плейсхолдер изображения.
- Загрузите с устройства или выберите из базы Медиа.
- Заголовок — тема уведомления.
- Текст сообщения — основное содержимое.
Вставьте атрибуты из базы контактов — например, {{attribute.name}}.
В поле Отправитель выберите имя со статусом Активно.
Для канала Push статус Доставлено недоступен. Установите значение Отправлено.
Период ожидания — если истечёт, система переключится на следующий канал в каскаде.
Доступны три действия:
- Сохранить — сохранить сообщение.
- Удалить шаг — удалить шаг из цепочки каскада.
- Отменить — отменить изменения.
Результат
Push-сообщение настроено и готово к отправке в рассылке или шаблоне.
Сколько это стоит? Push тарифицируется за отправку. Подробнее: Обзор тарифов →.
Частые проблемы
Причина: у получателя не установлено приложение компании, или не сохранён токен устройства.
Решение: убедитесь, что у получателя установлено приложение компании, и в контакте сохранён токен устройства. В каскаде сообщение уйдёт по следующему каналу.
Причина: не заполнен ни один из блоков — изображение, заголовок, текст.
Решение: заполните хотя бы один из блоков.
Причина: канал Push не поддерживает статус «Доставлено».
Решение: используйте статус Отправлено — это норма для канала Push.
Причина: неверный ключ атрибута.
Решение: проверьте формат — например, {{attribute.name}}.
Причина: файл не загружен в базу Медиа или ссылка повреждена.
Решение: загрузите изображение заново.
Причина: контакт не привязан к приложению компании.
Решение: получатель должен установить приложение компании и авторизоваться — тогда токен появится в контакте.
См. также
Нужна помощь?
- OTP-коды: support@otpcod.ru
- Multi API: support@multiapi.ru
- Мой диалог: support@mydialogi.ru