التوثيق 📚
مرجع كامل لمنصة 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 للملف الواحد.