Captain

تحديث ملف robots.txt للسماح لمساعد Chatwoot بفهرسة موقعك الإلكتروني

تستخدم Chatwoot خدمة Firecrawl داخليًا لجلب وفهرسة محتوى موقعك الإلكتروني. يتيح ذلك لمساعد Chatwoot الإجابة على الأسئلة باستخدام معلومات موقعك. ومع ذلك، إذا كان ملف robots.txt الخاص بموقعك يتضمن قواعد Disallow، فسيحترم Firecrawl تلك القواعد ويتخطى الزحف إلى هذه الصفحات. عندما يحدث ذلك: - لن تتم إضافة أي مستندات من موقعك إلى Chatwoot - لن يتلقى المساعد أي سياق إضافي - قد تصبح الإجابات ناقصة أو عامة لضمان عمل المساعد بشكل صحيح، عليك السماح لـ Firecrawl بالزحف إلى موقعك الإلكتروني. الخطوة 1: تحقق من ملف robots.txt الخاص بك قم بزيارة: https://yourdomain.com/robots.txt ابحث عن أي إدخالات Disallow: قد تمنع عوامل المستخدم. الخطوة 2: أضف قاعدة سماح لـ Firecrawl اطلب من مسؤول موقعك أو المطور إضافة الأسطر التالية إلى ملف robots.txt: User-agent: FirecrawlAgent Allow: / يشير هذا إلى Firecrawl بأنه مسموح له بزحف كامل موقعك، حتى إذا تم تقييد برامج الزحف الأخرى. الخطوة 3: احفظ وانشر بعد تحديث ملف robots.txt، تأكد من أن الملف تم نشره ويمكن الوصول إليه علنًا. يمكنك التحقق عن طريق زيارة: https://yourdomain.com/robots.txt والتأكد من ظهور القواعد الجديدة.

كيف تستخدم Captain Memories؟

Captain Memories هي عبارة عن قطع من المعلومات يتم حفظها من محادثات العملاء لتوفير سياق للتفاعلات المستقبلية. تُمكِّن هذه الذكريات من تقديم ردود شخصية وفعّالة وواعية بالسياق. على سبيل المثال، إذا ذكر أحد العملاء أن لديه فريقًا مكونًا من 18 شخصًا أو شارك تفضيلات محددة، سيقوم Captain بحفظ هذه المعلومات. يسمح ذلك لفريقك باستخدام هذه الرؤى خلال المحادثات المستقبلية لتعزيز تجربة العميل. ما نوع المعلومات التي يقوم Captain بحفظها؟ تم تصميم Captain لحفظ التفاصيل التي يشاركها العملاء والتي ترتبط بتقديم دعم شخصي. قد يتضمن ذلك: • تفضيلات العميل (مثل، أسلوب التواصل المفضل أو تفضيلات المنتج). • الأسئلة والمشكلات المتكررة (مثل، "كيف أدير المستخدمين في لوحة التحكم؟"). • المتطلبات الفريدة (مثل، "فريقنا يستخدم خطة المؤسسات ويحتاج إلى واجهة برمجة تطبيقات للتكاملات."). • السياق التشغيلي (مثل، "فريقنا يتكون من 18 عضوًا") يتم حفظ هذه التفاصيل تلقائيًا كملاحظات في ملف تعريف العميل، مما يسهل الوصول إليها في المستقبل. أين يمكنني رؤية ذكرى تم إنشاؤها بواسطة Captain؟ يتم حفظ الذكريات التي ينشئها Captain في قسم الملاحظات في لوحة معلومات العميل، وترتبط مباشرة بالعميل المعني. هذا يضمن أن فريقك يمكنه الوصول إليها في أي وقت أثناء المحادثات. كيفية عرض الذكريات: 1. افتح ملف تعريف العميل في لوحة المعلومات. 2. انتقل إلى قسم الملاحظات، حيث يتم تنظيم جميع الذكريات المحفوظة مع الطوابع الزمنية والسياق لسهولة الرجوع إليها.

مقدمة إلى الكابتن

كابتن هو وكيل الذكاء الاصطناعي لـ Chatwoot الذي يساعد في جعل دعم العملاء أسرع، أذكى وأكثر تخصيصًا. يأتي مع أدوات قوية لمساعدة كل من عملائك ووكلاء الدعم لديك، لضمان محادثات سلسة وحلول سريعة. 🤖 مساعد كابتن – مساعد ذكي يتحدث مع عملائك، ويتعلم من مستندات المساعدة والمحادثات السابقة، ويقدم ردودًا سريعة ودقيقة. عند التمكين، يتلقى المساعد الأسئلة الأولية قبل تحويلها إلى وكيل. اقرأ المزيد عن المساعد هنا. 🧑‍✈️ كابتن كوبيلوت – أفضل صديق لوكيل الدعم! يساعد في صياغة الردود، وترجمة الرسائل، والعثور على التفاصيل المهمة من أدواتك المتصلة. بالإضافة إلى ذلك، سنضيف المزيد من التكاملات قريبًا لجلب كل ما تحتاجه في مكان واحد. اقرأ المزيد عن الكوبيلوت هنا. 📚 كابتن الأسئلة الشائعة – يكتشف الأسئلة الشائعة من العملاء التي لم تدرج بعد في قاعدة المعرفة ويساعدك على سد الفجوات، مما يجعل الدعم أسرع للجميع. اقرأ المزيد عن الأسئلة الشائعة هنا. 🧠 ذكريات كابتن – يتتبع التفاصيل المهمة من المحادثات. إذا ذكر العميل مشكلة أكثر من مرة، يتذكرها كابتن، حتى يتمكن فريقك من تقديم دعم أفضل وأكثر تخصيصًا. اقرأ المزيد عن الذكريات هنا.

