# Отправка сообщений владельцам карт Apple Wallet
Как только пользователь добавляет вашу карту Apple Wallet, Pushwoosh регистрирует ее как подписку на платформу Apple Wallet, привязанную к этому [User ID](/ru/product/pushwoosh-knowledge-hub/users-userids/). Карты доступны на iPhone и Apple Watch.
Связаться с владельцами карт можно несколькими способами: отправить разовое пуш-уведомление, отправить обновление карты, автоматизировать сообщения из Customer Journey или уведомить владельцев конкретной карты через API.
## Отправка разового пуш-уведомления владельцам карт
Отправьте отдельное пуш-уведомление одному владельцу карты или более широкой аудитории. Оно появится на экране блокировки как сообщение на карте.
1. Откройте редактор разовых пуш-уведомлений. Либо нажмите **Send message** в **Campaigns → Wallet Passes → Apple Wallet**, либо перейдите в **Campaigns → One-Time Messages** и нажмите **Send message → One-time push**.
2. На шаге **Content** напишите сообщение или выберите пресет.
3. На шаге **Audience** укажите, кто получит сообщение. Настройки по умолчанию зависят от того, где вы открыли редактор:
* **Из 'Send message' на карте:** выбрана опция **Send to specific users**, а в поле **Recipients (User IDs)** уже указан [User ID](/ru/product/pushwoosh-knowledge-hub/users-userids/) владельца этой карты. Отправьте как есть, чтобы связаться с этим одним владельцем, или измените аудиторию:
* Добавьте больше User ID в поле **Recipients (User IDs)**
* Переключитесь на **Send to segment**
* Выберите **Send to all subscribers**
* **Из One-Time Messages:** настройте аудиторию как для обычного [разового пуш-уведомления](/ru/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#select-audience-for-push-notification): **Send to specific users**, **Send to segment** или **Send to all subscribers**.
4. В разделе **Target platforms** выберите **Apple Wallet**.
5. Отправьте или запланируйте отправку сообщения.
## Отправка обновления карты
Редактирование и сохранение карты переподписывает ее и уведомляет каждое устройство, на которое она была добавлена. iOS загружает новую версию в фоновом режиме. Чтобы оповестить владельцев о конкретном изменении, установите **Change message** для поля, чтобы iOS показало его на экране блокировки.
1. В **Campaigns → Wallet Passes → Apple Wallet** найдите карту и нажмите **Edit** в меню действий.
2. Измените необходимые поля и добавьте сообщение об изменении для любого поля, о котором вы хотите оповестить владельцев.
3. Нажмите **Save**.
Каждое устройство, на которое была добавлена карта, получит обновление. Поля без сообщения об изменении обновляются без уведомления.
## Автоматизация сообщений из Customer Journey
Отправляйте сообщения автоматически на основе событий или сегментов.
### Journey с входом по триггеру
1. Создайте [Customer Journey](/ru/product/customer-journey/pushwoosh-journey-overview/) и добавьте элемент [**Trigger-based entry**](/ru/product/customer-journey/journey-elements/entry-elements/trigger-based-entry/).
2. Выберите событие, которое должно запускать Journey. Если вы еще этого не сделали, сначала создайте кастомное событие в Панели управления, например `RewardAvailable`.
3. Добавьте и настройте элемент пуш-уведомления. Включите опцию [**Send by User ID**](/ru/product/customer-journey/journey-elements/channels/push/#send-by-user-id), чтобы пуш-уведомление доставлялось на все устройства, привязанные к пользователю, включая сохраненную карту.
4. Завершите настройку и активируйте Journey.
Когда срабатывает событие входа, Pushwoosh отправляет пуш-уведомление на все устройства, привязанные к пользователю. Владельцы карт получают его как сообщение на экране блокировки на карте. Пользователи без карты Apple Wallet получают его на другие свои устройства.
**Пример: Уведомить пользователя о доступности вознаграждения**
`POST https://api.pushwoosh.com/json/1.3/postEvent`
```json
{
"request": {
"application": "XXXXX-XXXXX",
"userId": "u12345",
"event": "RewardAvailable",
"attributes": {
"reward": "Free coffee",
"expires": "2026-07-01"
}
}
}
```
Имя `event` должно совпадать с событием, созданным в вашей Панели управления.
### Другие способы построения Journey
Описанный выше процесс на основе триггера — это один из вариантов. В зависимости от того, что должно запускать Journey, выберите другой [элемент входа](/ru/product/customer-journey/journey-elements/entry-elements/):
* **[Audience-based entry](/ru/product/customer-journey/journey-elements/entry-elements/audience-based-entry/):** запуск Journey для целого сегмента, а не по одному событию. Запустите его один раз, по расписанию или периодически (например, каждую неделю для всех, у кого есть активная карта), при этом новые пользователи будут входить в Journey по мере присоединения к сегменту.
* **[API-based entry](/ru/product/customer-journey/journey-elements/entry-elements/api-based-entry/):** запуск Journey по бизнес-событию, которое происходит вне приложения, например, задержка рейса или смена выхода на посадку. Ваша внешняя система вызывает шаблон запроса элемента входа и передает фильтр для таргетинга на нужных пользователей, например, на всех, у кого при выпуске карты был установлен тег `flightNumber = SU1234`. Хорошо подходит для посадочных талонов и билетов на мероприятия.
## Уведомление владельцев конкретной карты через API
Чтобы отправить сообщение всем, кто сохранил одну конкретную карту, вызовите метод [Update a pass](/ru/developer/api-reference/apple-wallet-passkit-api/#update-a-pass). Он обновит карту и уведомит устройства.
4. В разделе **Target platforms** выберите **Apple Wallet**.
5. Отправьте или запланируйте отправку сообщения.
## Отправка обновления карты
Редактирование и сохранение карты переподписывает ее и уведомляет каждое устройство, на которое она была добавлена. iOS загружает новую версию в фоновом режиме. Чтобы оповестить владельцев о конкретном изменении, установите **Change message** для поля, чтобы iOS показало его на экране блокировки.
1. В **Campaigns → Wallet Passes → Apple Wallet** найдите карту и нажмите **Edit** в меню действий.
2. Измените необходимые поля и добавьте сообщение об изменении для любого поля, о котором вы хотите оповестить владельцев.
3. Нажмите **Save**.
Каждое устройство, на которое была добавлена карта, получит обновление. Поля без сообщения об изменении обновляются без уведомления.
## Автоматизация сообщений из Customer Journey
Отправляйте сообщения автоматически на основе событий или сегментов.
### Journey с входом по триггеру
1. Создайте [Customer Journey](/ru/product/customer-journey/pushwoosh-journey-overview/) и добавьте элемент [**Trigger-based entry**](/ru/product/customer-journey/journey-elements/entry-elements/trigger-based-entry/).
2. Выберите событие, которое должно запускать Journey. Если вы еще этого не сделали, сначала создайте кастомное событие в Панели управления, например `RewardAvailable`.
3. Добавьте и настройте элемент пуш-уведомления. Включите опцию [**Send by User ID**](/ru/product/customer-journey/journey-elements/channels/push/#send-by-user-id), чтобы пуш-уведомление доставлялось на все устройства, привязанные к пользователю, включая сохраненную карту.
4. Завершите настройку и активируйте Journey.
Когда срабатывает событие входа, Pushwoosh отправляет пуш-уведомление на все устройства, привязанные к пользователю. Владельцы карт получают его как сообщение на экране блокировки на карте. Пользователи без карты Apple Wallet получают его на другие свои устройства.
**Пример: Уведомить пользователя о доступности вознаграждения**
`POST https://api.pushwoosh.com/json/1.3/postEvent`
```json
{
"request": {
"application": "XXXXX-XXXXX",
"userId": "u12345",
"event": "RewardAvailable",
"attributes": {
"reward": "Free coffee",
"expires": "2026-07-01"
}
}
}
```
Имя `event` должно совпадать с событием, созданным в вашей Панели управления.
### Другие способы построения Journey
Описанный выше процесс на основе триггера — это один из вариантов. В зависимости от того, что должно запускать Journey, выберите другой [элемент входа](/ru/product/customer-journey/journey-elements/entry-elements/):
* **[Audience-based entry](/ru/product/customer-journey/journey-elements/entry-elements/audience-based-entry/):** запуск Journey для целого сегмента, а не по одному событию. Запустите его один раз, по расписанию или периодически (например, каждую неделю для всех, у кого есть активная карта), при этом новые пользователи будут входить в Journey по мере присоединения к сегменту.
* **[API-based entry](/ru/product/customer-journey/journey-elements/entry-elements/api-based-entry/):** запуск Journey по бизнес-событию, которое происходит вне приложения, например, задержка рейса или смена выхода на посадку. Ваша внешняя система вызывает шаблон запроса элемента входа и передает фильтр для таргетинга на нужных пользователей, например, на всех, у кого при выпуске карты был установлен тег `flightNumber = SU1234`. Хорошо подходит для посадочных талонов и билетов на мероприятия.
## Уведомление владельцев конкретной карты через API
Чтобы отправить сообщение всем, кто сохранил одну конкретную карту, вызовите метод [Update a pass](/ru/developer/api-reference/apple-wallet-passkit-api/#update-a-pass). Он обновит карту и уведомит устройства.