Wiadomości w aplikacji

Na tej stronie

Wiadomości w aplikacji to karty z ogłoszeniami wyświetlane na panelu aplikacji mobilnej. Istnieją trzy rodzaje: wiadomość dla całego obiektu, którą widzą wszyscy, wiadomość dla użytkownika ustawiana dla konkretnej osoby oraz wiadomości automatyczne stosowane przez reguły (np. powiadomienie o wygaśnięciu członkostwa). Ta strona opisuje wszystkie trzy rodzaje oraz wspólny edytor wiadomości.

Trzy rodzaje wiadomości w skrócie

RodzajOdbiorcyGdzie się konfigurujeKtóra ma pierwszeństwo
Wiadomość dla całego obiektuWszyscy w obiekcieSettings → App Security & Settings → karta wiadomości dla całego obiektuWyświetlana obok ewentualnej wiadomości dla użytkownika
Wiadomość dla użytkownika (ręczna)Jedna osobaUsers → panel użytkownika → App messageWiadomość ręczna nigdy nie jest nadpisywana przez automatyzację
Wiadomość automatycznaWszyscy spełniający warunekSettings → Automated MessagesStosowana tylko tam, gdzie nie ustawiono wiadomości ręcznej; usuwa się sama, gdy warunek przestaje być spełniony

Edytor wiadomości

Wszystkie trzy rodzaje korzystają z tego samego edytora (rysunek 1 poniżej pokazuje go w dwóch regułach wiadomości automatycznych).

PoleSzczegóły
Notification typeInformation (neutralny), Notice (ostrzegawczy) lub Urgent. Określa kolor karty i etykietę ważności w aplikacji (INFORMATION / NOTICE / URGENT).
TitleDo 120 znaków — np. Pool Closed for Maintenance
Message bodyDo 2000 znaków (po przekroczeniu 500 pojawia się łagodne ostrzeżenie — karty na panelu powinny być krótkie)
Optional link URLLink http:// / https://; jeśli go pominiesz, https:// zostanie dodany automatycznie
Link labelTekst przycisku linku; domyślnie More info
ScheduleOpcjonalne daty i godziny Starts at / Ends at. Pozostaw puste, aby nie ograniczać czasu; wiadomość jest wyświetlana tylko w wyznaczonym przedziale.

Bieżący podgląd pokazuje "How this will look on the mobile app dashboard." Główny przełącznik edytora włącza lub wyłącza wiadomość bez utraty jej treści.

Wiadomość dla całego obiektu

Settings → App Security & Settings, karta wiadomości dla całego obiektu — "Allows you to configure a notification in the app for everyone at this facility." Używaj jej do informowania o zamknięciach, przerwach serwisowych lub wydarzeniach. Pamiętaj, aby kliknąć Save changes na pasku zapisu ustawień.

Wiadomości dla użytkowników

Otwórz użytkownika na liście Users i użyj sekcji App message w jego panelu. Typowe zastosowania: przypomnienie o płatności, osobiste powiadomienie, prośba o podejście do recepcji. Użytkownicy z aktywną wiadomością mają na liście plakietkę Message w kolorze odpowiadającym jej ważności.

Ręcznie ustawiona wiadomość dla użytkownika zawsze ma pierwszeństwo — automatyzacja jej nie nadpisze.

Wiadomości automatyczne

Settings → Automated Messages otwiera stronę App Messaging Rules, która automatyzuje wiadomości dla użytkowników na podstawie danych o członkostwie lub bieżącej widoczności drzwi. Ręcznie ustawiona wiadomość nigdy nie jest nadpisywana, a wiadomości automatyczne usuwają się same, gdy przestają mieć zastosowanie.

Ustawienia, automatyczne wiadomościUstawienia, automatyczne wiadomości

Rysunek 1: App Messaging Rules z dwiema regułami używającymi typu powiadomienia Urgent