كيف تستخدم كابتن كوبيلوت؟

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

إنشاء صفحة الأسئلة الشائعة مع كابتن

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

كيفية تفعيل Captain على التثبيتات المستضافة ذاتياً؟

Captain هو مساعد ذكاء اصطناعي يساعدك على الرد بشكل أسرع وأكثر دقة. مع إحضار مفتاحك الخاص (BYOK)، يمكنك استخدام مفتاح API الخاص بك من OpenAI أو أي خدمة ذكاء اصطناعي متوافقة. أنت تتحكم في البيانات والتكاليف وأي نموذج يُستخدم. في بيئة الاستضافة الذاتية، يقوم Captain فقط بإرسال البيانات إلى نموذج الذكاء الاصطناعي الذي تختاره. سيرشدك هذا الدليل حول كيفية تفعيل Captain في إصدار المؤسسات المستضاف ذاتياً، وإضافة مفتاح API الخاص بك، وإعداد نموذج مخصص إذا رغبت بذلك. المتطلبات الأساسية قبل أن تبدأ، تأكد من توفر ما يلي لديك: - إصدار Chatwoot المؤسساتي مع خطة مدفوعة. - صلاحية مسؤول في وحدة تحكم السوبر أدمن. - مفتاح OpenAI API صالح. - (اختياري) نقطة نهاية API متوافقة مع OpenAI مستضافة ذاتياً. - (اختياري) مفتاح Firecrawl API لتحسين الزحف على الوثائق. تفعيل Captain في وحدة تحكم السوبر أدمن لتفعيل Captain على مستوى التثبيت: سجّل الدخول إلى وحدة تحكم السوبر أدمن. انتقل إلى الإعدادات → Captain. قم بتعبئة حقول الإعدادات: 1. مفتاح OpenAI API (إلزامي) – المفتاح لمصادقة الطلبات إلى OpenAI أو خدمة متوافقة. 2. نموذج OpenAI (إلزامي) – الافتراضي هو gpt-4o-mini. يمكنك اختيار نموذج آخر مدعوم مثل gpt-5. 3. نقطة نهاية OpenAI API (اختياري) – أدخل نقطة النهاية المخصصة إذا كنت تستخدم نموذجاً مستضافاً ذاتياً. 4. مفتاح Firecrawl API (اختياري) – يُنصح به لتحسين زحف المواقع والوثائق. اضغط على إرسال لحفظ الإعدادات. تفعيل Captain لحساب معيّن بعد تفعيل Captain على مستوى التثبيت، فعّله للحسابات الفردية: 1. في وحدة تحكم السوبر أدمن، انتقل إلى الحسابات. 2. اختر الحساب الذي ترغب في تفعيل Captain له ثم اضغط على تعديل. 3. ضمن قسم الميزات المميزة، فعّل خيار Captain. 4. احفظ التغييرات. استكشاف الأخطاء وإصلاحها إذا لم يكن Captain يستجيب كما هو متوقع: - تحقق من أن مفتاح OpenAI API صحيح وفعّال. - تأكد من أن اسم النموذج يطابق أحد النماذج المدعومة. - تأكد من أن مفتاح Firecrawl API لديك صالح في حال كنت تستخدم الزحف. - تحقق من أن Captain مفعّل على مستوى التثبيت والحساب. إذا استمر Captain في عدم الاستجابة، راجع سجلات خادم Chatwoot لكل من عمليات الويب وعمليات العامل (worker) لتحديد أي أخطاء، وشارك تفاصيل هذه الأخطاء مع فريق الدعم لمزيد من المساعدة.

إنشاء مساعد باستخدام كابتن

