واجهة برمجة تطبيقات Teloz REST

قم ببناء الصوت في أي شيء باستخدام تيلوز API

ابدأ المكالمات، واستقبل خطافات الويب، ودفق النصوص، وقم بتضمين برنامج اتصال كامل الميزات - كل ذلك من خلال واجهة REST API النظيفة المزودة بأدوات تطوير البرامج (SDK) لكل لغة رئيسية.

واجهة برمجة تطبيقات RESTخطافات الويبمواصفات OpenAPIأدوات تطوير البرامج (SDKs).وقت تشغيل بنسبة 99.99%
200 OK - المكالمة في قائمة الانتظار
تم تضمين مواصفات OpenAPI 3.0
teloz-api.js
// Initiate an outbound call
 
const response = await teloz.calls.create({
to: "+12025550123",
from: "+18005550199",
record: true,
webhook: "https://your-app.com/events"
});
 
// Response
// {
// sid: "CA3f9a…"
// status: "queued"
// duration: null
// }
بالأرقام

مصممة للإنتاج من اليوم الأول

Teloz API هي نفس البنية التحتية التي تعمل على تشغيل الآلاف من الولايات المتحدة أنظمة الهاتف التجارية كل يوم.

99.99%
وقت تشغيل واجهة برمجة التطبيقات (API) لاتفاقية مستوى الخدمة (SLA).
موثوقية على مستوى المؤسسات
<100 مللي ثانية
متوسط ​​زمن الاستجابة
في جميع مناطق الولايات المتحدة
50+
نقاط النهاية REST
المكالمات وجهات الاتصال والأرقام والمزيد
4 أدوات تطوير البرمجيات
مكتبات اللغات الرسمية
العقدة، بايثون، PHP، الذهاب
نقاط النهاية

ست مجموعات موارد، وأكثر من 50 نقطة نهاية

كل ما تحتاجه لإنشاء ميزات الصوت والرسائل النصية القصيرة ومركز الاتصال في منتجك.

نشر · الحصول على · حذف

المكالمات

يمكنك بدء المكالمات الصادرة واسترداد سجلات المكالمات والوصول إلى التسجيلات وبث النصوص في الوقت الفعلي.

بريد/v1/calls
يحصل/v1/calls/:sid
يحصل/v1/calls/:sid/recording
يمسح/v1/calls/:sid
نشر · الحصول على · وضع · حذف

اتصالات

إنشاء وقراءة وتحديث وحذف جهات الاتصال. قم بالمزامنة مع نظام إدارة علاقات العملاء (CRM) الخاص بك أو أنشئ دليل الهاتف الخاص بك.

بريد/v1/contacts
يحصل/v1/contacts
يضع/v1/contacts/:id
يمسح/v1/contacts/:id
نشر · الحصول على · حذف

أرقام

ابحث عن الأرقام المتاحة، وقم بتوفير أرقام DID المحلية أو المجانية، وإدارة تكوين الأرقام.

يحصل/v1/numbers/available
بريد/v1/numbers
يحصل/v1/numbers/:id
يمسح/v1/numbers/:id
نشر · الحصول على · حذف

خطافات الويب

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

بريد/v1/webhooks
يحصل/v1/webhooks
يضع/v1/webhooks/:id
يمسح/v1/webhooks/:id
يحصل

التحليلات

سحب حجم المكالمات ومدتها والتصرف فيها وإحصائيات قائمة الانتظار للوحات المعلومات والتقارير الخاصة بك.

يحصل/v1/analytics/calls
يحصل/v1/analytics/queues
يحصل/v1/analytics/agents
يحصل/v1/analytics/summary
جافا سكريبت SDK

المسجل المضمنة

قم بإسقاط أداة النقر للاتصال كاملة الميزات في أي تطبيق ويب باستخدام بضعة أسطر من JavaScript.

teloz.dialer.init(config)
teloz.dialer.call(number)
teloz.dialer.on('event', fn)
teloz.dialer.destroy()
أمثلة على الكود

الاندماج في اللغة التي تختارها

حزم SDK الرسمية لـ Node.js وPython وPHP وGo - أو اتصل بـ واجهة برمجة تطبيقات REST مباشرة من أي لغة.

بدء مكالمة
import Teloz from "@teloz/node";
 
const client = new Teloz(process.env.TELOZ_API_KEY);
 
