أدلة المطوّرين
Kavchat هو دردشة لدعم العملاء تجيب وفق سيناريوهات تكتبونها أنتم. لا يستخدم نموذجًا لغويًا: يعمل السيناريو الذي نشرتموه على جهاز المستخدم، لذا تكون الإجابات سريعة ومتوقعة، وتستمر في العمل حتى دون اتصال بالشبكة. هنا تجدون شرحًا لكيفية ترابط المكوّنات ومن أين تبدؤون.
كيف يعمل Kavchat
- لوحة التحكم. تسجّلون أنتم وفريقكم الدخول إلى app.kavchat.com. لكل مساحة عمل مفتاح عام (
pk_live_...) ومفتاح سري (sk_live_...)، وكلاهما يظهر في صفحة التثبيت. - السيناريوهات. تبنون في المحرّر المرئي سيناريوهات مكوّنة من خطوات. تحتوي كل خطوة على رسالة وأزرار وكلمات مفتاحية. ينقلكم الزر إلى خطوة أخرى أو سيناريو آخر أو رابط أو شاشة في تطبيقكم أو نموذج تذكرة دعم.
- النشر. تُحفظ كل عملية نشر كإصدار مرقّم. تحدّدون من يرى البوت: لا أحد، أو مستخدمو الاختبار فقط (حسب رقم الهاتف)، أو الجميع. يمكنكم استعادة إصدار سابق في أي وقت، دون تحديث التطبيق.
- أداة الدردشة أو حزمة تطوير البرمجيات. يحمّل الموقع أداة الدردشة باستخدام المفتاح العام، ويستخدم التطبيق إحدى حزم تطوير البرمجيات للأجهزة المحمولة. تنزّل هذه الأدوات الإصدار المنشور وتحفظه على الجهاز وتدير المحادثة عليه.
- رمز الهوية (اختياري). عندما يكون المستخدم مسجّل الدخول، يوقّع خادمكم رمز JWT قصيرًا باستخدام المفتاح السري. بهذه الطريقة، يربط Kavchat معرّف المستخدم لديكم بالمحادثة وتذكرة الدعم، ويمكنه إظهار البوت المخصّص لمستخدمي الاختبار فقط للأشخاص المعنيين.
- تذاكر الدعم وwebhook. عندما لا يحلّ السيناريو المشكلة، ينشئ نموذج تذكرة الدعم تذكرةً تتضمّن المحادثة كاملة. تصل التذكرة إلى صندوق تذاكر الدعم في لوحة التحكم، وفي خطة Premium تُرسَل أيضًا إلى نظامكم عبر webhook موقّع. ويمكن لخادمكم أيضًا قراءة تذاكر الدعم وإغلاقها عبر API الخادم.
مفتاحان، لكلٍّ منهما مكانه
| المفتاح | أين يُستخدم | الغرض منه |
|---|---|---|
المفتاح العام pk_live_... | في صفحات الموقع والتطبيقات. يمكن إظهاره علنًا. | تحميل البوت، والإبلاغ عن مسار المحادثة، وفتح تذاكر الدعم. |
المفتاح السري sk_live_... | على خادمكم فقط. لا تضعوه أبدًا في المتصفّح أو التطبيق. | توقيع رمز الهوية، والتحقّق من webhook، وإرسال طلبات إلى API الخادم. |
البدء السريع
للموقع، يكفي وضع هذا السطر قبل </body>. انسخوه مع مفتاحكم من صفحة التثبيت في لوحة التحكم:
<script src="https://cdn.kavchat.com/v1/kavchat.js" data-key="pk_live_..." async></script>انشروا سيناريو، وأتيحوا البوت للجميع (أو لأرقام هواتف مستخدمي الاختبار)، ثم أعيدوا تحميل الصفحة.
الأدلة
الأزرار والأسئلة
أزرار قصيرة وأسئلة كاملة في كل خطوة، مع بحث عند وجود مواضيع كثيرة.
أداة الدردشة للموقع
سطر برمجي واحد، وواجهة JavaScript اختيارية، وأحداث وCSP.
React Native
Provider وشاشة دردشة وزر عائم. تعمل في أي تطبيق React Native (من الإصدار 0.72)، مع Expo أو بدونه.
Flutter
متحكم وزر عائم وشاشة دردشة، مع دعم مدمج للعرض من اليمين إلى اليسار (RTL).
iOS
حزمة Swift بمكونات SwiftUI وUIKit. من iOS 15 فما فوق.
Android
مكونات Jetpack Compose وActivity لتطبيقات Views. من API 23 فما فوق.
التعرّف على المستخدمين
وقّعوا رمزًا قصير الأجل على الخادم. أمثلة بـ7 لغات.
Webhook
تصل كل تذكرة جديدة إلى نظامكم موقّعة. في Premium.
Server API
التذاكر والتقارير والجمهور والإصدارات، مباشرة من خادمكم.
هل تحتاجون إلى مساعدة؟
راسلونا على support@kavchat.com. تجدون الوصف الكامل لواجهة API في ملف openapi.yaml (OpenAPI 3.1).