وكلاء همسة الصوتيون · واجهة برمجة التطبيقات (API)

واجهة برمجة التطبيقات (API) للوكلاء الصوتيين الأذكياء عبر الهاتف

استفد من جميع إمكانات لوحة تحكم وكلاء همسة الصوتيين مباشرةً عبر واجهة برمجة التطبيقات (API). أنشئ الوكلاء الصوتيين وأدِر إعداداتهم، واربط أرقام الهواتف، وابدأ المكالمات، وأطلق حملات الاتصال الصادرة، واستعرض سجلات المحادثات ونصوصها بالكامل من خادمك. كما تتيح لك إشعارات Webhook تلقّي أحداث المكالمات تلقائيًا وفور وقوعها، لتتمكّن من متابعة التفاعلات وأتمتة سير العمل والتكامل مع أنظمتك المؤسسية بسهولة.

  • إنشاء الوكلاء الصوتيين وإدارتهم عبر واجهة REST API
  • إدارة أرقام الهواتف والمكالمات وحملات الاتصال
  • استعراض المحادثات ونصوصها الكاملة
  • دعم 5 أنواع من أحداث Webhook
  • تكامل الأدوات وقواعد المعرفة وإدارة بيانات الاعتماد السرّية

الإمكانات

إدارة الوكلاء الصوتيين عبر الهاتف وبرمجتهم من البداية إلى النهاية

01

إنشاء الوكلاء الصوتيين وإدارتهم عبر واجهة برمجة التطبيقات (API)

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

02

إدارة أرقام الهواتف وربطها بالوكلاء الصوتيين

أدِر أرقام الهواتف بالكامل عبر واجهة REST API، بدءًا من تسجيل الأرقام واستعراضها، وصولًا إلى ربط كل رقم بوكيل صوتي محدّد أو إلغاء ارتباطه به، وحذف الأرقام التي لم تعد بحاجة إليها. تتيح لك هذه الإمكانات إدارة دورة حياة أرقام الهواتف برمجيًا، وتحديث إعدادات الاتصال بسهولة دون الحاجة إلى استخدام لوحة التحكم.

03

إجراء المكالمات الصادرة وإدارة حملات الاتصال برمجيًا

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

04

استعراض المحادثات وإدارة المكالمات عبر واجهة برمجة التطبيقات (API)

استعرض سجلات المحادثات واسترجع تفاصيل أي محادثة، بما في ذلك نصوصها الكاملة، أو أنهِ مكالمة جارية مباشرةً عبر واجهة برمجة التطبيقات (API). وتتيح لك نقاط النهاية الوصول إلى البيانات نفسها المتاحة في سجل المكالمات بلوحة تحكم همسة، ما يسهّل متابعة تفاعلات العملاء وتحليل المحادثات وإدارة المكالمات برمجيًا من أنظمتك الخاصة.

05

متابعة أحداث المكالمات لحظة بلحظة عبر Webhook

تلقَّ إشعارات فورية عبر Webhook باستخدام بروتوكول HTTPS لمتابعة أحداث المكالمات في الوقت الفعلي، بما في ذلك بدء المكالمة (call.started)، والرد عليها (call.answered)، وتحديث نص المحادثة (transcription.update)، وتنفيذ الأدوات (tool.executed)، وانتهاء المكالمة (call.ended). تتيح هذه الإشعارات لأنظمتك متابعة سير المكالمات تلقائيًا، والاستجابة للأحداث فور وقوعها، وتحديث البيانات وسير العمل دون الحاجة إلى الاستعلام المستمر عن حالة المكالمات.

06

إدارة متكاملة لإعدادات الوكلاء الصوتيين وتكاملاتهم

أدِر جميع المكوّنات الداعمة لوكلائك الصوتيين عبر واجهة برمجة التطبيقات (API)، بما في ذلك قواعد المعرفة، وأدوات التكامل عبر HTTP وMCP، وقواميس النطق المخصّصة، وبيانات الاعتماد السرّية المشفّرة. وتوفّر همسة نقاط نهاية مخصّصة لكل مكوّن، ما يتيح لك إعداد الوكلاء وتحديث إمكاناتهم وإدارة تكاملاتهم برمجيًا من خادمك، دون الحاجة إلى إجراء التعديلات يدويًا عبر لوحة التحكم.

خطوات التكامل

من إنشاء مفتاح API إلى إجراء مكالمة هاتفية مباشرة

