بدء المكالمة (النقر للاتصال)إنهاء المكالمة نقل المكالمة كتم الصوت / تشغيله بيانات المكالمات المباشرة المسار المعتاد: النقر للاتصال من CRM

إدارة المكالمات

ابدؤوا مكالمة من برنامجكم (النقر للاتصال)، وأنهوا المكالمة الجارية أو انقلوها أو اكتموها. جميع نقاط النهاية بمفتاح API (النطاق call; Authorization: Bearer bt_… في الترويسة، انظروا أمان API) مع و GET يُستدعى بالطريقة.

حد المعدل: 10 طلبًا في الدقيقة. معرّف المكالمة (call_uuid) begin_call تعود في الرد وفي بيانات المكالمة المباشرة.

GETبدء المكالمة (النقر للاتصال)

يرنّ الرقم الداخلي المحدد أولًا؛ وعند ردّه يُتصل بالرقم المطلوب ويُوصَل الطرفان.

GET https://api.buluthat.com/api/begin_call.php?extension=1001&destination=905321234567

المعلمة	إلزامي	الوصف
`Authorization` (العنوان)	نعم	`Bearer bt_…`، النطاق `call`
`extension`	نعم	الرقم الداخلي الذي ستُوصَل إليه المكالمة (مثال: `1001`)
`destination`	نعم	الرقم المطلوب الاتصال به. لتركيا `905321234567`، للخارج `00` + رمز الدولة
`caller_id`	لا	الرقم الذي يظهر في المكالمة الخارجية؛ وإن لم يُحدَّد فالافتراضي للرقم الداخلي. رقم لا يخص حسابكم `400` يعود
`manual_answer`	لا	`true` فينتظر أن يفتحه الرقم الداخلي يدويًا؛ وإن لم يُعطَ يُجاب تلقائيًا في الأجهزة التي تدعم ذلك
`timeout`	لا	مدة الرنين، 10-60 ث (الافتراضي 30)
`announcement_to_caller`	لا	معرّف المقطع الصوتي الذي يُشغَّل للرقم الداخلي لحظة الاتصال
`announcement_to_callee`	لا	معرّف المقطع الصوتي الذي يُشغَّل للمتصَّل به لحظة الاتصال

الرد الناجح: 200 OK، وفي المحتوى معرّف المكالمة.

358c20bc-fd86-11e5-87a2-157d41a07454

أمثلة على ردود الخطأ:

400 Bad Request   extension 1005 not found
400 Bad Request   caller_id 02120000000 not allowed
401 Unauthorized  Geçersiz anahtar: K…

GETإنهاء المكالمة

GET https://api.buluthat.com/api/hangup.php?id=<call_uuid>

id تُقبل أيضًا صيغة المسار بدلًا من: /api/hangup/<call_uuid>. الرد 200 OK.

GETنقل المكالمة

ينقل المكالمة الجارية إلى رقم داخلي أو رقم خارجي.

GET https://api.buluthat.com/api/transfer.php?id=<call_uuid>&user_number=1002

المعلمة	الوصف
`id`	معرّف المكالمة
`user_number`	الرقم الداخلي المستهدف (مثال: `1002`) أو رقم خارجي (`905321234567`)

GETكتم الصوت / تشغيله

GET https://api.buluthat.com/api/mute.php?id=<call_uuid>&state=on

state: on (كتم الصوت) أو off (تشغيل الصوت).

بيانات المكالمات المباشرة

تُقرأ قائمة المكالمات الجارية (المتصل والمتصَّل به والرقم الداخلي والحالة والمدة) من نقطة نهاية جسر CRM؛ واستخدموا هذه البيانات أو Webhook لفتح بطاقة العميل عند المكالمة الواردة. وللتفاصيل اطلبوا من مركز الدعم وثيقة "جسر CRM"؛ والجسر جاهز لـ Byfix CRM.

المسار المعتاد: النقر للاتصال من CRM

1. Kullanıcı CRM'de numaraya tıklar
2. Sunucunuz begin_call'u çağırır (extension = kullanıcının dahilisi)
3. Dahili çalar, açınca müşteri aranır; call_uuid'yi kaydedin
4. Görüşme bitince CDR raporda; kayıt panelden dinlenir

→ أمان API الطوابير