🔎

شرح الميزات المتقدمة

20 المقالات Sojan بواسطة Sojan

استكشف الأتمتة وقواعد الإسناد والسمات المخصصة ووحدات الماكرو واتفاقيات مستوى الخدمة وwebhooks.

ما هي علامة "الوكيل البشري" في قناة إنستغرام/ماسنجر؟

تتيح ميزة البشرية للأعمال الاستجابة لرسائل المستخدمين خارج إطار نافذة المراسلة القياسية لمدة 24 ساعة. عندما يقوم وكيل بشري بتطبيق علامة رسالة human_agent، يمكنه الرد على رسائل المستخدمين في غضون 7 أيام من آخر رسالة أرسلها المستخدم. تكون هذه الميزة مفيدة بشكل خاص في الحالات التي تتطلب وقتًا أطول لحل المشكلات. تشمل حالات الاستخدام الشائعة: - عندما يكون العمل مغلقًا (على سبيل المثال، في العطلات الأسبوعية أو الرسمية) - الاستفسارات المعقدة من العملاء التي تتطلب أكثر من 24 ساعة للحل بينما تم تفعيل إذن HUMAN_AGENT بالفعل لمثيل السحابة الخاص بنا، إلا أن التركيبات المستضافة ذاتيًا يجب أن تخضع لعملية مراجعة التطبيق وتنجح فيها للوصول إلى هذه الميزة. يرجى قراءة المزيد حول ذلك هنا.

كيف تعمل عملية الفرز؟

عند إدارة المحادثات في Chatwoot، تساعد عمليات الفرز في تحديد الأولويات وتنظيم الرسائل بكفاءة. هناك أربع خيارات متاحة للفرز: أحدث نشاط، وقت الإنشاء، الأولوية، والردود المعلقة. كل طريقة فرز تخدم غرضًا محددًا في تبسيط التواصل. الفرز حسب أحدث نشاط يضمن الفرز حسب أحدث نشاط أن تظهر المحادثات التي تحتوي على أحدث التفاعلات في الأعلى. هذا يعني: - سيتم إدراج المحادثة ذات النشاط الأحدث (مثل رسالة جديدة أو تحديث) أولاً. - سيتم وضع المحادثات الأقدم والأقل نشاطاً في الأسفل. - هذا الخيار مفيد للبقاء على تواصل مع النقاشات الأحدث والأكثر نشاطًا. الفرز حسب وقت الإنشاء ينظم الفرز حسب وقت الإنشاء المحادثات بناءً على وقت بدئها. عند الفرز حسب أحدث محادثة تم إنشاؤها: - تظهر أحدث محادثة تم إنشاؤها في الأعلى. - تُدفع المحادثات الأقدم إلى الأسفل. - تساعد هذه الطريقة في إعطاء الأولوية للمحادثات الأقدم التي قد تحتاج إلى الانتباه أولاً. الفرز حسب الأولوية يساعد الفرز حسب الأولوية في التركيز على المحادثات الأكثر أهمية أولاً. ومع ذلك، قد لا يكون لجميع المحادثات أولوية محددة. ترتيب الفرز هو كما يلي: 1. المحادثات العاجلة تظهر في الأعلى. 2. تليها المحادثات ذات الأولوية الأعلى. 3. ثم المحادثات ذات الأولوية المتوسطة. 4. ثم المحادثات ذات الأولوية الأقل. 5. المحادثات بدون أولوية محددة توضع في النهاية. هذه الطريقة مثالية لضمان معالجة القضايا ذات الأولوية العالية بسرعة. الفرز حسب الردود المعلقة قد تكون بعض المحادثات في انتظار رد من أحد العملاء. ينظم الفرز حسب الردود المعلقة المحادثات بناءً على مدة الانتظار: - تظهر المحادثات التي انتظرت الأطول في الأعلى. - تليها المحادثات ذات فترات الانتظار الأقصر. - المحادثات التي لا تنتظر ردًا تدرج في الأسفل. هذه الطريقة مفيدة للتعامل مع المحادثات غير المردود عليها بكفاءة وتقليل التأخير في الردود.

دعم عناوين URL الشاملة في حملات الدردشة المباشرة على الموقع الإلكتروني

تدعم حملات الدردشة الحية في الموقع أنماط عناوين URL باستخدام wild card. عند إنشاء نمط عنوان URL، ضع السلوك التالي في اعتبارك. في Chatwoot، يجب أن يبدأ كل نمط عنوان URL بـ http:// أو https://. تشغيل الحملة على عنوان URL محدد بالضبط​ إذا قمت بإضافة عنوان URL محدد مثل https://chatwoot.com/app، فإن العناوين التي تحتوي على شرطة مائلة في النهاية أو معلمات URL أو معلمات التجزئة لن تتطابق. بعض الأمثلة لتعريفات التطابق الدقيق كما يلي: - https://chatwoot.com/app لن يتطابق مع https://chatwoot.com/app/ أو https://chatwoot.com/app?test_param=1 - https://chatwoot.com/app?test_param=test_value لن يتطابق مع https://chatwoot.com/app أو https://chatwoot.com/app#test_hash_param تشغيل الحملة مع تجاهل معلمات عنوان URL​ لتجاهل معلمات URL أو معلمات التجزئة، يمكنك إضافة شرطة مائلة في نهاية العنوان. على سبيل المثال: https://chatwoot.com/app/ سيتطابق مع جميع عناوين URL التالية. - https://chatwoot.com/app/ - https://chatwoot.com/app - https://chatwoot.com/app/?test=1 - https://chatwoot.com/app/#test تشغيل الحملة في جميع الأدلة الفرعية​ يمكنك استخدام الرمز * في العنوان إذا كنت ترغب في التطابق مع جميع الأدلة الفرعية. على سبيل المثال: https://chatwoot.com/* سيتطابق مع عناوين URL التالية - https://chatwoot.com/ - https://chatwoot.com/app - https://chatwoot.com/app/subdirectory تشغيل الحملة في جميع النطاقات الفرعية​ لمطابقة النطاق الحالي والنطاقات الفرعية، يمكنك استخدام النمط {*.}? في العنوان. على سبيل المثال: https://{*.}?chatwoot.com/ سيتطابق مع عناوين URL التالية - https://chatwoot.com - https://app.chatwoot.com - https://www.chatwoot.com

كيفية استخدام مرشحات المحادثة؟

يمكنك تصفية محادثاتك باستخدام معايير مختلفة. يمكنك أيضًا استخدام عوامل التشغيل "AND" و "OR" لتحسين نتائج البحث بشكل أكبر. تتوفر عوامل التصفية التالية أدناه. 1. حالة المحادثة 2. الوكيل المكلّف 3. البريد الوارد 4. الفريق 5. معرّف المحادثة 6. العلامات 7. الحملات 8. تاريخ الإنشاء 9. آخر نشاط 10. لغة المتصفح 11. البلد 12. روابط الإحالة 13. السمات المخصصة المضافة إلى حسابك. كيف تقوم بتصفية المحادثات؟ لتصفية محادثاتك، اتبع الخطوات التالية. الخطوة 1. انقر على أيقونة الفلتر في أعلى قائمة الرسائل. الخطوة 2. ستظهر نافذة منبثقة تتيح لك اختيار نوع الفلتر، والمشغل (يساوي، لا يساوي، موجود، غير موجود) والقيمة. اختر وطبّق عوامل التصفية الخاصة بك. مثال للحصول على جميع المحادثات "المحلولة" من قبل الوكيل "Fayaz"، قم بتعيين الفلاتر كما هو موضّح أدناه. 1. عيّن نوع الفلتر كـ "الحالة"، والمشغل كـ "يساوي"، والقيمة كـ "محلولة". 2. عيّن "اسم المكلّف" كنوع الفلتر، و"يساوي" كمشغل، و"Fayaz" كقيمة. 3. اضغط على زر "إرسال". سيتم الآن تصفية قائمة المحادثات بحسب المعايير أعلاه. يمكنك تطبيق عدد غير محدود من الفلاتر بدمجها باستخدام عوامل التشغيل AND و OR لإنشاء استعلامات معقدة. مسح الفلاتر لمسح عوامل التصفية والعودة إلى القائمة الأصلية، انقر على زر "مسح الفلاتر".

السمات المطلوبة للمحادثة

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

اتفاقيات مستوى الخدمة

بصفتك مزود الخدمة، تُعد اتفاقيات مستوى الخدمة (SLAs) بمثابة ترتيبات تعاقدية بينك وبين عملائك تحدد مستوى الخدمة الذي تلتزم بتقديمه. تُحدد اتفاقيات مستوى الخدمة المقاييس المتوقعة للأداء، مثل أوقات الاستجابة، وتوافر الخدمة، وأوقات الحل، التي وافقت على تقديمها. تُحمّلك هذه الاتفاقيات، بصفتك مزود الخدمة، المسؤولية عن جودة الخدمة التي تقدمها، مما يضمن مستوى دعم ثابت وموثوق للعملاء. يتيح لك Chatwoot تتبع المقاييس التالية: - وقت الاستجابة الأول (FRT): يشير هذا المقياس إلى الوقت الذي يستغرقه الوكيل للرد على استفسار أو طلب العميل الأولي. يُعد ذلك معيارًا حاسمًا لقياس الاستجابة، حيث يتوقع العملاء اهتمامًا سريعًا بمشكلاتهم أو استفساراتهم. - وقت الاستجابة التالي (NRT): يركز هذا المقياس على الوقت بين رسالة المتابعة من العميل واستجابة الوكيل التالية. يضمن ذلك أن يواصل مزود الخدمة تفاعله ويحافظ على تقدم المحادثة بشكل مستمر. - وقت الحل (RT): يقيس هذا المقياس إجمالي الوقت المستغرق حتى يتمكن الوكيل من حل مشكلة أو استفسار العميل بالكامل، من الاتصال الأولي إلى الحل النهائي. يُعتبر مؤشرًا رئيسيًا على كفاءة وفاعلية المزود في تلبية احتياجات العملاء. إنشاء اتفاقية مستوى الخدمة (SLA) يمكنك ضبط اتفاقيات مستوى الخدمة من صفحة الإعدادات، حيث يُسمح للمسؤول بإنشاء وحذف الاتفاقيات، يرجى ملاحظة أنه لا يمكنك تعديل أو تغيير اتفاقية مستوى الخدمة بعد إنشائها. لإنشاء اتفاقية، يجب عليك إضافة مقياس واحد على الأقل ليتم تتبعه. تطبيق اتفاقية مستوى الخدمة (SLA) يمكنك استخدام قاعدة أتمتة لتعيين اتفاقية مستوى الخدمة عند حدوث حدث محادثة. إليك مثال على تعيين اتفاقية "Enterprise P0" عند إنشاء محادثة بواسطة عنوان بريد إلكتروني محدد وتم تعيين الأولوية إلى عاجل. بمجرد أن تتطابق المحادثة مع شروط اتفاقية مستوى الخدمة والأحداث الخاصة بها، يتم تطبيق سياسة الاتفاقية تلقائيًا. بمجرد تطبيق اتفاقية مستوى الخدمة، لا يمكن إزالتها من المحادثة. ستظهر المحادثات التي تحتوي على اتفاقية مستوى خدمة نشطة وقريبة من الحد في واجهة المستخدم كما يلي تطبيق اتفاقية مستوى الخدمة لفريق يمكنك استخدام قواعد الأتمتة لتطبيق اتفاقيات مستوى خدمة محددة تلقائيًا على المحادثات التي يديرها فرق مختلفة. في المثال أعلاه، تراقب قاعدة الأتمتة الفريق المُعيّن وحالة المحادثة. عند تعيين المحادثة إلى فريق المبيعات، يتم تطبيق اتفاقية مستوى الخدمة Enterprise PO تلقائيًا، ويبدأ تتبع SLA فورًا. وبنفس الطريقة، يمكنك إنشاء قواعد أتمتة لتطبيق اتفاقيات مختلفة بناءً على صناديق البريد الوارد، الشركات، جهات الاتصال، المُعيّنين، الخصائص المخصصة، وغير ذلك. من خلال الجمع بين قواعد الأتمتة واتفاقيات مستوى الخدمة، يمكنك تخصيص أهداف الاستجابة والحل لتتوافق مع تدفقات دعمك وأعمالك الفريدة.

