SuperAPI AI 工具集

message-bird

办公与效率

查看项目

更新于 10-16 00:27

技能介绍

用途:这是一个 Message Bird 集成技能,用于在 Membrane CLI 中与 Message Bird 云通信平台交互。Message Bird 提供 SMS、语音和聊天 API,该技能适合用户需要操作 Message Bird 数据时使用,包括管理 Persons、Organizations、Pipelines、Users、Goals、Filters,以及发送短信、查询消息与账户余额等。

主要能力:官方资料列出的常用操作包含列出联系人(list-contacts)、删除联系人(delete-contact)、更新联系人(update-contact)、获取联系人(get-contact)、创建联系人(create-contact)、获取余额(get-balance)、删除消息(delete-message)、获取消息(get-message)、列出消息(list-messages)、发送短信(send-sms)。可通过自然语言意图搜索更多动作(membrane action list)。当现有动作不满足需求时,可通过 Membrane 代理直接向 Message Bird API 发送请求,Membrane 会自动拼接基础 URL 并注入认证头,支持凭证过期后的透明刷新。

使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>;无头环境下会打印授权 URL,用户完成登录后用 membrane login complete <code> 收尾。连接:membrane connection ensure "https://messagebird.com" --json,用户在浏览器完成认证后获得连接 id;若状态为 BUILDING 可用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。搜索动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --json,传参使用 --input '{"key": "value"}'。代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。任意命令加 --json 可获得机器可读输出。

适用场景:需要在自动化代理或工作流中读写 Message Bird 联系人、短信、消息记录与账户信息时使用;官方建议优先使用预建动作,因其内置认证、分页与错误处理,比自行编写 API 调用更省 token 且更安全。

限制与说明:需要通过 Membrane 建立连接,不要让用户直接提供 API 密钥或令牌,凭证由 Membrane 在服务端管理。部分连接状态需要用户在浏览器中完成操作(如 clientAction.type 为 connect 或 provide-input)。交互模式下登录会打开浏览器,无头模式只能给出授权 URL。其他未在资料中明确说明的功能、收费、价格与平台支持情况,暂未提供。官方文档地址为 https://developers.messagebird.com/。