التوثيق 📚

مرجع كامل لمنصة Grow Chat: بدء التشغيل، أوامر المساعد الذكي، وواجهة البرمجة.

البدء السريع

1. سجّل الدخول إلى app.grow-chat.com بنفس بياناتك في منصة الدردشة.

2. بعد الدخول، اختر فلتر المحادثات (مفتوحة / قيد الانتظار / محلولة / غير مقروءة).

3. افتح أي محادثة — يمكنك إرسال رسائل، إرفاق ملفات، أو إضافة ملاحظات داخلية 🔒 لا يراها العميل.

4. من لوحة «المساعد الذكي» على يسار الشاشة، شغّل أي أمر سريع بضغطة زر واحدة.

وضع اليدوية (Manual Mode) افتراضي دائم

مساعد Grow Chat الذكي لا يرسل أي رسالة للعملاء من تلقاء نفسه — أبدًا. ميزات مثل التذكير التلقائي والردود الآلية للأسئلة الشائعة معطّلة بالكامل. عمل الذكاء الاصطناعي ينحصر في: توليد اقتراحات تظهر للموظف فقط، وتنفيذ الأوامر التي يكتبها الموظف في الملاحظات الداخلية مثل /reply و /summary.

الأوامر السريعة

الأمرالوظيفةالناتج
/replyاقتراح 3 ردود جاهزةملاحظة خاصة
/summaryتلخيص المحادثةملاحظة خاصة
/sentimentتحليل مشاعر العميلملاحظة خاصة
/improveتحسين آخر رسالةملاحظة خاصة
/translate_enترجمة للإنجليزيةملاحظة خاصة
/translate_arترجمة للعربيةملاحظة خاصة
/ask سؤالكسؤال حر مع معرفة الشركةملاحظة خاصة

يمكن تشغيل جميع الأوامر بضغطة زر من لوحة المساعد الذكي، أو كتابتها يدويًا في ملاحظة داخلية بنفسك.

واجهة API (Gateway)

كل اتصالات الواجهة الجديدة تمر عبر بوابة API آمنة على app.grow-chat.com/api. لأغراض التطوير الداخلي، هذه أهم المسارات:

POST /api/auth/login            # تسجيل دخول (email + password) → access_token
GET  /api/auth/profile          # التحقق من التوكن
GET  /api/cw/v1/{accountId}/conversations?status=open&page=1
GET  /api/cw/v1/{accountId}/conversations/{id}/messages
POST /api/cw/v1/{accountId}/conversations/{id}/messages
POST /api/ai/command            # تشغيل أمر ذكي يدوي (token + accountId + conversationId + command)
GET  /api/ai/commands           # قائمة الأوامر المتاحة
GET  /health                    # فحص صحة الخدمة

صيغة طلب أمر ذكي:

POST /api/ai/command
{
  "token": "YOUR_ACCESS_TOKEN",
  "accountId": 1,
  "conversationId": 2085,
  "command": "reply",
  "question": "",
  "postAsNote": false
}

مؤقت SLA

يُظهر عمر آخر رسالة وردت من العميل في كل محادثة:

اللونالحالةالمدة
🟢 أخضر (sla-fast)سريعأقل من 10 دقائق
🟡 أصفر (sla-warn)متأخر10 – 60 دقيقة
🔴 أحمر (sla-late)متأخر جدًاأكثر من ساعة

الإشعارات (Web Notifications)

عند أول دخول، سيطلب المتصفح إذن الإشعارات — اختر «مسموح» حتى تصلك إشعارات كلما وصلت رسالة جديدة إلى محادثة غير مفتوحة. لا تعمل الإشعارات في وضع التصفح الخاص.

أسئلة تقنية

الحدود؟ يعتمد عدد المستخدمين والعملاء المسموح به على باقتك، وعند تجاوز الحد يظهر تنبيه إداري.

هل يوجد تحديث لحظي؟ نعم — قائمة المحادثات تتحدث تلقائيًا كل 10 ثوانٍ ورسائل المحادثة المفتوحة كل 6 ثوانٍ، بالإضافة إلى التحديث الفوري عند رجوعك للتبويب.

حجم المرفقات؟ حتى 20MB للملف الواحد.