Ringflow
Ringflow REST API · v2

Один API для викликів, SMS і AI — створено для сучасних команд.

REST API від Ringflow дає вам програмний контроль над кожною частиною стека зв’язку — вихідними дзвінками, масовими SMS-повідомленнями, двоканальними записами, агентами AI Receptionist та веб-перехопленнями подій у реальному часі — усе за єдиною автентифікованою кінцевою точкою.

Безкоштовна постійна пісочниця5 хвилин до першого живого дзвінкарівень API, що підтримується угодою про рівень обслуговування
API, що підтримується угодою про рівень обслуговування·Безпека підприємства·В наявності БАД·Редакція запису виклику·Підписання подій HMAC·Резиденція даних ЄС і США
Посилання на API

Все, що вам потрібно, нічого, чого вам не потрібно.

Шість груп ресурсів, одна базова URL-адреса, одна схема автентифікації. Кожна кінцева точка має версії, повертає узгоджений JSON і постачається з прикладами запитів/відповідей у повна довідка.

Голосові дзвінки
  • ПОСТ/v2/дзвінкиЗдійснюйте вихідний дзвінок на будь-який номер
  • ОТРИМАТИ/v2/calls/:idПереглядайте статус, тривалість і запис прямого ефіру
  • ПОСТ/v2/calls/:id/transferТеплий або холодний переказ під час розмови
  • ВИДАЛИТИ/v2/calls/:idНегайно завершити активний дзвінок
SMS і MMS
  • ПОСТ/v2/messagesНадсилайте SMS або MMS одному одержувачу
  • ПОСТ/v2/messages/bulkПакетуйте до 1000 повідомлень на запит
  • ОТРИМАТИ/v2/messages/:idСтатус доставки опитування та квитанція перевізника
Записи
  • ПОСТ/v2/calls/:id/recordПочніть двоканальний запис розмови
  • ВИДАЛИТИ/v2/calls/:id/recordЗупиніть запис і запустіть зберігання
  • ПОСТ/v2/recordings/:id/transcribeЗапит на асинхронну транскрипцію AI
AI Ресепшн
  • ПОСТ/v2/ai/агентиНадання нового секретаря AI
  • ПОСТАВИТИ/v2/ai/agents/:id/knowledgeПоширені запитання, документи та правила ескалації
  • ОТРИМАТИ/v2/ai/sessions/:id/summaryОтримати підсумок AI після виклику
Події
  • ПОСТ/v2/events/subscriptionsПідпишіться на будь-яку подію платформи
  • ОТРИМАТИ/v2/events/subscriptionsСписок і фільтрування ваших підписок
  • ВИДАЛИТИ/v2/events/subscriptions/:idВидалити підписку на подію
Авторизація та ключі
  • ПОСТ/v2/auth/tokensВипуск короткочасного токена на пред'явника
  • ПОСТ/v2/auth/keysСтворіть ключ API робочої області
  • ПОСТАВИТИ/v2/auth/keys/:id/rotateОбертання ключів без простоїв
Клієнтські SDK

Ідіоматичні клієнти для вашого стека.

Кожен пакет Ringflow SDK створено на основі коду, а не на основі специфікації. Повторні спроби, курсори розбиття на сторінки та перевірка вебхука — це першокласні, а не запальні думки.

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-Remaining, X-RateLimit-Reset, і a Повторити після заголовок на 429s щоб ви могли елегантно відступити.

ПланВитриманоЛопнула кришкаОдночасні дзвінки
Пісочниця5 запит/с15 запит/с2 дзвінки
Стартер40 запит/с80 запит/с25 дзвінків
Бізнес150 запитів/с300 запитів/с150 дзвінків
підприємствоCustomCustomCustomНеобмежений
Чому Ringflow

Побудований різний. Справедлива ціна.

більшість API телефонії увімкніть штучний інтелект невдовзі. Ringflow створив штучний інтелект, голос і обмін повідомленнями з нуля як єдиний узгоджений API, тож ви не склеюєте трьох постачальників разом.

МожливістьRingflowТипова альтернатива
Уніфікований виклик + SMS + AI в одному API
Постійна пісочниця — без терміну дії, без картки
Двоканальний запис із коробки
Рецепціоніст AI через кінцеву точку REST
Підписані HMAC вебхук доставки
Ротація ключів API без простоїв
Доступний аудит безпеки підприємства + BAA

Наше зобов'язання

API REST, розроблений відповідно до виробничих стандартів.

API Ringflow розроблений для обробки реальних робочих навантажень — узгоджені відповіді JSON, надійна автентифікація, чітка сигналізація про обмеження швидкості та постійна пісочниця для безпечного тестування інтеграції.

