مرحبًا، كيف يمكننا مساعدتك؟
ابحث عن المقالات هنا أو تصفح الفئات أدناه.
تصفح حسب الموضوع
اعثر على أدلة ودروس وأجوبة منظمة حسب الفئة.
أساسيات Chatwoot
ابدأ هنا للتعرّف على Chatwoot ومفاهيمه الأساسية وكيف يساعدك على إدارة محادثات العملاء.
تصفح
القنوات الأخرى
اربط قنوات مثل البريد الإلكتروني وWhatsApp وFacebook وInstagram وTelegram وغيرها، وأدرها من مكان واحد.
تصفح
إعداد الحساب
أعدّ حسابك ومساحة العمل والفرق والمستخدمين والإعدادات الأساسية قبل بدء الاستخدام.
تصفح
القنوات الصوتية
تعرّف على كيفية ربط مزوّدي الخدمات الصوتية وإدارة المكالمات الواردة وإعداد الدعم الهاتفي في Chatwoot.
تصفح
الدردشة المباشرة للموقع
تعرّف على كيفية تثبيت أداة الدردشة المباشرة من Chatwoot وإعدادها وتخصيصها لموقعك أو تطبيقك.
تصفح
شرح الميزات
تعرّف على ميزات Chatwoot الأساسية لإدارة صناديق الوارد والمحادثات وجهات الاتصال والفرق وسير العمل.
تصفح
شرح الميزات المتقدمة
استكشف الأتمتة وقواعد الإسناد والسمات المخصصة ووحدات الماكرو واتفاقيات مستوى الخدمة وwebhooks.
تصفح
التطبيقات والتكاملات
اربط Chatwoot بالأدوات والخدمات الخارجية لتوسيع إمكانات سير عمل الدعم.
تصفح
التقارير
استخدم التقارير والتحليلات لقياس أداء الفريق وحجم المحادثات وأوقات الاستجابة وجودة دعم العملاء.
تصفح
مركز المساعدة
أنشئ مقالات مركز المساعدة ونظّمها وانشرها ليتمكّن العملاء من العثور على الإجابات بأنفسهم.
تصفح
أفضل الممارسات
توصيات عملية لمساعدة فريقك على تحقيق أفضل النتائج باستخدام Chatwoot.
تصفح
Captain
تعرّف على كيفية إعداد Captain، وكيل Chatwoot المدعوم بالذكاء الاصطناعي لدعم العملاء، واستخدامه.
تصفح
الانتقال إلى Chatwoot
أدلة للانتقال بسلاسة من منصات مثل Zendesk وFreshdesk وIntercom وغيرها إلى Chatwoot.
تصفح
موضوعات أخرى
أدلة ومراجع إضافية لمساعدتك على الاستفادة من Chatwoot إلى أقصى حد.
تصفح
أدلة إرشادية
أدلة تفصيلية خطوة بخطوة للمهام الشائعة وحالات الاستخدام المحددة في Chatwoot.
تصفح
المقالات الشائعة
ما يقرأه الآخرون الآن.
الدرس الأول: أول محادثة لك في Chatwoot
مرحبًا بك في Chatwoot! هذه هي محطتك الأولى في سلسلة تطبيقية تأخذك من حساب جديد تمامًا إلى مكتب دعم يعمل بشكل كامل. بنهاية هذا الدرس، سيكون لديك صندوق وارد لموقعك الإلكتروني وستكون قد رددت على أول رسالة من عميلك. ماذا ستتعلم - ما هو Chatwoot وكيف يتكامل مع أدوات دعمك - ما هي القنوات وصناديق الوارد، وكيف يرتبطان ببعضهما - كيف تتحول رسالة العميل إلى محادثة في لوحة التحكم الخاصة بك - كيفية إعداد صندوق وارد للدردشة المباشرة على الموقع في أقل من خمس دقائق - كيفية إرسال أول رد لديك وحل المحادثة ستحتاج إلى: حساب Chatwoot (النسخة التجريبية المجانية تكفي) وأي موقع إلكتروني يمكنك لصق شيفرة فيه. ليس لديك موقع الآن؟ يمكنك التجربة على ملف HTML محلي. ما هو Chatwoot؟ Chatwoot هو لوحة تحكم واحدة لكل محادثة عملاء تقوم بها أعمالك — البريد الإلكتروني، الدردشة المباشرة على الموقع، WhatsApp، Instagram، Facebook، الرسائل القصيرة، Telegram، وأكثر. بدلاً من التبديل بين خمسة تطبيقات وفقدان تتبع من قال ماذا، يعمل فريقك من مكان واحد، مع سياق مشترك، وسجل تاريخي، وأدوات. فكر فيه على أنه صندوق وارد مشترك لفريقك لخدمة العملاء — ولكن مع الأتمتة، والتقارير، ومساعدي الذكاء الاصطناعي التي يحتاجها فريق الدعم الحقيقي. القنوات وصناديق الوارد (أهم مفهوم أولاً) القناة هي نوع من التواصل — بريد إلكتروني، موقع إلكتروني، WhatsApp، رسائل نصية قصيرة، إلخ. صندوق الوارد هو مثيل محدد لقناة متصل بحسابك. على سبيل المثال: - "support[@]acme.com" هو صندوق وارد للبريد الإلكتروني - أداة الدردشة في acme.com هي صندوق وارد لموقع إلكتروني - رقم WhatsApp الخاص بك +1-555-… هو صندوق وارد على WhatsApp يمكنك أن تمتلك ما تشاء من صناديق الوارد، حتى من نفس النوع (صندوق وارد للموقع للتسويق وآخر للفواتير). كل رسالة واردة تعيش داخل صندوق وارد، وكل صندوق يمكن أن يكون له وكلاؤه، وساعات عمله، وترحيبه، وقواعد توجيهه الخاصة. نصيحة: لا تعقّد توزيع صناديق الوارد لديك في اليوم الأول. ابدأ بصندوق واحد فقط، تعلّم عليه، ثم قسّمه حسب حاجة نمو فريقك لاحقًا. كيف تتحول الرسالة إلى محادثة هذه هي دورة حياة رسالة العميل الواحدة — تذكّرها أثناء تعرّفك على بقية المنتج: 1. يرسل العميل رسالة عبر إحدى قنواتك (مثل الكتابة عبر أداة الدردشة في موقعك). 2. ينشئ Chatwoot محادثة في صندوق الوارد المناسب. تبدأ المحادثة بحالة مفتوحة أو قيد الانتظار إذا كان Captain متّصلاً. 3. تُسند المحادثة إلى وكيل — أوتوماتيكيًا (عن طريق سياسة الإسناد) أو يدويًا. 4. يرد الوكيل من لوحة التحكم. يُرسل الرد إلى العميل عبر نفس القناة التي بدأ منها. 5. تُعتبر المحادثة محلولة عند معالجة المشكلة. لا تُحذف — يبقى السجل كاملاً قابلًا للبحث ومرتبطًا بالعميل. للمحادثات أربع حالات شائعة: مفتوحة، قيد الانتظار، مؤجلة، محلولة. ستتعرف عليها جميعًا خلال الاستخدام. إعداد أول صندوق وارد لديك: دردشة الموقع المباشرة سنستخدم قناة الموقع لأنها أسرع طريقة لرؤية Chatwoot يعمل من البداية للنهاية. الخطوة 1 — فتح إعداد صندوق الوارد من لوحة التحكم، اذهب إلى الإعدادات → صناديق الوارد → إضافة صندوق وارد. الخطوة 2 — اختر "موقع إلكتروني" سترى شبكة بأنواع القنوات. انقر على أيقونة الموقع الإلكتروني. الخطوة 3 — املأ الأساسيات - اسم الموقع — ما سيراه عملاؤك في أعلى أداة الدردشة (مثلًا: دعم Acme). - نطاق الموقع الإلكتروني — عنوان URL الذي سيظهر فيه الأداة (مثلاً: https://acme.com). - لون الودجت — اختر لونًا متوافقًا مع علامتك التجارية. - عنوان الترحيب والسطر التعريفي — أول ما يقرأه الزوار عند فتح الأداة. الخطوة 4 — إضافة الوكلاء اختر أي من زملائك يمكنه الرد على الرسائل من هذا الصندوق الوارد. يمكنك إضافة أو إزالة الأشخاص لاحقًا. الخطوة 5 — تثبيت الشيفرة سيعطيك Chatwoot مقتطف جافاسكريبت صغير. الصقه في <head> في موقعك (أو قبل </body> مباشرة). أعد تحميل صفحتك وسترى فقاعة الدردشة في الزاوية. ليس لديك موقع بعد؟ لا تحتاج لموقع كي تجرب. اذهب إلى الإعدادات → صناديق الوارد، انقر رمز الترس بجانب الصندوق الجديد لفتح إعداداته، ثم افتح تبويب الإعدادات واضغط على فتح في Codepen على الشيفرة. ستفتح أداة دردشة مباشرة في المتصفح لتجربة الرسائل فورًا. الخطوة 6 — أرسل رسالة اختبارية انقر على فقاعة الدردشة في موقعك، اكتب "مرحبًا من أول زائر لدي!" واضغط إرسال. الخطوة 7 — رد من لوحة التحكم عد إلى لوحة التحكم في Chatwoot. ستظهر المحادثة الجديدة أعلى قائمة المحادثات مع شارة رسالة غير مقروءة. انقر عليها، واكتب ردك في صندوق الدردشة أسفل الصفحة، واضغط إرسال. سيظهر الرد فورًا للعميل في الأداة. 🎉 لقد تعاملت الآن مع أول محادثة Chatwoot لديك. جولة سريعة في واجهة المحادثة حالما تكون داخل المحادثة، هذه وظيفة كل جزء سريعًا: | المنطقة | وظيفتها | | -------------------------- | ------------------------------------------------------------------ | | صندوق الرد | إرسال الردود العامة للعميل | | ملاحظات خاصة | مناقشة المحادثة مع زملائك — العميل لا يرى هذه الملاحظات أبدًا | | الشريط الجانبي الأيمن | تفاصيل العميل، إجراءات المحادثة، سمات مخصصة، ومحادثات سابقة | | إجراءات المحادثة | تعيين وكيل، تغيير الحالة، تأجيل، إضافة تسميات | | قائمة المحادثات (يسار) | تصفية حسب الحالة، المكلف، صندوق الوارد، التسمية، أو المجلد المحفوظ | لا تحتاج لاستخدام أي من هذه الأدوات في اليوم الأول. الرد من صندوق الدردشة يكفي لدعم العملاء بشكل حقيقي. إنهاء المحادثة عندما تنتهي من مساعدة العميل: 1. اضغط على حل في أعلى المحادثة. 2. ستنتقل المحادثة من قائمة المفتوحة لديك إلى محلولة. 3. إذا فعلت CSAT، سيُطلب من العميل تلقائيًا تقييم التجربة. إذا رد العميل بعد إغلاق المحادثة، تُعاد المحادثة للفتح تلقائيًا — لن يضيع أي شيء. جرب هذه الخطوات التالية (اختيارية، دقيقة لكل منها) بينما أنت هنا، يمكنك تجربة واحدة أو اثنين من هذه الخيارات حتى تتعود عليها لاحقًا: - غيّر حالتك إلى متصل — أفاتارك بالأعلى → متصل / مشغول / غير متصل. - أرسل ملاحظة خاصة — اكتب @زميل يبدو أنها قضية فوترة في تبويب الملاحظات الخاصة. - أضف تسمية — جرّب تقرير-عطل أو طلب-ميزة من الشريط العلوي. - قم بتأجيل المحادثة — مفيد في حالات "بانتظار العميل". أسئلة اليوم الأول الشائعة هل سيرى العميل اسمي؟ نعم — يظهر اسم العرض والصورة الرمزية الخاصة بك (من إعدادات الملف الشخصي) على الردود الصادرة. خذ دقيقة لضبطها قبل الرد على عميل حقيقي. ماذا إذا رددت على الشخص الخطأ؟ يمكنك حذف رسالة أرسلتها (في الدردشة المباشرة فقط، غير مدعوم في القنوات الأخرى). بعد ذلك أرسل تصحيحًا توضيحيًا — تبقى النسخة الأصلية في لوحة التحكم بعلامة رسالة محذوفة للدقة، ولا تظهر للعميل مجددًا. هل يمكن أن يعمل وكيلان على نفس المحادثة؟ نعم. أحدهم هو المكلف (صاحب الرد)؛ يمكن إضافة آخرين كـ مشاركين في المحادثة للمتابعة والمشاركة. هل كل ما أكتبه في مربع الدردشة يُرسل فورًا؟ لا. تُرسل الردود فقط عند الضغط على إرسال (أو ⌘/Ctrl+Enter). وإذا انتقلت أثناء كتابة رسالة، يحتفظ Chatwoot بـ مسودة رد حتى لا تضيع عملك. ماذا بعد في الدرس الثاني، سنتخطى مربع الرد: الملاحظات الخاصة، الردود الجاهزة، التسميات، وكيفية تنظيم قائمة المحادثات مع تراكم الرسائل. حتى ذلك الحين، واجبك بسيط: أرسل لنفسك ثلاث رسائل اختبارية من الأداة ورد على كل واحدة منها. التمرين العملي أفضل من النظرية. مرحبًا بك في الفريق. 👋
⚡️ التطبيقات والتكاملاتكيفية تتبع المشاكل والميزات باستخدام تكامل Linear؟
إذا كانت شركتك أو حسابك أو مشروعك يستخدم Linear كأداة لإدارة المشاريع، يمكنك دمجها مع Chatwoot لإدارة جميع المحادثات في مساحة عمل Linear الخاصة بك. يمكنك إنشاء قضايا جديدة في Linear مباشرة من نافذة المحادثة الخاصة بك أو ربطها بقضايا موجودة لتتبع أكثر سلاسة. لبدء الإعداد، اتبع الخطوات أدناه. إذا كنت تستخدم إصدار Chatwoot المستضاف ذاتيًا، يرجى اتباع هذا الدليل. كيف تربط دمج Linear؟ الخطوة 1. انتقل إلى الإعدادات → التكاملات → Linear. انقر على زر "تكوين" الخطوة 2. اضغط على زر الاتصال. عندما تظهر نافذة الإذن، اضغط على تفويض للموافقة على الصلاحيات. بمجرد الانتهاء، سيتم إعادة توجيهك إلى تطبيق Chatwoot. مبروك! يمكنك الآن استخدام Linear في حسابك على Chatwoot. الميزات المدعومة إنشاء قضايا من المحادثة لإنشاء قضية جديدة، افتح أي محادثة واضغط على زر Linear في رأس المحادثة. ثم املأ تفاصيل القضية، بما في ذلك العنوان والوصف والفريق. بعد إدخال التفاصيل، اضغط على زر إنشاء لإضافة القضية إلى مساحة عمل Linear الخاصة بك مع ربط المحادثة. ستتم إضافة القضية إلى مساحة عمل Linear الخاصة بك مع ربط المحادثة. ربط القضايا الموجودة. لربط محادثة بتذكرة موجودة سلفاً، اضغط على علامة تبويب ربط القضية، وابحث عن التذكرة، ثم اضغط على "ربط" لربطها بتذكرة Linear.
👝 إعداد الحسابإنشاء حساب في Chatwoot
هذا الدليل يشرح لك كيفية إنشاء حساب جديد في Chatwoot — سواء كنت تستخدم Chatwoot Cloud (الإصدار المستضاف على chatwoot.com) أو تثبيت ذاتي الاستضافة خاص بك. السحابة أم الاستضافة الذاتية؟ اختر المسار الذي يناسب إعدادك. | | السحابة | الاستضافة الذاتية | | ------------ | ------------------------------------------ | ---------------------------------------------------------- | | مكان التسجيل | chatwoot.com | your-installation-url/app/auth/signup | | الاستضافة | تدار بواسطة Chatwoot | أنت تدير الخادم | | التحديثات | تلقائية | أنت تديرها | | الأفضل لـ | معظم الفرق التي تريد تجنب العمليات التقنية | الفرق ذات متطلبات صارمة لإقامة البيانات أو الإدارة الذاتية | إذا لم تكن متأكدًا من الإصدار الذي تستخدمه، اسأل فريق تقنية المعلومات لديك — أو افترض أنك تستخدم السحابة ما لم يُخبرك أحد بعكس ذلك. التسجيل في Chatwoot Cloud الخطوة 1 — افتح صفحة التسجيل انتقل إلى chatwoot.com وانقر على زر التسجيل. الخطوة 2 — املأ نموذج التسجيل سيُطلب منك خمسة أشياء: | الحقل | ما يجب إدخاله | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | البريد الإلكتروني للعمل | عنوان بريد إلكتروني للعمل صالح — ستستخدمه لتسجيل الدخول. مثال: john.hopkins[@]**companyname.com. | | كلمة المرور | يجب أن تحتوي على حرف كبير واحد على الأقل (A–Z)، ورقم واحد على الأقل (0–9)، وعلامة خاصة واحدة على الأقل | انقر على إنشاء حساب للإرسال. الخطوة 3 — تحقق من بريدك الإلكتروني سيرسل لك Chatwoot رسالة عبر البريد الإلكتروني بعنوان "تعليمات التأكيد" إلى بريد العمل الذي استخدمته للتسجيل. افتح الرسالة وانقر على تأكيد حسابي. سينقلك الرابط مباشرة إلى لوحة التحكم. لا تجد الرسالة؟ تحقق أولاً من مجلد الرسائل غير المرغوب بها، ثم من منطقة الحظر الخاصة ببريد العمل. بعض المؤسسات تملك سياسات أمان بريد تمنع الرسائل الآلية الخارجية من الوصول إلى صندوق الوارد — إذا كان هذا هو الحال، اطلب من مسؤول تقنية المعلومات لديك الإفراج عن الرسالة أو إضافة نطاق إرسال Chatwoot إلى القائمة المسموح بها. التسجيل في تثبيت مستضاف ذاتيًا إذا كان فريقك يدير Chatwoot بنفسه، فإن خطوات التسجيل هي نفسها، فقط الرابط يختلف. افتح: {your-installation-url}/app/auth/signup استبدل {your-installation-url} بما يستخدمه فريقك (مثال: support.acme.com). حقول النموذج هي نفسها مثل السحابة. وسيعمل تأكيد البريد الإلكتروني بالطريقة نفسها، بشرط أن يكون التثبيت مذنبًا لإرسال البريد الإلكتروني. غالبًا ما تكون للتثبيتات المستضافة ذاتيًا خطوات إعداد إضافية (نطاق مخصص، SMTP، SAML SSO). تم توثيق هذه الخطوات بشكل منفصل في أدلة Chatwoot للاستضافة الذاتية. الخطوات التالية: نوصيك باتباع الخطوات التالية لإعداد حسابك والاستفادة الكاملة من إمكانيات Chatwoot. يمكنك أيضًا المرور عبر دروس Chatwoot 101 لتتعلم تفاصيل التعامل الفعال مع العملاء باستخدام Chatwoot.ضبط ملفك الشخصي: عيّن اسمك، صورتك، كلمة المرور، وغيرها.ضبط تفاصيل الحساب: قم بضبط اسم حسابك، اللغة، وغيرها.إضافة وكلاء: أضف أعضاء فريقك لمساعدتك في إدارة المحادثات.إضافة صناديق بريد: أضف صناديق البريد/القنوات الخاصة بمحادثاتك مثل أداة الموقع، فيسبوك، واتساب، إلخ.ضبط أداة الدردشة: قم بتخصيص أداة الدردشة على موقعك.إضافة فرق: أنشئ فرقك مثل المبيعات، الخدمات، المنتج، وغيرها. - إضافة تسميات: أنشئ تسميات لتصنيف جهات الاتصال/المحادثات.إضافة ردود محفوظة: أنشئ قوالب الردود المحفوظة لأسئلة العملاء المتكررة. - التكاملات: قم بدمج Chatwoot مع تطبيقاتك المفضلة، أو استخدم Webhooks. - التطبيقات: اربط حسابك مع التطبيقات لتحسين تدفق العمل.
⚡️ التطبيقات والتكاملاتكيف تستخدم تطبيقات لوحة التحكم؟
مع تطبيقات لوحة التحكم، يمكنك دمج تطبيق ضمن لوحة تحكم Chatwoot لاستخدام الوكلاء. تتيح لك هذه الميزة إنشاء تطبيق بشكل مستقل، يمكن تضمينه بعد ذلك لتوفير معلومات العملاء، الطلبات، سجل الدفعات السابق، وغيرها. عند تضمين تطبيقك في لوحة تحكم Chatwoot، سيحصل تطبيقك على سياق المحادثة وجهة الاتصال كحدث نافذة. قم بتنفيذ مستمع لحدث الرسالة في صفحتك لاستلام السياق. ملاحظة: اطلع على البث المباشر على YouTube حول بناء تطبيق لوحة تحكم. كيف تنشئ تطبيق لوحة تحكم؟ الخطوة 1. انتقل إلى الإعدادات → التكاملات → تطبيقات لوحة التحكم. اضغط على زر "تكوين" المقابل لتطبيقات لوحة التحكم. الخطوة 2. أضف اسم تطبيقك والرابط الذي يستضيف عليه تطبيقك. عند الانتهاء، سيظهر تبويب جديد بالاسم الذي منحته للتطبيق في نافذة المحادثة. في هذا المثال، هو "طلبات العملاء". عند النقر على التبويب الجديد، ستتمكن من رؤية تطبيقك يجلب البيانات في لوحة تحكم Chatwoot. استقبال البيانات من Chatwoot إلى تطبيقك سيقوم Chatwoot بإرسال سياق المحادثة وجهة الاتصال كحدث نافذة. يمكن الوصول إليه داخل تطبيقك عبر تنفيذ مستمع للحدث كما يلي: window.addEventListener("message", function (event) { if (!isJSONValid(event.data)) { return; } const eventData = JSON.parse(event.data); }); طلب البيانات من Chatwoot عند الطلب إذا كنت بحاجة إلى طلب بيانات المحادثة عند الطلب من Chatwoot، يمكنك إرسال رسالة إلى نافذة الأب باستخدام واجهة Javascript postMessage API. سيقوم Chatwoot بالاستماع إلى هذا المفتاح: chatwoot-dashboard-app:fetch-info. مثال يمكن استخدام الكود التالي لاستعلام تطبيق لوحة التحكم. سيستجيب Chatwoot مباشرة لهذا الطلب ويوفر بيانات المحادثة المحدثة. window.parent.postMessage('chatwoot-dashboard-app:fetch-info', '*') // ستتلقى رسالة في مستمع الرسائل مع حمولة appContext. حمولة الحدث كائن المحادثة { "meta": { "sender": { "additional_attributes": { "description": "string", "company_name": "string", "social_profiles": { "github": "string", "twitter": "string", "facebook": "string", "linkedin": "string" } }, "availability_status": "string", "email": "string", "id": "integer", "name": "string", "phone_number": "string", "identifier": "string", "thumbnail": "string", "custom_attributes": "object", "last_activity_at": "integer" }, "channel": "string", "assignee": { "id": "integer", "account_id": "integer", "availability_status": "string", "auto_offline": "boolean", "confirmed": "boolean", "email": "string", "available_name": "string", "name": "string", "role": "string", "thumbnail": "string" }, "hmac_verified": "boolean" }, "id": "integer", "messages": [ { "id": "integer", "content": "Hello", "inbox_id": "integer", "conversation_id": "integer", "message_type": "integer", "content_type": "string", "content_attributes": {}, "created_at": "integer", "private": "boolean", "source_id": "string", "sender": { "additional_attributes": { "description": "string", "company_name": "string", "social_profiles": { "github": "string", "twitter": "string", "facebook": "string", "linkedin": "string" } }, "custom_attributes": "object", "email": "string", "id": "integer", "identifier": "string", "name": "string", "phone_number": "string", "thumbnail": "string", "type": "string" } } ], "account_id": "integer", "additional_attributes": { "browser": { "device_name": "string", "browser_name": "string", "platform_name": "string", "browser_version": "string", "platform_version": "string" }, "referer": "string", "initiated_at": { "timestamp": "string" } }, "agent_last_seen_at": "integer", "assignee_last_seen_at": "integer", "can_reply": "boolean", "contact_last_seen_at": "integer", "custom_attributes": "object", "inbox_id": "integer", "labels": "array", "muted": "boolean", "snoozed_until": null, "status": "string", "timestamp": "integer", "unread_count": "integer", "allMessagesLoaded": "boolean", "dataFetched": "boolean" } كائن جهة الاتصال { "additional_attributes": { "description": "string", "company_name": "string", "social_profiles": { "github": "string", "twitter": "string", "facebook": "string", "linkedin": "string" } }, "availability_status": "string", "email": "string", "id": "integer", "name": "string", "phone_number": "+91 9000000001", "identifier": "string || null", "thumbnail": "+91 9000000001", "custom_attributes": {}, "last_activity_at": "integer" } كائن الوكيل الحالي { "email": "string", "id": "integer", "name": "string" } الحمولة النهائية { "event": "appContext", "data": { "conversation": { // <...خصائص المحادثة> }, "contact": { // <...خصائص جهة الاتصال> }, "currentAgent": { // <...خصائص الوكيل الحالي> } } }
🔥 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 متوقعة — التحقق من الحالة، والبحث، والاستعلامات المهيكلة الأخرى هي حالات استخدام ممتازة.
📌 موضوعات أخرىاللغات المدعومة في Chatwoot
يدعم Chatwoot أكثر من 30 لغة مختلفة بشكلٍ أصلي. سيوضح هذا الدليل كيفية تفعيل لغة معينة للعمل مع لوحة التحكم وأداة الدردشة المباشرة. اللغات المدعومة فيما يلي اللغات المدعومة في Chatwoot والاختصارات المقابلة لها (مستمدة من رموز لغات ISO 639). (ar) العربية Català (ca) čeština (cs) dansk (da) Deutsch (de) ελληνικά (el) English (en) Español (es) فارسی (fa) suomi, suomen kieli (fi) Français (fr) magyar nyelv (hu) Bahasa Indonesia (id) Italiano (it) 日本語 (ja) 한국어 (ko) latviešu valoda (lv) മലയാളം (ml) Nederlands (nl) norsk (no) język polski (pl) Português (pt) Português Brasileiro (pt-BR) Română (ro) русский (ru) slovenčina (sk) Svenska (sv) தமிழ் (ta) ภาษาไทย (th) Türkçe (tr) українська мова (uk) Tiếng Việt (vi) 中文 (zh-CN) 中文 (台湾) (zh-TW) كيف تحدّث اللغة في أداة الدردشة المباشرة؟ كما هو موضح في دليل إعداد SDK، يمكنك ضبط اللغة المستخدَمة في أداة الدردشة المباشرة إما بتمريرها في chatwootSettings أو عن طريق استدعاء دالة setLocale. لاختيار اللغة، استخدم الاختصارات المذكورة أعلاه. سيسمح ذلك بعرض الأداة باللغة المطلوبة. // تمرير عبر window.chatwootSettings window.chatwootSettings = { locale: 'pt_BR', // .. بقية الإعدادات } // استخدام دالة setLocale window.$chatwoot.setLocale('pt_BR') كيف تحدّث لغة لوحة التحكم الخاصة بك؟ فقط المدراء يمكنهم تحديث لغة لوحة التحكم. انتقل إلى الإعدادات → إعدادات الحساب. ستكون قادرًا على رؤية خيار لغة الموقع في الخيارات المتاحة. اختر اللغة المفضلة لديك من قائمة الاختيار المنسدلة المقابلة. اضغط على زر تحديث الإعدادات في الزاوية العلوية اليمنى من شاشتك. تغيير لغة الموقع سيغير اللغة الافتراضية لجميع الوكلاء/المدراء في النظام. حاليًا، لا يدعم Chatwoot اختيار اللغة على مستوى الوكيل. كما يرجى ملاحظة أن هذه اللغة سيتم استخدامها كلغة افتراضية احتياطية لأداة الدردشة المباشرة.