تعرّف على خطوات التكامل مع الوكلاء الصوتيين عبر الهاتف، بدءًا من إعداد واجهة برمجة التطبيقات (API) وإنشاء الوكيل وربط رقم الهاتف، وصولًا إلى إجراء المكالمات ومتابعة أحداثها في الوقت الفعلي.

  1. 01

    أنشئ مفتاحًا سريًا

    أنشئ مفتاحًا سريًا من لوحة تحكم همسة واحفظه على خادمك، ثم أرفقه مع كل طلب عبر ترويسة Authorization بالصيغة Token <key>.

  2. 02

    أنشئ وكيلًا صوتيًا أو اختر وكيلًا موجودًا

    أنشئ وكيلًا صوتيًا جديدًا عبر نقاط النهاية من الإصدار v2، أو صمّمه بصريًا من خلال لوحة التحكم واسترجع تفاصيله باستخدام معرّفه الفريد. ويمكنك أيضًا ربط الوكيل بالأدوات وقواعد المعرفة وبيانات الاعتماد السرّية عبر واجهة برمجة التطبيقات (API).

  3. 03

    اربط رقم هاتف بالوكيل

    سجّل رقم الهاتف عبر واجهة برمجة التطبيقات (API)، ثم اربطه بالوكيل الصوتي المطلوب. وبمجرد اكتمال الربط، يصبح الوكيل جاهزًا لاستقبال المكالمات الواردة إلى الرقم والتعامل معها تلقائيًا وفق إعداداته ومسارات المحادثة المحدّدة.

  4. 04

    ابدأ المكالمات الصادرة

    أجرِ مكالمة هاتفية فردية عبر نقطة النهاية المخصّصة للاتصال، أو أنشئ حملة اتصالات صادرة تتضمّن قائمة بالمستلمين. ويمكنك إدارة الحملة وجدولة اتصالاتها وفق احتياجاتك، مع إمكانية إيقافها مؤقتًا أو استئنافها أو إلغائها.

  5. 05

    تابع المكالمات وحلّل نتائجها

    استقبل إشعارات Webhook لمتابعة أحداث المكالمات لحظة بلحظة. وبعد انتهاء كل مكالمة، يمكنك استرجاع سجل المحادثة ونصّها الكامل عبر نقاط النهاية المخصّصة، والاستفادة من واجهات التحليلات لمتابعة مؤشرات الأداء ومستويات رضا العملاء وتقييم نتائج التفاعلات الصوتية.

المرجع

مرجع سريع لواجهة برمجة التطبيقات (API) للوكلاء الصوتيين عبر الهاتف

يرتبط كل قسم بصفحته في التوثيق الرسمي لواجهة برمجة التطبيقات (API)، حيث يمكنك الاطّلاع على التفاصيل التقنية الكاملة، وبنية الطلبات والاستجابات، وأمثلة شيفرة جاهزة للتنفيذ، لتسهيل التكامل مع الوكلاء الصوتيين عبر الهاتف من همسة.

المجالالتفاصيل
إدارة الوكلاء الصوتيينأنشئ وكلاء صوتيين جدد، واستعرض قائمة الوكلاء المتاحين، واسترجع تفاصيل كل وكيل باستخدام معرّفه الفريد، وحدّث إعداداته وخصائصه عبر واجهة برمجة التطبيقات (API).
إدارة أرقام الهواتفسجّل أرقام الهواتف واستعرض الأرقام المتاحة، واربطها بالوكلاء الصوتيين أو ألغِ ارتباطها بهم، مع إمكانية حذف الأرقام التي لم تعد بحاجة إليها عبر واجهة برمجة التطبيقات (API).
إجراء المكالمات الصادرةابدأ مكالمة هاتفية صادرة باستخدام أحد أرقامك المسجّلة، عبر نقطة النهاية المخصّصة لإجراء المكالمات في واجهة برمجة التطبيقات (API).
إدارة حملات الاتصال الصادرةأنشئ حملات اتصال تستهدف قوائم محدّدة من المستلمين، وأدِرها عبر واجهة برمجة التطبيقات (API)، مع إمكانية إيقاف الحملات مؤقتًا واستئنافها أو إلغائها، وإعادة محاولة الاتصال بالمستلمين عند الحاجة.
إدارة المحادثات والمكالماتاستعرض سجلات المكالمات، واسترجع تفاصيل أي محادثة ونصّها الكامل، أو أنهِ مكالمة جارية مباشرةً عبر واجهة برمجة التطبيقات (API).
إشعارات Webhookاستقبل إشعارات فورية عبر بروتوكول HTTPS لمتابعة خمسة أنواع من أحداث المكالمات: بدء المكالمة (call.started)، والرد عليها (call.answered)، وتحديث نص المحادثة (transcription.update)، وتنفيذ الأدوات (tool.executed)، وانتهاء المكالمة (call.ended)، ما يتيح لأنظمتك متابعة التفاعلات والاستجابة لها في الوقت الفعلي.
إعداد الوكلاء وتكاملاتهمأدِر قواعد المعرفة، وأدوات التكامل عبر HTTP وMCP، وقواميس النطق المخصّصة، وبيانات الاعتماد السرّية المشفّرة الخاصة بالمشروع، عبر نقاط النهاية المخصّصة لكل مكوّن في واجهة برمجة التطبيقات (API).
التحليلات والتقاريراستعرض مؤشرات الأداء العامة للوكلاء الصوتيين، وحلّل كفاءة المكالمات ومستويات رضا العملاء عبر واجهة برمجة التطبيقات (API)، مع إمكانية تصدير بيانات المحادثات وسجلات المكالمات لدعم إعداد التقارير وتحليل النتائج وتحسين الأداء.
المصادقةمفتاح سري في ترويسة Authorization مع كل طلب، بالصيغة Token <key>.

حالات الاستخدام