المساعد في Captain مصمم لمساعدة العملاء في الإجابة على الاستفسارات، وتقديم الحلول، والمساعدة في المشكلات المتعلقة بالمنتج. يتعلم من مقالات مركز المساعدة والمحادثات السابقة ليقدم ردوداً دقيقة. عند ربطه بصندوق وارد، يمكنه التعامل مع المحادثات مباشرة مع عملائك. كيف تنشئ مساعدًا في Captain؟ إذا كنت تستخدم خطة مدفوعة على Chatwoot Cloud، ستجد قائمة Captain في الشريط الجانبي الأيسر. تحت هذه القائمة، سترى خيارات للمساعدين، المستندات، والأسئلة الشائعة. انقر على المساعدون. ستظهر لك صفحة مثل الصورة أدناه. انقر على زر إنشاء مساعد جديد. هذه هي الحقول المتاحة حالياً في نموذج إنشاء المساعد: | اسم الحقل | الوصف | الافتراضي | مطلوب | | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----- | | اسم المساعد | هذا هو الاسم الداخلي للمساعد | -- | نعم | | الوصف | قدم وصفاً عن ما يفعله المساعد. ملاحظة: هذا ليس تعليمات للمساعد | -- | نعم | | اسم المنتج | هذا مهم. يتم بناء المساعد حول المنتج، وجود اسم المنتج سيساعده في تحديد الفجوات في المحتوى والأسئلة من المستخدم | -- | نعم | | الميزات: تفعيل الأسئلة الشائعة من المحادثات المحلولة | إذا قمت بتفعيل هذا الخيار، سيحاول مساعد Captain اكتشاف الفجوات في مقالات مركز المساعدة وسيقترح أسئلة شائعة جديدة، لمزيد من التفاصيل راجع مستند الأسئلة الشائعة | خطأ | لا | | الميزات: حفظ التفاصيل الأساسية كذكريات من تفاعلات العملاء | إذا تم تفعيلها، سيحاول التعرف على التفاصيل الرئيسية من المحادثات وسيحفظها في الملاحظات | خطأ | لا | بعد إدخال التفاصيل، اضغط على إنشاء، وسيتم إضافة المساعد إلى حسابك! يمكنك إنشاء عدة مساعدين للتعامل مع حالات استخدام مختلفة إذا لزم الأمر. كيف تربط مساعدًا بالصناديق الواردة؟ إضافة مساعد إلى حسابك لا تربطه تلقائيًا بكل الصناديق الواردة. ستحتاج إلى ربط كل مساعد يدويًا بالصناديق الواردة المناسبة حيث يكون مطلوبًا. يمنحك هذا المرونة في تخصيص المساعدين حسب المنتجات أو شرائح العملاء المحددة. لربط مساعد، انقر على قائمة النقاط الثلاث بجانب تفاصيل المساعد. من القائمة المنسدلة، اختر عرض الصناديق المتصلة. سيتم نقلك إلى صفحة تعرض جميع الصناديق الواردة المرتبطة بالمساعد. من هناك، يمكنك إدارة الاتصالات. ملاحظة: يمكن ربط كل صندوق وارد بمساعد واحد فقط في الوقت نفسه. انقر على ربط صندوق وارد جديد لمشاهدة قائمة بالصناديق المتاحة. اختر صندوقاً من القائمة وقم بربطه. هذا كل شيء! أصبح المساعد الآن نشطًا في الصندوق الوارد. جربه—أرسل رسالة في الدردشة وشاهد إذا ما كان سيرد بالترحيب الأولي. يمكنك نشر المساعد في أي صندوق وارد متاح، سواء كان دردشة مباشرة، واتساب، إنستجرام، بريد إلكتروني، أو غيرها. رائع! تم إعداد المساعد بنجاح. ولكن، في هذه المرحلة، لا يمتلك أي معرفة بعملك ومنتجك. بعد الترحيب الأولي، سيحاول المساعد تحويل المحادثة إلى وكيل. لإعطاء المساعد معلومات حول منتجك، يمكنك إضافة مستندات. تعرف على المزيد حول المستندات في هذه المقالة.

إنشاء مستند في Captain

