انتقل إلى المحتوى الرئيسي

التكامل مع OpenAPI في SmartFlow

المقدمة​

يسمح SmartFlow بتكامل واجهات برمجة التطبيقات الخارجية عبر معيار OpenAPI. توفر لك هذه الميزة مرونة هائلة لربط سير العمل الخاص بك بخدمات الطرف الثالث، وأتمتة المهام المعقدة، وإثراء عملياتك التجارية.

لماذا تستخدم OpenAPI في SmartFlow؟​

  • التشغيل البيني: ربط SmartFlow بأي نظام متوافق مع OpenAPI.
  • الأتمتة المتقدمة: إجراء مكالمات API لإرسال أو استرجاع البيانات في الوقت الحقيقي.
  • توفير الوقت: استيراد مجموعات OpenAPI لاستخدام نقاط النهاية المحددة مسبقًا دون تكوين معقد.

لقطة شاشة: [قم بتضمين لقطة شاشة تُظهر الواجهة لاستيراد مجموعة OpenAPI من صفحة إعدادات chatbot.]

إضافة تكامل OpenAPI​

1. استيراد مجموعة OpenAPI​

  1. الوصول إلى صفحة إعدادات الدردشة: انتقل إلى علامة التبويب "الإعدادات" للدردشة المعنية.
  2. استيراد ملف أو التكوين من الواجهة: انقر على "إضافة مجموعة OpenAPI" واختر ملف JSON أو YAML، أو قم بتكوين النقاط النهائية مباشرة من الواجهة.
  3. التحقق: يتم فرز النقاط النهائية تلقائيًا حسب المجموعة والتحقق منها.
  4. حفظ: بمجرد التحقق، تصبح النقاط النهائية متاحة كإجراءات من نوع "API" في SmartFlow.

لقطة شاشة: [عرض واجهة التكوين في صفحة إعدادات الدردشة.]

2. استخدام إجراءات API في SmartFlow​

  1. إضافة إجراء: في سير العمل الخاص بك في SmartFlow، انتقل إلى علامة التبويب "الإجراءات" واختر "API".
  2. اختيار نقطة النهاية: يتم فرز نقاط النهاية حسب المجموعة ومتاحة لجميع أنواع SmartFlows.
  3. تحديد المعلمات: قم بتكوين الحقول المطلوبة للاتصال (الرؤوس، الجسم، إلخ).
  4. الملاحظة الافتراضية: بشكل افتراضي، تعيد كل إجراء API نتيجة الاتصال كملاحظة في وضع "أداة المحادثة"، مما يسمح للذكاء الاصطناعي باتخاذ القرار التالي تلقائيًا.

لقطة شاشة: [إدراج لقطة شاشة تظهر نقطة نهاية مستخدمة كإجراء API في SmartFlow.]

مثال الاستخدام​

السيناريو: المزامنة مع CRM خارجي​

  1. الهدف: تحديث معلومات العملاء في CRM الخاص بك عند تقديم نموذج.
  2. سير العمل:
    • الحدث: يقوم المستخدم بملء نموذج عبر SmartForm.
    • إجراء API: إرسال بيانات النموذج إلى API الخاص بـ CRM.
    • الملاحظة: يتم إرجاع نتيجة الاتصال تلقائيًا كملاحظة في وضع "أداة المحادثة".
  3. الفوائد: توفير الوقت وتقليل الأخطاء اليدوية.

لقطة شاشة: [عرض سير عمل كامل مع اتصال API مرتبط بـ CRM.]

السيناريو: استرجاع بيانات المستخدم​

  1. الهدف: تخصيص استجابة chatbot بناءً على بيانات المستخدم.
  2. سير العمل:
    • الحدث: طلب من المستخدم في chatbot.
    • إجراء API: استعلام عن API خارجي للحصول على معلومات المستخدم.
    • الملاحظة: استخدام البيانات المسترجعة كملاحظة لتحديد الاستجابة التالية لـ chatbot.

لقطة شاشة: [توضيح تفاعل بين chatbot و API خارجي.]

أفضل الممارسات​

  • استيراد المجموعات الموثوقة: تأكد من أن ملفات OpenAPI الخاصة بك تتوافق مع المعايير لتجنب أخطاء الاستيراد.
  • اختبر بانتظام: تحقق من مكالمات API الخاصة بك للتأكد من أنها تعمل كما هو مقصود.
  • وثق تكاملاتك: أضف أوصافًا واضحة لكل نقطة نهاية لتسهيل إدارتها.

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