agentbase-docs

消息

Messaging 用于向终端用户发送 Email / SMS / Push 消息,并管理 Topics(主题)、Subscribers(订阅者) 与 Providers(发送提供商)。

入口与导航

截图未公开:上游原图包含真实账号或资源标识。

前置条件

前提说明
权限成员需具备对应项目权限:messages.write(创建 / 发送 / 定时 / 删除消息)、topics.write(主题与订阅者管理)、providers.write(提供商管理);只读成员仅可查看
接收目标接收者来自项目 Auth 用户的 Targets:Email 目标需用户有邮箱、SMS 目标需用户有手机号、Push 目标为设备 token(产生与管理方式见认证与用户)
Provider发送某渠道前需已创建并启用该渠道的 Provider 及其第三方凭据

Providers(发送提供商)

创建:Providers 页 Create provider → 选择渠道 → 填写名称与 Provider ID → 配置凭据字段 → Create。创建向导内置「如何获取凭据」的分步指引。

渠道可选 Provider关键必填字段
PushFCM(Firebase)、APNS(Apple)FCM:服务账号 JSON 文件;APNS:Team ID、Bundle ID、密钥 ID、.p8 密钥,可选 Sandbox
EmailMailgun、SendGrid、Resend、SMTPAPI key + 发件邮箱(Mailgun 另需 Domain;SMTP 另需主机 / 端口 / 用户名 / 密码 / 加密方式)
SMSTwilio、MSG91、Telesign、Textmagic、Vonage账号凭据(SID / API key 等)+ 发信号码(MSG91 另需 Template ID)

管理(Provider 详情页):Enabled / Disabled 开关(投递时只使用已启用的 Provider)、重命名、更新凭据设置、Danger zone 删除。

不可逆风险:删除 Provider 将永久删除该配置实例,不可撤销。密钥类字段保存后不以明文回显。

Topics(主题)与订阅者

不可逆风险:删除主题将永久删除主题及其全部关联数据,不可撤销。

创建与发送消息

入口:Messages 页 Create message 下拉选择渠道(或命令中心快捷进入三步向导:Message → Targets → Schedule)。

渠道必填内容可选
EmailSubject、正文HTML 模式开关、自定义 Message ID
SMS正文(≤900 字符)—
Push标题、正文(≤1000 字符)图片(Media)、自定义键值数据(用户不可见);右侧手机预览

选择收件对象:选择 Topics(按渠道只发送该渠道的订阅 targets)和 / 或直接选择用户 targets;至少需要一个主题或目标。

发送时机:

消息状态与结果

状态含义可执行操作
draft草稿,不入队编辑正文 / 目标、Schedule、Send message、删除
scheduled已排期,等待定时发送Cancel scheduling(回草稿)、Reschedule、删除(同时取消投递)
processing已入队投递中(列表每 2 秒轮询刷新)不可编辑、不显示删除卡
sent至少一个目标投递成功删除(仅从列表移除,不撤回已投递消息)
failed投递失败(无可用 Provider、无有效目标或投递错误;部分失败同样计入 failed,无单独部分成功状态)Details / View logs 查看错误明细;删除

不可逆风险汇总:

常见问题