应用消息
本页内容
应用消息是显示在移动应用仪表板上的公告卡片，共有三种类型：所有人都能看到的设施范围消息、为个人设置的单个用户消息，以及由规则应用的自动消息（例如会员资格过期通知）。本页介绍这三种消息以及它们共用的消息编辑器。
三种消息类型概览
| 类型 | 受众 | 配置位置 | 优先规则 |
|---|---|---|---|
| 设施范围消息 | 设施中的所有人 | Settings → App Security & Settings → 设施范围消息卡片 | 与任何单个用户消息一同显示 |
| 单个用户消息（手动） | 一个人 | Users → 用户面板 → App message | 手动消息永远不会被自动化覆盖 |
| 自动消息 | 符合条件的所有人 | Settings → Automated Messages | 仅在未设置手动消息时应用；条件不再满足时会自动清除 |
消息编辑器
三种消息使用同一个编辑器（下方图 1 显示了两条自动消息规则中的编辑器）。
| 字段 | 详细信息 |
|---|---|
| Notification type | Information（中性）、Notice（警告语气）或 Urgent。控制卡片在应用中的颜色和严重程度标签（INFORMATION / NOTICE / URGENT）。 |
| Title | 最多 120 个字符，例如 Pool Closed for Maintenance |
| Message body | 最多 2000 个字符（超过 500 个字符时会显示软性警告，仪表板卡片应保持简短） |
| Optional link URL | http:// / https:// 链接；如果省略，系统会自动添加 https:// |
| Link label | 链接的按钮文字；默认为 More info |
| Schedule | 可选的 Starts at / Ends at 日期时间。留空表示不限制；消息只在该时间段内显示。 |
实时预览显示 "How this will look on the mobile app dashboard." 编辑器的主开关可开启或关闭消息，且不会丢失其内容。
设施范围消息
Settings → App Security & Settings 中的设施范围消息卡片："Allows you to configure a notification in the app for everyone at this facility." 可用于发布关闭通知、维护时段或活动信息。请记得在设置保存栏中点击保存更改。
单个用户消息
在 Users 中打开用户，然后使用其面板中的 App message 部分。典型用途：付款提醒、个人通知、“请到前台”提示。拥有有效消息的用户会在列表中显示 Message 标记，其颜色按严重程度区分。
手动设置的单个用户消息始终优先，自动化不会覆盖它。
自动消息
Settings → Automated Messages 会打开 App Messaging Rules 页面，该页面根据会员资格数据或当前门的可见性自动设置单个用户消息。手动设置的消息永远不会被覆盖，自动消息在不再适用时会自动清除。
图 1：App Messaging Rules，其中两条规则使用 Urgent 通知类型
规则的工作方式
- Enable automated messages 是总开关：关闭时，下方所有规则均不生效（以暗色显示："Automated messages are turned off — these rules are inactive."）。
- 每条规则的形式为：When <Membership status | Person type | Tag | Door visibility> is any of <值> → 显示此消息。Tag 规则同时匹配同步标签和自定义标签（不区分大小写）。
- Door visibility 支持 No doors visible 和 Has visible doors。它使用移动应用最终的门列表：可用的门以及未来/开放时段外的门都算作可见，特意以封锁或维护状态显示的门也算作可见。仅当该列表为空时，No doors visible 才会匹配。
- 规则顺序即优先级：第一条匹配某人的已启用规则生效；每人只显示一条自动消息。
- 当某人不再匹配任何规则时，其自动消息会自动清除。
- 消息文本支持占位符 {firstName} 和 {lastName}，例如 "Hi {firstName}, your membership has expired."
添加规则
- 点击 Add rule，或从 Start from a template… 中选择：
| 模板 | 匹配条件 | 预填消息（严重程度） |
|---|---|---|
| No door access | Door visibility：no doors visible | No door access available（Notice） |
| Expired membership | Membership status：expired | Your membership has expired（Notice） |
| Payment overdue | Tag：overdue | Payment overdue（Notice） |
| Account on hold / suspended | Membership status：on hold、suspended | 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） |
- 设置 When 字段及其值，编辑消息，并确保 Rule enabled 开关已开启。
- 在设置保存栏中点击保存更改。
保存后会发生什么
保存后会触发后台批量处理，将规则应用于设施中的所有人。卡片会显示进度："Applying to members in the background…"，然后显示 "App messages applied · N updated"（或 "Background update failed."）。批量处理会跳过已解除关联的用户，此后用户在同步或编辑时也会应用这些规则。
每当加载设施时，移动 API 都会根据当前门的可见性重新评估自动规则。因此，策略、授权、维护和时间表的更改会立即影响消息；应用无需等待下一次后台批量处理。
为单个用户关闭自动化
在用户面板中，当有自动消息生效时，您可以点击 Turn off for this user：该自动消息会被移除，此后任何规则都不会再向其发送消息（直到您在此处点击 Re-enable automated messages）。这适用于例外情况，例如您正在亲自处理账单纠纷的会员。
会员看到的内容
消息以卡片形式显示在应用仪表板顶部，按类型着色，包含标题、正文和可选的链接按钮。Urgent 消息在视觉上更醒目。消息仅用于提供信息，其本身不会阻止门禁访问（如需阻止，请使用 Access enabled 开关或 Access Policies）。
相关页面
- 用户：单个用户消息、Message 标记
- Access Policies：按 Who、Where 和 When 进行门禁授权
- 应用安全与设置：设施范围消息卡片
- 移动应用指南