OpenPhone

该 Skill 提供 OpenPhone REST API 的 curl 用法，用于发送短信、查询消息与通话记录、获取语音留言和通话转录、管理联系人及电话号码。需要 OPENPHONE_API_KEY 和网络访问；每次操作通过命令行发起，不含本地文件处理或图形界面。

dwhite-oss

热度 46.83

最近更新 2026-05-11 17:37:27

分类：协作依赖：代码执行 / 第三方 API应用场景：CRM / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add openphone

Metadata

name: openphone
description: Manage business phone calls, SMS, and contacts via OpenPhone API. Use when asked to send a text message, list calls or messages, look up conversation history with a contact, get voicemail transcripts, list phone numbers, or check call recordings. Requires OPENPHONE_API_KEY env var.

OpenPhone Skill

OpenPhone REST API base: https://api.openphone.com/v1

Auth

curl -H "Authorization: $OPENPHONE_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.openphone.com/v1/...

Phone Numbers

List Your Phone Numbers

curl "https://api.openphone.com/v1/phone-numbers" \
  -H "Authorization: $OPENPHONE_API_KEY"
# Save phoneNumberId for sending messages/calls

Contacts

Search Contacts

curl "https://api.openphone.com/v1/contacts?query=John+Smith" \
  -H "Authorization: $OPENPHONE_API_KEY"

Create Contact

curl -X POST "https://api.openphone.com/v1/contacts" \
  -H "Authorization: $OPENPHONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Jane",
    "lastName": "Smith",
    "phoneNumbers": [{"number": "+15551234567"}],
    "emails": [{"address": "jane@acme.com"}],
    "company": "Acme Corp"
  }'

Messages (SMS/MMS)

Send SMS

curl -X POST "https://api.openphone.com/v1/messages" \
  -H "Authorization: $OPENPHONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "<phoneNumberId>",
    "to": ["+15551234567"],
    "content": "Hi Jane, following up on our conversation earlier!"
  }'

List Messages (Conversation History)

curl "https://api.openphone.com/v1/messages?phoneNumberId=<id>&participants[]=+15551234567&maxResults=20" \
  -H "Authorization: $OPENPHONE_API_KEY"

Calls

List Calls

curl "https://api.openphone.com/v1/calls?phoneNumberId=<id>&maxResults=20" \
  -H "Authorization: $OPENPHONE_API_KEY"

Get Call Details (Recording + Transcript)

curl "https://api.openphone.com/v1/calls/<call_id>" \
  -H "Authorization: $OPENPHONE_API_KEY"
# Response includes: recordingUrl, transcript (if enabled), duration, direction

List Voicemails

curl "https://api.openphone.com/v1/calls?type=voicemail&phoneNumberId=<id>" \
  -H "Authorization: $OPENPHONE_API_KEY"

Call Directions

incoming, outgoing

Message Status Values

queued, sending, delivered, failed, received

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