# Push-уведомления о смене статуса заказа

Если ваш магазин использует мобильное приложение с версией 2.0 или выше, вы можете подключить push-уведомления о смене статуса заказа через сервис OneSignal.

## Настройка API OneSignal

Для того, чтобы и приложение, и наш сервер могли работать с OneSignal, вам потребуется указать идентификатор приложения OneSignal (App ID) в конструкторе приложения. Так же необходимо указать этот же App ID и ключ REST API (REST API Key) в настройках уведомлений магазина.

App ID и REST API Key можно найти в вашем аккаунте OneSignal.

<figure><img src="/files/U6bxPtLmZ6tfRmTzvpnK" alt=""><figcaption><p>Раздел с информацией о приложении в интерфейсе OneSignal.</p></figcaption></figure>

### Настройка приложения

В панели управления магазином найдите ваше приложение в боковом меню слева. Выберите раздел **«Конструктор»** и перейдите в него.

В интерфейсе конструктора выберите раздел **«Интеграции»** и введите идентификатор вашего приложения в поле **Клиентский API ключ OneSignal**, предварительно выбрав **OneSignal** в выпадающем списке **Провайдер пуш уведомлений**. Сохраните настройки.

<figure><img src="/files/jlZAc4q6Sy64XGMUk5En" alt=""><figcaption><p>Редактирование интеграции push-уведомлений в конструкторе приложения.</p></figcaption></figure>

### Настройка уведомлений заказов

Перейдите в раздел **«Магазин»** -> **«Настройки заказов»** и найдите раздел **«Уведомления»**.

В этом разделе включите настройку **«Подключить пуш-уведомления OneSignal»**. Далее введите App ID в поле **«ID приложения OneSignal»** и ключ REST API в поле **«Ключ REST API приложения OneSignal»**. Сохраните настройки.

<figure><img src="/files/hxHGE7SqsIZHLBmfBWCV" alt=""><figcaption><p>Редактирование настроек уведомлений заказов.</p></figcaption></figure>

## Настройка статусов заказов

Теперь вам нужно отредактировать каждый статус заказа, для которого вы хотите подключить push-уведомления.

Перейдите в раздел **«Продажи»** -> **«Статусы заказов»** и откройте редактирование нужного статуса заказа.

{% hint style="info" %}
Push-уведомления недоступны для статусов заказов с типом **«Ожидание»**, **«Ожидание оплаты»**, **«Новый»** и **«Экспортирован»**.
{% endhint %}

В разделе **«Пуш-уведомления»** включите отправку, переключив настройку **«Отправлять пуш-уведомления»**, и введите текст сообщения, которое будет отправлено покупателю.

<figure><img src="/files/8WLVFQiAvK9HjU7dDUVv" alt=""><figcaption><p>Настройка push-уведомления для статуса заказа.</p></figcaption></figure>

В тексте сообщения вы можете использовать специальные подстановки `:order` и `:status`, которые будут заменены на номер заказа и название статуса заказа соответственно.

{% hint style="info" %}
Например, если вы введёте текст «Ваш заказ **:order** подтверждён!», то покупателю будет отправлено сообщение «Ваш заказ **№2306-100** подтверждён!», где «№2306-100» – настоящий номер заказа.

Другой пример – текст «Статус вашего заказа **:order** изменился на **:status**.» будет заменён на «Статус вашего заказа **№2306-100** изменился на **Подтверждён**», где «№2306-100» – настоящий номер заказа, а «Подтверждён» – название статуса заказа.

При использовании этих подстановок не забудьте про **двоеточие**, которое должно идти **слитно** вместе с названием подстановки (`:order` и `:status`).
{% endhint %}

Эту операцию нужно проделать с каждым статусом, который должен отправлять push-уведомления.

Статусы заказов, для которых подключены push-уведомления, будут отмечены иконкой колокола.

<figure><img src="/files/J4FZERh2U2bbUnlUVhwp" alt=""><figcaption><p>Список статусов заказов с отметкой push-уведомлений.</p></figcaption></figure>

## Если push-уведомления не приходят

1. Убедитесь, что вы указали правильный идентификатор приложения OneSignal (в конструкторе приложения и в настройках заказов магазина) и ключ REST API (в настройках заказов магазина);
2. Убедитесь, что для конкретного статуса заказа подключена отправка push-уведомлений;
3. Для получения push-уведомлений покупатель должен войти в свой аккаунт в вашем приложении, а так же разрешить получение push-уведомлений от вашего приложения.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.zenky.io/push/order-statuses.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.