SuperAPI AI 工具集

saas-telephony

办公与效率

查看项目

更新于 10-16 08:00

技能介绍

用途:该技能用于让智能体经 ThinkFleetBot SaaS 电话 API 发起语音通话、发送短信(SMS)与多媒体短信(MMS),并查询发送状态与历史记录。所有请求需携带 Authorization: Bearer $SAAS_API_KEY,接口基址为 $SAAS_API_URL。

主要能力与用法:先检查是否启用——curl -s "$SAAS_API_URL/api/agents/me/telephony" -H "Authorization: Bearer $SAAS_API_KEY",返回 enabled、phone_number、capabilities;若 enabled 为 false 则不要尝试通话或发消息。发送短信:POST $SAAS_API_URL/api/messaging/sms,JSON 体含 to 与 body。发送彩信:POST $SAAS_API_URL/api/messaging/mms,JSON 体含 to、body、media_url。发起语音通话:POST $SAAS_API_URL/api/messaging/voice,JSON 体含 to 与 prompt,prompt 定义 AI 要说的话。查询状态:GET /api/messaging/sms/{MESSAGE_ID} 或 /api/messaging/voice/{CALL_ID},分别返回 status、delivered_at、error 或 status、duration、recording_url。列出近期消息:GET /api/messaging/history?limit=20。

限制与注意事项:发送前必须检查电话功能是否启用,并向用户确认收件人号码;号码须为 E.164 格式(如 +1XXXXXXXXXX);消息投递为异步,需要确认时应发送后查询状态;存在速率限制,未确认套餐限制前不要群发;不要在 SaaS 平台之外以明文记录或存储电话号码。语音 prompt 应保持口语化且清晰。资料未提供具体价格、配额数值与错误码说明。