يعمل المستند في Captain كمصدر معرفة للمساعد. من خلال ربط مركز المساعدة أو الأدلة الخاصة بك، يمكن لـ Captain تحليل المحتوى ومساعدتك بفعالية في الرد على استفسارات العملاء. حالياً، ندعم عناوين مواقع الويب وملفات PDF كمصادر، ولكننا نخطط لتوسيع ذلك ليشمل مستندات Notion في المستقبل. كيف يمكن إنشاء مستند؟ من قائمة الشريط الجانبي، انقر على خيار المستندات تحت Captain. ستظهر لك صفحة مثل الصفحة أدناه. عند النقر على إنشاء مستند جديد، سيظهر لك نموذج يمكنك من خلاله إدخال عنوان URL لقاعدة المعرفة الخاصة بك أو رفع ملف PDF. يرجى ملاحظة أننا ندعم فقط الروابط العامة في الوقت الحالي. بعد إدخال عنوان URL لقاعدة المعرفة أو مركز المساعدة أو رفع مستند، انقر على إنشاء لبدء العملية. سيبدأ Captain بتحليل المحتوى من عنوان URL أو المستند المقدم، ويستخدمه كنقطة انطلاق لجمع المعلومات التي يمكن أن تساعد في الإجابة على أسئلة العملاء بفعالية. سيقوم Captain بالزحف بشكل منهجي إلى جميع الصفحات المرتبطة ضمن مسار عنوان URL المقدم، والبحث عن المقالات والأدلة والموارد الأخرى المرتبطة بعنوان URL الرئيسي. على سبيل المثال، إذا قدمت عنوان URL مثل https://www.chatwoot.com/hc/user-guide، سيقوم Captain بتحليل جميع الروابط التي تبدأ بهذا المسار. أثناء زحفه على المحتوى، يقوم بتنظيم وفهرسة المعلومات، مما يجعل الوصول إليها سهلاً للإجابة على استفسارات العملاء. تضمن عملية الزحف المنهجي هذه أن جميع المعرفة ذات الصلة من المصدر المحدد سيتم التقاطها وتوفيرها للرجوع إليها. بالنسبة لتحميلات PDF، سيقوم Captain باستخراج وتحليل محتوى النص من الملف. هذا مفيد لإضافة أدلة المنتجات أو الكتيبات أو أي وثائق أخرى محفوظة كملفات PDF إلى قاعدة المعرفة الخاصة بك. سيتم إنشاء المستند، وأي مستندات جديدة تم تحديدها أثناء عملية الزحف ستتم إضافتها أيضًا بشكل منفصل كمستندات منفردة. إذا كنت ترغب في إزالة مستند محدد غير ذي صلة، يمكنك حذفه. سيؤدي ذلك أيضًا إلى محو جميع المعلومات المرتبطة التي جمعها Captain من ذلك المستند، ويضمن عدم الرجوع إليه في أي من المحادثات. كيف يمكنني التحقق من أن المحتوى تم تحليله بشكل صحيح؟ للتأكد من أن المحتوى قد تم تحليله بشكل صحيح، يقوم Captain بتحليل المستندات المقدمة لتحديد الأسئلة المحتملة. ثم يقوم بإنشاء قائمة من الأسئلة الشائعة المتعلقة بالمستند. من خلال مراجعة هذه الأسئلة الشائعة، يمكنك التحقق من أن المحتوى قد تمت معالجته بدقة وفُهِم بشكل صحيح. يمكنك عرض الأسئلة الشائعة التي تم إنشاؤها لكل مستند. فقط انقر على قائمة النقاط الثلاث في المستند واختر عرض الردود ذات الصلة للوصول إليها. سيتم عرض الأسئلة الشائعة ذات الصلة، كما هو موضح أدناه. حد الاستخدام إذا لم تكن قد اشتركت في إضافة مدفوعة لـ Captain، فسيكون عدد المستندات التي يمكنك إضافتها محدودًا. مع خطة الشركات الناشئة (Startups)، يمكنك إضافة حتى 100 مستند مجانًا. في الخطط الأعلى، يزيد الحد إلى 200 مستند مجاني مع خطة الأعمال (Business) و300 مستند مجاني مع خطة المؤسسات (Enterprise).

تحكم في من يرد عليه الكابتن ومتى

