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

المحادثات

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

الرسائل

كل ما يُقال داخل المحادثة: نص ومرفقات وقوالب واتساب وردود تفاعلية، من العميل أو الوكيل أو وكيل الذكاء الاصطناعي أو الأتمتة. إرسال رسالة عبر الواجهة يوصلها على قناة المحادثة ويعرضها في صندوق الوارد كأي رد آخر.

جهات الاتصال

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

صناديق الوارد

قناة متصلة: رقم واتساب للأعمال، أو صفحة إنستغرام أو ماسنجر، أو عنوان بريد، أو أداة الدردشة المباشرة على الموقع. تحدد صناديق الوارد مصدر المحادثة وأي الوكلاء يستطيعون رؤيتها.

الفرق والوكلاء

الوكلاء هم البشر في حسابك؛ والفرق تجمعهم للتعيين والتقارير. تعرض الواجهة الوكلاء وتوفرهم، وتدير الفرق والعضوية. يعيد GET /agents وPATCH /agents/{id} لكل شخص حقلين للتوفر. chosen_availability هي الحالة التي اختارها الوكيل أو مسؤول الحساب: online أو busy أو offline. وavailability_status هي الحالة الفعلية الآن: online أو away أو busy أو offline. يظهر الوكيل الذي اختار online بحالة away عندما يكون HueChat مفتوحًا لديه لكنه لم يستخدمه خلال مهلة الخمول المحددة للحساب. وlast_active_at هو وقت آخر نشاط مسجل له بتوقيت Unix، أو null. لا يغيّر PATCH /agents/{id} الاختيار إلا إذا أرسلت availability؛ فاعتمد في قيمتها على chosen_availability لا على الحالة الفعلية.

وكلاء الذكاء الاصطناعي

وكيل الذكاء الاصطناعي مساعد تبنيه في HueChat ليرد على العملاء بنفسه. تمنحه شخصية ولغة وضوابط وأدوات وقاعدة معرفة؛ وتنشره على صندوق وارد أو أكثر؛ فيرد على المحادثات الواردة بالعربية أو الإنجليزية حتى يسلّم السلسلة إلى إنسان. تنشئ الواجهة الوكلاء وتحدّثهم، وتنشرهم وتوقفهم، وتختبرهم، وتقرأ إحصاءاتهم وجودتهم وتقييماتهم، وتعيدهم إلى إصدارات سابقة.

المعرفة

المستندات وصفحات الويب والنصوص التي تستند إليها إجابات وكيل الذكاء الاصطناعي. ارفع ملفًا أو أشر إلى عنوان URL أو الصق نصًا؛ تفهرسه HueChat ويستشهد به الوكيل عندما يرد. تضيف نقاط النهاية المصادر وتعيد فهرستها وتزيلها.

القوالب والحملات

القوالب هي صيغ رسائل واتساب المعتمدة مسبقًا التي تشترطها Meta للرسائل التي يبدؤها النشاط التجاري. ترسل الحملات قالبًا إلى قائمة جهات اتصال، من ملف CSV أو جمهور محفوظ، مع الجدولة والإيقاف المؤقت والاستئناف وتقارير التسليم.

سير العمل وقوائم الدردشة

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

مفاتيح API

مفاتيح hc_ محدودة النطاق بنطاقاتها وحد معدلها وقائمة IP وتاريخ انتهائها. يدير مدير الحساب قيمها وتدويرها وسجل استخدامها داخل HueChat، بينما تشرح هذه البوابة كيفية المصادقة واستخدام واجهات المنتج فقط.