للمطورين

كل ما تفعله لوحة التحكم يستطيع كودكم أن يفعله أيضًا

‏API عام بمصادقة بمفتاح، وwebhooks موقّعة عند انتهاء المكالمة، وكتابة النشاط إلى الـCRM، وخادم MCP يتيح بناء مساحة العمل كاملة من Claude أو ChatGPT.

باختصار

هل يوجد API للمساعد الهاتفي؟

نعم. يوجد REST API عام تجري مصادقته بمفتاح يُرسَل في ترويسة Authorization، ويستطيع إدراج مكالمة صادرة في الطابور، وقراءة المحادثات والنصوص المفرَّغة، وإدارة المساعدين ومسارات المكالمة وقاعدة المعرفة. وعند انتهاء المكالمة يُسلَّم webhook موقّع بـHMAC إلى endpoint تحددونه، فلا تحتاجون إلى الاستقصاء الدوري أبدًا. وإذا كنتم تعملون بـSalesforce أو HubSpot، يستطيع النظام كتابة المكالمة كنشاط مكتمل مرتبط بالعميل المحتمل أو جهة الاتصال. وكل ذلك متاح أيضًا عبر خادم MCP بعيد، يتيح لعميل نموذج لغوي بناء مساحة العمل وتشغيلها دون أن تكتبوا أي كود. أما المرجع الكامل، حقلًا حقلًا ومسارًا مسارًا، فيوجد في توثيق OpenAPI المرتبط من هذه الصفحة.

المرجع الحي

يُولَّد المرجع من الكود نفسه، فهو مطابق دائمًا لما يعمل فعليًا. وأي مسار أو حقل أو رمز خطأ ترونه هناك هو ما يعيده الخادم.

افتحوا مرجع الـAPI

https://server.daber.ai/v1/docs

الـREST API العام

مصادقة بمفتاح في كل طلب، وصيغة snake_case على السلك، ونطاقات صلاحيات لكل مسار — كل مفتاح يحمل مجموعة scopes محددة، والمفتاح الذي ينقصه الـscope المناسب لا يصل إلى المسار ببساطة. ويُعرَض المفتاح مرة واحدة عند إنشائه؛ ولا يُحفَظ لدينا سوى تجزئته.

إدراج مكالمة صادرة في الطابور، مع ربطها اختياريًا بحملة كي تنعكس النتيجة في مؤشرات أدائها
قراءة المحادثات: البيانات الوصفية، والنص المفرَّغ، والملخص، والانطباع، وسبب التحويل إلى موظف
إدارة المساعدين ومسارات المكالمة، بما في ذلك توليد مسار من مستند سيناريو قائم
الكتابة إلى قاعدة المعرفة — المدخلات المنشأة عبر الـAPI تصل كمسودات، وموافقة لوحة التحكم هي ما يجعلها قابلة للاسترجاع
كل تغيير في مساعد أو مسار يحصل على نسخة خاصة به، حتى ما وصل عبر الـAPI — ويمكن التراجع إلى الوراء

إدراج مكالمة صادرة في الطابور

الطلب الأدنى: معرّف المساعد ورقم للاتصال به. تدخل المكالمة الطابور وتسير في مسار الاتصال نفسه الذي تستخدمه الحملات، فلا يوجد مسار كود ثانٍ يتصرف على نحو مختلف.

curl -X POST https://server.daber.ai/v1/calls \
  -H "Authorization: Bearer dbr_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "3f9c1a52-7b41-4f0e-9c8d-2a5b6e7d8f10",
    "phone": "+972501234567"
  }'

يعيد الرد معرّف طلب المكالمة. أما النتيجة — أُجيبت أم لم تُجَب، وما قيل وما لُخِّص — فتصل عبر webhook الإتمام، لا في الرد على هذا الطلب.

‏Webhooks عند الإتمام

بدل استقصاء الـAPI حتى تنتهي المكالمة، تسجّلون endpoint فيصلكم الحدث. ويحمل كل طلب توقيع HMAC-SHA256 على الطابع الزمني وجسم الرسالة — والتحقق منه لديكم هو الفرق بين endpoint وendpoint يستطيع أي أحد تغذيته.

أحداث دورة حياة مكالمة طُلبت عبر الـAPI: أُدرجت في الطابور، اكتملت، أخفقت
حدث اكتمال محادثة لكل محادثة صوتية منتهية، لا للمكالمات المطلوبة عبر الـAPI وحدها
يُرسَل التوقيع في ترويسة مخصصة ويتضمن طابعًا زمنيًا، فتستطيعون رفض إعادة إرسال قديمة
يمكن كشف السر وتدويره من الإعدادات، ويحتفظ سجل التسليم بالمحاولات الأخيرة لكل endpoint

إلى أين تذهب المكالمة بعد انتهائها

المكالمة المنتهية سجل في نظامين على الأقل — نظامنا ونظامكم. وهاتان طريقتان لسد تلك الفجوة دون كتابة مزامنة يدوية.

كتابة النشاط إلى الـCRM

إذا لم تظهر المكالمة في الـCRM، فهي بالنسبة إلى المندوب لم تحدث. وعند الإتمام يستطيع النظام إنشاء نشاط مكتمل في Salesforce أو HubSpot، مرتبط بالعميل المحتمل أو جهة الاتصال الصحيحة ومسنَد إلى مالكه، ويحمل الملخص والنتيجة. وفشل الكتابة إلى الـCRM لا يُسقِط المكالمة نفسها أبدًا — بل يُسجَّل ويُعرَض، وتبقى المحادثة سليمة لدينا.

خادم MCP بعيد

الـAPI نفسه، معروضًا كخادم MCP — فتستطيعون ربط مساحة العمل بعميل نموذج لغوي مثل Claude أو ChatGPT وبناءها بالحوار: تحويل مستند سيناريو إلى مسار مكالمة، وإنشاء مساعد، وربط المسار والنماذج به، وإضافة مدخلات إلى قاعدة المعرفة، وإجراء مكالمة اختبار. والمصادقة بمفتاح الـAPI نفسه، والأدوات المعروضة للعميل هي فقط ما تسمح به scopes ذلك المفتاح — فلا يحصل عميل النموذج اللغوي على أكثر مما يحصل عليه المفتاح الذي بيده.

قبل الانتقال إلى الإنتاج

المفتاح الحي سر كأي سر آخر: يُعرَض مرة واحدة، ولا يُرسَل أبدًا من متصفح
هناك حد لمعدل الطلبات لكل مفتاح، ورصد فيضان اتصالات قد يعلّق مفتاحًا تلقائيًا — والتعليق قابل للإلغاء من الإعدادات
التحقق من توقيع الـwebhook لديكم إلزامي لا اختياري
يُكتَب الملخص والانطباع بعد انتهاء المكالمة لا لحظة إغلاق الخط — ولذلك يصلان عبر الـwebhook لا في الرد على طلب الاتصال

اتصل بالمساعد الصوتي الآن

مكالمة حقيقية بالعبرية. هذا بالضبط ما سيسمعه المتصلون بك.

اطلب أن يتصل بك المساعد

اترك رقمك — سيتصل بك المساعد خلال أقل من دقيقة.