ستحتاج إلى حساب ThunderPhone.
التسجيل مجاني ويستغرق أقل من دقيقة. هل تفضّل النقر بدل استخدام curl؟
يوصلك البدء السريع من لوحة التحكم إلى المكالمة
الأولى نفسها دون كتابة أي تعليمات برمجية.
الخطوة 1: الحصول على مفتاح API
1
تسجيل الدخول
افتح app.thunderphone.com.
2
الانتقال إلى المفاتيح
انتقل إلى المؤسسة ← المفاتيح في لوحة التحكم.
3
إنشاء مفتاح
انقر على إنشاء مفتاح، وأعطه اسمًا، ثم انسخ قيمة
sk_live_.... يظهر المفتاح الخام مرة واحدة فقط — خزّنه
في مدير الأسرار لديك فورًا.sk_live_YOUR_API_KEY بالقيمة التي
نسختها للتو. يعرّف المفتاح مؤسستك تلقائيًا، لذا لا تحتاج مطلقًا إلى
وضع معرّف المؤسسة في عناوين URL.
الخطوة 2: إنشاء وكيل
يحدّد الوكيل كيفية تعامل الذكاء الاصطناعي مع المحادثات — الموجّه والصوت ومستوى المنتج والأدوات وأهلية استخدام الأداة المصغّرة.الخطوة 3: توفير رقم هاتف
يطلب هذا الاستدعاء رقمًا من مجموعة ThunderPhone التجريبية ويعيّن وكيلك الجديد كمعالج للمكالمات الواردة. (لإحضار رقمك الخاص من موفر VoIP، راجع اتصالات VoIP بدلًا من ذلك.)status="provisioning" ثم ينتقل إلى
active خلال بضع ثوانٍ؛ وبحلول وقت إغلاق متصفحك، يكون الرقم جاهزًا
لاستقبال المكالمات.
الخطوة 4 (اختيارية): إعداد خطاف ويب
للحصول على أحداث في الوقت الفعلي (توجيه المكالمات الديناميكي، والمعالجة بعد المكالمة)، أضف نقطة نهاية لخطاف ويب. اشترك فقط في الأحداث التي تحتاج إليها.secret يُستخدم لمرة واحدة — انسخه إلى مدير
الأسرار لديك. استخدم هذا السر للتحقق من ترويسة
X-ThunderPhone-Signature في الطلبات الواردة (راجع
نظرة عامة على خطافات الويب).
الخطوة 5: اختبار وكيلك
اتصل بالرقم الذي وفّرته للتو. يرد الوكيل، ويعرّف بنفسه، ويتبع موجّهك. افحص المكالمة بعد انتهائها:الخطوات التالية
إضافة أدوات الدوال
دع وكيلك يستدعي واجهات API الخاصة بك أثناء المحادثة.
إجراء مكالمات صادرة
شغّل المكالمات من التعليمات البرمجية الخاصة بك.
التعامل مع خطافات الويب
تفاعل مع أحداث المكالمات في الوقت الفعلي.
مرجع API الكامل
جميع نقاط النهاية العامة، موثقة.