بشكل افتراضي، يجيب مساعد Captain على كل محادثة تصل إلى صناديق الوارد المتصل بها، في أي وقت. تساعدك خيارات الجمهور والجدول الزمني في تضييق ذلك: يحدد "الجمهور" لمن يرد Captain، بينما يحدد "الجدول الزمني" متى. أي شيء لا يلتقطه Captain لا يُهمل؛ تُعلّم المحادثة كمفتوحة ليقوم فريقك بمراجعتها، تمامًا مثل أي محادثة في صندوق وارد بدون مساعد متصل. أين تجد هذه الإعدادات 1. انتقل إلى Captain → المساعدون وافتح المساعد الذي ترغب في تعديله. 2. افتح الإعدادات. 3. استخدم علامات التبويب الجمهور والجدول الزمني في العمود الأيسر. يتم ضبط خيارات الجمهور والجدول الزمني لكل مساعد، وتطبق على كل صندوق وارد مرتبط بهذا المساعد. الجمهور: لمن يرد Captain تحتوي علامة تبويب الجمهور على خيارين. الجميع يرد Captain على كل محادثة في صناديق الوارد المتصلة. هذا هو الوضع الافتراضي. جمهور محدد يرد Captain فقط على العملاء الذين يطابقون الشروط التي تحددها. جميع الآخرين يتم تحويلهم مباشرة إلى فريقك. كل شرط يتكون من ثلاثة أجزاء: سمة، عامل، وقيمة — على سبيل المثال الدولة · يساوي · ألمانيا. في أعلى أداة بناء الشروط يمكنك اختيار كيفية الجمع بين الشروط: - مطابقة كل مما يلي — يجب أن تكون جميع الشروط صحيحة (و) - مطابقة أي مما يلي — يجب أن يكون هناك على الأقل شرط واحد صحيح (أو) تجميع الشروط انقر على إضافة مجموعة شروط لبناء منطق مختلط — على سبيل المثال "العميل مشترك في خطة برو و (موجود في الولايات المتحدة أو كندا)". كل مجموعة لها خيار المطابقة الخاصة بها (مطابقة الكل / مطابقة أي). يمكن تجميع المجموعات حتى مستوى واحد متداخل. السمات التي يمكنك استخدامها سمات جهة الاتصال | السمة | الاستخدام المعتاد | | ------------- | ---------------------------------------------------------- | | الاسم | مطابقة حسابات محددة بالاسم | | البريد الإلكتروني | استهداف أو استثناء نطاق، مثل البريد الإلكتروني يحتوي على @acme.com | | رقم الهاتف | استهداف أرقام محددة | | المعرف | المعرف الذي ترسله من تطبيقك عند تعريف المستخدمين | | الدولة | التوجيه بناءً على المنطقة | | المدينة | التوجيه بناءً على الموقع | | الشركة | استهداف شركة معينة | | تاريخ الإنشاء | جهات الاتصال الجديدة مقابل القديمة | | آخر نشاط | جهات اتصال نشطة حديثًا مقابل جهات اتصال خاملة | | محظور | محظور أو غير محظور | | التسميات | مطابقة جهات الاتصال التي تحمل تسمية واحدة أو أكثر | سمات المحادثة | السمة | الاستخدام المعتاد | | ----------------- | ------------------------------------------------------------------------------------------------------ | | مستخدم مسجل الدخول| ما إذا كان الزائر تم التحقق منه عبر التحقق من الهوية (HMAC) في أداة الموقع. مفيد لجعل Captain يخدم المستخدمين المسجلين فقط. | | لغة المتصفح | اللغة التي تم تعيين متصفح الزائر عليها | السمات المخصصة كل سمة مخصصة لجهة الاتصال قمت بتعريفها في الإعدادات → السمات المخصصة متاحة أيضًا — مثل الخطة، الإيرادات الشهرية المتكررة، تاريخ التسجيل، علامة التجربة التجريبية، وهكذا. العوامل المتاحة تعتمد على نوع السمة (نص، رقم، عملة، نسبة مئوية، رابط، تاريخ، قائمة، خانة اختيار). بعض السلوكيات الهامة: - التسميات تطابق عندما تحمل جهة الاتصال التسمية التي اخترتها. - مطابقة النص غير حساسة لحالة الأحرف، لذا Acme وacme يتصرفان بنفس الطريقة. - يتم مقارنة أرقام الهواتف مع تجاهل البادئة +، لذا +14155550100 و14155550100 يتطابقان. - سمات خانة الاختيار التي لم يتم تعيينها أبداً تعتبر خاطئة. الجدول الزمني: متى يرد Captain تتحكم علامة تبويب الجدول الزمني في نافذة رد Captain، بناءً على ساعات العمل المضبوطة في كل صندوق وارد (الصندوق → الإعدادات → ساعات العمل). | الخيار | ماذا يحدث | | ---------------------------- | ------------------------------------------------------------------------------------------------------------- | | أي وقت | يرد Captain على كل المحادثات بغض النظر عن الوقت. هذا هو الوضع الافتراضي. | | أثناء ساعات العمل | يرد Captain فقط أثناء فتح صندوق الوارد. خارج تلك الساعات، تذهب المحادثة إلى فريقك. | | خارج ساعات العمل | يرد Captain فقط أثناء إغلاق صندوق الوارد — مفيد لتغطية الليل وعطلات نهاية الأسبوع بينما يتعامل فريقك مع النهار. | الصناديق بدون ساعات عمل مُعدة دائمًا مشمولة. إذا كان صندوق الوارد لم يتم تفعيل ساعات العمل فيه، يعتبر Captain أنه متاح دائمًا ويجيب بغض النظر عن الخيار الذي تختاره. لذا إذا لم يبدُ خيار "أثناء ساعات العمل" محدودًا لأي شيء، تحقق من تفعيل ساعات العمل بالفعل في ذلك الصندوق. نظرًا لأن ساعات العمل موجودة في الصندوق، فإن مساعدًا واحدًا متصل بصناديق وارد في مناطق زمنية مختلفة يتبع جدول كل صندوق على حدة. كيف يعمل الجمهور والجدول الزمني معًا يجب أن يتحقق كلا الشرطين. يرد Captain فقط عندما يطابق العميل الجمهور وكان الوقت الحالي يقع ضمن نافذة الاستجابة. إذا فشل أي فحص، تُعلّم المحادثة كمفتوحة ليقوم فريقك بالرد. متى يتم التحقق من القواعد تعمل الفحوصات في اللحظة التي كان من المفترض أن يتولى فيها Captain المحادثة: - عند إنشاء محادثة جديدة، و - عند إعادة فتح محادثة محلولة من قبل العميل. بمجرد أن يتولى Captain المحادثة، يستمر في إدارتها حتى يتم حلها أو تسليمها. لا يعيد التحقق من الشروط مع كل رسالة واردة. لذا، لن يتم التخلي عن محادثة تبدأ قبل خمس دقائق من نهاية ساعات العمل أثناء الرد. وسيتم تقييم المحادثة الجديدة التالية من ذلك العميل بشكل جديد تمامًا. تغيير إعدادات الجمهور أو الجدول الزمني يؤثر فقط على المحادثات الجديدة والمعاد فتحها. المحادثات التي يديرها Captain بالفعل تستمر كما هي. استكشاف المشاكل وإصلاحها لا يزال Captain يرد على أشخاص قمت باستثنائهم. يتم تقييم الجمهور بناءً على سجل جهة الاتصال عند بدء المحادثة. إذا تم تعيين السمة على جهة الاتصال بعد بدء المحادثة (على سبيل المثال إذا قام تطبيقك بتعريف المستخدم بعد لحظات)، تكون تلك المحادثة قد تم توجيهها بالفعل. تحقق من سمات جهة الاتصال في الشريط الجانبي لتتأكد من القيمة التي رآها Captain. "أثناء ساعات العمل" لا يحد من شيء. غالبًا لم يتم تفعيل ساعات العمل في ذلك الصندوق. قم بتفعيلها في الصندوق → الإعدادات → ساعات العمل. سمة مخصصة خاصة بي غير موجودة في القائمة. متاح فقط السمات المخصصة لجهة الاتصال. السمات المخصصة للمحادثة غير مدعومة في شروط الجمهور. عرّف السمة تحت الإعدادات → السمات المخصصة مع نموذج جهة الاتصال. لا يمكنني حفظ جمهوري. كل شرط يحتاج قيمة (باستثناء "موجود" / "غير موجود" في السمات المخصصة من نوع تاريخ)، ويجب أن يحتوي الجمهور المحدد على شرط واحد على الأقل. الشروط المظللة باللون الأحمر غير مكتملة.

