SuperAPI AI 工具集

telephony

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:为 Hermes 增加实用电话能力,同时不把电话功能加入核心工具列表。辅助脚本 scripts/telephony.py 可保存服务商凭据、搜索并购买 Twilio 号码、记住已购号码、发送 SMS/MMS、轮询入站短信、用 TwiML <Say> 或 <Play> 直接呼叫、把 Twilio 号码导入 Vapi,以及通过 Bland.ai 或 Vapi 发起 AI 外呼。

主要能力:覆盖外呼、发短信、拥有可复用代理号码、之后查看该号码收到的消息,并在会话间保留号码与相关 ID。入站短信通过轮询 Twilio REST API 实现,无需 webhook 服务器;它不是实时入站电话网关。

使用方式:安装命令为 hermes skills search telephony 与 hermes skills install official/productivity/telephony。脚本定位:SCRIPT="$(find ~/.hermes/skills -path '*/telephony/scripts/telephony.py' -print -quit)"。凭据与状态保存在 ${HERMES_HOME:-~/.hermes}/.env 和 ~/.hermes/telephony_state.json。常用命令包括 save-twilio、twilio-search、twilio-buy、twilio-send-sms、twilio-inbox --since-last --mark-seen、twilio-call、save-bland、save-vapi、vapi-import-twilio、ai-call、ai-status、diagnose。

适用场景:需要代理自有号码、部署告警或定时通知、稍后读取短信、单向语音播报、IVR 按键导航,以及 Bland/Vapi 的 AI 外呼。

限制:呼叫或发短信前必须确认;禁止紧急号码、骚扰、垃圾信息、冒充或违法用途;第三方号码不得写入 Hermes 记忆。VoIP 号码不保证适用于所有第三方 2FA。Twilio 试用账户和地区规则可能限制呼叫对象;twilio-inbox 是轮询而非即时推送;Vapi 外呼依赖已导入的有效号码。该技能不支持实时入站接听、基于 webhook 的实时短信推送,也不保证支持任意第三方 2FA。