إعداد مصادقة SAML

هذه عبارة عن دليل لإعداد المصادقة باستخدام SAML لحسابك، يفترض الدليل أن لديك موفر هوية (IdP) خاص بالعمل. قبل أن تبدأ، هناك بعض النقاط التي يجب الانتباه إليها - بمجرد تمكين SAML، لن يتمكن المستخدمون من الوصول إلى Chatwoot باستخدام كلمات المرور الخاصة بهم. عند تعطيل SAML، سيعود هذا السلوك كما كان. - إذا كان المستخدم جزءًا من حسابات متعددة، وكان أي حساب منها يحتوي على إعداد SAML، فسيتعين عليه تسجيل الدخول عبر موفر SAML IdP فقط. من الأفضل تقييد المستخدمين ليكونوا ضمن نطاقك فقط. إعداد SAML يمكنك العثور على إعدادات SAML تحت الإعدادات > الأمان. فيما يلي الإعدادات التي يجب أن تكون على علم بها. - رابط الدخول الموحد (SSO URL): العنوان المحدد عبر HTTPS على موفر الهوية حيث تبدأ عملية تسجيل الدخول عبر SAML؛ يقوم تطبيقك بإعادة توجيه المستخدمين هنا للمصادقة. فكر فيه كنقطة دخول "تسجيل الدخول" لموفر الهوية التي تقبل طلبات المصادقة SAML وتبدأ تدفق الدخول الموحد. - معرّف كيان موفر الهوية (Identity Provider Entity ID): معرف فريد عالميًا (عادة سلسلة تبدو كـ URI) يحدد موفر الهوية في بيانات تعريف SAML. يستخدم موفر الخدمة هذا المعرف لاختيار إعدادات IdP الصحيحة وللتحقق من أن رسائل SAML الواردة تدعي فعليًا أنها من ذلك IdP. - شهادة التوقيع (Signing Certificate): شهادة X.509 العامة لموفر الهوية والتي تُستخدم لتوقيع الاستجابات/الإثباتات الخاصة بـ SAML. يخزّن موفر الخدمة هذه الشهادة ويتحقق من التوقيعات باستخدامها، مما يضمن أن الرسالة لم يتم تغييرها وأنها جاءت فعلاً من موفر الهوية. بعد الإعداد، ستجد المعلومات المطلوبة لتسجيل Chatwoot كمزود خدمة (SP) على موفر SAML الخاص بك. هذه هي التفاصيل التي ستحصل عليها - رابط خدمة استقبال الإثباتات (ACS URL): نقطة النهاية الخاصة بخدمة استقبال الإثباتات على موفر الخدمة والتي تستلم استجابة SAML من موفر الهوية. بعد مصادقة المستخدم، يرسل IdP الإثبات الموقّع إلى هذا الرابط عبر HTTPS، حيث يقوم تطبيقك بالتحقق منه وإنشاء جلسة تسجيل دخول. - معرّف كيان موفر الخدمة (SP Entity ID): المعرّف الفريد (غالبًا ما يكون URI) لموفر الخدمة في بيانات تعريف SAML. يستخدم IdP هذه القيمة للتأكد من أنه يصدر استجابة للتطبيق الصحيح ولاختيار رابط ACS الصحيح والإعدادات المناسبة. في حال كنت بحاجة إلى هذه المعلومات بشكل مسبق، إليك الصيغة الخاصة بها - رابط ACS: <your-chatwoot-installation>/omniauth/saml/callback?account_id=<your-account-id> - معرّف كيان SP: <your-chatwoot-installation>/saml/sp/<your-account-id> تعيين البيانات يجب تكوين تعيين السمات التالية في موفر الهوية الخاص بك - email - first_name - last_name عند تسجيل دخول المستخدم لأول مرة، تُستخدم هذه المعلومات لإنشاء مستخدم جديد له. ولا تقوم بتحديث المعلومات بعد ذلك. المصادقة يمكنك الانتقال إلى هذا الرابط https://app.chatwoot.com/app/login/sso لعرض نموذج تسجيل الدخول عبر SAML. فقط أدخل عنوان البريد الإلكتروني وسيقوم التطبيق بإعادة توجيهك إلى موفر SAML الذي تم إعداده.

كيفية استخدام سجلات التدقيق؟

