Сообщения на карты Wallet

Как отправить сообщение сценария на карты гостей, что можно отправлять на iPhone, сколько уведомлений в сутки и как понять, что сообщение дошло.

Сценарий «Автоматизации» может отправить сообщение не только в мессенджер, но и на саму карту гостя в Apple Wallet или Google Кошельке. Гость видит короткое уведомление на экране блокировки, а текст остаётся на карте до следующего сообщения.

Карта подходит для сообщений про саму карту и визит: бонусы сгорают, начислили за визит, ждёт подарок.

Apple Wallet и Google Wallet в сообщении

В действии «Сообщение» на вкладке «Общее», под мессенджерами, есть строка «Карты Wallet — дополнительно» с двумя галочками: Apple Wallet и Google Wallet. Обе по умолчанию сняты: ни новое сообщение, ни готовый набор сами на карты не отправляют.

«Дополнительно» значит, что карта — не ступень в очереди мессенджеров. Мессенджеры получают сообщение по очереди, пока оно где-то не дойдёт. Карта получает его сверх этого: если отмечены и Telegram, и Apple Wallet, гость увидит сообщение и в Telegram, и на экране блокировки. Дойдёт оно только до тех, у кого карта на отмеченной площадке сохранена в телефоне.

Текст для карт общий для обеих площадок. Короткий вариант для карты пишется на вкладке «Карта Wallet»; без него карты получают общий текст. Картинка и кнопки на карту не уходят.

Когда вы отмечаете Apple Wallet, редактор показывает предупреждение: через карты iPhone можно отправлять только сервисные сообщения. У Google Wallet предупреждения нет — только подсказка про лимит уведомлений.

Сервисное или рекламное

Правило для спорных случаев: сообщение про то, что уже есть у гостя на карте — его бонусы, уровень, подарок, визит, — сервисное. Сообщение про то, что заведение предлагает купить, — рекламное.

Сомневаетесь — отправьте такое сообщение в мессенджер, а не на iPhone.

Правило Apple

Apple разрешает уведомления карт Wallet только для важной информации о самой карте: изменился баланс, подходит срок, пора воспользоваться. Маркетинг и реклама через уведомления карт запрещены. Правило описано в рекомендациях Apple для разработчиков — Human Interface Guidelines, раздел Wallet.

Нарушение одного заведения бьёт по всем. Карты всех заведений в Axle App выпускаются под одним нашим аккаунтом разработчика Apple. Если хотя бы одно заведение рассылает рекламу, Apple может заблокировать этот аккаунт — и карты всех заведений, включая ваши, перестанут обновляться, а новые перестанут выдаваться.

Как мы проверяем сообщения

• Каждый текст на iPhone-карты после сохранения сценария видит сотрудник сервиса. Сообщения только на Google Wallet на проверку не идут.
• Рассылка проверки не ждёт: сценарий работает сразу после сохранения.
• Если среди сообщений найдётся реклама, мы отключим организации **все сообщения сценариев на карты** — и Apple Wallet, и Google Wallet. Карты гостей при этом работают: бонусы и уровень обновляются, уведомления о них приходят.
• Об отключении владелец организации узнаёт сообщением в админ-бот: что отключено и почему. В редакторе сценария галочки карт становятся неактивными с подписью «Сообщения на карты отключены администрацией сервиса».
• Если это ошибка, ответьте на сообщение в боте.

Условия записаны в пунктах 6.4 и 6.5 оферты.

Сколько уведомлений в сутки

• Сообщения сценариев — не больше 3 уведомлений на одну карту в сутки. Лимит общий для всех сценариев. Четвёртое сообщение за сутки ляжет на карту без уведомления: текст на карте будет, но экран блокировки не загорится.
• Уведомления о бонусах и уровне на iPhone не ограничены. У Google для них свой лимит — тоже 3 в сутки на карту, отдельно от сообщений. Сверх лимита баланс на карте обновится без уведомления.
• Одинаковый текст тоже приходит уведомлением. На iPhone к повтору добавляется время отправки.
• На iPhone сообщения идут по одному. Пока телефон не забрал предыдущее сообщение, следующее ждёт, но не дольше 30 минут. Иначе iPhone показал бы только последнее.
• Ночного режима у карт нет. Ночью гостя защищают только тихие часы сценария — проверьте их на шаге «Правила».

Как понять, что дошло

Сообщение на карту ложится в ленту «Общение» гостя одной записью с пометкой «Карта Wallet». Под текстом видно, что ответила каждая площадка, на которой у гостя есть карта: «Apple: телефон забрал обновление · Google: карта не сохранена». Пока площадка не ответила, у записи серая пометка «в пути». Новый статус видно после обновления страницы или при повторном открытии ленты.

Ни Apple, ни Google не сообщают, увидел ли гость уведомление. Поэтому слов «показано» и «прочитано» в ленте нет. Самое точное, что мы знаем: телефон забрал обновление (iPhone) или сообщение записано на карту (Google).

Сообщение считается доставленным, если его взяла хотя бы одна площадка.

Все сообщения по всем гостям — в разделе Диалоги → «Все сообщения»: там у записи есть колонка «Канал», а поиск «Карта Wallet» оставит только сообщения на карты.

Гость говорит, что ничего не пришло

Откройте карточку гостя → «Общение» и найдите это сообщение:

• «телефон не забрал обновление за 30 минут» — попросите гостя открыть карту в Wallet и проверить в её настройках, что включены «Автоматические обновления» и уведомления. Ещё возможные причины — не было сети или телефон был выключен.
• «на телефоне нет обновляемой карты», «карта не сохранена» или **«гость удалил карту»** — отправьте гостю новую ссылку: карточка гостя → блок «Карта Wallet» → Ссылка на карту.
• «без уведомления — лимит» — текст на карте есть, но экран блокировки не загорелся: три уведомления в этот день уже ушли. Разнесите сценарии по времени.
• «сбой отправки» — это наша сторона. Мы повторяем отправку несколько раз, а если не вышло, в колокольчике появится запись о сбое карт Wallet.