消息
Messaging 用于向终端用户发送 Email / SMS / Push 消息,并管理 Topics(主题)、Subscribers(订阅者) 与 Providers(发送提供商)。
入口与导航
截图未公开:原图可能包含账号或资源标识。
- 页面路径:
/console/project-{region}-{project}/messaging,页头三个页签:Messages / Topics / Providers。 - 当前版本侧边栏默认不显示 Messaging 入口(构建内置隐藏项),可通过直达 URL 或命令中心进入;路由与功能本身可用。
前置条件
| 前提 | 说明 |
|---|---|
| 权限 | 成员需具备对应项目权限:messages.write(创建 / 发送 / 定时 / 删除消息)、topics.write(主题与订阅者管理)、providers.write(提供商管理);只读成员仅可查看 |
| 接收目标 | 接收者来自项目 Auth 用户的 Targets:Email 目标需用户有邮箱、SMS 目标需用户有手机号、Push 目标为设备 token(产生与管理方式见认证与用户) |
| Provider | 发送某渠道前需已创建并启用该渠道的 Provider 及其第三方凭据 |
Providers(发送提供商)
创建:Providers 页 Create provider → 选择渠道 → 填写名称与 Provider ID → 配置凭据字段 → Create。创建向导内置「如何获取凭据」的分步指引。
| 渠道 | 可选 Provider | 关键必填字段 |
|---|---|---|
| Push | FCM(Firebase)、APNS(Apple) | FCM:服务账号 JSON 文件;APNS:Team ID、Bundle ID、密钥 ID、.p8 密钥,可选 Sandbox |
| Mailgun、SendGrid、Resend、SMTP | API key + 发件邮箱(Mailgun 另需 Domain;SMTP 另需主机 / 端口 / 用户名 / 密码 / 加密方式) | |
| SMS | Twilio、MSG91、Telesign、Textmagic、Vonage | 账号凭据(SID / API key 等)+ 发信号码(MSG91 另需 Template ID) |
管理(Provider 详情页):Enabled / Disabled 开关(投递时只使用已启用的 Provider)、重命名、更新凭据设置、Danger zone 删除。
不可逆风险:删除 Provider 将永久删除该配置实例,不可撤销。密钥类字段保存后不以明文回显。
Topics(主题)与订阅者
- 创建主题:Topics 页 Create topic → 名称(可自定义 Topic ID)。
- 添加订阅者:主题详情 Create subscriber → 从 Auth 用户的 targets 中勾选(订阅对象是「用户的通知目标」,不是属性订阅)。可批量删除订阅者。
- 设置(Settings):改名;Subscription access 角色设定(控制哪些客户端角色可通过 Client API 订阅该主题)。
- Activity:主题的操作审计日志。
不可逆风险:删除主题将永久删除主题及其全部关联数据,不可撤销。
创建与发送消息
入口:Messages 页 Create message 下拉选择渠道(或命令中心快捷进入三步向导:Message → Targets → Schedule)。
| 渠道 | 必填内容 | 可选 |
|---|---|---|
| Subject、正文 | HTML 模式开关、自定义 Message ID | |
| SMS | 正文(≤900 字符) | — |
| Push | 标题、正文(≤1000 字符) | 图片(Media)、自定义键值数据(用户不可见);右侧手机预览 |
选择收件对象:选择 Topics(按渠道只发送该渠道的订阅 targets)和 / 或直接选择用户 targets;至少需要一个主题或目标。
发送时机:
- Now:立即入队投递。发送确认框会显示预估目标数并明示 This action is irreversible.
- 定时(Schedule):选择未来日期时间;成功后状态为
scheduled,可 Reschedule 或 Cancel scheduling(取消定时后消息回到草稿状态,可继续编辑)。 - 保存草稿(Save as draft):不进入投递队列;草稿可修改正文与主题 / 目标。
消息状态与结果
| 状态 | 含义 | 可执行操作 |
|---|---|---|
draft | 草稿,不入队 | 编辑正文 / 目标、Schedule、Send message、删除 |
scheduled | 已排期,等待定时发送 | Cancel scheduling(回草稿)、Reschedule、删除(同时取消投递) |
processing | 已入队投递中(列表每 2 秒轮询刷新) | 不可编辑、不显示删除卡 |
sent | 至少一个目标投递成功 | 删除(仅从列表移除,不撤回已投递消息) |
failed | 投递失败(无可用 Provider、无有效目标或投递错误;部分失败同样计入 failed,无单独部分成功状态) | Details / View logs 查看错误明细;删除 |
不可逆风险汇总:
- 立即发送不可撤销;已进入
processing/sent/failed的消息不能改内容重发同一记录。 - 删除
sent/failed消息只是从 Console 移除记录,不会召回已发出的消息。 - Messages / Topics / 订阅者 / Providers 列表均支持多选批量删除,删除类操作均需确认。
常见问题
- 侧栏没有「消息」入口? 当前版本默认隐藏该项;使用直达 URL 或命令中心进入。
- 发送失败? 检查该渠道是否已启用 Provider 且凭据完整、目标用户是否有对应渠道的 targets;在消息详情 / 列表查看失败明细。
- 主题没出现在发送对象里? 该主题在对应渠道下没有订阅者;先为主题添加该渠道的订阅目标。