سجلات التدقيق هي ميزة للمؤسسات. تحتفظ هذه الميزة بسجل للأنشطة التي تحدث في حسابك، والتي يمكنك تتبعها لمراجعة حسابك أو فريقك أو خدماتك. بشكل أساسي، تجيب سجلات التدقيق على الأسئلة الأربعة التالية: - من - ماذا - متى - أين أو، من قام بـ ماذا، متى ومن أين؟ أين تجد سجلات التدقيق داخل شات ووت؟ الخطوة 1. إذا كانت الميزة متاحة لك، يمكنك العثور عليها من خلال الذهاب إلى "الإعدادات" -> "سجلات التدقيق". الخطوة 2. تصفح سجلاتك. مرر لأسفل للعثور على الإدخالات المطلوبة أو استخدم التنقل للتبديل بين الصفحات. نصيحة احترافية: استخدم cmd/ctrl + F للبحث السريع عن الإدخال المطلوب. ستجد الإدخالات تحت ثلاثة عناوين: النشاط، الوقت وعنوان الـ IP. الأنشطة التي يتم تتبعها من خلال سجلات التدقيق عندما يحدث أي من الأنشطة التالية ضمن حسابك، يتم إنشاء إدخال مع التاريخ والطابع الزمني وعنوان الـ IP. انظر القائمة الكاملة أدناه. سجلات نشاط المستخدم - <الاسم | البريد الإلكتروني> غيّر الحالة الخاصة به إلى متصل، غير متصل، مشغول - <الاسم | البريد الإلكتروني> سجل الدخول - <الاسم | البريد الإلكتروني> سجل الخروج - <الاسم | البريد الإلكتروني> غيّر حالة التوفر لـ <الاسم | البريد الإلكتروني> إلى <متصل | غير متصل | مشغول> - <الاسم | البريد الإلكتروني> دعا المستخدم <البريد الإلكتروني> كـ <وكيل | مشرف> - <الاسم | البريد الإلكتروني> غيّر دور المستخدم <البريد الإلكتروني> إلى <وكيل | مشرف> سجلات نشاط الحساب - <الاسم | البريد الإلكتروني> قام بتحديث إعدادات الحساب. سجلات قواعد الأتمتة - <الاسم | البريد الإلكتروني> أنشأ قاعدة أتمتة جديدة (#معرّف-القاعدة) - <الاسم | البريد الإلكتروني> حدّث قاعدة أتمتة (#معرّف-القاعدة) - <الاسم | البريد الإلكتروني> حذف قاعدة أتمتة (#معرّف-القاعدة) سجلات القوالب الجاهزة (الماكرو) - <الاسم | البريد الإلكتروني> أنشأ ماكرو جديد (#معرّف-الماكرو) - <الاسم | البريد الإلكتروني> حدّث ماكرو (#معرّف-الماكرو) - <الاسم | البريد الإلكتروني> حذف ماكرو (#معرّف-الماكرو) سجلات صناديق الوارد - <الاسم | البريد الإلكتروني> أنشأ صندوق وارد جديد (#معرّف-صندوق-الوارد) - <الاسم | البريد الإلكتروني> حدّث صندوق وارد (#معرّف-صندوق-الوارد) - <الاسم | البريد الإلكتروني> حذف صندوق وارد (#معرّف-صندوق-الوارد) - <الاسم | البريد الإلكتروني> أضاف <اسم1 | بريد1>، <اسم2 | بريد2> إلى صندوق الوارد (#معرّف-صندوق-الوارد) - <الاسم | البريد الإلكتروني> أزال <اسم1 | بريد1>، <اسم2 | بريد2> من صندوق الوارد (#معرّف-صندوق-الوارد) سجلات Webhooks - <الاسم | البريد الإلكتروني> أنشأ Webhook جديد (#معرّف-Webhook) - <الاسم | البريد الإلكتروني> حدّث Webhook (#معرّف-Webhook) - <الاسم | البريد الإلكتروني> حذف Webhook (#معرّف-Webhook) سجلات الفريق - <الاسم | البريد الإلكتروني> أنشأ فريقًا جديدًا (#معرّف-الفريق) - <الاسم | البريد الإلكتروني> حدّث فريقًا (#معرّف-الفريق) - <الاسم | البريد الإلكتروني> حذف فريقًا (#معرّف-الفريق) - <الاسم | البريد الإلكتروني> أضاف <اسم1 | بريد1>، <اسم2 | بريد2> إلى الفريق (#معرّف-الفريق) - <الاسم | البريد الإلكتروني> أزال <اسم1 | بريد1>، <اسم2 | بريد2> من الفريق (#معرّف-الفريق)

كيف تستخدم الأتمتة؟

تعمل ميزة الأتمتة في Chatwoot على تبسيط سير عمل الفريق من خلال أتمتة المهام المتكررة وتوفير الوقت. تتيح تنفيذ إجراءات متنوعة مثل تعيين العلامات، وتعيين الفرق، وتوجيه المحادثات إلى الوكيل الأنسب، مما يمكّن الفريق من التركيز على مسؤولياتهم الأساسية وقضاء وقت أقل في المهام اليدوية. كيف تعمل الأتمتة؟ تتكون قاعدة الأتمتة من ثلاثة عناصر–– حدث، شروط، وإجراءات. الحدث هو المشغل الذي يقوم بتنفيذ الأتمتة. الشروط هي المعايير التي يجب تحققها قبل تنفيذ الإجراءات. الإجراءات هي المهام التي سيتم تنفيذها عند تحقق الشروط. أحداث الأتمتة أحداث الأتمتة هي المحفزات التي تبدأ تنفيذ الأتمتة. يوفر Chatwoot حالياً ثلاثة أنواع من الأحداث. 1. إنشاء محادثة: مشغل/حدث يتم تنفيذه عند إنشاء محادثة جديدة. يشمل ذلك المحادثات التي يتم إنشاؤها في جميع القنوات. 2. تحديث محادثة: مشغل/حدث يتم تنفيذه عند تحديث محادثة. 3. إنشاء رسالة: مشغل/حدث يتم تنفيذه عند إنشاء رسالة جديدة في محادثة. 4. فتح محادثة: مشغل/حدث يتم تنفيذه عند فتح محادثة كانت مؤجلة أو محلولة أو معلقة مسبقاً. شروط الأتمتة الشروط هي المعايير التي يجب تحققها قبل تنفيذ الإجراءات. يتم تقييمها حسب الترتيب الذي تم تحديدها فيه. تعتمد الشروط على نوع الحدث الذي تختاره. فيما يلي قائمة شاملة: إجراءات الأتمتة الإجراءات هي مهام أو عمليات يتم تنفيذها متى ما تم تحقق الشروط المحددة. يدعم Chatwoot حالياً الإجراءات التالية: - تعيين وكيل - تعيين فريق - إضافة علامة - إرسال بريد إلكتروني للفريق - إرسال نص المحادثة بالبريد الإلكتروني - كتم المحادثة - تأجيل المحادثة - حل المحادثة - إرسال حدث Webhook - إلغاء - إرسال مرفق - إرسال رسالة هذه الإجراءات متاحة بغض النظر عن الأحداث أو الشروط التي تختارها. كيف تنشئ قاعدة أتمتة؟ الخطوة 1. انتقل إلى الإعدادات → الأتمتة. اضغط على زر "إضافة قاعدة أتمتة". الخطوة 2. ستفتح نافذة إنشاء قاعدة أتمتة. ابدأ بملء الحقول كما هو موضح أدناه. 1. امنح الأتمتة اسماً حتى يسهل الرجوع إليها لاحقاً. 2. أضف وصفاً (اختياري). 3. اختر الحدث من القائمة المنسدلة. 4. أضف الشروط. استخدم معاملات يساوي أو لا يساوي لتعريف الشروط. 5. أضف الإجراءات. يمكنك إضافة شروط وإجراءات متعددة أيضاً. استخدم معاملات و، أو للقيام بذلك. مثال تريد تعيين جميع المحادثات الجديدة إلى فريق المبيعات في فرنسا كلما كانت لغة المتصفح بالفرنسية. إليك كيفية إنشاء قاعدة أتمتة لهذا الغرض – 1. أضف اسماً ووصفاً. 2. اختر الحدث تم إنشاء محادثة. 3. أضف شرطين ووصل بينهما باستخدام معامل و. الشرط الأول: حالة المحادثة مفتوحة، والشرط الثاني: لغة المتصفح الفرنسية (fr) من القائمة المنسدلة. 4. أضف إجراء - تعيين فريق واختر فريق مبيعات فرنسا من القائمة المنسدلة. (يجب إنشاء فريقك أولاً). كيف توقف، تعدّل، تنسخ أو تحذف قواعد الأتمتة؟ تظهر قائمة قواعد الأتمتة الخاصة بك ضمن "الأتمتة". يمكنك عرض هذه الصفحة بالذهاب إلى الإعدادات → الأتمتة. ستجد هنا مجموعة من الإجراءات السريعة: لإيقاف قاعدة الأتمتة: قم بتبديل الزر تحت عمود "نشطة" إلى وضع الإيقاف. لتعديل قاعدة: اضغط على رمز القلم. لاستنساخ قاعدة: اضغط على رمز النسخ. لحذف قاعدة: اضغط على رمز التقاطع الأحمر.

تحديد حدود المحادثات لكل وكيل باستخدام سياسات سعة الوكيل

سياسة سعة الوكيل هي حزمة من القواعد التي تُحدد الحد الأقصى لعدد المحادثات المفتوحة التي يمكن أن يديرها وكيل واحد في وقت واحد. بهذه الطريقة تمنع غرق وكيل واحد في العمل بينما يجلس آخر بدون عمل، وتضمن توزيع تعيين المحادثات بشكل عادل عندما يرتفع حجم المحادثات. عندما يبحث التعيين التلقائي عن وكيل مؤهل، يتحقق من سياسة السعة الخاصة بكل مرشح (إن وجدت) قبل التعيين. يتم تخطي الوكلاء الذين وصلوا أو تجاوزوا الحد الأقصى؛ ويتم تعيين المحادثة للوكيل المؤهل التالي الذي لم يصل للحد الأقصى بعد. تتكون السياسة من: - اسم (مطلوب) - وصف (اختياري) - مجموعة من حدود السعة لكل صندوق وارد — حدود مختلفة لكل صندوق وارد إذا رغبت بذلك - قواعد استثناء اختيارية — تصنيفات وأعمار محادثات يجب تجاهلها عند عد المحادثات المفتوحة الصلاحيات: وحدهم المدراء يمكنهم إنشاء أو تعديل أو حذف سياسات السعة، وفقط المدراء يمكنهم ربطها بالوكلاء. إدارة سياسات السعة كيف تنشئ سياسة سعة؟ 1. انتقل إلى الإعدادات → سعة الوكيل ثم اضغط على إنشاء سياسة سعة وكيل. 2. املأ البيانات التالية: - اسم السياسة — مطلوب، حد أقصى 255 حرفاً. - الوصف — اختياري. - حدود السعة في الصناديق — حدد لكل صندوق وارد تود تحديد سعة له الحد الأعلى لعدد المحادثات المفتوحة التي يمكن للوكيل ضمن هذه السياسة العمل عليها في ذلك الصندوق. - قواعد الاستثناء (اختياري): - التصنيفات المستثناة — المحادثات مع هذه التصنيفات لا تحتسب ضمن الحد الأقصى. - استبعاد الأقدم من — المحادثات التي تجاوز عمرها N ساعة لا تحتسب ضمن الحد الأقصى. 3. أضف الوكلاء الذين يجب أن تنطبق عليهم هذه السياسة ضمن الوكلاء المخصصين. 4. احفظ. كيف تعدل سياسة السعة؟ 1. انتقل إلى الإعدادات → سعة الوكيل وافتح السياسة المطلوبة. 2. غيّر الحدود أو الاستثناءات أو الوكلاء المخصصين لها. 3. احفظ. حذف سياسة السعة حذف السياسة يؤدي إلى إلغاء ربطها بكل الوكلاء. يعود الوكلاء إلى وضع عدم وجود حد ويتمكنون من تلقي التعيينات التلقائية دون قيود. كيف تعمل قواعد الاستثناء الهدف من الاستثناءات هو أن تجعل الحدود تعكس عبء العمل الحقيقي والنشط — وليس مجرد أي محادثة مفتوحة ما زالت موجودة. التصنيفات المستثناة أضف تصنيفات مثل في انتظار العميل أو مؤجلة إلى قائمة الاستثناءات. المحادثات بتلك التصنيفات لا تزال مملوكة للوكيل ولكن لا تحتسب ضمن الحد الأقصى. فإذا كان الحد 10 ولدى وكيل 7 فعالين + 5 بتصنيف في انتظار العميل، تبقى لديه سعة لـ 3 محادثات جديدة. استثناء العمر عيّن "استبعاد الأقدم من 24 ساعة" وستسقط المحادثات التي أنشئت منذ أكثر من يوم من الحسبة. مفيد للمحادثات الطويلة (مثلاً تذاكر المؤسسات متعددة الأيام) والتي لا تريدها أن تستهلك سعة الوكيل. نصيحة: ابدأ بحد سعة سخي وبدون استثناءات. أضف الاستثناءات فقط إذا استطعت تحديد نوع معين من المحادثات يسبب تحريفاً في العد. كيف تربط سياسة بوكيل؟ يمكنك ربط السياسة أثناء إنشائها (تحت الوكلاء المخصصين في نموذج السياسة) أو بعد ذلك: 1. افتح السياسة. 2. اضغط على إضافة وكيل. 3. اختر الوكلاء الذين تريد أن تشملهم هذه السياسة. يمكن ربط نفس السياسة بعدة وكلاء. يمكن لوكيل واحد أن يكون مرتبطاً بسياسة سعة واحدة فقط في وقت ما. تعيين سياسة جديدة يستبدل القديمة. كيف يستخدم التعيين التلقائي السعة؟ عندما تصل محادثة جديدة إلى صندوق وارد مفعل فيه التعيين التلقائي: 1. يبحث Chatwoot عن وكلاء مؤهلين (أعضاء الصندوق، بحالة متاحة). 2. لكل مرشح بسياسة سعة، يعد المحادثات المفتوحة لديه في ذلك الصندوق، مع تطبيق قواعد الاستثناء. 3. يستبعد الوكلاء الذين وصلوا أو تجاوزوا الحد الأقصى. 4. يختار الوكيل المؤهل التالي حسب استراتيجية التعيين المحددة (دوران أو توازن). إذا لم يكن أي وكيل تحت الحد، تبقى المحادثة غير معينة في قائمة الانتظار حتى ينخفض عدد محادثات أحدهم أو تتوفر سعة جديدة. السعة لكل صندوق وارد. يمكن أن يصل وكيل للحد الأقصى في صندوق A بينما يبقى له سعة في صندوق B — سيتم تخطيه في A ولكنه مؤهل في B. مثال عملي فريق دعم مكون من 12 وكيلاً لديه الصناديق التالية: - الموقع الإلكتروني — حجم مرتفع، محادثات قصيرة - البريد الإلكتروني — حجم منخفض، محادثات طويلة أنشأت سياستين لسعة الوكلاء: | السياسة | الحد للموقع | الحد للبريد | |---------|-------------|------------| | وكيل قياسي | 10 | 5 | | وكيل خبير | 15 | 8 | الوكلاء الجدد يوضعون على الوكيل القياسي؛ والوكلاء المتمرسون على الوكيل الخبير. أضف استثناء: في انتظار العميل (لتجاهل المحادثات المؤجلة). أضف استثناء عمر: 48 ساعة (حتى لا تحجز رسالة مؤسسة قديمة خانة عند وكيل). النتيجة: يتم توزيع الرسائل دون إغراق أي وكيل، والفريق الخبير يتحمل الحصة الأكبر دون تدخل يدوي. الأسئلة المتكررة ماذا يحدث لمحادثة معُينة بالفعل عندما يصل وكيل إلى الحد الخاص به؟ لا شيء. الحدود تؤثر فقط على تعيينات جديدة تلقائياً. التعيينات الحالية تبقى كما هي. هل يمكن للوكيل إعادة تعيين محادثة لإتاحة سعة؟ نعم — إعادة التعيين اليدوية تعمل بشكل طبيعي. إذا نقلت محادثة إلى زميل، ينخفض عدك بمقدار واحد ويمكن أن تصلك التعيينات التلقائية الواردة مجدداً. ماذا لو كان كل الوكلاء قد وصلوا للحد؟ تبقى المحادثة غير معينة في قائمة الانتظار حتى ينخفض عدد محادثات أحدهم (بانتهاء محادثة أو تأجيلها أو إعادة تعيينها). راقب طول قائمة غير المعينين — إذا كبرت، أنت بحاجة للمزيد من الموظفين أو زيادة الحد الأعلى. هل يمكنني تعيين سعة لكل فريق؟ السعة تُحدد لكل وكيل، وليس لكل فريق. إذا أردت تقليد سعة لكل فريق، اربط نفس السياسة بجميع أعضاء الفريق. هل تطبق الاستثناءات على مستوى الوكيل أم السياسة؟ مستوى السياسة. كل الوكلاء المرتبطين بنفس السياسة يخضعون لنفس قواعد الاستثناء.

قوالب المحتوى من Twilio

تسمح قوالب محتوى Twilio لك بإرسال رسائل قوالب WhatsApp معتمدة مسبقًا عبر قنوات أعمال Twilio WhatsApp في Chatwoot. تتيح لك هذه القوالب بدء المحادثات وإرسال رسائل منظمة تتوافق مع سياسات المراسلة على WhatsApp. أنواع القوالب المدعومة قوالب نصية - رسائل نصية بسيطة مع متغيرات اختيارية - دعم حتى 100 متغير لكل قالب باستخدام تنسيق {{1}}, {{2}} - دعم متعدد اللغات قوالب وسائط - قوالب الصور: نص مع رؤوس صور (JPEG/PNG، بحد أقصى 5MB) - قوالب الفيديو: نص مع رؤوس فيديو (MP4/3GPP، بحد أقصى 16MB) - قوالب المستندات: نص مع مرفقات مستندات (PDF/أوفيس، بحد أقصى 100MB) - دعم لروابط وسائط ديناميكية مع متغيرات قوالب الرد السريع - استجابات الزر التفاعلية التي يديرها WhatsApp - إجراءات أزرار بسيطة للاستجابات الشائعة - دعم لعدة متغيرات لغوية قوالب دعوة لإجراء - قوالب زر الروابط: إرسال رسائل مع أزرار إجراءات قابلة للنقر - دعم المتغيرات: يمكن أن تتضمن كل من نص الرسالة ومعلمات الزر متغيرات - أنواع الإجراءات: أزرار روابط للمدفوعات، الحجوزات، المواقع الإلكترونية، إلخ. المتطلبات الأساسية قبل استخدام قوالب محتوى Twilio: 1. حساب Twilio: حساب Twilio نشط مع إمكانية الوصول إلى واجهة برمجة تطبيقات أعمال WhatsApp 2. قوالب معتمدة: قوالب تم إنشاؤها واعتمادها في Twilio Console 3. تكامل Chatwoot: تكوين قناة Twilio WhatsApp في Chatwoot 4. حساب أعمال WhatsApp: ملف تعريف أعمال WhatsApp موثق إعداد القوالب 1. سجّل الدخول إلى لوحة تحكم Twilio 2. انتقل إلى Messaging → Content Template Builder 3. انقر على Create new template 4. اختر نوع القالب: Text: للرسائل النصية البسيطة، Media: للصور أو الفيديوهات أو المستندات، Quick Reply: للأزرار التفاعلية 5. قم بتكوين القالب بناءً على الغرض. 6. قدّم القالب لاعتماده من WhatsApp 7. انتظر الاعتماد (من 5 دقائق إلى 24 ساعة) 8. القوالب المعتمدة تحصل على ContentSid 9. القوالب أصبحت جاهزة للاستخدام في Chatwoot مزامنة القوالب مع Chatwoot المزامنة التلقائية عبر API يتم مزامنة القوالب تلقائيًا عند: 1. فتح نافذة قوالب المحتوى في محادثة 2. إنشاء محادثة جديدة باستخدام قناة Twilio WhatsApp المزامنة اليدوية لمدراء الصندوق: 1. انتقل إلى Settings → Inboxes 2. اختر صندوق Twilio WhatsApp الخاص بك 3. انقر على زر Sync Templates 4. انتظر إشعار اكتمال المزامنة استخدام القوالب في المحادثات الخطوة 1: الوصول إلى خيارات القوالب افتح أي محادثة مع جهة اتصال WhatsApp، انقر على أيقونة القالب في محرر الرسائل، اختر "قوالب WhatsApp" من القائمة المنسدلة الخطوة 2: اختر قالبك تصفح القوالب المعتمدة الخاصة بك، استخدم شريط البحث للعثور بسرعة على قوالب محددة الخطوة 3: خصص رسالتك اعتمادًا على نوع القالب لديك، قد تحتاج إلى تعبئة: أفضل الممارسات تصميم القوالب - اجعل الرسائل موجزة وواضحة - استخدم المتغيرات للتخصيص - تأكد من أن ملفات الوسائط محسّنة وسهلة الوصول - جرّب القوالب قبل إرسالها للاعتماد استخدام المتغيرات - استخدم أسماء متغيرات وصفية في لوحة تحكم Twilio - قدم أمثلة واضحة للاعتماد - اجعل عدد المتغيرات معقولًا (أقل من 10 لأفضل تجربة) إرشادات الوسائط - استضف ملفات الوسائط على خوادم موثوقة وسريعة - استخدم روابط HTTPS لجميع الوسائط - قم بتحسين أحجام الملفات لتسريع التسليم - أضف نص بديل في قوالب الوسائط الامتثال - اتبع إرشادات سياسة أعمال WhatsApp - تأكد من أن القوالب تخدم أغراضًا تجارية مشروعة - احرص على خصوصية المستخدم والموافقة - راقب أداء القوالب وحالة الاعتماد استكشاف الأخطاء وإصلاحها مشكلات شائعة عدم ظهور القالب - السبب: لم يتم اعتماد القالب من WhatsApp - الحل: تحقق من حالة الاعتماد في لوحة تحكم Twilio فشل مزامنة القالب - السبب: مشاكل اتصال API أو بيانات اعتماد غير صحيحة - الحل: تحقق من بيانات اعتماد Twilio وأعد المحاولة عدم تحميل الوسائط - السبب: رابط الوسائط غير متاح أو بتنسيق غير مدعوم - الحلول: تحقق من أن الرابط متاح علنًا، تحقق من تنسيق الملف وحدوده، تأكد من استخدام بروتوكول HTTPS عدم عمل المتغيرات - السبب: تنسيق متغير غير صحيح أو القيم مفقودة - الحلول: استخدم التنسيق الصحيح {{1}}, {{2}} في Twilio، عَبئ كل المتغيرات المطلوبة في Chatwoot، تحقق من تطابق عدد المتغيرات مع القالب رسائل الخطأ "لم يتم العثور على القالب" - القالب غير متزامن مع Chatwoot - قم بتشغيل المزامنة اليدوية أو تحقق من اعتماد القالب "ملف الوسائط كبير جدًا" - الملف يتجاوز حدود WhatsApp - اضغط الملف أو استخدم تنسيقًا مختلفًا "معلمات القالب غير صالحة" - قيم المتغيرات مفقودة أو غير صحيحة - راجع وأكمل جميع الحقول المطلوبة أمثلة على القوالب قالب نصي أساسي الاسم: welcome_message المحتوى: "مرحبًا بك في {{1}}! يسعدنا مساعدتك في {{2}}." المتغيرات: اسم الشركة، نوع الخدمة عرض المنتج (قالب وسائط) الاسم: product_launch الوسائط: صورة المنتج المحتوى: "🎉 وصل منتج جديد! {{1}} متوفر الآن بسعر {{2}}. عرض لفترة محدودة!" المتغيرات: اسم المنتج، السعر تأكيد الطلب (قالب نصي) الاسم: order_confirmed المحتوى: "مرحبًا {{1}}! تم تأكيد طلبك {{2}}. متوقع التسليم: {{3}}." المتغيرات: اسم العميل، رقم الطلب، تاريخ التسليم قالب الرد السريع الاسم: support_options المحتوى: "كيف يمكننا مساعدتك اليوم؟" الأزرار: "الدعم الفني"، "الفوترة"، "معلومات عامة" القيود القيود الحالية - القوالب غير مدعومة في الحملات (قادمة في التحديثات المستقبلية) - قوالب منتقي القائمة - قوالب الكتالوج - قوالب الدوارة (كاروسيل) حدود القوالب - حد أقصى 100 متغير لكل قالب - يجب أن تكون ملفات الوسائط متاحة علنًا - تتطلب القوالب موافقة WhatsApp - ترقيم تسلسلي للمعاملات مطلوب الدعم للحصول على مساعدة إضافية: - تصفح مستندات Twilio WhatsApp - راجع إرشادات منصة أعمال WhatsApp - تواصل مع مسؤول النظام لديك في حال وجود مشكلات تقنية - راجع مستندات Chatwoot للحصول على إرشادات عامة للمنصة

قوالب واتساب

قوالب واتساب هي تنسيقات رسائل مُعتمدة مسبقًا تتيح لك بدء المحادثات مع عملائك. وهي ضرورية لإرسال الرسائل الترويجية، وتحديثات الطلبات، وإشعارات الدعم من خلال منصة واتساب للأعمال. ملاحظة: قوالب واتساب مدعومة حاليًا لصناديق واتساب كلاود فقط. ما هي قوالب واتساب؟ قوالب واتساب هي رسائل منظمة يجب أن تتم الموافقة عليها من واتساب قبل أن تتمكن من إرسالها للعملاء. تساعد هذه القوالب على ضمان الامتثال لسياسات المراسلة الخاصة بواتساب مع تمكينك من إرسال اتصالات احترافية ومتسقة. يمكن أن تتضمن القوالب: - رسائل نصية مع متغيرات شخصية - صور، فيديوهات أو مستندات في رأس الرسالة - أزرار إجراء لردود العملاء السريعة - أزرار دعوة لاتخاذ إجراء ترتبط بمواقع إلكترونية أو أرقام هواتف فئات القوالب يقوم واتساب بتنظيم القوالب في فئات مختلفة بناءً على غرضها: - خدمة - رسائل معاملات مثل تأكيد الطلبات والإيصالات - تسويق - محتوى ترويجي وعروض خاصة - تحديث الشحن - تحديثات حالة التسليم والطرد - تحديث التذاكر - إشعارات حالات الدعم - حل المشكلات - متابعات خدمة العملاء ما الذي لا يُدعم قوالب المصادقة - قوالب المصادقة التي تحتوي على رموز OTP ورسائل التحقق - التعبئة التلقائية لمعلمات الأزرار باستخدام رموز OTP - التحقق من رمز OTP والتعامل مع وقت انتهاء الصلاحية العناصر التفاعلية - قوالب القوائم مع خيارات قابلة للتحديد - قوالب المنتجات بدمج الكتالوج - قوالب الكتالوج لتصفح المنتجات - عناصر تحديد متعدد عناصر أذونات الاتصال - قوالب طلب إذن الاتصال التي تتطلب تفعيل واجهة برمجة تطبيقات الاتصال في واتساب - أزرار وعناصر تفاعلية لطلب الإذن بالاتصال عناصر الموقع - رؤوس الموقع مع إحداثيات الخريطة - معلمات العنوان مع خطوط الطول/العرض - قوالب مبنية على الموقع الميزات المتقدمة - تنسيق النص الغني عند إنشاء القالب (يتم الحفاظ عليه أثناء الإرسال) - قوالب السلايدر/العارض ببطاقات متعددة - مكونات النماذج لجمع البيانات - قوالب تكامل الدفع - قوالب التدفق بشرطيات منطقية قوالب تقليدية مقابل القوالب المحسنة يدعم Chatwoot تنسيقين للقوالب لضمان التوافق مع جميع قوالبك الحالية: القوالب التقليدية هذه هي القوالب التقليدية التي تستخدم متغيرات نصية بسيطة. تعمل مع: - الرسائل النصية الأساسية - استبدال متغير بسيط (مثل إدراج اسم العميل) - تفاعلات الأزرار المباشرة مثال على التنسيق التقليدي: { "parameters": ["John Doe", "12345", "2025-01-15"] } ⚠️ هام: سيتم إيقاف دعم القوالب التقليدية في الإصدار v4.7. ننصح بالانتقال إلى القوالب المحسنة لضمان الاستمرارية. القوالب المحسنة يقدم التنسيق المحسن الجديد ميزات أكثر تطورًا: - دعم الوسائط - إرسال الصور، الفيديوهات، والمستندات - متغيرات متقدمة - تخصيص نص أكثر مرونة - أزرار تفاعلية - أزرار الروابط مع روابط ديناميكية، أكواد نسخ وردود سريعة - تحقق أفضل - التحقق الفوري من معلمات القالب مثال على التنسيق المحسن: { "body": { "1": "John Doe", "2": "12345", "3": "2025-01-15" }, "header": { "media_url": "https://example.com/image.jpg", "media_type": "image" }, "buttons": [ { "type": "url", "parameter": "track123" } ] } ملاحظة: جميع قوالبك التقليدية الحالية ستستمر في العمل في الوقت الحالي، ولكن يجب التخطيط للانتقال إلى القوالب المحسنة. الميزات المحسنة متاحة تلقائيًا عند استخدام أنواع القوالب المدعومة. يرجى مراجعة هذا API لمعرفة تنسيقات الطلب. كيفية إنشاء قوالب واتساب حاليًا، يجب إنشاء قوالب واتساب عبر مدير أعمال واتساب: 1. الدخول إلى مدير الأعمال لواتساب - انتقل إلى business.facebook.com 2. الانتقال إلى القوالب - ابحث عن قسم "أدوات الحساب" واختر "قوالب الرسائل" 3. أنشئ قالبًا جديدًا - اضغط على "إنشاء قالب" واختر نوع القالب 4. صمم قالبك - أضف رأسًا، نصًا، تذييلًا وأزرارًا حسب الحاجة 5. أرسل القالب للموافقة - سيقوم واتساب بمراجعة القالب (قد يستغرق ذلك حتى 24 ساعة) 6. المزامنة إلى Chatwoot - بمجرد الموافقة، ستظهر القوالب تلقائيًا أو يمكنك مزامنة القوالب يدويًا عبر صندوق البريد في Chatwoot 🚀 قريبًا: نخطط لإضافة إنشاء القوالب مباشرة في واجهة Chatwoot في إصدار قادم، مما سيسهل تصميم وإدارة قوالبك دون مغادرة Chatwoot. كيفية إرسال قوالب واتساب يمكن إرسال قوالب واتساب بطريقتين: - المحادثات الفردية - إرسال القوالب إلى عملاء محددين أثناء المحادثات - الحملات - إرسال القوالب إلى عدة عملاء دفعة واحدة باستخدام ميزة الحملات في Chatwoot إرسال القوالب في المحادثات الخطوة 1: الوصول إلى خيارات القالب افتح أي محادثة مع جهة اتصال واتساب، اضغط على أيقونة القالب في محرر الرسائل، اختر "قوالب واتساب" من قائمة الخيارات الخطوة 2: اختر قالبك تصفح القوالب المعتمدة، استخدم شريط البحث لإيجاد قوالب معينة بسرعة الخطوة 3: خصص رسالتك اعتمادًا على نوع القالب، قد تحتاج إلى ملء: لقوالب النص: - اسم العميل، رقم الطلب أو أي معلومات شخصية أخرى - أي حقول متغيرة معلمة بـ {{1}}، {{2}}، إلخ. لقوالب الوسائط: - رابط الصورة/الفيديو - قدم رابطًا مباشرًا لملف الوسائط الخاص بك - رابط المستند - روابط لملفات PDF أو Word أو أي مستندات أخرى - يجب أن تكون الوسائط متاحة للجمهور (بدون الحاجة لتسجيل الدخول) لقوالب الأزرار: - معلمات الروابط - روابط ديناميكية لأزرار الدعوة لاتخاذ إجراء - أكواد النسخ - رموز الخصم أو الإحالة - أرقام الهواتف - لأزرار الاتصال المباشر الخطوة 4: المعاينة والإرسال 1. راجع رسالتك في لوحة المعاينة 2. تحقق من تعبئة جميع المتغيرات بشكل صحيح 3. تأكد من أن روابط الوسائط تعمل (إن وُجدت) 4. اضغط على "إرسال القالب" لإرسال رسالتك إرسال القوالب عبر الحملات لإرسال القوالب إلى عدة عملاء دفعة واحدة: انتقل إلى حملات واتساب في لوحة تحكم Chatwoot وأنشئ حملة جديدة واختر واتساب كقناة اختر قالب واتساب من الخيارات المتاحة وضبط جمهورك ومعلمات القالب ملاحظة: تتيح لك وظيفة الحملات الوصول إلى عدة عملاء بكفاءة باستخدام نفس رسالة القالب. الأسئلة المتكررة (FAQ) أسئلة عامة لماذا لا أرى جميع قوالب واتساب الخاصة بي في Chatwoot؟ تظهر فقط القوالب التي تمت الموافقة عليها من واتساب والمدعومة من Chatwoot. يتم تلقائيًا استبعاد أنواع القوالب غير المدعومة (مثل القوالب الخاصة بالمصادقة مع رموز OTP). كم من الوقت يستغرق ظهور القوالب الجديدة في Chatwoot؟ عادةً تتم مزامنة القوالب تلقائيًا بعد وقت قصير ويمكنك أيضًا تحديثها يدويًا من إعدادات صندوق البريد. هل يمكنني تعديل القوالب مباشرة في Chatwoot؟ لا، يجب إنشاء وتعديل القوالب في مدير أعمال واتساب. يُستخدم Chatwoot فقط لإرسال القوالب المعتمدة. لماذا أحتاج لتوفير روابط للصور والفيديوهات؟ يتطلب واتساب استضافة ملفات الوسائط عبر الإنترنت وأن تكون متاحة للجمهور. لا يمكنك رفع الملفات مباشرة - يجب تقديم روابط تعمل لمحتوى الوسائط. هل يمكنني استخدام نفس القالب لعملاء مختلفين؟ نعم! تم تصميم القوالب لإعادة الاستخدام. فقط ضع معلومات عميل مختلفة في كل مرة ترسل فيها القالب. استكشاف الأخطاء وإصلاحها فشل إرسال القالب الخاص بي. ماذا أفعل؟ المشكلات الشائعة تشمل: - متغيرات مفقودة - تأكد من ملء جميع الحقول المطلوبة - روابط وسائط معطلة - تحقق من أن روابط الصور/الفيديو/المستندات تعمل - حجم الملف كبير جدًا - تحقق من مطابقة ملفات الوسائط لحدود حجم واتساب - لم تتم الموافقة على القالب - تحقق من حالة القالب في مدير أعمال واتساب لماذا لا يرى العملاء صوري/فيديوهاتي؟ هذا غالبًا يعني: - أن الرابط غير متاح للجمهور - تنسيق الملف غير مدعوم - الملف كبير جدًا - خادم الاستضافة معطل أو يتطلب مصادقة أزرار الروابط الخاصة بي لا تعمل بشكل صحيح. كيف أحل هذه المشكلة؟ بالنسبة للقوالب التي تحتوي على أزرار روابط ديناميكية، هناك مشاكل مع بعض تكوينات القوالب. جرب استخدام روابط ثابتة بدلاً من المعلمات الديناميكية من أجل أداء أفضل. هل يمكنني إرسال قوالب للعملاء الذين لم يراسلوني أولاً؟ نعم، لكن فقط للفئات التالية من القوالب: - قوالب الخدمة يمكن إرسالها في أي وقت للأغراض المعاملاتية - قوالب التسويق تتطلب موافقة العميل وتخضع لنوافذ إرسال محددة - يجب دائمًا اتباع إرشادات الامتثال الخاصة بواتساب لمنطقتك الوسائط والملفات ما أنواع الملفات التي يمكنني استخدامها في القوالب؟ التنسيقات المدعومة تشمل: - الصورة: JPEG، PNG (أقل من 5 ميجابايت) - الفيديو: MP4، 3GPP (أقل من 16 ميجابايت) - المستندات: PDF، DOC، DOCX، XLS، XLSX، PPT، PPTX، TXT (أقل من 100 ميجابايت) الامتثال والحدود كم عدد القوالب التي يمكنني إرسالها يوميًا؟ هذا يعتمد على حدود حساب واتساب للأعمال وحصص الرسائل الخاصة بك. تواصل مع دعم واتساب لمعرفة الحدود الخاصة بحسابك. هل هناك قيود زمنية على إرسال قوالب التسويق؟ نعم، قوالب التسويق لها نوافذ إرسال خاصة وتتطلب موافقة العملاء. تحقق من سياسات واتساب الحالية لمنطقتك ونوع عملك. ماذا يحدث إذا أرسلت الكثير من الرسائل؟ يراقب واتساب جودة الرسائل ومعدلات التسليم. يمكن أن يؤدي إرسال الكثير من الرسائل غير المرغوب فيها أو غير الناجحة إلى التأثير على حدود الرسائل وحصول القوالب الخاصة بك على الموافقة. تحتاج إلى مزيد من المساعدة؟ إذا كنت تواجه مشاكل لم يتم تناولها في هذا الدليل: 1. تحقق من حالة القالب في مدير أعمال واتساب 2. تأكد من أن روابط الوسائط تعمل ومفتوحة للجمهور 3. اختبر باستخدام بيانات تجريبية قبل الإرسال للعملاء 4. تواصل مع مسؤول Chatwoot لمشاكل تتعلق بالحساب 5. راجع سياسات قوالب واتساب لأسئلة الامتثال تذكر أن قوالب واتساب أداة قوية للتواصل مع العملاء عند استخدامها بشكل صحيح. ركّز على تقديم قيمة لعملائك برسائل ذات صلة وفي الوقت المناسب وتحترم تفضيلاتهم.

كيفية إعداد اتصال WebSocket؟

تُنشئ WebSockets اتصالاً مستمراً بين العميل والخادم، مما يتيح الاتصال ثنائي الاتجاه. يستخدم Chatwoot هذا الاتصال لتوفير التحديثات الفورية حول أحداث المنصة. للاتصال بـ Chatwoot WebSocket، ما عليك سوى تقديم رمز مميز واتباع تعليمات الإعداد الموضحة في هذا الدليل. ملاحظة: هذه الميزة تجريبية، وقد تتغير الوثائق مع كل إصدار. بالإضافة إلى ذلك، لا يمكن ضمان التوافق مع الإصدارات السابقة، لذا من المهم التأكد من أنك تستخدم أحدث إصدار من التطبيق. لماذا يجب أن أستخدم اتصال WebSocket؟ يسمح اتصال WebSocket بتحديثات البيانات في الوقت الفعلي، مما يجعله مثالياً للعملاء مثل حزمة SDK لعملاء Android أو iOS لـ Chatwoot. يساعد ذلك في تحديث لوحة المعلومات دون الحاجة إلى إعادة تحميل الصفحة. وبالتالي، يمكنه تعزيز تجربة المستخدم وتحسين إنتاجية الوكيل. كيف يمكنني إعداد اتصال WebSocket مع Chatwoot؟ لإعداد اتصال WebSocket مع Chatwoot، تحتاج إلى بدء اتصال باستخدام رمز PubSub الخاص بالمصادقة المقدم من Chatwoot. عنوان URL للاتصال هو wss://<your-installation-url>/cable. إذا كنت تستخدم Chatwoot Cloud، يمكنك استخدام wss://app.chatwoot.com/cable كعنوان URL. رمز PubSub هو رمز يُستخدم لمصادقة العميل عند الاتصال بخدمة PubSub (النشر/الاشتراك). يجب على العميل تقديم هذا الرمز للخدمة من أجل إنشاء الاتصال وبدء النشر أو الاشتراك في الرسائل. هناك نوعان من رموز PubSub المتاحة في Chatwoot كما هو موضح أدناه. 1. رمز PubSub للمستخدم: يمتلك هذا الرمز امتيازات الوكيل/المسؤول وسيتلقى جميع الأحداث المدرجة لاحقاً في الصفحة. يمكنك الحصول على رمز PubSub من خلال الاتصال بـ واجهة تعريف الملف الشخصي. 2. رمز PubSub لجهة الاتصال: ينشئ Chatwoot رمز PubSub فريد لكل جلسة لجهة الاتصال. يمكن استخدام هذا الرمز للاتصال بـ WebSocket وتلقي التحديثات الفورية لنفس الجلسة. عند إنشاء جهة اتصال من خلال الواجهات العامة، يتم تضمين pubsub_token في حمولة الاستجابة. يمنح هذا الرمز الوصول فقط للأحداث المتعلقة بالجلسة الحالية مثل conversation.created، conversation.status_changed، message.created، message.updated، conversation_typing_on، conversation_typing_off و presence.update. يرجى الرجوع إلى واجهات برمجة التطبيقات للعميل لبناء تكاملات تفاعلية مع العملاء باستخدام Chatwoot. ملاحظة: قد يتم تحديث هذا الرمز بشكل منتظم حسب نوع التثبيت لديك. يرجى التأكد من أنك تستخدم أحدث رمز. كيف يمكنني الاتصال بـ Chatwoot WebSocket؟ للاتصال بـ Chatwoot WebSocket، استخدم الأمر subscribe وضمن طلب الاتصال أضف pubSubToken، و accountId، و userId (إذا كنت تستخدم رمز المستخدم). فيما يلي مثال على كيفية الاتصال بـ Chatwoot. // أضف دالة مساعدة لتحويل JSON إلى سلسلة نصية const stringify = (payload = {}) => JSON.stringify(payload); const pubSubToken = "<contact/user-pub-sub-token>"; const accountId = "<your-account-id-in-integer>"; const userId = "<user-id-in-integer-if-using-user-token>"; const connection = new WebSocket( "wss://app.chatwoot.com/cable" ); connection.send( stringify({ command: "subscribe", identifier: stringify({ channel: "RoomChannel", pubsub_token: pubSubToken, account_id: accountId, user_id: userId, }), }) ); // السلسلة المتوقعة في connection.send هي بالتنسيق التالي: // {"command":"subscribe","identifier":"{\\"channel\\":\\"RoomChannel\\",\\"pubsub_token\\":\\"your-pubsub-token\\",\\"account_id\\": account_id_integer,\\"user_id\\":user_id_integer }"} نشر الحضور إلى خادم WebSocket للحفاظ على حالة المستخدمين نشطة في Chatwoot، يمكنك إرسال حدث لتحديث الحضور إلى Chatwoot كل 30 ثانية. هذا الإجراء سيبقي حالة الوكيل/جهة الاتصال على الإنترنت. كيف يتم تحديث حالة الحضور لوكيل/مسؤول؟ لتحديث حالة الحضور لوكيل أو مسؤول، أرسل الحمولة التالية إلى الخادم: const userPayload = stringify({ command: "message", identifier: stringify({ channel: "RoomChannel", pubsub_token: "<user-pubsub-token>", account_id: accountId, user_id: userId, }), data: stringify({ action: "update_presence" }), }); connection.send(userPayload); // السلسلة المتوقعة في connection.send هي بالتنسيق التالي: // {"command":"message","identifier":"{\\"channel\\":\\"RoomChannel\\",\\"pubsub_token\\":\\"your-pubsub-token\\",\\"account_id\\": account_id_integer,\\"user_id\\":user_id_integer ","data":"{\\"action\\":\\"update_presence\\"}"} كيف يتم تحديث حالة الحضور لجهة الاتصال؟ لتحديث حالة الحضور لجهة اتصال، أرسل الحمولة التالية إلى الخادم: const agentPayload = stringify({ command: "message", identifier: stringify({ channel: "RoomChannel", pubsub_token: "<user-pubsub-token>", }), data: stringify({ action: "update_presence" }), }); connection.send(agentPayload); // السلسلة المتوقعة في connection.send هي بالتنسيق التالي: // {"command":"message","identifier":"{\\"channel\\":\\"RoomChannel\\",\\"pubsub_token\\":\\"your-pubsub-token\\","data":"{\\"action\\":\\"update_presence\\"}"} حمولة WebSocket الكائنات يمكن أن يحتوي الحدث على أي من الكائنات التالية كحمولة. أنواع الكائنات المدعومة في Chatwoot هي كما يلي. المحادثة سيتم إرجاع الحمولة التالية لمحادثة. { "additional_attributes": { "browser": { "device_name": "string", "browser_name": "string", "platform_name": "string", "browser_version": "string", "platform_version": "string" }, "referer": "string", "initiated_at": { "timestamp": "iso-datetime" } }, "can_reply": "boolean", "channel": "string", "id": "integer", "inbox_id": "integer", "contact_inbox": { "id": "integer", "contact_id": "integer", "inbox_id": "integer", "source_id": "string", "created_at": "datetime", "updated_at": "datetime", "hmac_verified": "boolean" }, "messages": ["Array of message objects"], "meta": { "sender": { // كائن جهة الاتصال }, "assignee": { // كائن المستخدم } }, "status": "string", "unread_count": "integer", "agent_last_seen_at": "unix-timestamp", "contact_last_seen_at": "unix-timestamp", "timestamp": "unix-timestamp", "account_id": "integer" } جهة الاتصال سيتم إرجاع الحمولة التالية لجهة الاتصال. { "additional_attributes": "object", "custom_attributes": "object", "email": "string", "id": "integer", "identifier": "string or null", "name": "string", "phone_number": "string or null", "thumbnail": "string" } المستخدم سيتم إرجاع الحمولة التالية للوكيل/المسؤول. { "id": "integer", "name": "string", "available_name": "string", "avatar_url": "string", "availability_status": "string", "thumbnail": "string" } الرسالة سيتم إرجاع الحمولة التالية لرسالة. { "id": "integer", "content": "string", "account_id": "integer", "inbox_id": "integer", "message_type": "integer", "created_at": "unix-timestamp", "updated_at": "datetime", "private": "boolean", "status": "string", "source_id": "string / null", "content_type": "string", "content_attributes": "object", "sender_type": "string", "sender_id": "integer", "external_source_ids": "object", "sender": { "type": "string - contact/user" // كائن المستخدم أو جهة الاتصال } } الإشعار سيتم إرجاع الحمولة التالية لإشعار. { "id": "integer", "notification_type": "string", "primary_actor_type": "string", "primary_actor_id": "integer", "primary_actor": { "can_reply": "boolean", "channel": "string", "id": "integer", "inbox_id": "integer", "meta": { "assignee": { "id": "integer", "name": "string", "available_name": "string", "avatar_url": "string", "type": "user", "availability_status": "string", "thumbnail": "string" }, "hmac_verified": "boolean" }, "agent_last_seen_at": "unix-timestamp", "contact_last_seen_at": "unix-timestamp", "timestamp": "unix-timestamp", }, "read_at": "unix-timestamp", "secondary_actor": "object/null", "created_at":"unix-timestamp", "account_id": "integer", "push_message_title": "string" } المعرف سيكون لدى كل حدث سمة identifier بالتنسيق التالي. { "identifier": "{\\"channel\\":\\"RoomChannel\\",\\"pubsub_token\\":\\"token\\",\\"account_id\\":id,\\"user_id\\":user_id}" } الرسالة سيحتوي كل حدث على سمة message والتي نُرجِع من خلالها اسم الحدث بالإضافة إلى البيانات المرتبطة به. للاطلاع على قائمة الأحداث، يرجى مراجعة الوثائق أدناه. أنواع الأحداث conversation.created يتم إطلاق هذا الحدث عند بدء محادثة جديدة. إذا كنت مشتركاً في رمز PubSub لجهة الاتصال، فسيتضمن هذا الحدث فقط البيانات المرتبطة بالجلسة المحددة المرتبطة برمز PubSub. متاح لـ: وكيل/مسؤول، جهة اتصال { "message": { "event": "conversation.created", "data": { // كائن المحادثة سيكون متاحاً هنا } } } conversation.read يتم إطلاق هذا الحدث وإرساله إلى الوكلاء/المسؤولين الذين لديهم حق الوصول إلى البريد الوارد، عندما تقوم جهة الاتصال بقراءة رسالة. متاح لـ: وكيل/مسؤول { "message": { "event": "conversation.read", "data": { // كائن المحادثة سيكون متاحاً هنا } } } message.created يتم إطلاق هذا الحدث وإرساله إلى الوكلاء، المسؤولين، وجهات الاتصال عندما يتم إنشاء رسالة جديدة في محادثة لديهم حق الوصول إليها. متاح لـ: وكيل/مسؤول، جهة اتصال { "message": { "event": "message.created", "data": { // كائن الرسالة سيكون متاحاً هنا } } } message.updated يتم إطلاق هذا الحدث وإرساله إلى الوكلاء، المسؤولين، وجهات الاتصال عند تحديث رسالة في محادثة لديهم حق الوصول إليها. متاح لـ: وكيل/مسؤول، جهة اتصال { "message": { "event": "message.updated", "data": { // كائن الرسالة سيكون متاحاً هنا } } } conversation.status_changed يتم إرسال هذا الحدث إلى الوكلاء، المسؤولين، وجهات الاتصال عند تحديث حالة محادثة. متاح لـ: وكيل/مسؤول، جهة اتصال { "message": { "event": "conversation.status_changed", "data": { // كائن المحادثة سيكون متاحاً هنا } } } conversation.typing_on يتم إرسال هذا الحدث إلى الوكلاء، المسؤولين، وجهات الاتصال عند بدء جهة اتصال أو وكيل في كتابة رد. متاح لـ: وكيل/مسؤول، جهة اتصال { "message": { "event": "conversation.typing_on", "data": { "conversation": { // كائن المحادثة سيكون متاحاً هنا }, "user": { // كائن المستخدم – جهة اتصال/وكيل/مسؤول سيكون متاحاً هنا. }, "is_private": "boolean", // يُظهر ما إذا كان الوكيل يكتب ملاحظة خاصة أم لا. "account_id": "integer" } } } conversation.typing_off يتم إرسال هذا الحدث إلى الوكلاء، المسؤولين، وجهات الاتصال عند إنهاء جهة الاتصال أو الوكيل الكتابة. متاح لـ: وكيل/مسؤول، جهة اتصال { "message": { "event": "conversation.typing_off", "data": { "conversation": { // كائن المحادثة سيكون متاحاً هنا }, "user": { // كائن جهة الاتصال / المستخدم سيكون متاحاً هنا. }, "account_id": "integer" } } } assignee.changed يتم إرسال هذا الحدث إلى الوكلاء/المسؤولين الذين لديهم حق الوصول إلى البريد الوارد عند تغيير الوكيل المخصص. متاح لـ: وكيل/مسؤول { "message": { "event": "assignee.changed", "data": { // كائن المحادثة سيكون متاحاً هنا } } } team.changed يتم إرسال هذا الحدث إلى الوكلاء/المسؤولين الذين لديهم حق الوصول إلى البريد الوارد عند تغيير الفريق المخصص. متاح لـ: وكيل/مسؤول { "message": { "event": "team.changed", "data": { // كائن المحادثة سيكون متاحاً هنا } } } conversation.contact_changed يتم إرسال هذا الحدث إلى الوكلاء/المسؤولين عندما يتم دمج جهتي اتصال وجمع جميع محادثاتهم تحت جهة اتصال واحدة. متاح لـ: وكيل/مسؤول { "message": { "event": "conversation.contact_changed", "data": { // كائن المحادثة سيكون متاحاً هنا } } } contact.created يتم إرسال هذا الحدث إلى الوكلاء/المسؤولين عند إنشاء جهة اتصال. متاح لـ: وكيل/مسؤول { "message": { "event": "contact.created", "data": { // كائن جهة الاتصال سيكون متاحاً هنا } } } contact.updated يتم إرسال هذا الحدث إلى الوكلاء/المسؤولين عند تحديث جهة اتصال. متاح لـ: وكيل/مسؤول { "message": { "event": "contact.updated", "data": { // كائن جهة الاتصال سيكون متاحاً هنا } } } presence.update متاح لكل من الوكيل وجهة الاتصال، حيث يوفر هذا الحدث تحديثات فورية حول حالة التوفر للمستخدمين في النظام. الحدث المرسل إلى جهات الاتصال لن يتضمن معلومات عن حالة تواجد جهات الاتصال الأخرى. متاح لـ: وكيل/مسؤول { "message": { "event": "presence.update", "data": { "account_id": "integer", "users": { "user-id": "string" }, "contacts": { "contact-id": "string" } } } } notification_created يتم إرسال هذا الحدث إلى الوكلاء/المسؤولين عند إنشاء إشعار. متاح لـ: وكيل/مسؤول

كيف يمكن إنشاء رسائل تفاعلية؟

يتيح لك Chatwoot إنشاء أنواع رسائل تفاعلية مثل البطاقات والنماذج داخل عنصر واجهة مستخدم الويب Chatwoot باستخدام واجهات برمجة التطبيقات. يمكنك إنشاء هذه الرسائل باستخدام واجهة برمجة تطبيقات الرسالة الجديدة. عينات الحمولة​ استخدم عينات الحمولة التالية كقيم لإنشاء رسائل تفاعلية متنوعة. 1. خيارات​ { "content": "حدد أحد العناصر أدناه", "content_type": "input_select", "content_attributes": { "items": [ { "title": "Option1", "value": "Option 1" }, { "title": "Option2", "value": "Option 2" } ] }, "private":false } 2. نموذج​ { "content": "form", "content_type": "form", "content_attributes": { "items": [ { "name": "email", "placeholder": "يرجى إدخال بريدك الإلكتروني", "type": "email", "label": "البريد الإلكتروني", "default": "xyc@xyc.com" }, { "name": "text_aread", "placeholder": "يرجى إدخال نص", "type": "text_area", "label": "نص كبير", "default": "نص نموذجي" }, { "name": "text", "placeholder": "يرجى إدخال نص", "type": "text", "label": "نص", "default": "إدخال نموذجي" }, { "name": "select", "label": "اختر خيارًا", "type": "select", "options": [ { "label": "🌯 بوريتو", "value": "Burito" }, { "label": "🍝 باستا", "value": "Pasta" } ] } ] }, "private": false } 3. بطاقات​ { "content": "رسالة بطاقة", "content_type":"cards", "content_attributes":{ "items":[ { "media_url":"https://assets.ajio.com/medias/sys_master/root/hdb/h9a/13582024212510/-1117Wx1400H-460345219-white-MODEL.jpg", "title":"حذاء نايك 2.0", "description":"الجري مع حذاء نايك 2.0", "actions":[ { "type":"link", "text":"عرض المزيد", "uri":"google.com" }, { "type":"postback", "text":"إضافة إلى السلة", "payload":"ITEM_SELECTED" } ] } ] }, "private":false } 4. مقالات​ { "content": "مقالات", "content_type": "article", "content_attributes": { "items": [ { "title": "دليل البدء لواجهة برمجة التطبيقات", "description": "دليل عشوائي لبدء واجهة برمجة التطبيقات", "link": "http://google.com" }, { "title": "وثائق التطوير", "description": "وثائق وإرشادات التطوير", "link": "http://google.com" } ] }, "private":false }

كيفية استخدام نماذج ما قبل الدردشة؟

يُستخدم نموذج ما قبل الدردشة لجمع المعلومات حول جهة الاتصال/المحادثة قبل بدء المحادثة. يتوفر نموذج ما قبل الدردشة فقط في الدردشة الحية على الموقع الإلكتروني. كيف تضيف نموذج ما قبل الدردشة؟ الخطوة 1. انتقل إلى الإعدادات → صناديق البريد الوارد. انقر على إعدادات محددة لصندوق بريد الموقع الإلكتروني. الخطوة 2. انتقل إلى علامة تبويب "نموذج ما قبل الدردشة". هناك نوعان من الحقول الممكنة في نموذج ما قبل الدردشة. 1. حقول قياسية: وهي الحقول الأساسية لجهة الاتصال––البريد الإلكتروني، رقم الهاتف، والاسم الكامل. 2. حقول مخصصة: هي الحقول التي يتم إنشاؤها من خلال السمات المخصصة. تعرض إعدادات نموذج ما قبل الدردشة كلاً من الحقول القياسية والمخصصة. يتم شرح الأعمدة في إعدادات نماذج ما قبل الدردشة أدناه. - المفتاح معرف الحقل الفريد - النوع نوع الحقل (نص، قائمة، رقم، تاريخ، رابط، منطقية) - مطلوب ما إذا كان الحقل مطلوبًا أم لا - التسمية التسمية التي ستظهر للزائر على الودجت - العنصر النائب القيمة الافتراضية في الحقل ستظهر جميع الحقول تحت إعدادات نموذج ما قبل الدردشة بشكل افتراضي. سيتمكن المسؤول من القيام بما يلي. - تفعيل/تعطيل الحقول - تغيير ترتيب الحقول - تحديث التسمية/العنصر النائب - تفعيل/تعطيل التحقق خصص نموذج ما قبل الدردشة وفقًا لاحتياجاتك. من أجل إضافة المزيد من الحقول، قم بإضافة المزيد من السمات المخصصة. كيف يبدو نموذج ما قبل الدردشة؟ بمجرد تفعيل نموذج ما قبل الدردشة، سيطلب من عملائك تعبئة نموذج كالذي يظهر أدناه عند بدء محادثة عبر الدردشة الحية. اقرأ أيضاً: نموذج ما قبل الدردشة + الأتمتة = 🚀

كيفية استخدام متغيرات القوالب؟

باستخدام متغيرات القوالب، يمكنك تخصيص رسائلك عن طريق إدخال محتوى ديناميكي موجه لكل مستلم. من خلال إضافة عناصر نائبة في رسائلك، يمكنك بسهولة تخصيص اتصالاتك بمعلومات مثل اسم العميل، رقم الطلب، أو تفاصيل أخرى. على سبيل المثال، إذا أرسلت رسالة مرحبًا {{ contact.name }}، كيف يمكنني مساعدتك؟، سيقوم Chatwoot بسحب اسم جهة الاتصال وإرسال رسالة مثل مرحبًا محمد، كيف يمكنني مساعدتك؟. يمكنك أيضًا استخدام المتغيرات في الردود الجاهزة، والماكرو، والأتمتة. إنشاء متغيرات القالب لاستخدام متغير، اكتب قوسين معقوفين مزدوجين {{ عند كتابة رسالة جديدة أو رد جاهز. ستظهر لك المتغيرات المتاحة، ويمكنك اختيار المتغير الذي ترغب في استخدامه. المتغيرات المتاحة في القالب هي: - conversation.id ~ للنسخة الرقمية من معرف المحادثة. - contact.id ~ للنسخة الرقمية من معرف جهة الاتصال. - contact.name ~ للاسم الكامل لجهة الاتصال. - contact.first_name - contact.last_name - contact.phone_number - agent.name - agent.first_name - agent.last_name - agent.phone_number ماذا يحدث إذا أرسلت متغيرًا غير موجود؟ إذا حاولت إرسال متغير غير معرف، سيقوم Chatwoot بعرض تحذير. كيف تضيف نصًا بديلاً عند الفشل؟ إذا تعذر على النظام تعبئة متغير معرف، يمكن استخدام نص بديل ليحل محل القيمة المقصودة. على سبيل المثال، إذا تعذر تعبئة المتغير contact.first_name، يمكن أن يكون النص البديل المناسب هو "عزيزي". عند تحديد نص بديل، تأكد من إحاطته بعلامتي اقتباس مفردتين. إليك مثال: {{ contact.first_name || 'عزيزي'}}.

المشكلات الشائعة في واتساب وكيفية حلها

رسائل واتساب لا تصل على الرغم من أن كل شيء يبدو متصلاً الأعراض - تم توصيل قناة واتساب بنجاح - حالة رقم الهاتف تظهر متصل - تقييم الجودة أخضر - لا تظهر أي أخطاء في شاتووت - قد تعمل الرسائل الصادرة، لكن الرسائل الواردة لا تصل سبب حدوث ذلك في بعض الحالات، تطلب ميتا أن يتم تسجيل رقم واتساب مرة أخرى، حتى وإن كان يظهر متصلاً وبحالة جيدة. عادة ما يحدث هذا بعد: - تغيير اسم العرض - تحديثات ملف تعريف النشاط التجاري - بعض مشاكل المزامنة الداخلية من جهة ميتا عندما يحدث ذلك، قد تتوقف رسائل واتساب عن الوصول بصمت دون ظهور أخطاء واضحة. هذا سلوك معروف من ميتا. كيف يتم إصلاحه إعادة تسجيل رقم واتساب سيحل المشكلة فورًا (يرجى التواصل معنا في الدعم وسنقوم بحلها لك) - لا حاجة لتغيير الخطة - لا حاجة لتغيير webhooks - في معظم الحالات، لا حاجة إلى رمز تحقق جديد بمجرد إعادة تسجيل الرقم، ستعود الرسائل للعمل بشكل طبيعي. مشاكل حالة اسم العرض (قيد الانتظار / مرفوض / غير معتمد) ما هو اسم العرض؟ اسم العرض هو الاسم التجاري الذي يظهر للعملاء على واتساب. ميتا تراجع وتوافق على هذا الاسم قبل أن يصبح نشطًا. حالات اسم العرض الشائعة - معتمد – كل شيء جيد ولا حاجة لأي إجراء - قيد الانتظار – ميتا تقوم بمراجعة الاسم - مرفوض – الاسم لم يستوفِ إرشادات ميتا لماذا مشاكل اسم العرض مهمة - رفض اسم العرض أو بقاؤه قيد الانتظار قد يؤخر عملية التفعيل - تغيير اسم العرض قد يتطلب إعادة تسجيل رقم الهاتف - قد تفشل الرسائل أو تتوقف إذا لم تكتمل عملية التسجيل بعد الموافقة الأسباب الشائعة للرفض - الاسم لا يطابق الاسم التجاري في مدير أعمال ميتا - استخدام كلمات عامة (مثلاً: “دعم”، “رسمي”، “خدمة”) - استخدام الرموز التعبيرية، رموز أو أحرف كبيرة بالكامل - عدم التطابق بين اسم العلامة التجارية وبين الموقع/النطاق أفضل الممارسات لأسماء العرض - استخدم اسمك التجاري أو اسم العلامة التجارية الرسمي - طابق الاسم المستخدم في موقعك ومدير أعمال ميتا - تجنب الرموز التعبيرية، الشعارات، أو الأوصاف الزائدة - اجعل الاسم بسيطًا ومتناسقًا مع هوية علامتك التجارية ملاحظة مهمة بعد الموافقة على اسم العرض، قد تطلب ميتا تسجيل الرقم مرة أخرى ليتم تفعيل التغيير بالكامل. إذا توقفت رسائل واتساب عن العمل بعد تحديث اسم العرض، فإن إعادة تسجيل الرقم غالبًا ستحل المشكلة. خطأ واتساب 131049 – المستخدم لم يقبل شروط خدمة واتساب ما هو الخطأ 131049؟ يعني الخطأ 131049 أن المستلم لم يقبل شروط خدمة واتساب المحدثة. يتم إرجاع هذا الخطأ من قبل واتساب، وليس شاتووت، وهو مرتبط برقم هاتف العميل، وليس بإعدادات نشاطك التجاري. متى يظهر هذا الخطأ؟ قد يظهر الخطأ 131049 عندما: - ترسل رسالة إلى مستخدم لم يفتح واتساب مؤخرًا - تم إصدار شروط خدمة محدثة من قبل واتساب - لم يقم المستخدم بقبول الشروط الجديدة في تطبيق واتساب الخاص به في هذه الحالة، يقوم واتساب بحظر تسليم الرسائل لذلك المستخدم حتى يقبل الشروط. سبب حدوث ذلك يتطلب واتساب من جميع المستخدمين قبول شروط الخدمة المحدثة قبل أن يتمكنوا من: - استقبال الرسائل من الأعمال التجارية - المشاركة في المحادثات مع الشركات حتى يقبل المستخدم الشروط، سيقوم واتساب برفض الرسائل بخطأ 131049. كيفية إصلاح الخطأ 131049 هذا الخطأ لا يمكن إصلاحه من شاتووت أو حساب واتساب للأعمال الخاص بك. يجب على المستخدم النهائي أن: 1. يفتح تطبيق واتساب الخاص به 2. يقبل طلب شروط الخدمة المحدثة بمجرد أن يقبل المستخدم الشروط، ستبدأ الرسائل في الوصول تلقائيًا — لا حاجة لإعادة المحاولة أو تغيير أي إعدادات.

كيفية استخدام وحدات الماكرو؟

الماكرو هو مجموعة من الإجراءات المتسلسلة المحفوظة، مثل تصنيف محادثة، إرسال نسخة من البريد الإلكتروني، إرسال مرفق، وما إلى ذلك، والتي يمكنك تعريفها من خلال لوحة التحكم الخاصة بك. بصفتك وكيل دعم، ستجد أنك تحتاج إلى تكرار نفس مجموعة الإجراءات كثيرًا. وإليك مثال: كلما استقبلت طلب تجربة، تقوم بتعيين فريق المبيعات، إرسال رسالة موحدة حول كيفية حجز موعد، إضافة تصنيف المبيعات، وتفعيل خاصية الغفوة للمحادثة. أو، كلما استقبلت رسائل غير مرغوب فيها (سبام)، تقوم بإرسال نفس الرسالة عن أنهم وصلوا إلى المكان الخطأ، وتضيف تصنيف سبام، وتغلق المحادثة. تنفيذ كل تلك الإجراءات واحدة تلو الأخرى، ولعدة مرات في اليوم، قد يكون أمرًا مرهقًا ويستغرق كثيرًا من الوقت. بدلاً من ذلك، يمكنك تشغيل ماكرو. يشرح هذا الدليل، مع أمثلة، كيفية إنشاء وحدات ماكرو – سواء شخصية أو عامة – وكيفية استخدامها. كيف تنشئ ماكرو؟ الخطوة 1. انتقل إلى الإعدادات -> وحدات الماكرو -> "إضافة ماكرو جديد". الخطوة 2. ستظهر أمامك شاشة إعداد الماكرو. هنا، يمكنك إنشاء تسلسل من الإجراءات التي يجب تنفيذها عند تشغيل هذا الماكرو. يمكنك أيضًا تسمية الماكرو للرجوع الداخلي إليه في الشريط الجانبي الأيمن. يمكنك البدء بتحديد إجراء من القائمة المنسدلة. الإجراءات المتوفرة حاليًا معروضة أدناه. اختر إجراء وقم بإعداده حسب الحاجة. عند الانتهاء، واصل بإضافة المزيد من الإجراءات. مثال على إعداد ماكرو هذا مثال على الإجراءات المتسلسلة التي يتم تنفيذها دائمًا عندما يستقبل فريق Paper Layer استفسارًا من عميل ضمن الخطة المجانية. يرجى ملاحظة أن ترتيب الإجراءات التي تحددها هو ترتيب تنفيذها بالضبط. الخطوة 3. حدد مدى إتاحة الماكرو. إذا كنت تنشئه للاستخدام الشخصي، اختر "خاص". إذا كنت تريد أن يتمكن فريقك من استخدامه، حدد الإتاحة كـ "عام". الخطوة 4. انقر على زر "حفظ الماكرو" الموجود أسفل يمين صفحة الإعداد. الآن أصبح الماكرو جاهزًا للاستخدام! كيف تنفذ ماكرو؟ الخطوة 1. حدد قسم "وحدات الماكرو" في الشريط الجانبي الأيمن من نافذة الدردشة لديك. انقر على علامة الزائد لتوسيعه. سيُظهر لك قائمة وحدات الماكرو المُنشأة لحسابك – سواء الخاصة بك أو العامة. الخطوة 2. عاين الماكرو إذا لم تكن متأكدًا من ما سيفعله. للمعاينة، انقر على أيقونة "i". ستظهر لك معاينة للإجراءات المحددة في ذلك الماكرو. الخطوة 3. نفذ الماكرو بالنقر على زر التشغيل. سيقوم تلقائيًا بتنفيذ جميع الإجراءات بالتسلسل المحدد في أقل من ثانية. ستتمكن من رؤية رسائل نجاح للإجراءات المختلفة. وإليك مثال: كيف تعدل أو تحذف ماكرو؟ لتعديل أو حذف وحدات الماكرو، افتح قائمة وحدات الماكرو من خلال زيارة الإعدادات -> وحدات الماكرو. ابحث عن الماكرو المطلوب واستخدم زر التعديل أو الحذف المناسب كما هو موضح في الصورة أدناه.

سياسات المهام المتقدمة

نظرة عامة تقدم المهمة المتقدمة نظام تعيين محادثات قائم على السياسات بشكل شامل. يتيح ذلك إدارة مركزية، وخوارزميات متقدمة، وضوابط سعة بمستوى المؤسسات. توفر الميزات - المصدر المفتوح: سياسات التعيين مع خوارزمية التناوب الدائري - المؤسسات والأعمال: جميع ميزات المصدر المفتوح بالإضافة إلى التعيين المتوازن وإدارة سعة الوكلاء المفاهيم الأساسية سياسات التعيين سياسات التعيين هي قواعد مركزية تتحكم في كيفية تعيين المحادثات تلقائيًا للوكلاء. كل سياسة تحدد: - ترتيب التعيين: كيفية اختيار الوكلاء (تناوب دائري أو متوازن) - أولوية المحادثة: أي المحادثات يتم تعيينها أولاً - التوزيع العادل: الحد من معدل التعيين لمنع تحميل زائد على الوكلاء سياسات سعة الوكيل (المؤسسات) تحدد سياسات السعة حدود المحادثات لكل وكيل مع مستوى تفصيلي حسب البريد الوارد وقواعد تصفية متقدمة. سياسات التعيين إنشاء سياسات التعيين 1. انتقل إلى الإعدادات → تعيين الوكيل → سياسة التعيين 2. انقر على إنشاء سياسة تعيين 3. قم بإعداد ما يلي: الإعداد الأساسي - الاسم: معرف فريد للسياسة - الوصف: وصف اختياري للسياسة - مفعلة: تبديل تفعيل السياسة إعدادات التعيين - ترتيب التعيين: - تناوب دائري: يقوم بالدوران على الوكلاء المتاحين بالتسلسل (المصدر المفتوح والمؤسسات) - متوازن: يوزع بناءً على عبء العمل الحالي وتعيين متساوي (للمؤسسات فقط) - أولوية المحادثة: - الأقدم إنشاءً: تعيين أقدم المحادثات أولاً - الأطول انتظاراً: إعطاء الأولوية للمحادثات ذات أوقات الانتظار الأطول - التوزيع العادل: - الحد: الحد الأقصى لعدد المحادثات لكل وكيل ضمن نافذة زمنية (الافتراضي: 100) - النافذة: فترة زمنية بالثواني للحد من معدل التعيين (الافتراضي: 3600) ربط السياسات مع صناديق البريد الوارد 1. انتقل إلى الإعدادات → تعيين الوكلاء 2. حرر سياسة 3. أضف صندوق بريد وارد إدارة سعة الوكيل (المؤسسات) إنشاء سياسات السعة 1. انتقل إلى الإعدادات → سياسة التعيين → السعة 2. انقر على إنشاء سياسة سعة 3. قم بإعداد ما يلي: 1. الإعدادات الأساسية 1. الاسم: معرف السياسة 2. الوصف: وصف اختياري 2. حدود السعة لصندوق البريد 1. لكل صندوق بريد، حدد: 2. حد المحادثة: الحد الأقصى للمحادثات المفتوحة لكل وكيل 3. قواعد الاستثناء (تكوين JSON) 1. التسميات المستثناة: لن يتم تعيين المحادثات التي تحمل هذه التسميات تلقائيًا 2. حد العمر: استبعاد المحادثات الأقدم من عدد الساعات المحدد تعيين سياسات السعة للوكلاء 1. انتقل إلى سياسة التعيين → سياسة سعة الوكيل 2. اختر سياسة سعة وكيل 3. أضف حدود السعة لصناديق البريد 4. عيّن الوكلاء للسياسة خوارزميات التعيين التناوب الدائري (المصدر المفتوح و المؤسسات) يدور بين الوكلاء المتاحين بالتسلسل، لضمان توزيع متساوٍ مع مرور الوقت. التعيين المتوازن (المؤسسات) يقوم بتوزيع المحادثات بذكاء بناءً على: - عبء عمل الوكيل الحالي - التوزيع المتساوي استكشاف الأخطاء وإصلاحها المشاكل الشائعة عدم تعيين المحادثات - التأكد من تفعيل سياسة التعيين وربطها بصندوق البريد - التحقق من توفر الوكلاء وأنهم متصلون - التأكد من عدم تجاوز الوكلاء لحدود السعة (المؤسسات) - مراجعة قواعد الاستثناء وعدم تصفية المحادثات غير المرغوب فيها التوزيع غير المتساوي - مراجعة إعدادات التوزيع العادل - التفكير في التبديل إلى التعيين المتوازن (المؤسسات) - التحقق من أنماط توفر الوكلاء خطوات التصحيح 1. فحص تكوين سياسة التعيين 2. التأكد من ربط صندوق البريد بالسياسة 3. مراجعة إعدادات سعة الوكيل (المؤسسات) 4. مراقبة سجلات خدمة التعيين 5. التحقق من حالة توفر الوكيل يوفر Assignment V2 حلاً قويًا وقابلًا للتوسع لإدارة المحادثات ينمو مع احتياجات مؤسستك مع الحفاظ على توزيع عبء العمل الأمثل على الوكلاء

كيف تستخدم الحملات؟

ميزة الحملات هي وسيلة لإرسال رسائل صادرة إلى عملائك. هناك نوعان من الحملات في Chatwoot: I. الحملات المستمرة يمكنك استخدام الحملات المستمرة لإرسال رسائل صادرة بشكل متكرر عبر دردشة الموقع المباشرة. يمكنك تعيين شروط محددة تقوم بتفعيل هذه الرسائل، مثل عندما يقضي المستخدم وقتًا معينًا على صفحة محددة. من خلال إرسال هذه الرسائل، يمكنك زيادة احتمالية التحويلات وإبقاء المحادثة مستمرة مع عملائك المحتملين. II. الحملات الفردية (لمرة واحدة) يمكنك استخدام الحملات الفردية لإرسال حملة رسائل SMS إلى مجموعة من جهات الاتصال. هذه طريقة فعالة للوصول إلى العديد من العملاء دفعة واحدة وإجراء الإعلانات أو الترويج لمنتجاتك/خدماتك أو عروض معينة. كيف يمكنك إنشاء حملة مستمرة؟ الخطوة 1. انقر على تبويب "الحملات" في الشريط الجانبي. اختر "مستمرة" -> زر "إنشاء حملة مستمرة". الخطوة 2. ستظهر لك نافذة منبثقة حيث يمكنك إدخال تفاصيل الحملة. فيما يلي مثال على إنشاء حملة لصفحة الأسعار: شرح الحقول الظاهرة في النموذج كما يلي: 1. العنوان سم الحملة الخاصة بك للرجوع إليها داخليًا. 2. الرسالة اكتب رسالتك الصادرة. هذه هي الرسالة التي سيشاهدها عملاؤك عند تفعيل الحملة. 3. تحديد صندوق البريد حدد صندوق بريد موقعك الإلكتروني من القائمة المنسدلة. 4. يرسل بواسطة يمكنك إرسال الرسائل الصادرة إما بواسطة روبوت أو وكيل. اختر الخيار المناسب لك. 5. الرابط أدخل رابط الصفحة التي يجب أن تُفعل فيها هذه الحملة. ملاحظة هامة: يمكنك أيضًا إدخال الروابط العامة لتشغيل الحملة على النطاقات الفرعية أو الدلائل الفرعية. راجع هذا الدليل لمعرفة المزيد حول إنشاء نمط الروابط العامة. 6. الوقت على الصفحة (بالثواني) كم ثانية يجب أن يقضيها الزائر على الرابط المحدد قبل تفعيل الحملة؟ 7. تفعيل الحملة يُظهر هذا الخيار ما إذا كانت الحملة مفعلة أم لا. الخطوة 3. جرب الحملة. قم بزيارة الرابط المحدد في الحملة وانتظر المدة الزمنية المضبوطة. كيف يمكنك إنشاء حملة فردية (لمرة واحدة)؟ الخطوة 1. انقر على تبويب "الحملات" في الشريط الجانبي. اختر "لمرة واحدة" -> زر "إنشاء حملة لمرة واحدة". الخطوة 2. ستظهر لك نافذة منبثقة حيث يمكنك إدخال تفاصيل الحملة. شرح الحقول الظاهرة في النموذج كما يلي: 1. العنوان سم الحملة الخاصة بك للرجوع إليها داخليًا. 2. الرسالة اكتب رسالة SMS التي سيتم إرسالها للعملاء. 3. تحديد صندوق البريد حدد صندوق البريد الخاص برسائل SMS من القائمة المنسدلة. 4. الجمهور يمكنك إرسال هذه الحملة إلى جهات الاتصال الخاصة بك المصنفة ضمن تسمية محددة. 5. الوقت المجدول حدد وقت تنفيذ الحملة. بعد تعبئة الحقول، اضغط على زر "إنشاء". ستظهر الحملة في صفحة الحملات الفردية الخاصة بك. كيف يمكنك تعديل أو حذف الحملات؟ لتعديل أو حذف الحملات، افتح قائمة الحملات من خلال الذهاب إلى "الحملات" -> اختيار نوع الحملة. قم بالتمرير أفقيًا للعثور على خيارات التعديل والحذف.