SuperAPI AI 工具集

sent-messaging

智能体与模型

查看项目

更新于 10-16 08:46

技能介绍

Sent Messaging 用于通过 Sent 的 MCP 工具执行消息相关工作流,主要工具为 messages.send、messages.get 和 messages.activities.list,可发送 SMS、WhatsApp 或 RCS 消息,并查询单条消息状态与活动历史。

使用方式:由 MCP 客户端执行 OAuth 2.1/PKCE 授权,不要请求、接受、打印或存储令牌、API 密钥、授权头、客户端 ID 或密钥。在变更前应展示当前连接所选的组织与 Sender Profile。组织授权可用可选 profileId 选择自有 Sender Profile,需通过 sender_profiles.list 或 sender_profiles.get 验证归属,并在预检读取、变更与后续读取中使用同一选择器。Profile 授权不能使用该选择器。

发送为模板制:先用 templates.list 或 templates.get 获取真实模板 ID 或名称,并在 template.parameters 中提供所有声明的变量,不能把消息正文当作模板名,也不能臆造自由文本参数。发送前应构建 messages.send 参数、展示载荷预览(含组织、Sender Profile、渠道、目标、模板标识、变量、调度与幂等输入),并取得针对该确切载荷的显式确认;此前的一般性同意无效。若载荷、范围或上下文变化,需重新预览并确认。

scheduledAt 为可选,须为带明确 UTC 偏移或 Z 的 ISO-8601 时间戳,须在 1 分钟至 30 天之后;受理后返回 QUEUED,再进入 SCHEDULED,受静默时段或账户限制影响可能被推迟或拒绝。可用 camelCase 的 idempotencyKey,同一键 24 小时内可重放缓存结果。没有 MCP 层面的改期或取消工具。查询时用 messages.get 获取当前记录,用 messages.activities.list 获取生命周期事件;受理或排队不代表已送达。重试视为新的变更,须重新预览并确认;结果不明时先查证再决定。