OdyOdy
免费试用

开发者 API

您的商务电话，
现在可编程。

您的 Ody 工作区中的每个联系人、对话、消息和通话都通过一个简洁的 REST API 提供 | | 此外还有一个用于 AI 助手的 MCP 服务器、签名 Webhook 和 SDK。一个密钥，几分钟内即可创建。

Bearer 认证 · ody_live_ 和 ody_test_ 密钥 · 设置 → 开发者 API

send-sms.sh | | 您的第一个 API 调用
# 从您的 Ody 号码发送短信
curl https://api.ody.co/v1/api/messages \
-H "Authorization: Bearer ody_live_…" \
-H "Idempotency-Key: order-1042-shipped" \
-d '{"to": "+15125550123", "body": "Your order shipped!"}'
201 已创建
{
"conversationId": "b4a6f0…",
"message": { "body": "Your order shipped!" },
"simulated": false
}
POST /messages 上的幂等键 | | 24 小时内的重试会重放首次响应
每个列表端点上的游标分页 | | 遵循 nextCursor，永不遗漏任何一行
标准 RateLimit-Limit / -Remaining / -Reset 标头，429 上的 Retry-After
统一的 JSON 错误封装，每个响应都带有 X-Request-Id 回显

平台

在 Ody 上构建所需的一切

六个部分，一个 API 密钥。以最好的方式设计得“无聊”：可预测的资源、可预测的错误、可预测的页面。

REST API

联系人 CRUD、对话、短信/彩信发送、消息搜索、通话记录和电话号码位于 https://api.ody.co/v1/api | | 使用您的 ody_live_ 密钥进行 Bearer 认证。

GET /v1/api/contacts

用于 AI 助手的 MCP

将 ChatGPT、Claude 或 Cursor 连接到 https://api.ody.co/v1/mcp，您的助手将获得 11 种工具 | | 列出和更新联系人、读取对话、搜索消息、发送短信 | | 由您的密钥限定范围。

11 tools · /v1/mcp

签名 Webhook

带有 Standard-Webhooks HMAC 签名的出站 Webhook | | webhook-id、webhook-timestamp 和 webhook-signature 标头 | | 自动重试，以及可随时轮换的每个端点密钥。

webhook-signature: v1,…

测试模式

ody_test_ 密钥的行为与实时密钥完全相同，但消息发送是模拟的 | | 不会发送任何真实的短信。将您的 CI 指向生产环境，高枕无忧。

"simulated": true

TypeScript 和 Python SDK

官方、完全类型化的客户端，内置自动分页、类型化错误、幂等发送和 Webhook 签名验证 | | 因此您无需再手动编写 HMAC。

await ody.messages.send(…)

OpenAPI 3.1

整个接口都在 /v1/api/openapi.json 中的一个机器可读规范中描述 | | 生成客户端、模拟服务器，或者直接将其提供给您的 AI 编码代理。

GET /v1/api/openapi.json

最小权限

只执行您指定操作的密钥

在 Ody 应用的“设置 → 开发者 API”下创建密钥，并将每个密钥的范围精确限定到集成所需的范围 | | 涵盖联系人、对话、消息、号码和 Webhook 的七个范围。只读仪表板密钥永远无法向客户发送短信。

ody_live_… · 范围限定密钥
✓contacts:read
✕contacts:write
✓conversations:read
✕conversations:write
✓messages:send
✓numbers:read
✕webhooks:manage

模型上下文协议

粘贴一个代码块，您的 AI 即可接听电话

相同的 API 密钥为 MCP 服务器提供支持。将此配置导入 ChatGPT、Claude 或 Cursor，并让您的助手了解未读对话、起草回复或向客户发送短信 | 每次调用都限定在密钥允许的范围内。

探索 MCP 服务器→
mcp.json
{
"mcpServers": {
"ody": {
"url": "https://api.ody.co/v1/mcp",
"headers": {
"Authorization": "Bearer ody_live_…"
}
}
}
}

开始构建

从零到第一条 SMS 只需五分钟

获取密钥，进行一次 curl 调用，即可发送短信。完整的 API 参考、Webhook 指南和 SDK 快速入门都可在帮助中心找到。

API 密钥由工作区所有者和管理员在 设置 → 开发者 API 下创建。

常见问题

开发者问题解答

API 目前能做什么？
完整的联系人 CRUD；列出和读取对话并设置其状态；发送 SMS 和 MMS；搜索您的消息历史记录；获取通话和语音邮件历史记录及转录；并列出您工作区的电话号码。完整的参考资料可在 help.ody.co 上的开发者文档中找到。

Resources

Learn more

Guides to the concepts behind this feature.

What businesses need to know about CPaaSLearn how CPaaS APIs differ from UCaaS employee calling and CCaaS contact-center suites, and where SIP and WebRTC still sit underneath.Read guide What businesses need to know about MCPHow the Model Context Protocol standardizes the connection between AI assistants and external systems, and what an MCP server for a phone system exposes.Read guide What engineers need to know about SIPHow RFC 3261 signaling (INVITE, ACK, BYE) relates to SDP, RTP media, trunks, and registration.Read guide

与您的技术栈更好地协同

API 提供完整功能。集成是无代码路径。

范围密钥、Webhooks 和 SDK 涵盖了您想构建的一切。Slack、Make 和 CSV 涵盖了大多数团队无需编写代码即可完成的工作。

Make自动化

当足够时，使用场景而非 Webhook 处理程序。

从 Ody 通话事件触发 Make 场景。当您需要幂等性、分页和自己的代码时，请使用 API。当您今天需要扇出时，请使用 Make。

场景运行
MKon-call-completed返回执行 ID
无代码扇出
查看 Make 集成→
Slack通知

无需编写 Slack 应用即可获取频道提醒。

OAuth 授权，选择频道，完成。未接来电、语音邮件和摘要会发布到那里。当您需要不同的负载时，可以使用 Webhooks 自行实现。

#front-desk
✦未接来电 · Sophie Tran一键 OAuth 授权
无需维护机器人
查看 Slack 集成→
CSV import数据导入

无需循环调用 POST /contacts 即可导入联系人。

当列表已存在于电子表格中时，上传 CSV。当真实数据源是您自己的系统时，请使用联系人 API。

导入完成
✓customers-2026.csv跳过重复项
无需开发人员
查看 CSV 导入→
Klaviyo营销

将通话事件导入 Klaviyo，无需自定义任务。

将通话结果作为 Klaviyo 事件发送以触发流程。如果您需要不同的目的地，可以在 API 上构建相同的功能。

Klaviyo 事件
STSophie Tran通话结果已跟踪
流程
查看 Klaviyo 集成→
浏览所有 43 个集成→

绝不错过任何一位客户。

携号转网，在几分钟内训练您的 AI 助理，让您的线路自动运行。或者完全关闭 AI 功能。您说了算。