كيفية إعداد أدوات مخصصة لكابتن؟

تتيح الأدوات المخصصة لـ Captain إمكانية استدعاء واجهات برمجة التطبيقات الخارجية الخاصة بك أثناء المحادثات — بحيث يمكنه التحقق من حالة الضمان، أو التحقق من تغطية الخدمة، أو جلب بيانات من خدماتك الخاصة دون الحاجة إلى تحويل المحادثة إلى وكيل بشري. عندما يطرح العميل سؤالاً، يستخرج Captain القيم ذات الصلة من المحادثة، ويُدرجها في طلب الـ API الخاص بك، ويستخدم الاستجابة لتكوين رده. الأدوات المخصصة متوفرة في خطة الأعمال وما فوق. إنشاء أداة انتقل إلى Captain -> الأدوات ثم انقر على إنشاء أداة جديدة. املأ الحقول التالية: اسم الأداة — اسم قصير مثل "التحقق من الضمان" أو "تحقق من منطقة الخدمة" (بحد أقصى 55 حرفًا). الوصف — أبلغ Captain متى يجب استخدام هذه الأداة. هذا هو أهم حقل. اكتبه كما لو كنت تشرح لوكيل دعم: "يتحقق من حالة ضمان منتج باستخدام الرقم التسلسلي." الأوصاف غير الواضحة مثل "واجهة ضمان" ستؤدي إلى تفويت Captain لفرص استخدام الأداة. طريقة الطلب — اختر GET (لجلب البيانات) أو POST (لإرسال البيانات). رابط النهاية الطرفية — عنوان الـ API الخاص بك. استخدم {{ parameter_name }} لإدراج القيم المستخرجة من المحادثة: https://api.yourcompany.com/v1/warranty/{{ serial_number }} يجب أن يستخدم الرابط HTTPS، ويجب أن يكون اسم مضيف (وليس عنوان IP)، ولا يمكن أن يشير إلى localhost أو الشبكات الخاصة. المصادقة — اختر طريقة مصادقة API الخاصة بك: - بدون — بدون مصادقة - Token Bearer — يرسل الرمز الخاص بك في ترويسة Authorization - مصادقة أساسية — يرسل اسم مستخدم وكلمة مرور - مفتاح API — يرسل اسم ترويسة وقيمة مخصصة (مثال، X-API-Key) بيانات اعتماد المصادقة تكون مرئية فقط لمسؤولي الحساب. المعلمات — عرّف ما يجب على Captain استخراجه من رسالة العميل. كل معلمة تحتاج إلى اسم، نوع، ووصف. على سبيل المثال: serial_number (سلسلة نصية) — "الرقم التسلسلي للمنتج، يوجد في ظهر الجهاز." قالب الطلب (POST فقط) — قالب JSON باستخدام لغة Liquid. قالب الاستجابة — يتحكم بما يراه Captain من استجابة الـ API الخاصة بك. إذا تُرك فارغًا، يتلقى Captain JSON الخام. استخدم Liquid لاستخراج الحقول ذات الصلة، على سبيل المثال: الرقم التسلسلي {{ response.serial_number }}: {{ response.warranty_status }}. ينتهي في: {{ response.expiry_date }}. استخدم response للوصول إلى جسم JSON الذي تم تحليله. تساعد قوالب الاستجابة Captain على التركيز على البيانات ذات الصلة وتجنب الحقول الداخلية مثل معرفات قواعد البيانات أو معلومات تصحيح الأخطاء. اختبار أداتك انقر على اختبار الاتصال قبل الحفظ للتحقق من أن النهاية الطرفية الخاصة بك قابلة للوصول. يقدم الاختبار رمز حالة HTTP. تعني النتيجة الخضراء (HTTP 200–299) أن الاتصال والمصادقة يعملان. لاحظ أن الاختبار يرسل الرابط بدون تعبئة قيم المعلمات، لذا فهو يتحقق فقط من أن النهاية الطرفية الخاصة بك متاحة وأن بيانات الاعتماد الخاصة بك مقبولة. إذا فشل الاختبار، تحقق من التالي: - 401 غير مصرح — بيانات الاعتماد الخاصة بالمصادقة غير صحيحة. تحقق مجددًا من رمز bearer، مفتاح API، أو اسم المستخدم/كلمة المرور. - 403 محظور — الـ API الخاص بك يرفض الطلب. إذا كنت تطلب التحقق من الهوية، لاحظ أن الطلبات التجريبية لا تتضمن ترويسات الاتصال. - 404 غير موجود — رابط النهاية الطرفية غير صحيح. تحقق من المسار وتأكد من أن API يعمل. - انتهت المهلة — أخذ الـ API الخاص بك وقتًا طويلاً للرد. الأدوات المخصصة لديها مهلة 30 ثانية؛ تأكد من أن النهاية الطرفية تستجيب خلال تلك المهلة. السياق المُرسل مع كل مكالمة أداة عندما يستدعي Captain الـ API خاصتك، فإنه يتضمن ترويسات بيانات وصفية حتى يعرف النظام الخلفي لديك السياق: - X-Chatwoot-Account-Id — معرف حسابك - X-Chatwoot-Conversation-Id — معرف المحادثة - X-Chatwoot-Contact-Email — البريد الإلكتروني للعميل (إن وُجد) - X-Chatwoot-Contact-Inbox-Verified — ما إذا كانت هوية العميل تم التحقق منها عبر HMAC - X-Chatwoot-Assistant-Id — معرف المساعد Captain الذي يجري الاتصال - X-Chatwoot-Tool-Slug — معرف الأداة الداخلي - X-Chatwoot-Contact-Id — معرف جهة اتصال العميل - X-Chatwoot-Contact-Phone — رقم هاتف العميل (إن وُجد) - X-Chatwoot-Conversation-Display-Id — رقم عرض المحادثة يمكنك استخدام هذه الترويسات للبحث عن العميل في نظامك الخاص، تسجيل أي المحادثات التي أدت إلى استدعاءات API، والتحقق من صحة الطلب. الأمان الحمايات المدمجة: - جميع النهايات الطرفية يجب أن تستخدم HTTPS - الطلبات إلى نطاقات IP الخاصة، وlocalhost، ونطاقات .local محظورة - لا يتم تتبع عمليات إعادة التوجيه HTTP - الحد الأقصى لحجم الاستجابة 1 ميغابايت - بيانات الاعتماد مرئية فقط للمسؤولين التحقق من الهوية: إذا كانت أداتك تُرجع بيانات خاصة بالعميل (طلبات، فواتير، تفاصيل الحساب)، يجب على API الخاص بك التحقق من ترويسة X-Chatwoot-Contact-Inbox-Verified. بدون تفعيل التحقق من HMAC على صندوق بريدك، يمكن لأي زائر إدخال أي عنوان بريد إلكتروني في أداة الدردشة. لا تُرجع بيانات حساسة إلا إذا كانت هذه الترويسة true. للأدوات التي تُرجع بيانات عامة، لا داعي لهذا التحقق. حقن الأوامر: إذا كان API الخاص بك يُرجع محتوى يُنشئه المستخدم (مراجعات، منشورات المنتدى)، فقد يؤثر نص خبيث على سلوك Captain. استخدم قوالب الاستجابة لاستخراج الحقول المهيكلة فقط، ونظِّف المحتوى على جانب الـ API الخاص بك. الحدود - الحد الأقصى للأدوات لكل حساب — 15 - الموصى به — 10 أو أقل. تظهر رسالة تحذير عند أكثر من 10؛ قد يصعب على Captain اختيار الأداة المناسبة إذا زاد العدد. - طول اسم الأداة — 55 حرفًا - حجم الاستجابة — حتى 1 ميغابايت - مهلة الطلب — 30 ثانية متى تستخدم الأدوات المخصصة الأدوات المخصصة هي الأنسب للاستعلامات المهيكلة ذات المدخلات المتوقعة — مثل التحقق من حالة النظام، جلب الجداول الزمنية، أو البحث في السجلات بواسطة معرف. إذا كان لديك بالفعل تكامل Chatwoot مخصص لحالتك (مثل Shopify للتجارة الإلكترونية)، فالأفضل استخدامه — التكاملات المخصصة تدير البحث، والمطابقة الغامضة، ومزامنة البيانات بكفاءة أعلى من مجرد استدعاء API واحد. أمثلة التحقق من الضمان عندما يسأل العميل عما إذا كان منتجه لا يزال تحت الضمان، يمكن لـ Captain التحقق باستخدام الرقم التسلسلي. - اسم الأداة: التحقق من الضمان - الوصف: يتحقق من حالة ضمان المنتج باستخدام الرقم التسلسلي. استخدمه عندما يسأل العميل عما إذا كان منتجه مشمولاً، أو متى ينتهي الضمان، أو ما نوع التغطية لديه. التحقق من منطقة الخدمة للشركات التي تعمل في مناطق معينة — يسأل العملاء عما إذا كانت الخدمة متوفرة في موقعهم. - اسم الأداة: التحقق من منطقة الخدمة - الوصف: يتحقق مما إذا كانت الخدمة أو التوصيل متوفرة في منطقة معينة باستخدام الرمز البريدي للعميل أو اسم المدينة. تعمل الأدوات المخصصة بأفضل صورة عندما تكون المدخلات واضحة واستجابة الـ API متوقعة — التحقق من الحالة، والبحث، والاستعلامات المهيكلة الأخرى هي حالات استخدام ممتازة.