const call = await client.calls.create({
to: "+12025550123",
from: "+18005550199",
record: true,
transcribe: true,
webhook: "https://your-app.com/events",
});
 
console.log(call.sid); // CA3f9a7b…
خطافات الويب

الرد على كل حدث مكالمة في في الوقت الحالى

قم بتسجيل عنوان URL للخطاف على الويب وسيقوم Teloz بنشر حمولة JSON موقعة إلى نقطة النهاية الخاصة بك لحظة وقوع حدث ما - لا يلزم إجراء استقصاء. ادمج خطافات الويب مع خطافتنا التكامل لأتمتة سير العمل الخاص بك من البداية إلى النهاية.

توقيع HMAC-SHA256 على كل حمولة
إعادة المحاولة التلقائية مع التراجع الأسي
سجلات التسليم والإعادة في لوحة القيادة
يمكن تصفيته حسب نوع الحدث لكل نقطة نهاية
حدثفئة
call.initiatedيتم التشغيل عند وضع مكالمة صادرة في قائمة الانتظار
المكالمات
call.ringingالهاتف الوجهة يرن
المكالمات
call.answeredتم التقاط المكالمة — تتضمن البيانات التعريفية للمتصل
المكالمات
call.completedانتهت المكالمة — تتضمن المدة والتصرف
المكالمات
call.missedالمكالمة الواردة لم يتم الرد عليها
المكالمات
recording.readyعنوان URL لملف التسجيل متاح للتنزيل
تسجيل
transcript.readyتم إرفاق نص النص الكامل وتسميات المتحدثين
منظمة العفو الدولية
voicemail.newتم استلام بريد صوتي جديد مع عنوان URL الصوتي
البريد الصوتي
sms.inboundالرسائل القصيرة الواردة المستلمة على رقم محدد
رسالة قصيرة
الأسئلة الشائعة حول واجهة برمجة التطبيقات

الإجابات القصيرة.

الأسئلة الشائعة قبل البدء في البناء.

قم بالتسجيل للحصول على حساب Teloz وانتقل إلى الإعدادات → المطور → مفاتيح واجهة برمجة التطبيقات. يمكنك إنشاء مفاتيح متعددة بأذونات محددة (للقراءة فقط، للمكالمات فقط، للمسؤول) وإبطالها في أي وقت.

نعم. تتوفر مواصفات OpenAPI 3.0 الكاملة على api.teloz.com/openapi.json ويمكن استيرادها مباشرة إلى Postman أو Insomnia أو أي عميل متوافق. يتم الاحتفاظ بها متزامنة مع كل إصدار.

تستخدم واجهة برمجة التطبيقات (API) مصادقة الرمز المميز لحاملها. قم بتمرير مفتاح API الخاص بك في رأس التفويض باسم "Bearer YOUR_API_KEY". بالنسبة للاستخدام من خادم إلى خادم، نوصي بمفاتيح محددة النطاق؛ بالنسبة لبرامج الاتصال المضمنة في المتصفح، استخدم رموز OAuth قصيرة العمر.

نعم — الحد الافتراضي هو 100 طلب في الثانية لكل مفتاح API. يُسمح بدفعات تصل إلى 500 طلب/ثانية لمدة تصل إلى 10 ثوانٍ. يمكن أن تطلب خطط المؤسسات حدودًا أعلى. يتم إرجاع رؤوس حد المعدل (X-RateLimit-Remaining، وX-RateLimit-Reset) في كل استجابة.

يتضمن كل منشور webhook POST رأس X-Teloz-Signature يحتوي على تجزئة HMAC-SHA256 لنص الطلب الأولي الموقّع بسر خطاف الويب الخاص بك. قم بحساب نفس التجزئة من جانبك وقارنها - ارفض الطلبات غير المتطابقة.

نعم. استخدم عنوان URL الأساسي https://api.sandbox.teloz.com مع مفتاح API الاختباري الخاص بك. لا يتم أبدًا توصيل المكالمات التي يتم إجراؤها في وضع الحماية بشبكة PSTN - فهي تحاكي دورة حياة الحدث الكاملة بما في ذلك التسجيلات والنصوص.

ابدأ البناء باستخدام Teloz API. صندوق رمل مجاني متضمن.

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

مواصفات OpenAPI الكاملة4 SDKs الرسميةبيئة رملدعم المطورين في الولايات المتحدة