用途:该技能用于让 AI 代理与 Sendoso 数据交互。Sendoso 是一个发送平台,企业通过个性化礼品、电子礼品和直邮与客户、潜在客户及员工建立关系,营销、销售和客户成功团队用它提升参与度和忠诚度。官方文档见 https://developers.sendoso.com/。
主要能力:可管理 Send、Touch、Account、Campaign、Contact、Event、Sendoso List、User 等对象。常见操作包括创建实体礼品发送(可选通过邮件收集地址)、创建直接邮件投递的电子礼品发送、分页列出所有发送记录、按 ID 获取或列出活动(touch)、列出团队组及其预算、列出团队成员、邀请用户、列出用户、获取当前认证用户信息(含余额、角色、团队余额)。
使用方式:先安装 Membrane CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会打印授权 URL,完成后执行 membrane login complete <code>。连接 Sendoso:membrane connection ensure "https://sendoso.com" --json,用户在浏览器完成认证;若状态为 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"}'。当现有动作不覆盖需求时,可通过代理直接请求 Sendoso API:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--rawData、--query、--pathParam 等选项。任意命令加 --json 可获得机器可读输出。
适用场景:需要以编程方式创建礼品或电子礼品发送、查询发送状态与收件人、管理活动与团队组、管理用户及查看余额等。
限制:认证由 Membrane 服务端管理,不应向用户索取 API 密钥或令牌;连接状态可能为 CLIENT_ACTION_REQUIRED、CONFIGURATION_ERROR 或 SETUP_FAILED,需按提示处理。资料未提供具体收费、价格、平台支持范围及速率限制等信息。