البداية

يشغّل رفيق مسارات محادثة فوق واجهاتك البرمجية. يسأل المسار عمّا يحتاجه، ولا يستدعي إلا العمليات التي سمحت بها، ويسأل المستخدم قبل أن يتغيّر أي شيء.

1. احصل على حساب

سجّل من صفحة الأسعار: اختر خطة، وأنشئ حسابك ومؤسستك في خطوة واحدة، ثم أكّد الخطة، فتدخل التطبيق مباشرة.

2. اربط واجهتك البرمجية

افتح الموصّلات وأضف موصّلًا: أين تعمل واجهتك (https فقط)، وكيف تسجّل الدخول، وأي العمليات يحق للمسار استدعاؤها. لتعبئة العمليات بسرعة، الصق مستند OpenAPI 3 وحدّد ما يحق للمسارات استعماله؛ ولا يصبح شيء آخر منه عملية. أما مفتاح الواجهة فمكانه الخزنة، في الإعدادات ← المفاتيح، لا المسار.

3. ابنِ مسارًا

افتح المسارات وأنشئ مسارًا. أعطه مفتاحًا (تبدؤه التطبيقات به)، ثم ابنِ خطواته: اسأل عن قيم، استدعِ عملية، دع المستخدم يختار من قائمة، أكّد، قل شيئًا، حوّل إلى موظف، أنهِ. كل حفظ نسخة؛ انشر إحداها لتصبح فعّالة.

4. جرّبه

حادث المسار في محادثة تجريبية. يعمل عبر بيئة التشغيل الفعلية، لكن كل ما قد يغيّر البيانات تشغيل تجريبي يظهر معه الطلب الذي كان سيُرسل. واحفظ المحادثات التي تريد أن تنجح فيها كل نسخة بصفتها حالات اختبار.

5. افتحه في تطبيقك

أصدر مفتاحًا من مفاتيح المحادثة (يظهر مرة واحدة)، ثم أضف حزمة Flutter إلى تطبيقك:

AppChat.configure(AppChatOptions(
  chatKey: 'ck_…',
  apiUrl: 'https://<your chat host>',
));

FilledButton(
  onPressed: () => AppChat.open(context, flowKey: 'pizza', title: 'Order'),
  child: const Text('Order'),
);

وفي دليل حزمة Flutter كل ما عدا ذلك، ومنه المستخدم المسجّل.

بعد ذلك

• المفاهيم: المسارات والخطوات والخانات والموصّلات والنسخ والتأكيدات.
• اقرأ المحادثات الحقيقية في المحادثات، وأين يتوقف الناس في التحليلات.