استخدام عقدة API في منشئ روبوت المحادثة

يمكنك استخدام Call API لاستدعاء API من روبوت المحادثة نفسه. كما يمكنك استخدام استجابة API في تدفق روبوت المحادثة.

إعداد عقدة API

• API - يمكنك تحديد تفاصيل API أو إعدادها من قسم API
• انقر على "Show Editor" لتحديث إعدادات API
• إذا كنت تستخدم حمولة JSON، يمكنك كتابة {{ لعرض قائمة ببدائل المتغيرات المتاحة
• سيكون بإمكانك الوصول إلى نص آخر رسالة في المحادثة والبيانات التي جُمعت عبر روبوت المحادثة
• هل تريد تخزين الاستجابة في متغير؟ - أدخل اسم متغير لتخزين استجابة API فيه
• مسار JSON للقيمة المراد تخزينها؟ - أدخل مسار JSON لاستخراج قيمة محددة من استجابة JSON وتخزينها في المتغير

1. يمكن الوصول إلى استجابة API باستخدام المفتاح response.data
2. لذا، إذا كانت استجابة API هي { "value": "this is the response" }
3. فيجب أن يكون مسار JSONPath هو response.data.value

إعداد مخرجات API

ستؤدي API إما إلى success (2xx response) أو failure (non 2xx response). يمكنك ربط الخيارات بالعقد اللاحقة حسب الحاجة.

دليل إعداد عقدة API

فيما يلي دليل خطوة بخطوة لإنشاء روبوت محادثة جديد باستخدام Call API Node

إنشاء عقدة API في روبوت المحادثة

1. أنشئ روبوت محادثة باستخدام Message Node, Question Node، واحفظ رد الروبوت باستخدام Upsert Node ، ثم اربطها ضمن تدفق
2. اسحب عقدة Call API وأفلتها إلى يمين عقدة السؤال
3. عدّل عقدة Call Api
4. انقر على Show Editor بجانب واجهة API المحددة
5. أجرِ التغييرات اللازمة، مثل إدخال عنوان URL لواجهة API واختيار طريقة HTTP
6. اختر form url encoded أو form multipart من نوع محتوى الطلب
7. انقر على Add Another ضمن قسم key value
8. سيُنشأ إدخال جديد. أدخل اسم المفتاح، مثل text، ضمن حقل المفتاح، ثم اختر متغير الاستعلام ضمن حقل القيمة
9. انقر على Save API لإغلاق المحرر
10. ضمن Store response in variable ، أضف اسم متغير مثل api_response
11. ضمن JSON path of value to store ، أضف مسار JSON لاختيار قيمة محددة من استجابة API وحفظها
12. 1. يمكن الوصول إلى استجابة API باستخدام المفتاح response.data
    2. لذا، إذا كانت استجابة API هي { "value": "this is the response" }
    3. فيجب أن يكون مسار JSONPath هو response.data.value
12. انقر على Save لإغلاق محرر عقدة API

أضف Message Node لاستجابة API

1. اسحب عقدة رسالة وأفلتها إلى يمين عقدة API
2. اربط خيار Success في عقدة API بعقدة الرسالة الجديدة
3. عدّل عقدة الرسالة
4. اكتب رسالة لعقدة الرسالة. إذا أردت الوصول إلى البيانات التي أعادتها عقدة API، فاكتب @ وابدأ بالكتابة لعرض قائمة بالمتغيرات المتاحة. اختر المتغير api\_response
5. انقر على Save في عقدة الرسالة. بعد ذلك، انقر على Save في الزاوية العلوية اليمنى لحفظ روبوت المحادثة.

سيطرح روبوت المحادثة هذا سؤالًا على المستخدم، ثم يرسل رد المستخدم إلى واجهة API التي أعددتها. إذا تلقيت استجابة من واجهة API، فسيُرسل الرد إلى المستخدم.