Приглашения в приложение

На этой странице

Приглашения — это письма, которые сообщают человеку, что ему предоставлен доступ к дверям, и содержат ссылки для загрузки мобильного приложения (App Store и Google Play). На этой странице описаны три способа отправки приглашений — по отдельности, массово и автоматически при синхронизации, — а также статусы приглашений и типичные ошибки.

Что такое приглашение (и чем оно не является)

  • Приглашение — это только письмо по электронной почте. Для пользователей, у которых указан только номер телефона, канала для приглашения нет: они всё равно могут войти в приложение напрямую (номер телефона подходит для входа по одноразовому коду), но письмо не получат.
  • Письмо содержит название объекта, адрес, с которым пользователь должен входить, и ссылки для загрузки из App Store и Google Play. См. раздел Что получает человек.
  • Приглашение не предоставляет доступ. Доступ предоставляют Access Policies или персональные разрешения. Если отправить приглашение человеку без доступа, он просто получит приложение, которым не сможет ничего открыть.

Что получает человек

Человек получает письмо с темой "Your Door & Gate Access invitation". В нём говорится, что ваш объект использует приложение Door & Gate Access, и есть кнопки Download on the App Store и Get it on Google Play. В разделе Details указаны Объект и адрес электронной почты, с которым нужно входить (Sign in with). Подсказка напоминает входить именно с этим адресом, "so your access is recognised straight away". С вопросами следует обращаться к администратору расположения или площадки, а не в Performance Hub.

Пример письма с приглашением Door & Gate Access для jordan.t@example.com от Harbourside Business Centre с кнопками загрузки из App Store и Google PlayПример письма с приглашением Door & Gate Access для jordan.t@example.com от Harbourside Business Centre с кнопками загрузки из App Store и Google Play

Рисунок 1. Пример письма с приглашением в приложение. Имена и адреса приведены в качестве примера.

Статус приглашения

Состояние приглашения каждого пользователя отображается на панели сведений о нём и доступно в виде фильтра Invitation в Users:

СтатусЗначение
Not invitedПисьмо с приглашением не отправлялось
InvitedПриглашение отправлено (показывается время отправки). Метка Invited отображается в списке, пока пользователь впервые не воспользуется приложением
Send failedПоследняя попытка отправки не удалась — нажмите Resend invitation email, чтобы повторить

Как только пользователь действительно вошёл в приложение (App adoption: Active), метка Invited исчезает — приглашения выполнили свою задачу.

Отправка приглашения одному пользователю

  1. Откройте Users и нажмите на пользователя.
  2. Прокрутите до раздела Invitation.
  3. Нажмите Send invitation email (или Resend invitation email, если приглашение уже отправлялось).

При успешной отправке появится сообщение Invitation email sent. Если у пользователя нет адреса электронной почты, сначала добавьте его — в разделе поясняется это требование.

Пригласить пользователя можно и при его создании: в диалоговом окне Add user и в мастере импорта CSV есть флажок Send email invitation (включён по умолчанию и действует только для пользователей с адресом электронной почты).

Массовые приглашения

Чтобы пригласить сразу много пользователей, используйте диалоговое окно массовой отправки: Settings → Sync settings → App invitations → Send invitations… Диалоговое окно Send app invitations показывает список получателей для проверки до того, как что-либо будет отправлено.

По умолчанию массовая отправка адресована пользователям, которые:

  • имеют адрес электронной почты,
  • в настоящий момент имеют доступ (подходят под политику или имеют разрешение),
  • ни разу не получали приглашение и
  • ни разу не пользовались приложением.

Два флажка (оба выключены по умолчанию) расширяют аудиторию:

ВариантДействие
Also re-send to users who were already invitedВключает ранее приглашённых пользователей, которые до сих пор не пользовались приложением
Also include users who don't currently have accessВключает пользователей, которые сейчас не подходят ни под одну политику и не имеют разрешений

