OdyOdy
Dùng thử miễn phí

API dành cho nhà phát triển

Điện thoại doanh nghiệp của bạn,
giờ đây có thể lập trình.

Mọi danh bạ, cuộc trò chuyện, tin nhắn và cuộc gọi trong không gian làm việc Ody của bạn đều nằm sau một REST API gọn gàng | cộng với một máy chủ MCP cho trợ lý AI, webhook đã ký và SDK. Một khóa, tạo trong vài phút.

Xác thực Bearer · khóa ody_live_ và ody_test_ · Cài đặt → API nhà phát triển

send-sms.sh | cuộc gọi API đầu tiên của bạn
# Gửi SMS từ số Ody của bạn
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 Created
{
"conversationId": "b4a6f0…",
"message": { "body": "Your order shipped!" },
"simulated": false
}
Idempotency-Key trên POST /messages | thử lại trong vòng 24h sẽ phát lại phản hồi đầu tiên
Phân trang con trỏ trên mọi điểm cuối danh sách | theo dõi nextCursor, không bao giờ bỏ lỡ một hàng nào
Tiêu đề RateLimit-Limit / -Remaining / -Reset tiêu chuẩn, Retry-After trên 429
Bao lỗi JSON đồng nhất với một X-Request-Id được lặp lại trên mọi phản hồi

NỀN TẢNG

Mọi thứ bạn cần để xây dựng trên Ody

Sáu phần, một khóa API. Được thiết kế để mang lại cảm giác 'nhàm chán' theo cách tốt nhất: tài nguyên có thể dự đoán, lỗi có thể dự đoán, trang có thể dự đoán.

REST API

CRUD danh bạ, cuộc trò chuyện, gửi SMS/MMS, tìm kiếm tin nhắn, lịch sử cuộc gọi và số điện thoại tại https://api.ody.co/v1/api | được xác thực Bearer bằng khóa ody_live_ của bạn.

GET /v1/api/contacts

MCP cho trợ lý AI

Kết nối ChatGPT, Claude hoặc Cursor với https://api.ody.co/v1/mcp và trợ lý của bạn có 11 công cụ | liệt kê và cập nhật danh bạ, đọc cuộc trò chuyện, tìm kiếm tin nhắn, gửi tin nhắn văn bản | được giới hạn bởi khóa của bạn.

11 tools · /v1/mcp

Webhook đã ký

Webhook gửi đi với chữ ký HMAC Standard-Webhooks | tiêu đề webhook-id, webhook-timestamp và webhook-signature | tự động thử lại và các khóa bí mật cho mỗi điểm cuối mà bạn có thể xoay vòng bất cứ lúc nào.

webhook-signature: v1,…

Chế độ thử nghiệm

Khóa ody_test_ hoạt động chính xác như khóa trực tiếp, nhưng việc gửi tin nhắn được mô phỏng | không có SMS thực sự nào được gửi đi. Hướng CI của bạn đến môi trường sản xuất và yên tâm.

"simulated": true

TypeScript & Python SDKs

Các client chính thức, được gõ đầy đủ với tính năng tự động phân trang, lỗi được gõ, gửi idempotent và xác minh chữ ký webhook được tích hợp sẵn | để bạn không bao giờ phải tự viết HMAC nữa.

await ody.messages.send(…)

OpenAPI 3.1

Toàn bộ bề mặt được mô tả trong một đặc tả có thể đọc bằng máy tại /v1/api/openapi.json | tạo client, máy chủ giả lập hoặc chỉ cần cung cấp nó cho tác nhân mã hóa AI của bạn.

GET /v1/api/openapi.json

ĐẶC QUYỀN TỐI THIỂU

Các khóa chỉ làm những gì bạn yêu cầu

Tạo khóa trong ứng dụng Ody tại Cài đặt → API nhà phát triển và giới hạn từng khóa chính xác theo các phạm vi mà một tích hợp cần | bảy phạm vi bao gồm danh bạ, cuộc trò chuyện, tin nhắn, số điện thoại và webhook. Một khóa bảng điều khiển chỉ đọc không bao giờ có thể gửi tin nhắn cho khách hàng.

ody_live_… · khóa có phạm vi
✓contacts:read
✕contacts:write
✓conversations:read
✕conversations:write
✓messages:send
✓numbers:read
✕webhooks:manage

GIAO THỨC NGỮ CẢNH MÔ HÌNH