كيف تستفيد الفرق من واجهة برمجة التطبيقات (API) للوكلاء الصوتيين؟

01

أتمتة المكالمات من داخل تطبيقك

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

02

تحديث نظام إدارة علاقات العملاء تلقائيًا

اربط إشعارات Webhook بنظام إدارة علاقات العملاء (CRM) لتحديث سجلات العملاء ونتائج التفاعلات تلقائيًا فور انتهاء كل مكالمة عبر الحدث call.ended، دون الحاجة إلى الاستعلام الدوري عن حالة المكالمات أو إدخال البيانات يدويًا.

03

إدارة حملات الاتصال الصادرة من خادمك

أنشئ قوائم المستلمين مباشرةً من بيانات أنظمتك، وأطلق حملات الاتصال الصادرة عبر واجهة برمجة التطبيقات (API). وتابع نتائج المكالمات لإدارة الحملات بمرونة، مع إمكانية إيقافها مؤقتًا أو استئنافها أو إعادة محاولة الاتصال بالمستلمين وفقًا لنتائج التفاعلات.

04

مراقبة جودة المكالمات وإعداد التقارير

صدّر سجلات المحادثات ونصوصها، واسترجع بيانات التحليلات دوريًا عبر واجهة برمجة التطبيقات (API)، لدمج مؤشرات جودة المكالمات وأداء الوكلاء الصوتيين في لوحات المعلومات وأنظمة التقارير التي يستخدمها فريقك، بما يسهّل متابعة الأداء وتحديد فرص التحسين.

الأسئلة الشائعة

الأسئلة الشائعة حول واجهة برمجة التطبيقات (API) للوكلاء الصوتيين عبر الهاتف

هل يمكنني إنشاء الوكلاء الصوتيين وإدارتهم بالكامل عبر واجهة برمجة التطبيقات (API)؟

+

تتيح لك نقاط النهاية من الإصدار v2 إنشاء الوكلاء الصوتيين واستعراضهم واسترجاع تفاصيلهم وتحديث إعداداتهم برمجيًا. وعمليًا، تفضّل معظم الفرق تصميم مسارات المحادثة، خاصةً للوكلاء المعتمدين على مسارات محدّدة، من خلال لوحة تحكم همسة، ثم استخدام واجهة برمجة التطبيقات (API) لإدارة الوكلاء وإصداراتهم وتشغيلهم من الخادم.

كيف يمكن لنظامي بدء مكالمة هاتفية عبر واجهة برمجة التطبيقات (API)؟

+

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

كيف تصل نتائج المكالمات وبياناتها إلى أنظمتي؟

+

توفّر همسة ثلاث طرق للوصول إلى بيانات المكالمات ونتائجها، بحسب مستوى التحديث المطلوب. تتيح إشعارات Webhook متابعة الأحداث لحظة بلحظة، بما في ذلك بدء المكالمة (call.started)، والرد عليها (call.answered)، وتحديث نص المحادثة (transcription.update)، وتنفيذ الأدوات (tool.executed)، وانتهاء المكالمة (call.ended). وبعد انتهاء المكالمة، يمكنك استرجاع سجل المحادثة وتفاصيلها الكاملة عبر نقاط النهاية المخصّصة للمحادثات. كما تتيح لك واجهات التحليلات تجميع نتائج المكالمات ومؤشرات أدائها وتصديرها، لدعم إعداد التقارير ومتابعة الأداء على مستوى جميع المكالمات.

هل يمكنني إدارة قواعد المعرفة والأدوات وإعدادات الوكيل عبر واجهة برمجة التطبيقات (API)؟

+

نعم. توفّر همسة نقاط نهاية مخصّصة لإدارة قواعد المعرفة، وأدوات التكامل عبر HTTP وMCP، وقواميس النطق المخصّصة، وبيانات الاعتماد السرّية المشفّرة الخاصة بالمشروع. ويتيح لك ذلك إعداد الوكلاء الصوتيين وإدارة تكاملاتهم وتحديث مكوّناتهم برمجيًا ضمن عمليات النشر الآلية الخاصة بك، دون الحاجة إلى إجراء التعديلات يدويًا عبر لوحة التحكم.

كيف تتم المصادقة على طلبات واجهة برمجة التطبيقات (API)؟

+

تتم المصادقة باستخدام مفتاح سري تُنشئه من لوحة تحكم همسة، ثم تُرفقه مع كل طلب عبر ترويسة Authorization بالصيغة Token <key>. ولا يُعرض المفتاح إلا مرة واحدة، ويُرفض إن أُرسل من متصفح، فاحفظه على خادمك. ولبدء المكالمات من صفحة ويب أو تطبيق، استخدم بدلًا منه مفتاحًا عامًا مع حزمة الويب: فهو لا يفعل سوى بدء المكالمات.

تابع القراءة

منظومة الشركاء

شراكات موثوقة
ضمن منظومة التقنية

تتعاون همسة مع كبرى شركات التقنية، وشركات تكامل الأنظمة، ومزوّدي الحلول، لتقديم حلول الذكاء الاصطناعي الصوتي للمؤسسات على نطاق واسع في مختلف أنحاء المنطقة.