消息目标
Target 是 Auth 用户的通知目的地:邮箱地址、手机号或安装了应用的设备。Messaging 发送消息时的接收对象就是用户的 targets——target 可以订阅主题并接收发布到主题的消息。
查看与删除(Console)
入口:用户详情页 Targets 页签。
- 列:Target ID、Target(push 显示名称,email/SMS 显示 identifier)、Type(Email / SMS / Push)、Provider(关联的 Messaging 提供商,未指定时为空)、Created。
- 操作:勾选后批量删除。删除 target 后,消息将无法再投递到该目的地。
目标的产生方式
- 创建用户时自动生成:创建 Auth 用户时,系统自动为其生成一个 Email target(identifier=邮箱);填写了手机号时同时生成 SMS target。
- Server API 创建:
POST /v1/users/{userId}/targets(需要targets.write权限的 API Key):
| 参数 | 规则 |
|---|---|
targetId | 可选;自定义 ID 规则同用户 ID,缺省自动生成 |
providerType | 必填,只能是 email / sms / push |
identifier | 必填:邮箱地址 / 手机号 / 设备推送 token;email 类型必须是合法邮箱 |
providerId | 可选;指定已配置的 Messaging Provider,缺省使用第一个已配置的同渠道 Provider |
name | 可选,最长 128 字符(push 目标建议命名设备) |
重复创建相同目的地返回 USER_TARGET_ALREADY_EXISTS。
版本事实(如实说明):Console 的 Targets 页签提供查看与删除;代码中存在创建目标弹窗组件,但页面上没有任何可见按钮触发它。Push 目标与额外的 Email / SMS 目标请通过 Server API 或 SDK 创建。
常见问题
- 消息发送时找不到目标? 该用户没有对应渠道的 target:确认用户已填写邮箱 / 手机号(自动 target),或先用 Server API 创建 push target。
- 删除用户后 target 还在吗? 不在。删除用户会连同其全部 targets 一起删除。