الرد ببيانات حية من أنظمتك الخاصة
يتيح استدعاء الأدوات للروبوت الاتصال بواجهة API الخاصة بك في منتصف المحادثة، وقراءة ما يعود، واستخدامه في رده. يسأل العميل عن طلبه، فيعطي الروبوت الإجابة الحقيقية بدلاً من إجابة عامة.
التدريب يعلم الروبوت أشياء ثابتة. أما استدعاء الأدوات فيغطي ما يتغير كل دقيقة: حالة طلب، رقم تتبع، حجز. هذه ميزة متقدمة وتحتاج إلى كود مخصص على خادمك، لذا خطط لها مع من يدير أنظمتك.
خطوة بخطوة
حدد مكان البحث
يُستخدم استدعاء الأدوات في الأسئلة والأجوبة وفي التدفقات. ضعه في سؤال وجواب عندما تحتاج إجابة حية لسؤال واحد، وفي تدفق عندما يكون البحث خطوة في مسار محادثة أطول.
وجّهه إلى نقطة النهاية الخاصة بك
في عنوان URL، أدخل عنوان نقطة نهاية API التي ستستجيب للطلب. في الرؤوس (Headers)، أضف أي أزواج مفتاح:قيمة تحتاجها نقطة النهاية. في الأسئلة والأجوبة، تكون الرؤوس مفصولة بفواصل؛ وفي التدفقات تضيفها واحداً تلو الآخر.
حدد ما يجب أن يقدمه العميل
الخصائص (Properties) هي القيم التي يجب على الروبوت جمعها قبل أن يتمكن من الاتصال بك، مثل المدينة أو رقم التتبع. إذا كانت القيم المحتملة معروفة مسبقاً، اذكرها تحت القيم المسموح بها (Allowed values) ليبقى الروبوت ضمن تلك المجموعة.
اقرأ الطلب على خادمك
نرسل إلى خادمك هذا الشكل: {"sb":{"user_id":"123","conversation_id":"123","user_language":"es"},"arguments":{}} — كجسم JSON لطلبات POST، وكعنوان لطلبات GET. كل مفتاح وسيطة هو اسم الخاصية بصيغة kebab case، لذا فإن "رقم الطلب" يصل كـ order-number. يمكنك أيضاً وضع قيمة مباشرة في عنوان URL باستخدام حقل دمج، مثلاً {order-number}.
أعد JSON يمكن للروبوت استخدامه
يجب أن يرد خادمك بـ JSON يحتوي على القيم التي تريد أن ينطق بها البوت، على سبيل المثال {"order_status":"تم التوصيل منذ ساعتين و25 دقيقة","success":true}. أضف "success": true فقط عندما ينجح الطلب فعلياً.
مرجع الإعدادات
| الإعداد | ما يفعله |
|---|---|
| URL | عنوان نقطة نهاية API التي يتصل بها chatbot. |
| Headers | أزواج المفتاح:القيمة المرسلة مع الطلب، مفصولة بفواصل في الأسئلة والأجوبة وتُضاف واحدة تلو الأخرى في التدفقات. |
| Properties | القيم التي يجب على المستخدم توفيرها قبل إجراء المكالمة، مثل المدينة أو رقم التتبع. |
| Allowed values | يقيد الخاصية بمجموعة معروفة من الخيارات بدلاً من النص الحر. |
معلومات مفيدة
"success": true هو وعد وليس مجرد إجراء شكلي
أعده فقط عندما يعمل الطلب حقاً. إذا كان رقم الطلب غير صالح أو لم يتم العثور على شيء، فاتركه حتى لا يعرض البوت الفشل كإجابة.
أسماء الوسائط تتغير شكلها
تصل أسماء الخصائص بصيغة kebab case، لذا "Order Number" تصبح order-number. طابق هذا التهجئة في الكود الخاص بك وفي أي حقل دمج تضعه في URL.
GET و POST تستقبل البيانات بشكل مختلف
بالنسبة لـ POST، تصل الحمولة كجسم JSON. بالنسبة لـ GET، تصل كرأس. تحقق من الطريقة التي تستخدمها نقطة النهاية الخاصة بك قبل البدء في قراءة الطلب.
تحصل على سياق مع كل استدعاء
يحتوي الطلب على user_id وconversation_id وuser_language، بحيث يعرف نقطة النهاية الخاصة بك من يرسل الاستعلام وبأي لغة.
هذا يحتاج إلى مطور.
استدعاء الأدوات هي ميزة متقدمة. الجانب الخاص بلوحة التحكم قصير، ولكن يجب أن يكون هناك شيء على خادمك يستقبل الطلب ويعيد JSON.
أسئلة شائعة
أين يمكنني استخدام استدعاء الأدوات؟
ما الذي ترسله بالضبط إلى خادمي؟
كيف يمكنني إدخال قيمة العميل في عنوان URL الخاص بي؟
ماذا يجب أن يرسل خادمي مرة أخرى؟
ماذا يحدث إذا أعطى العميل رقمًا غير موجود؟
هل يمكنني تقييد ما يُسمح للعميل بإدخاله؟
هل أنت مستعد لإنهاء الفوضى؟
وحّد رسائلك، وأتمتة الأسئلة المتكررة، وحوّل المحادثات إلى إيرادات — ابدأ اليوم.
ابدأ الآن