Ringflow
Ringflow REST API · الإصدار 2

واجهة برمجة تطبيقات واحدة للمكالمات، الرسائل القصيرة والذكاء الاصطناعي - مصممة للفرق الحديثة.

تمنحك واجهة REST API الخاصة بـ Ringflow التحكم البرمجي في كل جزء من مجموعة اتصالاتك - المكالمات الصادرة، والرسائل النصية القصيرة المجمعة، والتسجيلات ثنائية القناة، ووكلاء الاستقبال بالذكاء الاصطناعي، وخطافات الويب للأحداث في الوقت الفعلي - كل ذلك خلف نقطة نهاية واحدة معتمدة.

صندوق رمل دائم مجاني5 دقائق لأول مكالمة مباشرةطبقة API المدعومة باتفاقيات مستوى الخدمة
واجهة برمجة التطبيقات المدعومة باتفاقية مستوى الخدمة·أمن المؤسسات·بي ايه ايه متاح·تنقيح تسجيل المكالمات·توقيع حدث HMAC·إقامة البيانات في الاتحاد الأوروبي والولايات المتحدة
مرجع واجهة برمجة التطبيقات

كل ما تحتاجه، لا شيء لا تحتاجه.

ست مجموعات موارد، وعنوان URL أساسي واحد، ونظام مصادقة واحد. يتم إصدار كل نقطة نهاية، وإرجاع JSON متسق، ويتم شحنها مع أمثلة الطلب/الاستجابة في ملف مرجع كامل.

المكالمات الصوتية
  • POST/v2/calls— إجراء مكالمة خارجية إلى أي رقم
  • GET/v2/calls/:id— جلب الحالة المباشرة والمدة والتسجيل
  • POST/v2/calls/:id/transfer— تحويل دافئ أو بارد في منتصف المكالمة
  • DELETE/v2/calls/:id— قم بإنهاء مكالمة نشطة على الفور
الرسائل القصيرة ورسائل الوسائط المتعددة
  • POST/v2/messages— إرسال الرسائل القصيرة أو رسائل الوسائط المتعددة إلى مستلم واحد
  • POST/v2/messages/bulk— دفعة تصل إلى 1000 رسالة لكل طلب
  • GET/v2/messages/:id— حالة تسليم الاستطلاع واستلام الناقل
التسجيلات
  • POST/v2/calls/:id/record— ابدأ تسجيل المكالمات ثنائية القناة
  • DELETE/v2/calls/:id/record— إيقاف التسجيل وتشغيل التخزين
  • POST/v2/recordings/:id/transcribe— طلب النسخ غير المتزامن لمنظمة العفو الدولية
AI Receptionist
  • POST/v2/ai/agents— توفير موظف استقبال جديد يعمل بالذكاء الاصطناعي
  • PUT/v2/ai/agents/:id/knowledge— دفع الأسئلة الشائعة والمستندات وقواعد التصعيد
  • GET/v2/ai/sessions/:id/summary— استرداد ملخص AI بعد المكالمة
الأحداث
  • POST/v2/events/subscriptions— اشترك في أي حدث منصة
  • GET/v2/events/subscriptions— قائمة وتصفية الاشتراكات الخاصة بك
  • DELETE/v2/events/subscriptions/:id— إزالة اشتراك الحدث
المصادقة والمفاتيح
  • POST/v2/auth/tokens— إصدار رمز حامل قصير الأجل
  • POST/v2/auth/keys— إنشاء مفتاح واجهة برمجة التطبيقات لمساحة العمل
  • PUT/v2/auth/keys/:id/rotate— دوران المفتاح بدون توقف
حزم SDK الخاصة بالعميل

العملاء الاصطلاحيون لمكدسك.

يتم إنشاء كل Ringflow SDK بالكود أولاً - ولا يتم إنشاؤه من المواصفات. تعد عمليات إعادة المحاولة ومؤشرات ترقيم الصفحات والتحقق من خطاف الويب من الدرجة الأولى، وليست أفكارًا لاحقة.

npm 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
إعادة المحاولة الذكية مع عدم الاستقرار
ترقيم الصفحات على أساس المؤشر
التحقق من التوقيع المدمج
تغطية TypeScript بنسبة 100%
حدود المعدل