Dán một khối, AI của bạn đã sẵn sàng nghe điện thoại

Cùng một khóa API cung cấp năng lượng cho máy chủ MCP. Đưa cấu hình này vào ChatGPT, Claude hoặc Cursor và yêu cầu trợ lý của bạn cập nhật các cuộc trò chuyện chưa đọc, soạn thảo trả lời hoặc nhắn tin cho khách hàng | mọi cuộc gọi đều được giới hạn trong những gì khóa cho phép.

Khám phá máy chủ MCP→
mcp.json
{
"mcpServers": {
"ody": {
"url": "https://api.ody.co/v1/mcp",
"headers": {
"Authorization": "Bearer ody_live_…"
}
}
}
}

BẮT ĐẦU XÂY DỰNG

Từ con số không đến SMS đầu tiên chỉ trong năm phút

Lấy một khóa, thực hiện một lệnh curl, và bạn đã gửi một tin nhắn. Tài liệu tham khảo API đầy đủ, hướng dẫn webhook và hướng dẫn bắt đầu nhanh SDK có sẵn trong trung tâm trợ giúp.

Khóa API được tạo bởi chủ sở hữu và quản trị viên không gian làm việc trong Cài đặt → API nhà phát triển.

FAQ

Giải đáp các câu hỏi của nhà phát triển

API có thể làm gì vào lúc này?
CRUD danh bạ đầy đủ; liệt kê và đọc các cuộc hội thoại cũng như đặt trạng thái của chúng; gửi SMS và MMS; tìm kiếm lịch sử tin nhắn của bạn; truy xuất lịch sử cuộc gọi và thư thoại kèm bản ghi; và liệt kê các số điện thoại của không gian làm việc của bạn. Tài liệu tham khảo đầy đủ có trong tài liệu dành cho nhà phát triển tại 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

Tốt hơn với bộ công cụ của bạn

API là bề mặt toàn diện. Tích hợp là con đường không cần mã.

Các khóa có phạm vi, webhook và SDK bao gồm mọi thứ bạn muốn xây dựng. Slack, Make và CSV bao gồm các công việc mà hầu hết các nhóm không cần phải tự viết mã.

MakeTự động hóa

Một kịch bản thay vì một trình xử lý webhook, khi điều đó là đủ.

Kích hoạt một kịch bản Make từ một sự kiện cuộc gọi Ody. Sử dụng API khi bạn cần tính bất biến, phân trang và mã của riêng bạn. Sử dụng Make khi bạn cần phân phối rộng rãi ngay lập tức.

Kịch bản đã chạy
MKon-call-completedID thực thi đã được trả về
Phân phối rộng rãi không cần mã
Xem tích hợp Make→
SlackThông báo

Cảnh báo kênh mà không cần viết ứng dụng Slack.

OAuth, chọn một kênh, hoàn tất. Các cuộc gọi nhỡ, thư thoại và tóm tắt sẽ được đăng tại đó. Tự tạo của riêng bạn bằng webhook khi bạn cần một tải trọng khác.

#front-desk
✦Cuộc gọi nhỡ · Sophie TranOAuth một lần nhấp
Không cần duy trì bot
Xem tích hợp Slack→
CSV importNhập dữ liệu

Nhập danh bạ mà không cần POST /contacts trong một vòng lặp.

Tải lên một CSV khi danh sách đã có sẵn trong bảng tính. Sử dụng API danh bạ khi nguồn dữ liệu chính là hệ thống của riêng bạn.

Nhập đã hoàn tất
✓customers-2026.csvĐã bỏ qua các mục trùng lặp
Không cần nhà phát triển
Xem nhập CSV→
KlaviyoMarketing

Đưa các sự kiện cuộc gọi vào Klaviyo, không cần công việc tùy chỉnh.

Gửi kết quả cuộc gọi dưới dạng sự kiện Klaviyo để kích hoạt các luồng. Xây dựng điều tương tự trên API nếu bạn cần một đích đến khác.

Sự kiện Klaviyo
STSophie TranKết quả cuộc gọi đã được theo dõi
Flows
Xem tích hợp Klaviyo→
Duyệt qua tất cả 43 tích hợp→

Không bao giờ bỏ lỡ một khách hàng nào nữa.

Chuyển số điện thoại của bạn, huấn luyện trợ lý của bạn trong vài phút và đặt đường dây của bạn ở chế độ tự động. Hoặc tắt hoàn toàn AI. Tùy bạn quyết định.