Dòng chảy vòng
API REST của luồng vòng · v2

Một API cho các cuộc gọi, SMS và trí tuệ nhân tạo — được xây dựng cho các đội hiện đại.

API REST của Ringflow cung cấp cho bạn quyền kiểm soát theo chương trình đối với mọi phần trong ngăn xếp liên lạc của bạn — cuộc gọi đi, SMS hàng loạt, bản ghi kênh đôi, nhân viên Lễ tân AI và webhook sự kiện theo thời gian thực — tất cả đều đằng sau một điểm cuối được xác thực duy nhất.

Hộp cát vĩnh viễn miễn phí5 phút cho cuộc gọi trực tiếp đầu tiênLớp API được hỗ trợ theo thỏa thuận cấp độ dịch vụ
API được hỗ trợ theo thỏa thuận cấp độ dịch vụ·Bảo mật doanh nghiệp·BAA có sẵn·Biên tập ghi âm cuộc gọi·Ký sự kiện HMAC·Nơi lưu trú dữ liệu của EU và Hoa Kỳ
Tham chiếu API

Tất cả mọi thứ bạn cần, không có gì bạn không.

Sáu nhóm tài nguyên, một URL cơ sở, một sơ đồ xác thực. Mọi điểm cuối đều được lập phiên bản, trả về JSON nhất quán và gửi kèm các ví dụ về yêu cầu/phản hồi trong tài liệu tham khảo đầy đủ.

Cuộc gọi thoại
  • BƯU KIỆN/v2/cuộc gọiThực hiện cuộc gọi đi đến bất kỳ số nào
  • LẤY/v2/cuộc gọi/:idTìm nạp trạng thái trực tiếp, thời lượng và ghi âm
  • BƯU KIỆN/v2/calls/:id/transferChuyển ấm hoặc lạnh giữa cuộc gọi
  • XÓA BỎ/v2/cuộc gọi/:idChấm dứt cuộc gọi đang hoạt động ngay lập tức
SMS & MMS
  • BƯU KIỆN/v2/tin nhắnGửi SMS hoặc MMS tới một người nhận
  • BƯU KIỆN/v2/tin nhắn/số lượng lớnHàng loạt lên tới 1 000 tin nhắn cho mỗi yêu cầu
  • LẤY/v2/tin nhắn/:idTrạng thái phân phối cuộc thăm dò và biên nhận của nhà cung cấp dịch vụ
Bản ghi âm
  • BƯU KIỆN/v2/calls/:id/recordBắt đầu ghi âm cuộc gọi kênh đôi
  • XÓA BỎ/v2/calls/:id/recordDừng ghi và kích hoạt lưu trữ
  • BƯU KIỆN/v2/recordings/:id/transcribeYêu cầu phiên âm AI không đồng bộ
Nhân viên lễ tân AI
  • BƯU KIỆN/v2/ai/đại lýCung cấp Nhân viên tiếp tân AI mới
  • ĐẶT/v2/ai/đại lý/:id/kiến thứcĐẩy Câu hỏi thường gặp, tài liệu và quy tắc báo cáo
  • LẤY/v2/ai/sessions/:id/tóm tắtTruy xuất bản tóm tắt AI sau cuộc gọi
Sự kiện
  • BƯU KIỆN/v2/sự kiện/đăng kýĐăng ký bất kỳ sự kiện nền tảng nào
  • LẤY/v2/sự kiện/đăng kýLiệt kê và lọc đăng ký của bạn
  • XÓA BỎ/v2/sự kiện/đăng ký/:idXóa đăng ký sự kiện
Xác thực & Khóa
  • BƯU KIỆN/v2/auth/mã thông báoPhát hành mã thông báo mang thời gian tồn tại ngắn
  • BƯU KIỆN/v2/auth/keyTạo khóa API không gian làm việc có phạm vi
  • ĐẶT/v2/auth/keys/:id/rotateXoay phím không có thời gian chết
SDK khách hàng

Khách hàng thành ngữ cho ngăn xếp của bạn.

Mọi SDK Ringflow đều được xây dựng theo mã đầu tiên — không được tạo từ thông số kỹ thuật. Thử lại, con trỏ phân trang và xác minh webhook là ưu tiên hàng đầu chứ không phải là suy nghĩ lại.

npm tôi @ringflow/sdk
import { Ringflow } from "@ringflow/sdk"