حدود يمكن التنبؤ بها في كل مستوى.

يتم فرض الحدود لكل مساحة عمل، وليس لكل IP. كل رد يحمل X-RateLimit-Remaining, X-RateLimit-Reset، و أ Retry-After رأس على 429 ثانية حتى تتمكن من التراجع بأمان.

يخططمستدامغطاء انفجارالمكالمات المتزامنة
رمل5 طلبات/ث15 طلب/ثانية2 مكالمات
بداية40 طلب/ثانية80 طلب/ثانية25 مكالمة
عمل150 طلب/ثانية300 طلب/ثانية150 مكالمة
مَشرُوعمخصصمخصصمخصصغير محدود
لماذا Ringflow

بنيت مختلفة. عادل الثمن.

معظم واجهات برمجة التطبيقات الهاتفية قم بتشغيل الذكاء الاصطناعي كفكرة لاحقة. قام Ringflow ببناء الذكاء الاصطناعي والصوت والمراسلة من الألف إلى الياء كواجهة برمجة تطبيقات واحدة متماسكة - بحيث لا تقوم بربط ثلاثة بائعين معًا.

القدرةRingflowبديل نموذجي
الاتصال الموحد + الرسائل القصيرة + الذكاء الاصطناعي في واجهة برمجة تطبيقات واحدة✕
وضع الحماية الدائم - لا انتهاء الصلاحية ولا توجد بطاقة✕
تسجيل ثنائي القناة خارج الصندوق✕
موظف استقبال AI عبر نقطة نهاية REST✕
عمليات تسليم الخطاف عبر الويب الموقعة من HMAC
دوران مفتاح API بدون توقف✕
يتوفر تدقيق أمان المؤسسة + BAA✕

التزامنا

واجهة برمجة تطبيقات REST مصممة وفقًا لمعايير الإنتاج.

تم تصميم واجهة API الخاصة بـ Ringflow للتعامل مع أعباء عمل الإنتاج الحقيقية - استجابات JSON المتسقة، والمصادقة القوية، وإشارات حدود المعدل الواضحة، ووضع الحماية الدائم لاختبار التكامل الآمن.

ردود JSON
أووث 2.0 مصادقة
رؤوس حدود المعدل
مفاتيح العجز
تتم إعادة محاولة الرد التلقائي على الويب
نقاط النهاية التي تم إصدارها
وقت تشغيل 99 نقطة
اختبار وضع الحماية

محبوب من قبل الفرق الهندسية عبر الصناعات.

من الرعاية الصحية إلى البيع بالتجزئة - تعمل واجهة API الخاصة بـ Ringflow على تشغيل اتصالات الإنتاج على نطاق واسع.

A

أرجون ميهتا

رئيس الهندسة, زينيا هيلث - مومباي

“تتيح لنا واجهة برمجة التطبيقات الخاصة بـ Ringflow تضمين الفرز الصوتي في بوابة المرضى الخاصة بنا خلال أسبوعين. لقد خفضت نقطة نهاية موظف الاستقبال العاملة بالذكاء الاصطناعي وحدها حجم مكالماتنا بعد ساعات العمل بنسبة 40%.”

عميل تم التحقق منه
R

راشيل توريس

نائب الرئيس للمنتج, كليرلين فاينانس - أوستن تكساس

“لقد قمنا بترحيل ثلاثة من موردي مراكز الاتصال إلى Ringflow في ربع واحد. لقد جعل سطح REST الموحد عملية التكامل لدينا واضحة ومباشرة - تدفق مصادقة واحد، ومخطط خطاف ويب واحد، وكل شيء.”

عميل تم التحقق منه
B

بن هارجريفز

قائد المنصة, ستاك روت - لندن

“لقد أنقذتنا نقاط نهاية التسجيل ثنائي القناة والنسخ غير المتزامن من بناء مسار الكلام الخاص بنا. يتعامل Ringflow مع الأمر فحسب، ويكون زمن الوصول مثيرًا للإعجاب حقًا.”

عميل تم التحقق منه
N

نادية يوسوبوفا