Jak działają reguły

  • Enable automated messages to główny przełącznik — gdy jest wyłączony, wszystkie poniższe reguły są nieaktywne (wyświetlane jako przygaszone: "Automated messages are turned off — these rules are inactive.").
  • Każda reguła ma postać: When <Membership status | Person type | Tag | Door visibility> is any of <wartości> → wyświetl tę wiadomość. Reguły tagów dopasowują zarówno tagi synchronizowane, jak i niestandardowe (bez rozróżniania wielkości liter).
  • Door visibility obsługuje wartości No doors visible i Has visible doors. Korzysta z ostatecznej listy drzwi aplikacji mobilnej: drzwi dostępne do użycia oraz drzwi przyszłe lub poza godzinami dostępu są liczone jako widoczne, podobnie jak drzwi celowo pokazywane w stanie zablokowanym lub serwisowym. No doors visible jest dopasowywane tylko wtedy, gdy ta lista jest pusta.
  • Kolejność reguł oznacza priorytet — wygrywa pierwsza włączona reguła pasująca do danej osoby; jedna wiadomość automatyczna na osobę.
  • Gdy osoba przestaje pasować do wszystkich reguł, jej wiadomość automatyczna usuwa się automatycznie.
  • Tekst wiadomości obsługuje symbole zastępcze {firstName} i {lastName} — np. "Hi {firstName}, your membership has expired."

Dodawanie reguły

  1. Kliknij Add rule lub wybierz szablon z menu Start from a template…:
SzablonDopasowujeWstępnie wypełniona wiadomość (ważność)
No door accessDoor visibility: brak widocznych drzwiNo door access available (Notice)
Expired membershipMembership status: wygasłeYour membership has expired (Notice)
Payment overdueTag: overduePayment overdue (Notice)
Account on hold / suspendedMembership status: wstrzymane, zawieszoneYour account is on hold (Urgent)
Welcome (new member)Tag: newWelcome! (Information)
Trial / prospectPerson type: prospectEnjoying your trial? (Information)
Document / waiver requiredTag: waiver-requiredAction required (Notice)
  1. Ustaw pole When i wartości, zmień treść wiadomości i upewnij się, że przełącznik Rule enabled jest włączony.
  2. Kliknij Save changes na pasku zapisu ustawień.

Co się dzieje po zapisaniu

Zapisanie uruchamia w tle przebieg, który stosuje reguły do wszystkich osób w obiekcie. Karta pokazuje postęp: "Applying to members in the background…", a następnie "App messages applied · N updated" (lub "Background update failed."). Odłączeni użytkownicy są pomijani, a reguły są odtąd stosowane również do użytkowników w momencie ich synchronizacji lub edycji.

Mobilne API ponownie ocenia reguły automatyczne względem bieżącej widoczności drzwi przy każdym wczytaniu obiektów. Zmiany zasad, uprawnień, trybu serwisowego i harmonogramów wpływają więc na wiadomość natychmiast; aplikacja nie czeka na kolejny przebieg w tle.

Wyłączanie automatyzacji dla jednej osoby

Gdy w panelu użytkownika aktywna jest wiadomość automatyczna, możesz kliknąć Turn off for this user — wiadomość automatyczna zostanie usunięta i żadna reguła nie wyśle już tej osobie wiadomości (dopóki nie klikniesz tam Re-enable automated messages). Przydaje się to w przypadku wyjątków, np. członka ze sporem dotyczącym płatności, którym zajmujesz się osobiście.

Co widzą członkowie

Wiadomości są wyświetlane jako karty u góry panelu aplikacji, w kolorze odpowiadającym typowi, z tytułem, treścią i opcjonalnym przyciskiem linku. Wiadomości pilne są wyraźnie wyróżnione. Wiadomości mają charakter informacyjny — same w sobie nie blokują dostępu do drzwi (do tego służy przełącznik Access enabled lub Access Policies).