环流
Ringflow REST API · v2

一个API用于调用, 短信、人工智能 — 专为现代团队打造。

Ringflow 的 REST API 使您能够以编程方式控制通信堆栈的每个部分 - 出站呼叫、批量短信、双通道录音、AI 接待员代理和实时事件 Webhooks - 所有这些都位于单个经过身份验证的端点后面。

免费永久沙箱距第一次实时通话 5 分钟服务水平协议支持的API层
服务水平协议-支持的API·企业安全·可用的 BAA·通话录音编辑·HMAC 事件签名·欧盟和美国数据驻留
API参考

你需要的一切,没有你不需要的。

六个资源组、一个基本 URL、一种身份验证方案。每个端点都有版本控制,返回一致的 JSON,并附带请求/响应示例 完整参考.

语音通话
  • 邮政/v2/通话拨打任意号码
  • 得到/v2/通话/:id获取实时状态、持续时间和录音
  • 邮政/v2/calls/:id/转账通话中热转或冷转
  • 删除/v2/通话/:id立即终止当前通话
短信和彩信
  • 邮政/v2/消息向单个收件人发送短信或彩信
  • 邮政/v2/消息/批量每个请求最多可批量处理 1000 条消息
  • 得到/v2/消息/:id轮询递送状态和承运人收据
录音
  • 邮政/v2/calls/:id/记录启动双通道通话录音
  • 删除/v2/calls/:id/记录停止录音并触发存储
  • 邮政/v2/录音/:id/转录请求异步 AI 转录
人工智能接待员
  • 邮政/v2/ai/代理配备新的人工智能接待员
  • /v2/ai/agents/:id/知识推送常见问题解答、文档和升级规则
  • 得到/v2/ai/sessions/:id/summary检索通话后 AI 摘要
活动
  • 邮政/v2/事件/订阅订阅任意平台活动
  • 得到/v2/事件/订阅列出并过滤您的订阅
  • 删除/v2/事件/订阅/:id删除事件订阅
身份验证和密钥
  • 邮政/v2/auth/令牌发行短期不记名代币
  • 邮政/v2/auth/密钥创建作用域工作区 API 密钥
  • /v2/auth/keys/:id/旋转零停机密钥轮换
客户端 SDK

您的堆栈的惯用客户端。

每个 Ringflow SDK 都是代码优先构建的,而不是根据规范生成的。重试、分页光标和 webhook 验证都是一流的,而不是事后的想法。

npm 我@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
带抖动的智能重试
基于光标的分页
内置签名验证
100% TypeScript 覆盖率
速率限制

每个级别都有可预测的限制。

限制是按工作空间而不是按 IP 强制执行的。每一个回应都承载着 X-RateLimit-剩余, X-RateLimit-重置,和一个 之后重试 标头打开 429s 这样你就可以优雅地退后。

计划持续爆破帽并发通话数
沙盒5 请求/秒15 请求/秒2 次通话
起动机40 请求/秒80 请求/秒25 通电话
商业150 请求/秒300 请求/秒150 通电话
企业风俗风俗风俗无限
为什么选择环流

建造不同。价格公道。

最多 电话 API 事后才添加人工智能。 Ringflow 从头开始​​将人工智能、语音和消息传递构建为一个统一的 API,因此您无需将三个供应商捆绑在一起。

能力环流典型替代方案
统一呼叫+短信+AI合一API
永久沙箱——无有效期、无卡
开箱即用的双通道录音
通过 REST 端点的 AI 接待员
HMAC 签名的 Webhook 交付
零停机 API 密钥轮换
提供企业安全审计+BAA

我们的承诺

按照生产标准构建的 REST API。

Ringflow 的 API 旨在处理实际生产工作负载 - 一致的 JSON 响应、强大的身份验证、明确的速率限制信号以及用于安全集成测试的永久沙箱。

JSON 响应
OAuth 2.0 身份验证
速率限制标头
幂等键
Webhook 重试
版本化端点
99 点正常运行时间
沙箱测试

深受各行业工程团队的喜爱。

从医疗保健到零售 — Ringflow 的 API 为大规模生产通信提供支持。

A

阿琼·梅塔

工程主管, Zenia Health — 孟买

Ringflow 的 API 让我们能够在两周内将语音分类嵌入到我们的患者门户中。仅 AI 接待员端点就将我们的非工作时间通话量减少了 40%。

已验证客户
R

雷切尔·托雷斯

产品副总裁, ClearLane Finance — 德克萨斯州奥斯汀

我们在一个季度内将三个联络中心供应商迁移到 Ringflow。统一的 REST 界面使我们的集成变得简单 — 一个身份验证流程、一个 Webhook 架构,一切。

已验证客户
B

本·哈格里夫斯

平台负责人, StackRoute — 伦敦

双通道录音和异步转录端点使我们无需构建自己的语音管道。 Ringflow 可以轻松处理它,并且延迟确实令人印象深刻。

已验证客户
N

纳迪亚·尤苏波娃

首席技术官, 奥比斯零售 — 迪拜

我们的 SMS 批量端点每天发送 50,000 个订单确认,没有出现任何问题。送货收据会在几秒钟内到达我们的网络挂钩 - 这正是零售运营商的要求。

已验证客户
T

汤姆·菲茨杰拉德

高级后端工程师, 劳布里奇 — 伊利诺伊州芝加哥

零停机时间的密钥轮换是我们安全团队的特色。在没有维护窗口的情况下滚动 API 密钥是我们的旧提供商根本无法做到的。

已验证客户
S

朴秀珍

解决方案架构师, Clearview SaaS — 首尔

Go SDK 很惯用,并且在每次 CI 运行时都会进行干净的编译。上下文取消、重试和速率限制回退的工作方式与您期望一流客户端的行为方式完全相同。

已验证客户

常问问题

常见问题解答

主动回答常见问题解答可以增强用户信心并减少支持请求。

登录到 Ringflow 仪表板,导航到设置 → 开发人员 → API 密钥,然后单击新建密钥。每个密钥的范围仅限于特定资源(呼叫、消息、AI 或全部),并绑定到单个工作区环境。
是的。每个 Ringflow 帐户都包含一个永久的沙盒环境。沙盒呼叫使用模拟运营商路由,因此您可以测试完整的集成 - 包括录音、AI 接待员和网络钩子 - 无需任何使用费或真正的电话线。
大多数情况下,从注册到实时通话不到 5 分钟。在仪表板中配置一个号码,复制您的 API 密钥,然后 POST 到 /v2/calls。我们的入职指南将逐步介绍它。
每个事件 POST 都包含一个 X-Ringflow-Signature-256 标头 - 原始请求正文的 HMAC-SHA256 摘要,以您的 Webhook 密钥作为密钥。 Node.js 和 Python SDK 都公开了 verifySignature() 实用程序,因此您无需自己实现它。
Ringflow 在工作区级别提供美国和欧盟数据驻留区域。商业伙伴协议适用于医疗保健用例的商业和企业计划。请联系我们的团队获取完整的安全文档包。
AI 接待员包含在商业和企业计划中。沙盒和入门帐户具有对 AI 端点的读取权限以进行集成测试,但实时 AI 呼叫处理需要有效的商业或企业订阅。

语音、短信和人工智能——午餐前全部连接完毕。

免费试用 · 无卡 · 免费携号转网 · 服务水平协议支持的正常运行时间

面向开发人员的 REST API 参考 · JSON 和 HTTPS · Ringflow