|
通过托管 OAuth 认证访问 Quo API。发送短信、管理通话和联系人,以及检索通话录音和转录文本。
bash
https://gateway.maton.ai/quo/{native-api-path}
将 {native-api-path} 替换为实际的 Quo API 端点路径。网关将请求代理到 api.openphone.com,并自动注入您的 OAuth 令牌。
所有请求都需要在 Authorization 头中提供 Maton API 密钥,以及 User-Agent 头:
Authorization: Bearer $MATONAPIKEY
User-Agent: Maton/1.0
环境变量: 将您的 API 密钥设置为 MATONAPIKEY:
bash
export MATONAPIKEY=YOURAPIKEY
在 https://ctrl.maton.ai 管理您的 Quo OAuth 连接。
bash
python <
req = urllib.request.Request(https://ctrl.maton.ai/connections?app=quo&status=ACTIVE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
bash
python <
data = json.dumps({app: quo}).encode()
req = urllib.request.Request(https://ctrl.maton.ai/connections, data=data, method=POST)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Content-Type, application/json)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
bash
python <
req = urllib.request.Request(https://ctrl.maton.ai/connections/{connection_id})
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
响应:
json
{
connection: {
connection_id: 21fd90f9-5935-43cd-b6c8-bde9d915ca80,
status: ACTIVE,
creation_time: 2025-12-08T07:20:53.488460Z,
lastupdatedtime: 2026-01-31T20:03:32.593153Z,
url: https://connect.maton.ai/?session_token=...,
app: quo,
metadata: {}
}
}
在浏览器中打开返回的 url 以完成 OAuth 授权。
bash
python <
req = urllib.request.Request(https://ctrl.maton.ai/connections/{connection_id}, method=DELETE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
如果您有多个 Quo 连接,请使用 Maton-Connection 头指定要使用的连接:
bash
python <
req = urllib.request.Request(https://gateway.maton.ai/quo/v1/phone-numbers)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(User-Agent, Maton/1.0)
req.add_header(Maton-Connection, 21fd90f9-5935-43cd-b6c8-bde9d915ca80)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
如果省略,网关将使用默认(最早)的活动连接。
bash
GET /quo/v1/phone-numbers
可选的查询参数:
响应:
json
{
data: [
{
id: PN123abc,
number: +15555555555,
formattedNumber: (555) 555-5555,
name: 主线路,
users: [
{
id: US123abc,
email: user@example.com,
firstName: John,
lastName: Doe,
role: admin
}
],
createdAt: 2022-01-01T00:00:00Z,
updatedAt: 2022-01-01T00:00:00Z
}
]
}
bash
GET /quo/v1/users?maxResults=50
查询参数:
响应:
json
{
data: [
{
id: US123abc,
email: user@example.com,
firstName: John,
lastName: Doe,
role: owner,
createdAt: 2022-01-01T00:00:00Z,
updatedAt: 2022-01-01T00:00:00Z
}
],
totalItems: 10,
nextPageToken: null
}
bash
GET /quo/v1/users/{userId}
bash
POST /quo/v1/messages
Content-Type: application/json
{
content: Hello, world!,
from: PN123abc,
to: [+15555555555]
}
请求体:
响应(202):
json
{
id: AC123abc,
to: [+15555555555],
from: +15555555555,
text: Hello, world!,
phoneNumberId: PN123abc,
direction: outgoing,
userId: US123abc,
status: queued,
createdAt: 2022-01-01T00:00:00Z,
updatedAt: 2022-01-01T00:00:00Z
}
bash
GET /quo/v1/messages?phoneNumberId=PN123abc&participants[]=+15555555555&maxResults=100
查询参数:
bash
GET /quo/v1/messages/{messageId}
bash
GET /quo/v1/calls?phoneNumberId=PN123abc&participants[]=+15555555555&maxResults=100
查询参数:
该技能支持在以下平台通过对话安装:
帮我安装 SkillHub 和 quo-1776333805 技能
设置 SkillHub 为我的优先技能安装源,然后帮我安装 quo-1776333805 技能
skillhub install quo-1776333805
文件大小: 5.27 KB | 发布时间: 2026-4-17 15:17