---
title: Что такое Push (Mobile Push)
description: Push-канал — отправка push-уведомлений в приложение компании на телефоне
---
> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.mydialogi.ru/llms.txt). Append `.md` to any page URL for its markdown version.
> **Коротко:** Push — канал для отправки push-уведомлений в **установленное приложение компании** на телефоне получателя.
## Кому подходит
- Роль: Клиент, Менеджер рассылок
- Уровень: Новичок / Опытный
## Что это
**Push (Mobile Push)** — канал для отправки push-уведомлений. Сообщения отправляются в **установленное приложение компании** на телефоне получателя.
Чтобы сообщение дошло, у получателя должно быть **установлено приложение вашей компании** и включены уведомления.
Если приложения нет — сообщение **не отправится**.
В **каскаде** Push (Mobile Push) работает так же, как и другие каналы: если у получателя нет приложения, сообщение автоматически уйдёт по **следующему каналу** в цепочке.
[Что такое каскад →](https://docs.mydialogi.ru/05-channels/00-overview/cascade)
## Перед началом
- [ ] У вас есть имя отправителя Push со статусом **Активно** — [Имя отправителя для Push →](https://docs.mydialogi.ru/05-channels/08-push/sender-id).
- [ ] У вас есть контакты с **токенами устройств**.
- [ ] У получателей установлено приложение вашей компании.
- [ ] Вы открыли форму создания рассылки или шаблона.
## Что содержит
| Элемент | Обязательность | Что содержит |
|---|---|---|
| **Заголовок** | Хотя бы одно из трёх | Тема уведомления |
| **Текст сообщения** | Хотя бы одно из трёх | Основное содержимое |
| **Изображение** | Хотя бы одно из трёх | Картинка уведомления |
При создании Push-сообщения настройте **хотя бы один** из блоков: изображение, заголовок или текст. Пустое уведомление не отправится.
## Структура payload в API
При отправке через API используется объект `notification`:
```json
{
"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 изображения |
## Как настроить
### 1. Откройте настройки Push
В форме создания рассылки выберите канал **Push**.
### 2. Загрузите изображение
1. Нажмите на плейсхолдер изображения.
2. Загрузите с устройства или выберите из базы **Медиа**.
### 3. Введите заголовок и текст
- **Заголовок** — тема уведомления.
- **Текст сообщения** — основное содержимое.
### 4. Персонализируйте сообщение
Вставьте атрибуты из базы контактов — например, `{{attribute.name}}`.
### 5. Выберите отправителя
В поле **Отправитель** выберите имя со статусом **Активно**.
### 6. Настройте статус и период ожидания
Для канала Push статус **Доставлено недоступен**. Установите значение **Отправлено**.
**Период ожидания** — если истечёт, система переключится на следующий канал в каскаде.
### 7. Сохраните
Доступны три действия:
- **Сохранить** — сохранить сообщение.
- **Удалить шаг** — удалить шаг из цепочки каскада.
- **Отменить** — отменить изменения.
## Результат
Push-сообщение настроено и готово к отправке в рассылке или шаблоне.
- [Что такое каскад →](https://docs.mydialogi.ru/05-channels/00-overview/cascade)
- [Обзор API OTP-кодов →](https://docs.mydialogi.ru/02-otp/08-api/otp-api-overview)
- [Обзор API Multi API →](https://docs.mydialogi.ru/03-multiapi/02-api/mapi-101-api-overview)
- [Обзор API Мой диалог →](https://docs.mydialogi.ru/04-mydialogi/09-api/md-api-overview)
> **Сколько это стоит?**
> Push тарифицируется за отправку.
> Подробнее: [Обзор тарифов →](https://docs.mydialogi.ru/06-reference/02-pricing/pricing-overview).
## Частые проблемы
### Уведомление не приходит
**Причина:** у получателя не установлено приложение компании, или не сохранён токен устройства.
**Решение:** убедитесь, что у получателя установлено приложение компании, и в контакте сохранён токен устройства. В каскаде сообщение уйдёт по следующему каналу.
[Что такое каскад →](https://docs.mydialogi.ru/05-channels/00-overview/cascade)
### Пустое уведомление не отправляется
**Причина:** не заполнен ни один из блоков — изображение, заголовок, текст.
**Решение:** заполните **хотя бы один** из блоков.
### Не отображается статус Доставлено
**Причина:** канал Push **не поддерживает** статус «Доставлено».
**Решение:** используйте статус **Отправлено** — это норма для канала Push.
### Персонализация не подставляется
**Причина:** неверный ключ атрибута.
**Решение:** проверьте формат — например, `{{attribute.name}}`.
[Управление атрибутами →](https://docs.mydialogi.ru/04-mydialogi/03-contacts/md-504-attributes)
### Изображение не загружается
**Причина:** файл не загружен в базу **Медиа** или ссылка повреждена.
**Решение:** загрузите изображение заново.
[Как загрузить медиафайл →](https://docs.mydialogi.ru/04-mydialogi/06-assets/md-801-media)
### Нет токена устройства
**Причина:** контакт не привязан к приложению компании.
**Решение:** получатель должен установить приложение компании и авторизоваться — тогда токен появится в контакте.
## См. также
Регистрация имени отправителя
Автоматическое переключение между каналами
OMNI API, Broadcasts API, 2FA
OMNI API и Broadcasts API
## Нужна помощь?
- **OTP-коды:** support@otpcod.ru
- **Multi API:** support@multiapi.ru
- **Мой диалог:** support@mydialogi.ru