التدفق الحلقي
Ringflow REST API · الإصدار 2

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

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

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

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

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

المكالمات الصوتية
  • بريد/v2/callsإجراء مكالمة خارجية إلى أي رقم
  • يحصل/v2/calls/:idجلب الحالة المباشرة والمدة والتسجيل
  • بريد/v2/calls/:id/transferتحويل دافئ أو بارد في منتصف المكالمة
  • يمسح/v2/calls/:idقم بإنهاء مكالمة نشطة على الفور
الرسائل القصيرة ورسائل الوسائط المتعددة
  • بريد/v2/messagesإرسال الرسائل القصيرة أو رسائل الوسائط المتعددة إلى مستلم واحد
  • بريد/v2/messages/bulkدفعة تصل إلى 1000 رسالة لكل طلب
  • يحصل/v2/messages/:idحالة تسليم الاستطلاع واستلام الناقل
التسجيلات
  • بريد/v2/calls/:id/recordابدأ تسجيل المكالمات ثنائية القناة
  • يمسح/v2/calls/:id/recordإيقاف التسجيل وتشغيل التخزين
  • بريد/v2/recordings/:id/transcribeطلب النسخ غير المتزامن لمنظمة العفو الدولية
موظف استقبال الذكاء الاصطناعي
  • بريد/v2/ai/agentsتوفير موظف استقبال جديد يعمل بالذكاء الاصطناعي
  • يضع/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إنشاء مفتاح واجهة برمجة التطبيقات لمساحة العمل
  • يضع/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 المتبقي, X-RateLimit-إعادة تعيين، و أ إعادة المحاولة بعد رأس على 429 ثانية حتى تتمكن من التراجع بأمان.

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

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

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

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

التزامنا

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

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

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

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

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

A

أرجون ميهتا

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

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

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

راشيل توريس

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

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

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

بن هارجريفز

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

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

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

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

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

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

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

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

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

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

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

بارك سو جين

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

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

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

التعليمات

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

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

قم بتسجيل الدخول إلى لوحة معلومات Ringflow، وانتقل إلى الإعدادات → المطور → مفاتيح API، وانقر فوق مفتاح جديد. يتم تحديد نطاق كل مفتاح لموارد محددة (المكالمات أو الرسائل أو الذكاء الاصطناعي أو الكل) ويرتبط ببيئة عمل واحدة.
نعم. يتضمن كل حساب 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 بإمكانية الوصول للقراءة إلى نقاط نهاية الذكاء الاصطناعي لاختبار التكامل، ولكن التعامل مع مكالمات الذكاء الاصطناعي المباشرة يتطلب اشتراكًا نشطًا للأعمال أو المؤسسات.

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

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

مرجع REST API للمطورين · JSON وHTTPS · Ringflow