Skip to main content
يرشدك هذا الدليل عبر استدعاءات REST الأربعة اللازمة للرد على أول مكالمة هاتفية لك باستخدام وكيل ذكاء اصطناعي.
ستحتاج إلى حساب ThunderPhone. التسجيل مجاني ويستغرق أقل من دقيقة. هل تفضّل النقر بدل استخدام curl؟ يوصلك البدء السريع من لوحة التحكم إلى المكالمة الأولى نفسها دون كتابة أي تعليمات برمجية.

الخطوة 1: الحصول على مفتاح API

1

تسجيل الدخول

2

الانتقال إلى المفاتيح

انتقل إلى المؤسسة ← المفاتيح في لوحة التحكم.
3

إنشاء مفتاح

انقر على إنشاء مفتاح، وأعطه اسمًا، ثم انسخ قيمة sk_live_.... يظهر المفتاح الخام مرة واحدة فقط — خزّنه في مدير الأسرار لديك فورًا.
هل تواجه مشكلة؟ يشرح إنشاء مفتاح API للخادم هذا المسار خطوة بخطوة بالتفصيل، ويمكن للمساعد المرافق داخل التطبيق إبراز كل عنصر تحكم لك مباشرةً.
في هذا الدليل، استبدل sk_live_YOUR_API_KEY بالقيمة التي نسختها للتو. يعرّف المفتاح مؤسستك تلقائيًا، لذا لا تحتاج مطلقًا إلى وضع معرّف المؤسسة في عناوين URL.

الخطوة 2: إنشاء وكيل

يحدّد الوكيل كيفية تعامل الذكاء الاصطناعي مع المحادثات — الموجّه والصوت ومستوى المنتج والأدوات وأهلية استخدام الأداة المصغّرة.
مستويات المنتج: spark مُحسّن للتكلفة، وbolt للسرعة، و storm-base / storm-extra للذكاء في الموجّهات المعقدة. راجع الوكلاء للمقارنة الكاملة.

الخطوة 3: توفير رقم هاتف

يطلب هذا الاستدعاء رقمًا من مجموعة ThunderPhone التجريبية ويعيّن وكيلك الجديد كمعالج للمكالمات الواردة. (لإحضار رقمك الخاص من موفر VoIP، راجع اتصالات VoIP بدلًا من ذلك.)
يبدأ رقمك الجديد بالحالة status="provisioning" ثم ينتقل إلى active خلال بضع ثوانٍ؛ وبحلول وقت إغلاق متصفحك، يكون الرقم جاهزًا لاستقبال المكالمات.

الخطوة 4 (اختيارية): إعداد خطاف ويب

للحصول على أحداث في الوقت الفعلي (توجيه المكالمات الديناميكي، والمعالجة بعد المكالمة)، أضف نقطة نهاية لخطاف ويب. اشترك فقط في الأحداث التي تحتاج إليها.
تتضمن الاستجابة secret يُستخدم لمرة واحدة — انسخه إلى مدير الأسرار لديك. استخدم هذا السر للتحقق من ترويسة X-ThunderPhone-Signature في الطلبات الواردة (راجع نظرة عامة على خطافات الويب).

الخطوة 5: اختبار وكيلك

اتصل بالرقم الذي وفّرته للتو. يرد الوكيل، ويعرّف بنفسه، ويتبع موجّهك. افحص المكالمة بعد انتهائها:
تعمّق في مكالمة محددة لجلب النص المفرغ ورابط التسجيل:

الخطوات التالية

إضافة أدوات الدوال

دع وكيلك يستدعي واجهات API الخاصة بك أثناء المحادثة.

إجراء مكالمات صادرة

شغّل المكالمات من التعليمات البرمجية الخاصة بك.

التعامل مع خطافات الويب

تفاعل مع أحداث المكالمات في الوقت الفعلي.

مرجع API الكامل

جميع نقاط النهاية العامة، موثقة.