跳到主要内容

让你的 AI Agent 连接 Saperly

配置号码与处理服务,在工作区权限范围内使用语音和短信。

每月 20,000 次免费应用调用(付费服务另计)

试试这些 Saperly 任务

将提示词复制到已安装 oo Skill 的 Agent,补充页面链接和原始笔记后执行。

oo SkillSaperly

检查用量与号码费用

开通前查询余额和号码报价。

/oo Saperly: 使用 Saperly 显示我的余额和用量,再查询 [国家] 的 [号码类型] 报价。

开始使用 Saperly

  1. 安装 OOMOL

    在 Agent 中配置 oo CLI 和 oo Skill。

    安装 OOMOL →
  2. 连接 Saperly

    在 https://saperly.com/sign-in 登录后,于 Settings → Keys 创建密钥。

    连接 Saperly→
  3. 向 Agent 交代任务

    使用 /oo,说明要读取的页面、修改的内容和保存位置。

    连接指南 →
  • 具有 read 权限的 Saperly API 密钥,用于连接验证。
  • 付费操作需要 write 权限和足够的预付余额;密钥管理需要 admin 权限。
  • 号码白名单、支出上限和同意检查由 Saperly 执行。
  • 自定义声音使用不超过 20 MiB 的公开音频 URL;manual connection 需要自行部署外部处理服务。
  • 可轮询通话和声音处理状态,录音链接为临时链接。

Saperly 工具

开通号码,配置 hosted 或 manual connection,查询或上传声音,管理同意记录,发送消息并读取通话记录。工作区工具覆盖用量、带权限的 API 密钥、webhook 和审计事件。

电话号码

报价、开通、配置和释放号码。

Connection 与声音

配置 hosted 或 manual 处理服务,查询声音并上传自定义声音样本。

通话、短信与同意记录

管理同意记录、发送短信、发起通话并读取录音与转录。

工作区与密钥管理

读取用量、管理带权限的密钥与 webhook、查看审计事件并向工作区助手提问。

48 个工具

Health

查询服务健康状态。

saperly.health

List Workspace Members

列出工作区成员。

saperly.list_workspace_members

List Workspace Keys

列出指定工作区的 API 密钥。

saperly.list_workspace_keys

Create Workspace Key

为指定工作区创建带权限的 API 密钥。

saperly.create_workspace_key

List Workspace Webhooks

列出工作区 webhook。

saperly.list_workspace_webhooks

Create Workspace Webhook

创建工作区事件 webhook。

saperly.create_workspace_webhook

List Webhook Deliveries

查询 webhook 投递历史。

saperly.list_webhook_deliveries

List Workspace Audit Events

列出工作区审计事件。

saperly.list_workspace_audit_events

Revoke Workspace Key

撤销指定工作区的 API 密钥。

saperly.revoke_workspace_key

Send Workspace Invitation

发送工作区邀请。

saperly.send_workspace_invitation

Ask Assistant

向工作区助手提问,助手可能调用工作区工具。

saperly.ask_assistant

List Numbers

列出电话号码。

saperly.list_numbers

Provision Number

开通电话号码并保留报价保护。

saperly.provision_number

Get Number

查询电话号码详情。

saperly.get_number

Release Number

释放电话号码。

saperly.release_number

Assign Connection

为号码绑定 connection。

saperly.assign_connection

Set Number Webhook

配置号码级 manual 模式文字处理 webhook。

saperly.set_number_webhook

Set Sms Sender

设置国际短信发送者 ID。

saperly.set_sms_sender

Set Caller Id

设置主叫显示名称。

saperly.set_caller_id

List Connections

列出 connection。

saperly.list_connections

Create Connection

创建 connection。

saperly.create_connection

Get Connection

查询 connection。

saperly.get_connection

Update Connection

更新 connection 并同步运营商配置。

saperly.update_connection

Delete Connection

删除 connection。

saperly.delete_connection

Send Message

发送短信。

saperly.send_message

List Messages

列出短信,可按号码筛选。

saperly.list_messages

Place Call

发起呼出通话。

saperly.place_call

List Calls

列出通话。

saperly.list_calls

End Call

结束正在进行的通话。

saperly.end_call

Transfer Call

盲转正在进行的通话。

saperly.transfer_call

Get Call

查询通话状态与详情。

saperly.get_call

Get Recording

获取已结束通话录音的临时下载 URL。

saperly.get_recording

Get Transcript

获取通话转录。

saperly.get_transcript

List Voices

列出可用声音,可按语言筛选。

saperly.list_voices

List Custom Voices

列出自定义声音。

saperly.list_custom_voices

Create Custom Voice

从公开 URL 上传声音样本,通过 get_custom_voice 查询处理结果。

saperly.create_custom_voice

Get Custom Voice

查询自定义声音状态。

saperly.get_custom_voice

Delete Custom Voice

删除自定义声音。

saperly.delete_custom_voice

List Languages

列出支持的口语语言。

saperly.list_languages

Get Usage

查询用量与余额,可指定起始时间。

saperly.get_usage

List Consent

列出工作区同意记录。

saperly.list_consent

Record Consent

记录联系人的同意。

saperly.record_consent

Revoke Consent

撤销联系人的同意。

saperly.revoke_consent

Check Consent

检查联系人是否有有效同意。

saperly.check_consent

Get Price Quote

查询电话号码报价。

saperly.get_price_quote

List Keys

列出当前工作区的 API 密钥。

saperly.list_keys

Mint Key

在父密钥权限上限内创建子密钥。

saperly.mint_key

Revoke Key

撤销 API 密钥。

saperly.revoke_key

常见问题

为什么密钥有效但请求仍被拒绝?

Scope、号码白名单、支出上限或同意状态都可能限制操作。应先查看 Saperly 返回的错误,再决定是否更换密钥。