Відповіді JSON
Аутентифікація OAuth 2.0
Заголовки обмеження швидкості
Ключі ідемпотентності
Повторні спроби вебхуку
Версійні кінцеві точки
99 точок безвідмовної роботи
Тестування пісочниці

Його люблять команди інженерів у різних галузях.

Від охорони здоров’я до роздрібної торгівлі — API Ringflow забезпечує масштабне виробниче спілкування.

A

Арджун Мехта

Начальник інженерного відділу, Zenia Health — Мумбаї

API Ringflow дозволив нам за два тижні вбудувати голосове сортування в наш портал для пацієнтів. Лише кінцева точка AI Receptionist скоротила кількість дзвінків у позаробочий час на 40%.

Перевірений клієнт
R

Рейчел Торрес

Віце-президент по продукту, ClearLane Finance — Остін Техас

За один квартал ми перенесли трьох постачальників контакт-центрів на Ringflow. Уніфікована поверхня REST спростила нашу інтеграцію — один потік автентифікації, одна схема вебхука, усе.

Перевірений клієнт
B

Бен Харгрівз

Керівник платформи, StackRoute — Лондон

Двоканальний запис і кінцеві точки асинхронної транскрипції врятували нас від побудови власного каналу мовлення. Ringflow справляється з цим, а затримка справді вражає.

Перевірений клієнт
N

Надія Юсупова

технічний директор, Orbis Retail — Дубай

Наша кінцева точка масового обміну SMS надсилає 50 000 підтверджень замовлень щодня без збоїв. Квитанції про доставку потрапляють у наш веб-хук за лічені секунди — саме те, що вимагає роздрібна торгівля.

Перевірений клієнт
T

Том Фіцджеральд

Старший бекенд-інженер, Лобрідж — Чикаго Іллінойс

Ротація ключів із нульовим простоєм — це функція, яка продала нашу команду безпеки. Постійні ключі API без періоду обслуговування — це те, чого наш старий постачальник просто не міг зробити.

Перевірений клієнт
S

Парк Су Джин

Архітектор рішень, Clearview SaaS — Сеул

Go SDK є ідіоматичним і компілюється під час кожного запуску CI. Скасування контексту, повторні спроби та відмова від обмеження швидкості працюють саме так, як ви очікуєте від першокласного клієнта.

Перевірений клієнт

FAQ

Часті запитання

Завчасні відповіді на поширені запитання підвищують довіру користувачів і скорочують звернення до служби підтримки.

Увійдіть на інформаційну панель Ringflow, перейдіть до Налаштування → Розробник → Ключі API та натисніть Новий ключ. Кожна клавіша прив’язана до певних ресурсів (дзвінків, повідомлень, штучного інтелекту чи всіх інших) і прив’язана до одного робочого середовища.
так Кожен обліковий запис Ringflow містить постійне середовище Sandbox. Виклики ізольованого програмного середовища використовують імітацію маршрутизації через оператора, тож ви можете перевірити свою повну інтеграцію, включаючи записи, AI Receptionist та веб-перехоплення, без жодної плати за користування чи реальної телефонної лінії.
У більшості випадків від реєстрації до живого дзвінка менше 5 хвилин. Надайте номер на інформаційній панелі, скопіюйте свій ключ API та опублікуйте в /v2/calls. Наш посібник із адаптації крок за кроком розповідає про це.
Кожна подія POST містить заголовок X-Ringflow-Signature-256 — дайджест HMAC-SHA256 необробленого тіла запиту з вашим секретним ключем вебхука. І Node.js, і Python SDK надають утиліту verifySignature(), тому вам ніколи не доведеться впроваджувати це самостійно.
Ringflow пропонує регіони проживання даних США та ЄС на рівні робочого простору. Угоди про ділове партнерство доступні в планах Business і Enterprise для випадків використання в охороні здоров’я. Зверніться до нашої команди, щоб отримати повний пакет документів із безпеки.
Рецепціоніст зі штучним інтелектом включено в плани Business і Enterprise. Облікові записи Sandbox і Starter мають доступ на читання до кінцевих точок ШІ для тестування інтеграції, але для обробки живих викликів ШІ потрібна активна підписка Business або Enterprise.

Голосовий зв’язок, SMS і штучний інтелект — усе підключено до обіду.

Безкоштовна пробна версія · Без картки · Безкоштовне перенесення номера · Час безперебійної роботи з підтримкою угоди про рівень обслуговування

Довідник REST API для розробників · JSON і HTTPS · Ringflow