Mensagens no aplicativo
Nesta página
As mensagens no aplicativo são cartões de aviso exibidos no painel do aplicativo móvel. Há três tipos: uma mensagem para toda a instalação, que todos veem; uma mensagem por usuário, definida para uma pessoa específica; e mensagens automáticas, aplicadas por regras (por exemplo, um aviso de associação expirada). Esta página aborda os três tipos, além do editor de mensagens que eles compartilham.
Os três tipos de mensagem em resumo
| Tipo | Público | Onde é configurada | Qual prevalece |
|---|---|---|---|
| Mensagem para toda a instalação | Todos na instalação | Settings → App Security & Settings → cartão de mensagem para toda a instalação | Exibida junto com qualquer mensagem por usuário |
| Mensagem por usuário (manual) | Uma pessoa | Users → painel do usuário → App message | Uma mensagem manual nunca é substituída pela automação |
| Mensagem automática | Todos que atendem a uma condição | Settings → Automated Messages | Aplicada somente quando não há mensagem manual definida; é removida automaticamente quando a condição deixa de ser atendida |
O editor de mensagens
Os três tipos usam o mesmo editor (a Figura 1 abaixo mostra o editor em duas regras de mensagens automáticas).
| Campo | Detalhes |
|---|---|
| Notification type | Information (neutro), Notice (tom de alerta) ou Urgent. Controla a cor do cartão e o rótulo de gravidade no aplicativo (INFORMATION / NOTICE / URGENT). |
| Title | Até 120 caracteres — por exemplo, Pool Closed for Maintenance |
| Message body | Até 2000 caracteres (um aviso leve aparece a partir de 500 — mantenha os cartões do painel curtos) |
| Optional link URL | Um link http:// / https://; https:// é adicionado automaticamente se você o omitir |
| Link label | O texto do botão do link; o padrão é More info |
| Schedule | Datas e horas opcionais em Starts at / Ends at. Deixe em branco para não haver limite; a mensagem só é exibida dentro desse período. |
Uma visualização em tempo real mostra "How this will look on the mobile app dashboard." A chave principal do editor ativa ou desativa a mensagem sem perder o conteúdo.
Mensagem para toda a instalação
Settings → App Security & Settings, cartão de mensagem para toda a instalação — "Allows you to configure a notification in the app for everyone at this facility." Use-a para fechamentos, janelas de manutenção ou eventos. Lembre-se de clicar em Save changes na barra de salvamento das configurações.
Mensagens por usuário
Abra um usuário em Users e use a seção App message do painel dele. Usos típicos: um lembrete de pagamento, um aviso pessoal, um pedido para "procurar a recepção". Os usuários com uma mensagem ativa exibem um selo Message na lista, colorido de acordo com a gravidade.
Uma mensagem por usuário definida manualmente sempre tem prioridade — a automação não a substitui.
Mensagens automáticas
Settings → Automated Messages abre a página App Messaging Rules, que automatiza mensagens por usuário com base nos dados de associação ou na visibilidade atual das portas. Uma mensagem definida manualmente nunca é substituída, e as mensagens automáticas são removidas automaticamente quando deixam de se aplicar.
Figura 1: App Messaging Rules, com duas regras que usam o tipo de notificação Urgent
Como as regras funcionam
- Enable automated messages é a chave geral — quando desativada, todas as regras abaixo ficam inativas (exibidas esmaecidas: "Automated messages are turned off — these rules are inactive.").
- Cada regra tem a forma: When <Membership status | Person type | Tag | Door visibility> is any of <valores> → exibir esta mensagem. As regras de tag correspondem tanto às tags sincronizadas quanto às personalizadas (sem diferenciar maiúsculas de minúsculas).
- Door visibility aceita No doors visible e Has visible doors. Ela usa a lista final de portas do aplicativo móvel: as portas utilizáveis e as portas futuras/fora do horário contam como visíveis, assim como as portas exibidas deliberadamente em estado bloqueado ou de manutenção. No doors visible corresponde somente quando essa lista está vazia.
- A ordem das regras define a prioridade — a primeira regra habilitada que corresponde a uma pessoa prevalece; uma mensagem automática por pessoa.
- Quando uma pessoa deixa de corresponder a todas as regras, a mensagem automática dela é removida automaticamente.
- O texto da mensagem aceita os marcadores {firstName} e {lastName} — por exemplo, "Hi {firstName}, your membership has expired."
Como adicionar uma regra
- Clique em Add rule ou escolha uma opção em Start from a template…:
| Modelo | Corresponde a | Mensagem pré-preenchida (gravidade) |
|---|---|---|
| No door access | Door visibility: nenhuma porta visível | No door access available (Notice) |
| Expired membership | Membership status: expirada | Your membership has expired (Notice) |
| Payment overdue | Tag: overdue | Payment overdue (Notice) |
| Account on hold / suspended | Membership status: em espera, suspensa | Your account is on hold (Urgent) |
| Welcome (new member) | Tag: new | Welcome! (Information) |
| Trial / prospect | Person type: prospect | Enjoying your trial? (Information) |
| Document / waiver required | Tag: waiver-required | Action required (Notice) |
- Defina o campo When e os valores, edite a mensagem e verifique se a chave Rule enabled está ativada.
- Clique em Save changes na barra de salvamento das configurações.
O que acontece depois de salvar
Salvar dispara uma varredura em segundo plano que aplica as regras a todos na instalação. O cartão mostra o progresso: "Applying to members in the background…" e, em seguida, "App messages applied · N updated" (ou "Background update failed."). Os usuários desacoplados são ignorados pela varredura, e as regras também passam a ser aplicadas aos usuários à medida que são sincronizados ou editados.
A API móvel reavalia as regras automáticas em relação à visibilidade atual das portas sempre que as instalações são carregadas. Por isso, alterações de políticas, concessões, manutenção e programações afetam a mensagem imediatamente; o aplicativo não espera por outra varredura em segundo plano.
Como desativar a automação para uma pessoa
No painel de um usuário, quando uma mensagem automática está ativa, você pode clicar em Turn off for this user — a mensagem automática é removida e nenhuma regra enviará mensagens a essa pessoa novamente (até que você clique em Re-enable automated messages no mesmo lugar). É útil para exceções, por exemplo, um membro com uma contestação de cobrança que você está tratando pessoalmente.
O que os membros veem
As mensagens aparecem como cartões na parte superior do painel do aplicativo, coloridos de acordo com o tipo, com o título, o corpo e um botão de link opcional. As mensagens urgentes têm destaque visual. As mensagens são informativas — elas não bloqueiam o acesso às portas por si só (para isso, use a chave Access enabled ou as Access Policies).
Páginas relacionadas
- Usuários — mensagens por usuário, o selo Message
- Access Policies — autorização de portas por Who, Where e When
- Segurança e configurações do aplicativo — o cartão de mensagem para toda a instalação
- Guia do aplicativo móvel