API لمركز الاتصال

بيانات مكالماتكم ورسائلكم، في أدواتكم الخاصة.

مع واجهة برمجة التطبيقات (API) لمركز الاتصال من OVOKY، تسحبون سجل المكالمات والتسجيلات ومؤشرات الأداء والتقارير إلى أداة BI أو CRM أو أنظمتكم الداخلية، وتشترون الأرقام وترسلون رسائل SMS من شيفرتكم. ولا يحمل كل مفتاح إلا نطاقات الصلاحية التي يحتاجها، ويمكن قصره على خوادمكم.

احجزوا عرضًا توضيحيًاابدؤوا الآن
نقطة نهاية REST
26
نطاق صلاحية لمفاتيح API
15
طلبًا في الدقيقة لكل مفتاح افتراضيًا
60
how it works

واجهة REST بمفاتيح محدودة الصلاحيات لقراءة مؤشرات الأداء والمكالمات والتسجيلات والتقارير، وشراء الأرقام، وإرسال SMS من أنظمتكم.

  1. التغطية

    عبر API لمركز الاتصال، اقرؤوا رصيدكم ومؤشرات الأداء والاستهلاك اليومي والمدفوعات والاشتراكات والأسعار. اعرضوا تفاعلات المكالمات وSMS، ونزّلوا تسجيلات المكالمات ورسائل البريد الصوتي، واقرؤوا أحداث التقويم، وشغّلوا التقارير الجاهزة بصيغة JSON. وابحثوا عن الأرقام المتاحة، واشتروها، وألغوها.

    • الرصيد ومؤشرات الأداء والاستهلاك والمدفوعات والاشتراكات والأسعار
    • سجل المكالمات وSMS، وتسجيلات المكالمات ورسائل البريد الصوتي
    • الأرقام: العرض، والتفاصيل، والمتاح، والشراء، والإلغاء
    • أحداث التقويم والتقارير

  2. الأمان

    أنشئوا مفتاحًا لكل تكامل، وامنحوه نطاقات الصلاحية التي يحتاجها فقط، كقراءة التقارير دون حق شراء الأرقام. حدّدوا تاريخ انتهاء، واقصروا المفتاح على قائمة من عناوين IP أو نطاقات الويب. وتُبيّن الاستجابات عدد الطلبات المتبقية لكم.

    • 15 نطاق صلاحية، من balance:read إلى numbers:purchase
    • تاريخ انتهاء لكل مفتاح
    • قوائم مسموح بها لعناوين IP ونطاقات الويب
    • حدود افتراضية: 60 في الدقيقة، و3.600 في الساعة، و50.000 في اليوم

  3. SMS

    أرسلوا إلى رقم واحد أو حتى 100 رقم في طلب واحد، وجدولوا التسليم لوقت لاحق، ومرّروا مفتاح عدم التكرار (idempotency) حتى لا يُرسَل طلب أُعيدت محاولته مرتين. اعرضوا المسارات المتاحة لكم، ثم تحقّقوا من حالة تسليم كل رسالة بمعرّفها.

    • حتى 100 مستلم في كل طلب
    • تسليم مجدول
    • مفتاح عدم التكرار لمنع الإرسال المزدوج
    • المسارات، وسجل الإرسال، وحالة التسليم

ما تتضمنه الميزة

كل ما يتعلق بـ API العامة

أمثلة برمجية

كل نقطة نهاية موثّقة بأمثلة cURL وJavaScript وPython.

مفاتيح من نوع Bearer

صادِقوا كل طلب بمفتاح API كرمز Bearer.

التقارير بصيغة JSON

شغّلوا تقريرًا جاهزًا بعوامل تصفية، واستلموا الأسطر بصيغة JSON.

التسجيلات

نزّلوا تسجيلات المكالمات وملفات البريد الصوتي لأرشيفكم الخاص.

طلب الأرقام

ابحثوا عن الأرقام المتاحة، واشتروها، وألغوها من شيفرتكم.

ترويسات حدود الطلبات

تُظهر الاستجابات الحد والمتبقي منه، مع مهلة لإعادة المحاولة عند بلوغه.

API العامة: أسئلة شائعة

إجابات قصيرة عن أكثر ما تسألنا عنه الفرق. لديكم سؤال آخر؟ تواصلوا معنا

  • لا. لا ترسل OVOKY الأحداث إلى أنظمتكم. وللبقاء على تزامن، استعلموا دوريًا من نقاط النهاية التي تحتاجونها، مثل تفاعلات المكالمات أو حالة SMS، ضمن حدود طلباتكم.

  • أنشئوا مفتاح API في إعدادات مساحة العمل، واختاروا نطاقات صلاحيته، وأرسلوه كرمز Bearer في ترويسة Authorization. ولا ينشئ المفاتيح أو يديرها إلا المستخدمون الذين يملكون صلاحية مفاتيح API.

  • افتراضيًا، يستطيع كل مفتاح إرسال 60 طلبًا في الدقيقة، و3.600 في الساعة، و50.000 في اليوم. وتتضمن الاستجابات الحد وعدد الطلبات المتبقية، ويتلقى الطلب الذي يتجاوز الحد ترويسة Retry-After.

  • ليس حاليًا. تغطي API المجالات المذكورة في هذه الصفحة: بيانات الحساب، والتفاعلات، والتسجيلات، ورسائل البريد الصوتي، والأرقام، وأحداث التقويم، والتقارير، وSMS. وتُستورد جهات الاتصال في التطبيق بملفات CSV، وتُدار الحملات فيه أيضًا.

  • يعرض التوثيق كل نقطة نهاية بأمثلة cURL وJavaScript وPython. وتعمل API مع أي لغة تستطيع إرسال طلبات HTTP وقراءة JSON.

تعمل مع

ميزات مكمّلة

اجمعوا كل محادثاتكم مع العملاء في مكان واحد

المكالمات وSMS وواتساب والبريد الإلكتروني والدردشة في صندوق وارد واحد وبفاتورة واحدة. ابدؤوا بفريق واحد، ثم توسّعوا.

احجزوا عرضًا توضيحيًااطّلعوا على الأسعارابدؤوا الآن