const client = new Ringflow({
  apiKey: process.env.RINGFLOW_API_KEY,
  region: "us-east-1",
})

// Place a call and stream status updates
const call = await client.calls.create({
  to:        "+14155550199",
  from:      "+19172544289",
  recordDualChannel: true,
  onStatus: (evt) => console.log(evt.status),
})

console.log(call.id)   // call_rfw_2Kj8mNpQ
Thử lại thông minh với jitter
Phân trang dựa trên con trỏ
Xác minh chữ ký tích hợp
Mức độ bao phủ 100% TypeScript
Giới hạn tỷ lệ

Giới hạn có thể dự đoán được ở mọi cấp độ.

Các giới hạn được thực thi trên mỗi không gian làm việc, không phải trên mỗi IP. Mọi phản hồi đều mang theo Giới hạn tỷ lệ X còn lại, X-RateLimit-Reset, và một Thử lại sau tiêu đề trên 429 giây để bạn có thể lùi lại một cách duyên dáng.

Kế hoạchduy trìnắp nổCuộc gọi đồng thời
Hộp cát5 yêu cầu/giây15 yêu cầu/giây2 cuộc gọi
người mới bắt đầu40 yêu cầu/giây80 yêu cầu/giây25 cuộc gọi
Việc kinh doanh150 yêu cầu/giây300 yêu cầu/giây150 cuộc gọi
Doanh nghiệpPhong tụcPhong tụcPhong tụcKhông giới hạn
Tại sao có dòng chảy vòng

Được xây dựng khác nhau. Giá cả hợp lý.

Hầu hết API điện thoại hãy nghĩ đến việc bật AI lên. Ringflow đã xây dựng AI, giọng nói và nhắn tin ngay từ đầu dưới dạng một API mạch lạc duy nhất — vì vậy, bạn không cần kết nối ba nhà cung cấp lại với nhau.

Khả năngDòng chảy vòngThay thế điển hình
Cuộc gọi hợp nhất + SMS + AI trong một API
Hộp cát vĩnh viễn - không hết hạn, không có thẻ
Ghi kênh đôi ngay lập tức
Nhân viên lễ tân AI thông qua điểm cuối REST
Giao hàng webhook có chữ ký của HMAC
Xoay khóa API không có thời gian ngừng hoạt động
Kiểm toán bảo mật doanh nghiệp + BAA có sẵn

Cam kết của chúng tôi

API REST được xây dựng theo tiêu chuẩn sản xuất.

API của Ringflow được thiết kế để xử lý khối lượng công việc sản xuất thực tế — phản hồi JSON nhất quán, xác thực mạnh mẽ, báo hiệu giới hạn tốc độ rõ ràng và hộp cát vĩnh viễn để thử nghiệm tích hợp an toàn.

Phản hồi JSON
Xác thực OAuth 2.0
Tiêu đề giới hạn tỷ lệ
Chìa khóa bình đẳng
Thử lại webhook
Điểm cuối được phiên bản
Thời gian hoạt động 99 điểm
Thử nghiệm hộp cát

Được yêu thích bởi các nhóm kỹ thuật trong các ngành công nghiệp.

Từ chăm sóc sức khỏe đến bán lẻ — API của Ringflow hỗ trợ hoạt động truyền thông sản xuất trên quy mô lớn.

A

Arjun Mehta

Trưởng phòng Kỹ thuật, Zenia Health — Mumbai

API của Ringflow cho phép chúng tôi nhúng phân loại giọng nói vào cổng thông tin bệnh nhân của mình sau hai tuần. Chỉ riêng điểm cuối của Nhân viên lễ tân AI đã cắt giảm 40% số lượng cuộc gọi ngoài giờ của chúng tôi.

Khách hàng đã được xác minh
R

Rachel Torres

Phó chủ tịch sản phẩm, Tài chính ClearLane — Austin TX

Chúng tôi đã di chuyển ba nhà cung cấp trung tâm liên lạc sang Ringflow trong một quý. Bề mặt REST hợp nhất giúp quá trình tích hợp của chúng tôi trở nên đơn giản — một luồng xác thực, một lược đồ webhook, mọi thứ.

Khách hàng đã được xác minh
B

Ben Hargreaves

Trưởng nhóm nền tảng, StackRoute — Luân Đôn

Điểm cuối ghi kênh đôi và phiên âm không đồng bộ đã giúp chúng tôi không phải xây dựng đường dẫn giọng nói của riêng mình. Ringflow chỉ xử lý nó và độ trễ thực sự ấn tượng.

