Як оновлювати цифрові паси та надсилати push-сповіщення в SmartPass
Цифровий пас у гаманці не схожий на PDF, який застаріває наступного дня після надсилання. У SmartPass ви змінюєте дані паса вже після його видачі, а нова версія з’являється в Apple Wallet або Google Wallet вашого клієнта. У цій статті ви дізнаєтеся, що можна оновити і як писати сповіщення, які клієнти справді читають. Також тут є готові приклади для кількох галузей і пояснення, як завершується життєвий цикл паса.
Головне коротко
Живі паси: оновлення доходять до пасів, уже збережених в Apple Wallet і Google Wallet, без повторного завантаження.
Що можна змінити: значення полів, штрихкод і дату завершення дії. Дизайн задає шаблон кампанії.
Сповіщення лише при зміні: власник отримує повідомлення на екрані блокування тільки тоді, коли змінюється поле з увімкненими сповіщеннями.
Готові приклади: тексти сповіщень для страхування, програм лояльності, подій і посвідчень працівників.
Два способи оновлення: на платформі Sparados або з вашої CRM через SmartPass API.
Зміст:

Навіщо оновлювати цифровий пас замість видачі нового?
Цифровий пас залишається в телефоні клієнта, доки триває ваша співпраця. Коли змінюється статус, дата чи баланс, ви оновлюєте вже виданий пас. У власника залишається один пас, а вам не потрібно надсилати новий лист чи просити когось зберегти пас повторно.
Кожен пас проходить ті самі етапи: ви його видаєте, оновлюєте стільки разів, скільки потрібно, повідомляєте власника про важливі зміни, а наприкінці дозволяєте йому завершити дію або анулюєте його.

