用途:该技能用于向手机号发送短信(SMS),当用户提出“发短信”“发 SMS”“给某人发消息”或“通过短信发送通知”等需求时使用。它通过 Orthogonal 上的 Textbelt API 完成发送,并可查询投递状态。
主要能力:发送短信并返回 textId 用于跟踪;查询投递状态,状态值为 DELIVERED、SENDING、FAILED 或 UNKNOWN;发送响应包含 success、textId、quotaRemaining 和 error 字段。
使用方式:先从 ~/.gooseworks/credentials.json 读取凭据并设置环境变量: export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])") export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))") 若该文件不存在,需提示用户运行 npx gooseworks login。所有端点使用 Bearer 认证。发送时向 $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run 发起 POST 请求,请求体指定 api 为 textbelt、path 为 /text,并传入 phone 与 message;查询状态时 path 为 /status/{textId},该状态查询端点免费。
适用场景:需要以短信形式向用户或联系人发送简短通知、提醒或消息时。
限制:单条消息最多 800 字符,超长会被拒绝而非截断;消息中不允许包含 URL,含 URL 会被拒绝,可用文字描述代替;美国/加拿大号码仅能在美国/加拿大 IP 区域使用;国际号码需使用 E.164 格式(如 +44...);发送者名称可选,在多数国家收件人不可见。可选参数包括 sender、replyWebhookUrl(仅美国)和 webhookData(最多 100 字符)。失败时 success 为 false,error 字段说明原因,如号码无效或余额不足。