Диалоговое окно заранее показывает, сколько именно пользователей получат письмо (с примером списка получателей и примечанием о том, что пользователи только с номером телефона исключаются), а затем отправляет письма пакетами, отображая ход выполнения в реальном времени: "Please keep this window open until sending completes." Итоговая сводка показывает количество sent, failed и skipped (no longer eligible). В одном пакетном запросе отправляется до 50 приглашений; диалоговое окно разбивает отправку на пакеты автоматически.

Автоматические приглашения при синхронизации

Если вы синхронизируете пользователей, приглашения можно отправлять автоматически: Settings → Sync settings → App invitations → Auto-send app invitations ("Automatically email eligible synced users who have not received an invitation.").

App invitations: автоматическая отправка и расширенное правило выбора получателей для текущих участников, исключающее потенциальных клиентовApp invitations: автоматическая отправка и расширенное правило выбора получателей для текущих участников, исключающее потенциальных клиентов

Рисунок 2. App invitations с расширенным правилом выбора получателей

Если параметр включён, при каждой синхронизации приглашение отправляется синхронизированным пользователям, которые:

  • имеют адрес электронной почты,
  • подходят под условие Who should receive an invitation? (см. ниже) и
  • ещё не получали приглашение. Приглашения никогда не отправляются повторно автоматически.

Неудачная автоматическая отправка повторяется при следующей синхронизации. См. раздел Синхронизация и интеграции.

Кто должен получать приглашение?

Выберите Only users with door access или All eligible synced users.

Расширенные правила выбора получателей

Advanced recipient rules ("Optionally limit invitations using synced member attributes.") дополнительно сужают круг получателей. Включите Enable advanced recipient rules, а затем добавьте одно или несколько правил:

  • Rule name и переключатель включения для каждого правила.
  • Match conditions — совпадение всех или любого из условий правила.
  • Conditions — поле (Membership Status, Person Type, Tag, Sync Source или Integration), оператор (Is Any Of или Is Not Any Of) и значения для сравнения. Используйте Add condition и Add rule, чтобы добавить условия и правила.

На странице поясняется, как работают правила:

  • «Пользователь должен соответствовать хотя бы одному включенному правилу ниже».
  • «Расширенные правила выбирают получателей независимо от текущего доступа к дверям. Отключенные пользователи или пользователи с конфликтами доступа по-прежнему исключаются, а приглашения никогда не предоставляют доступ».
  • «Изменения вступают в силу при следующей синхронизации пользователей; сохранение не приводит к немедленной отправке пакета».

На рисунке 2 правило "Current members only" содержит два условия: Membership Status с оператором Is Any Of и значениями active и current, а также Person Type с оператором Is Not Any Of и значением prospect. Аналогичным образом колледж может приглашать в приложение только зачисленных студентов, чтобы они получали доступ к студии в нерабочее время.

Устранение неполадок с приглашениями

ПризнакПричинаРешение
Кнопка отправки неактивна / "no email"У пользователя нет адреса электронной почтыДобавьте пользователю адрес электронной почты (или попросите его войти напрямую по номеру телефона)
Статус Send failedПочтовой службе не удалось доставить письмоПроверьте адрес на опечатки, затем нажмите Resend invitation email
Пользователь не попал в массовую отправкуОн уже был приглашён, пользовался приложением, не имеет адреса электронной почты или сейчас не имеет доступаИспользуйте флажки включения в диалоговом окне или пригласите его отдельно с его панели
Автоматические приглашения не отправляютсяПараметр Auto-send app invitations выключен или отключена сама синхронизацияВключите оба параметра в Settings → Sync settings
Синхронизированный пользователь не получает приглашение автоматическиОн не подходит под Who should receive an invitation? или ни под одно включённое расширенное правило выбора получателейПроверьте правила в Settings → Sync settings → App invitations; изменения применяются при следующей синхронизации
Пользователь получил письмо, но не может открыть дверьПриглашения не предоставляют доступПроверьте Access Policies и разрешения