Що можна змінити у вже виданому цифровому пасі?
Кожен пас поєднує кампанію (шаблон) з даними власника. Оновлення змінює дані одного паса. Дизайн належить кампанії.
Елемент | Чи можна змінити у виданому пасі? | Звідки береться |
Значення полів (наприклад, статус, баланс, дата) | Так | З паса |
Вміст штрихкоду й текст під кодом | Так | З паса |
Дата завершення дії | Так, її також можна видалити | З паса |
Логотип, іконка та смуга із зображенням (strip) | Ні | З кампанії |
Кольори | Ні | З кампанії |
Кампанія, до якої належить пас | Ні | Видайте новий пас в іншій кампанії |
Як налаштувати поля, зони та сповіщення в кампанії, ми пояснили в інструкції як створити кампанію та видати SmartPass. Ця стаття починається там, де закінчується інструкція: з паса, який уже є в гаманці власника.
Як оновити пас на платформі Sparados?
Щоб оновити окремий пас, розробник не потрібен. На платформі Sparados:
Відкрийте SmartPass у бічному меню та перейдіть на вкладку Passes.
Знайдіть пас у списку за власником і відкрийте меню дій поруч із ним.
Виберіть редагування паса, змініть значення, штрихкод або дату завершення дії та збережіть зміни.
Зміна доходить до кожного пристрою, на якому власник зберіг пас.
Як оновлювати паси з CRM через API?
Якщо дані для пасів зберігаються у вашій CRM, системі полісів чи платформі лояльності, ця система може оновлювати паси самостійно. Збережіть ідентифікатор паса, який API повертає під час видачі, а коли дані зміняться, надішліть нові значення цього паса в SmartPass API. Один запит може змінити значення полів, штрихкод і дату завершення дії.
Доступ до API включено без доплат. Ендпоінти, приклади запитів і кроки підключення описано в документації SmartPass API у Sparados Developer Zone.
Приклади push-сповіщень у цифрових пасах для різних галузей
Сповіщення корисне настільки, наскільки корисний його текст. У кожному прикладі нижче ви оновлюєте одне поле. Там, де в таблиці стоїть [нове значення], у тексті повідомлення про зміну на панелі ви вводите заповнювач %@, а гаманець замінює його новим значенням поля.
Сценарій | Поле і текст сповіщення | Що бачить власник |
Страховий випадок | Статус заяви: «Статус вашої заяви: [нове значення]» | Статус вашої заяви: схвалено |
Поновлення поліса | Діє до: «Ваш поліс діє до [нове значення]» | Ваш поліс діє до 31.12.2027 |
Програма лояльності | Винагорода: «Відкрито нову винагороду: [нове значення]» | Відкрито нову винагороду: безкоштовна кава |
Квиток на подію | Вхід: «Ваш вхід змінено: [нове значення]» | Ваш вхід змінено: ворота C |
Квиток на подію | Початок: «Новий час початку: [нове значення]» | Новий час початку: 19:30 |
Посвідчення працівника | Доступ: «Ваш доступ оновлено: [нове значення]» | Ваш доступ оновлено: корпус B |
Членська картка | Рівень: «Ваш рівень членства: [нове значення]» | Ваш рівень членства: Gold |
Страхування
Поле зі статусом заяви та увімкненими сповіщеннями дає змогу застрахованому стежити за розглядом без дзвінків на гарячу лінію. Після поновлення поліса оновіть дату дії та посилання на поновлення на звороті паса.
Програми лояльності та роздрібна торгівля
Оновлюйте баланс балів чи штампів після кожної покупки, але не надсилайте сповіщення про кожну з них. Тримайте баланс у полі без сповіщень і додайте окреме поле винагороди, яке сповіщає власника. Так клієнт бачить актуальний баланс щоразу, коли відкриває пас, а повідомлення отримує лише тоді, коли відкриває винагороду.
Події та квитки
Нова дата, новий час початку чи інший вхід є змінами, на які власник має відреагувати, тож про них варто повідомити. Зміни, що не впливають на відвідування, наприклад уточнений опис місця, можна вносити в поле без сповіщень.
Посвідчення працівників і членські картки
Оновлюйте рівень доступу, рівень членства чи дату дії в наявному пасі. Коли працівник звільняється або членство завершується, анулюйте пас замість того, щоб його оновлювати.
Коли оновлювати пас без сповіщення?
Не кожна зміна варта сповіщення. Виправлення одруку в імені чи помилково введеного значення не має засвічувати екран телефона власника. У SmartPass API оновлення можна позначити як тихе (notify: false): пас змінюється, але сповіщення не надсилається навіть для полів, які зазвичай сповіщають.
Які оновлення паса варті push-сповіщення?
Вагомі причини для сповіщення | Краще як тихе оновлення |
Змінюється статус заяви чи замовлення | Одрук в імені власника |
Нова дата, час або вхід на подію | Зміни формулювань чи форматування |
Поновлення або пропозиція, якою власник може скористатися | Виправлення помилково введеного значення |
Винагорода чи рівень, на які власник чекає | Внутрішні довідкові номери |
Одна зміна, одне повідомлення: коротке повідомлення про одну зміну зрозуміліше, ніж підсумок кількох.
Скажіть, що змінилося: додайте нове значення в повідомлення, як у прикладах вище.
Мовою власника: задайте текст повідомлення про зміну для кожної мови кампанії.
Що запускає сповіщення, а що ні?
У SmartPass сповіщення має один тригер: зміну значення поля, у якому ввімкнено сповіщення власників. SmartPass не надсилає сповіщень залежно від місцезнаходження власника чи за розкладом. Якщо хочете про щось нагадати, оновіть поле зі сповіщеннями в потрібний момент, на платформі чи з вашої системи.
Вбудованого поля для новин також немає. Щоб надсилати короткі повідомлення через пас, створіть власне поле, увімкніть у ньому сповіщення власників і змінюйте його значення, коли маєте новини.
Як цифровий пас завершує дію або анулюється?
Завершення дії: якщо пас має дату завершення дії, після цієї дати він автоматично анулюється. Apple Wallet отримує вбудовану дату завершення дії, а Google Wallet показує період дії та сповіщення про його завершення. Дату завершення дії можна перенести або видалити оновленням.
Анулювання: пас можна анулювати й самостійно, наприклад після розірвання поліса чи звільнення працівника. Тоді на обох платформах пас відображається в гаманці власника як анульований.
Важливо: анулювання остаточне. Анульований пас не можна ні оновити, ні відновити. Щоб у власника знову був пас, видайте новий.
FAQ: оновлення цифрових пасів
Чи доходить оновлення до пасів, уже збережених у гаманці?
Так. Після оновлення зміна надсилається до паса на пристрої власника в Apple Wallet і Google Wallet. Власнику не потрібно зберігати його повторно.
Чи можна змінити дизайн уже виданого паса?
Ні. У виданому пасі можна змінити значення полів, штрихкод і дату завершення дії. Логотип, іконка, смуга із зображенням і кольори беруться з шаблону кампанії.
Чи кожне оновлення надсилає push-сповіщення?
Ні. Сповіщення надсилається лише тоді, коли змінюється значення поля з увімкненими сповіщеннями власників. Через API оновлення також можна виконати тихо.
Чи може SmartPass надсилати сповіщення залежно від місця чи часу?
Ні. Сповіщення в SmartPass запускає лише зміна значення поля. Щоб нагадати про щось у певний час, оновіть поле зі сповіщеннями саме тоді.
Чи можна відновити анульований пас?
Ні. Анулювання остаточне, а анульований пас не можна оновити. Щоб у власника знову був пас, видайте новий.
Чи враховуються оновлення та сповіщення в ліміт SmartPass?
Ні. До ліміту зараховуються лише надіслані паси, тож оновлювати паси й надсилати сповіщення можна стільки разів, скільки потрібно. Подробиці дивіться на сторінці Ціни на SmartPass.
Подивіться на оновлення та сповіщення на вашому прикладі
Розкажіть, які статуси, дати чи баланси ви хочете підтримувати актуальними в телефонах своїх клієнтів. Замовте демо, і ми покажемо, як налаштувати поля та тексти сповіщень для вашого сценарію.



