OpenPhone Skill
OpenPhone REST API base: INLINECODE0
Auth
CODEBLOCK0
Phone Numbers
List Your Phone Numbers
CODEBLOCK1
Contacts
Search Contacts
CODEBLOCK2
Create Contact
CODEBLOCK3
Messages (SMS/MMS)
Send SMS
CODEBLOCK4
List Messages (Conversation History)
CODEBLOCK5
Calls
List Calls
CODEBLOCK6
Get Call Details (Recording + Transcript)
CODEBLOCK7
List Voicemails
CODEBLOCK8
Call Directions
incoming, INLINECODE2
Message Status Values
queued,
sending,
delivered,
failed, INLINECODE7
Tips
- -
phoneNumberId starts with PN — always list phone numbers first - Transcripts require call recording to be enabled in workspace settings
- Rate limit: 60 req/min; batch message sends in loops with brief delays
OpenPhone 技能
OpenPhone REST API 基础地址：https://api.openphone.com/v1
认证
bash
curl -H Authorization: $OPENPHONE
APIKEY \
-H Content-Type: application/json \
https://api.openphone.com/v1/...
电话号码
列出您的电话号码
bash
curl https://api.openphone.com/v1/phone-numbers \
-H Authorization: $OPENPHONE
APIKEY
保存 phoneNumberId 用于发送消息/通话
联系人
搜索联系人
bash
curl https://api.openphone.com/v1/contacts?query=John+Smith \
-H Authorization: $OPENPHONE
APIKEY
创建联系人
bash
curl -X POST https://api.openphone.com/v1/contacts \
-H Authorization: $OPENPHONE
APIKEY \
-H Content-Type: application/json \
-d {
firstName: Jane,
lastName: Smith,
phoneNumbers: [{number: +15551234567}],
emails: [{address: jane@acme.com}],
company: Acme Corp
}
消息（短信/彩信）
发送短信
bash
curl -X POST https://api.openphone.com/v1/messages \
-H Authorization: $OPENPHONE
APIKEY \
-H Content-Type: application/json \
-d {
from:
,
to: [+15551234567],
content: Hi Jane, following up on our conversation earlier!
}
列出消息（对话历史）
bash
curl https://api.openphone.com/v1/messages?phoneNumberId=&participants[]=+15551234567&maxResults=20 \
-H Authorization: $OPENPHONEAPIKEY
通话
列出通话
bash
curl https://api.openphone.com/v1/calls?phoneNumberId=&maxResults=20 \
-H Authorization: $OPENPHONEAPIKEY
获取通话详情（录音 + 转录文本）
bash
curl https://api.openphone.com/v1/calls/ \
-H Authorization: $OPENPHONEAPIKEY
响应包含：recordingUrl、transcript（如果启用）、duration、direction
列出语音信箱
bash
curl https://api.openphone.com/v1/calls?type=voicemail&phoneNumberId= \
-H Authorization: $OPENPHONEAPIKEY
通话方向
incoming（呼入）、outgoing（呼出）
消息状态值
queued（排队中）、sending（发送中）、delivered（已送达）、failed（失败）、received（已接收）
提示
- - phoneNumberId 以 PN 开头——始终先列出电话号码
- 转录文本需要在工作区设置中启用通话录音
- 速率限制：每分钟 60 次请求；批量发送消息时需在循环中添加短暂延迟