Khách hàng đã được xác minh
N

Nadia Yusupova

CTO, Bán lẻ Orbis – Dubai

Điểm cuối hàng loạt SMS của chúng tôi gửi 50.000 xác nhận đơn hàng hàng ngày mà không gặp trục trặc. Biên lai giao hàng sẽ đến webhook của chúng tôi trong vòng vài giây — chính xác là những gì hoạt động bán lẻ yêu cầu.

Khách hàng đã được xác minh
T

Tom Fitzgerald

Kỹ sư phụ trợ cao cấp, Lawbridge — Chicago IL

Xoay vòng khóa mà không có thời gian ngừng hoạt động là tính năng đã thu hút được sự chú ý của nhóm bảo mật của chúng tôi. Việc cuộn các khóa API mà không có thời gian bảo trì là điều mà nhà cung cấp cũ của chúng tôi không thể làm được.

Khách hàng đã được xác minh
S

Park Soo Jin

Kiến trúc sư giải pháp, Clearview SaaS — Seoul

SDK Go rất đơn giản và biên dịch rõ ràng trên mỗi lần chạy CI. Việc hủy bối cảnh, thử lại và lùi giới hạn tốc độ hoạt động chính xác theo cách bạn mong đợi ở một khách hàng hạng nhất sẽ hành xử.

Khách hàng đã được xác minh

Câu hỏi thường gặp

Câu hỏi thường gặp

Việc chủ động trả lời các câu hỏi thường gặp giúp tăng cường sự tự tin của người dùng và giảm bớt yêu cầu hỗ trợ.

Đăng nhập vào bảng điều khiển Ringflow của bạn, điều hướng đến Cài đặt → Nhà phát triển → Khóa API và nhấp vào Khóa mới. Mỗi khóa được xác định phạm vi cho các tài nguyên cụ thể (cuộc gọi, tin nhắn, AI hoặc tất cả) và gắn với một môi trường không gian làm việc duy nhất.
Đúng. Mọi tài khoản Ringflow đều bao gồm môi trường Sandbox vĩnh viễn. Cuộc gọi hộp cát sử dụng định tuyến nhà cung cấp dịch vụ mô phỏng nên bạn có thể kiểm tra khả năng tích hợp đầy đủ của mình — bao gồm các bản ghi âm, Nhân viên lễ tân AI và webhooks — mà không phải trả bất kỳ khoản phí sử dụng hoặc đường dây điện thoại thực nào.
Dưới 5 phút từ khi đăng ký đến khi có cuộc gọi trực tiếp trong hầu hết các trường hợp. Cung cấp một số trong trang tổng quan, sao chép khóa API của bạn và POST tới /v2/calls. Hướng dẫn giới thiệu của chúng tôi sẽ hướng dẫn từng bước.
Mỗi sự kiện POST bao gồm tiêu đề X-Ringflow-Signature-256 — bản tóm tắt HMAC-SHA256 của nội dung yêu cầu thô được khóa bằng bí mật webhook của bạn. Cả SDK Node.js và Python đều hiển thị tiện ích verifySignature() nên bạn không bao giờ phải tự mình triển khai tiện ích này.
Ringflow cung cấp các vùng lưu trữ dữ liệu của Hoa Kỳ và EU ở cấp độ không gian làm việc. Thỏa thuận liên kết kinh doanh có sẵn trên các gói Doanh nghiệp và Doanh nghiệp dành cho các trường hợp sử dụng dịch vụ chăm sóc sức khỏe. Hãy liên hệ với nhóm của chúng tôi để có gói tài liệu bảo mật đầy đủ.
Nhân viên lễ tân AI được bao gồm trong các gói Kinh doanh và Doanh nghiệp. Tài khoản Sandbox và Starter có quyền truy cập đọc vào điểm cuối AI để thử nghiệm tích hợp, nhưng việc xử lý cuộc gọi AI trực tiếp yêu cầu đăng ký Doanh nghiệp hoặc Doanh nghiệp đang hoạt động.

Giọng nói, SMS và AI - tất cả đều được kết nối trước bữa trưa.

Dùng thử miễn phí · Không cần thẻ · Chuyển số miễn phí · Thời gian hoạt động được hỗ trợ theo thỏa thuận cấp độ dịch vụ

Tài liệu tham khảo API REST dành cho nhà phát triển · JSON & HTTPS · Ringflow