مدير التكنولوجيا, أوربيس للبيع بالتجزئة - دبي

“ترسل نقطة نهاية الرسائل النصية القصيرة الخاصة بنا 50000 تأكيدًا للطلب يوميًا دون أي عوائق. تصل إيصالات التسليم إلى خطاف الويب الخاص بنا في غضون ثوانٍ، وهو بالضبط ما تطلبه عمليات البيع بالتجزئة.”

عميل تم التحقق منه
T

توم فيتزجيرالد

مهندس الواجهة الخلفية الأول, لوبريدج — شيكاغو إلينوي

“كان تدوير المفاتيح بدون توقف عن العمل هو الميزة التي شجعت فريق الأمان لدينا. يعد تشغيل مفاتيح واجهة برمجة التطبيقات (API) بدون نافذة صيانة أمرًا لا يستطيع مزود الخدمة القديم لدينا القيام به.”

عميل تم التحقق منه
S

بارك سو جين

مهندس الحلول, كليرفيو SaaS - سيول

“يعد Go SDK اصطلاحيًا ويتم تجميعه بشكل نظيف عند كل تشغيل CI. يعمل إلغاء السياق، وإعادة المحاولة، والتراجع عن الحد الأقصى للسعر تمامًا بالطريقة التي تتوقع أن يتصرف بها عميل من الدرجة الأولى.”

عميل تم التحقق منه

التعليمات

الأسئلة المتداولة

تعمل الإجابة بشكل استباقي على الأسئلة الشائعة على تعزيز ثقة المستخدم وتقليل تكاليف الدعم.

قم بتسجيل الدخول إلى لوحة معلومات Ringflow، وانتقل إلى الإعدادات → المطور → مفاتيح واجهة برمجة التطبيقات (API Keys)، وانقر فوق مفتاح جديد. يتم تحديد نطاق كل مفتاح لموارد محددة (المكالمات أو الرسائل أو الذكاء الاصطناعي أو الكل) ويرتبط ببيئة عمل واحدة.
نعم. يتضمن كل حساب Ringflow بيئة Sandbox دائمة. تستخدم مكالمات Sandbox توجيهًا محاكيًا لمشغل شبكة الجوّال، حتى تتمكن من اختبار التكامل الكامل - بما في ذلك التسجيلات وموظف الاستقبال AI وخطافات الويب - دون أي رسوم استخدام أو خط هاتف حقيقي.
أقل من 5 دقائق من التسجيل وحتى المكالمة المباشرة في معظم الحالات. قم بتوفير رقم في لوحة المعلومات، وانسخ مفتاح API الخاص بك، ثم قم بالنشر إلى /v2/calls. يشرح دليل الإعداد الخاص بنا ذلك خطوة بخطوة.
يتضمن كل حدث POST رأس X-Ringflow-Signature-256 — ملخص HMAC-SHA256 لنص الطلب الأولي المرتبط بسر خطاف الويب الخاص بك. تعرض كل من Node.js وPython SDK الأداة المساعدة VereSignature() لذا لن تضطر أبدًا إلى تنفيذ ذلك بنفسك.
يوفر Ringflow مناطق إقامة البيانات في الولايات المتحدة والاتحاد الأوروبي على مستوى مساحة العمل. تتوفر اتفاقيات شركاء الأعمال في خطط الأعمال والمؤسسات لحالات استخدام الرعاية الصحية. اتصل بفريقنا للحصول على حزمة الوثائق الأمنية الكاملة.
يتم تضمين AI Receptionist في خطط الأعمال والمؤسسات. تتمتع حسابات Sandbox وStarter بإمكانية الوصول للقراءة إلى نقاط نهاية الذكاء الاصطناعي لاختبار التكامل، ولكن التعامل مع مكالمات الذكاء الاصطناعي المباشرة يتطلب اشتراكًا نشطًا للأعمال أو المؤسسات.

الصوت، والرسائل النصية القصيرة، والذكاء الاصطناعي - كلها متصلة بالأسلاك قبل الغداء.

تجربة مجانية · لا توجد بطاقة · نقل مجاني للأرقام · مدة تشغيل مدعومة باتفاقية مستوى الخدمة