كيف تعمل أرصدة الذكاء الاصطناعي في كابتن؟

يشرح هذا الدليل كيفية استهلاك أرصدة الذكاء الاصطناعي، وكيف يتم تحديث أرصدتك عند شحن الرصيد، ومتى يحدث التجديد الشهري، وماذا يحدث عند تغيير خطتك، وكيف تعمل الإشعارات إذا نفدت أرصدتك. كيف يتم استهلاك أرصدة الذكاء الاصطناعي؟ يتم خصم أرصدة الذكاء الاصطناعي في كل مرة يتم فيها تنفيذ إجراء ذكاء اصطناعي. أمثلة على ذلك: - ردود المساعد Captain - عمليات بحث Copilot - إجراءات المحرر (إعادة صياغة، تلخيص، اقتراح رد) - اقتراحات التصنيف - أي سير عمل أو أتمتة تقوم بتشغيل استدعاء نموذج - نسخ الصوتيات تستهلك النماذج المختلفة الأرصدة بمعدلات متفاوتة. حالياً، جميع الإجراءات تستهلك رصيدًا واحدًا لكل رسالة، إذ يتم دعم إعداد واحد فقط للنموذج. سيتغير ذلك في المستقبل مع دعم خيارات أكثر للنماذج، وحينها قد تستهلك النماذج المختلفة كميات مختلفة من الرصيد لكل إجراء. إذا تعذر إكمال الإجراء بسبب عدم كفاية الأرصدة، يحدث فشل في الرصيد (موضح لاحقًا). متى يتم إعادة تعيين الاستخدام؟ يتم إعادة تعيين الاستخدام إلى 0 فقط أثناء التجديد الشهري. الاستخدام لا يعاد تعيينه عند: - شحن الأرصدة - تغيير خطتك - تغيير عدد المقاعد هذا يعني أنه يمكنك شحن الأرصدة في أي وقت دون فقدان تتبع دورة الاستخدام الحالية. كيف يتم تحديث أرصدة الذكاء الاصطناعي؟ 1. شحن الأرصدة عند شراء أرصدة إضافية، تتم إضافتها ببساطة إلى رصيدك الحالي. مثال - الرصيد السابق: 1500 - الشحن: 1000 - إجمالي الرصيد الجديد: 2500 لا تتغير أية قيم أخرى. 2. التجديد الشهري كل خطة تتضمن حصة أرصدة مجانية شهرية. عند التجديد، نقوم بضبط الاستخدام والأرصدة بناءً على ما استهلكته في الشهر السابق. الحالة أ: بدون استخدام الاستخدام: 0 → لا يتغير إجمالي رصيدك. الحالة ب: الاستخدام أقل من رصيدك المجاني الشهري - الرصيد السابق: 1500 - الاستخدام: 200 - الرصيد المجاني الشهري: 300 → لا يتم خصم أي شيء. → يظل إجمالي الرصيد 1500. → يعاد تعيين الاستخدام إلى 0. الحالة ج: الاستخدام يتجاوز رصيدك المجاني الشهري - الرصيد السابق: 1500 - الاستخدام: 600 - الرصيد المجاني الشهري: 500 تجاوز الحد = 600 − 500 = 100 → يتم خصم التجاوز من إجمالي الرصيد. → إجمالي الرصيد الجديد: 1400 → يعاد تعيين الاستخدام إلى 0. 3. تغيير خطتك عند تغيير الخطة، قد يزيد أو ينقص الرصيد المجاني الشهري الخاص بك. مثال - خطة الشركات الناشئة: 300 رصيد مجاني - خطة الأعمال: 500 رصيد مجاني - خطة المؤسسات: 800 رصيد مجاني إذا انتقلت من "الشركات الناشئة" إلى "الأعمال"، سيزيد رصيدك الإجمالي بمقدار 200. وبالمثل، إذا انتقلت من "الأعمال" إلى "الشركات الناشئة"، سينقص رصيدك الإجمالي بمقدار 200. يظل استخدامك الحالي بدون تغيير. فشل الرصيد (معالجة عدم كفاية الرصيد) يحدث فشل الرصيد عندما يتم تشغيل إجراء ذكاء اصطناعي لكن لا توجد أرصدة كافية لتنفيذه. ماذا يحدث أثناء فشل الرصيد - لا يتم تنفيذ الإجراء. يتم تنفيذ أية بدائل متاحة — على سبيل المثال، إذا لم يستطع المساعد الرد، يتم تحويل المحادثة مباشرة إلى وكيل. - نقوم بتسجيل الإجراء الفاشل داخليًا لأغراض التدقيق