القنوات الأخرى

كيف تقوم بإعداد قناة على إنستغرام؟

إذا كنت تستخدم تثبيت Chatwoot مستضاف ذاتيًا، يرجى إعداد تطبيق Instagram الخاص بك كما هو موضح في هذا الدليل. بالنسبة لإصدار السحابة من Chatwoot، يرجى اتباع هذا الدليل. المتطلبات الأساسية قبل إضافة صندوق وارد Instagram إلى Chatwoot، يجب التأكد من أن لديك حساب Instagram للأعمال. قم بإعداد حساب Instagram للأعمال إذا لم يكن لديك واحد. سيساعدك هذا الدليل من Instagram في القيام بذلك. كيف تنشئ صندوق وارد Instagram في Chatwoot؟ الخطوة 1. انتقل إلى الإعدادات ← الصناديق الواردة → "إضافة صندوق وارد". الخطوة 2. انقر على زر "المتابعة مع Instagram". الخطوة 3. فعّل خيار "الوصول وإدارة الرسائل" ثم انقر على زر السماح للمتابعة في عملية التفويض الخطوة 5. "أضف الوكلاء" إلى صندوق وارد Instagram الخاص بك. لقد أنشأت بنجاح صندوق وارد Instagram. في كل مرة يرسل فيها عميل رسالة إلى حساب Instagram الخاص بك، ستتمكن من رؤيتها والرد عليها في Chatwoot.

كيفية إعداد قناة على لاين؟

الخطوة 1. انتقل إلى الإعدادات → صناديق الوارد → "إضافة صندوق وارد". الخطوة 2. انقر على أيقونة "Line". الخطوة 3. انتقل إلى وحدة مطوري Line وأنشئ حساب Line. الخطوة 4. أنشئ "موفر خدمة" في وحدة المطورين. أنشئ قناة "Messaging API" جديدة (بوت) تحت الموفر. الخطوة 5. املأ الحقول التالية من وحدة مطوري Line (قناة Messaging API) ثم انقر على "إنشاء قناة LINE". 1. اسم القناة 2. معرف قناة LINE 3. سر قناة LINE 4. رمز قناة LINE الخطوة 6. "أضف الوكلاء" إلى صندوق وارد Line الخاص بك. تم الانتهاء من إعداد صندوق الوارد. الخطوة 7. انتقل إلى قناة "Messaging API" في وحدة المطور وقم بإعداد Webhook. 1. تحقق من رابط Webhook الخاص بـ Chatwoot 2. فعّل خيار "استخدام Webhook" الخطوة 8. اختبر صندوق وارد Line الجديد الخاص بك. أرسل رسالة إلى بوت Line. تحقق من صندوق وارد Line في Chatwoot للرسالة الجديدة.

كيفية إعداد قناة على إنستغرام (عبر تسجيل الدخول بفيسبوك)؟

نوصي بتسجيل دخول الأعمال على إنستجرام كطريقة المصادقة المفضلة، حيث يوفر إعدادًا أبسط وتجربة أفضل للمطورين. يرجى الرجوع إلى هذا الدليل لمزيد من التفاصيل. سنوقف دعم إنستجرام عبر تسجيل الدخول إلى فيسبوك في المستقبل بدءًا من الإصدار 4.1 فصاعدًا. إذا كنت تستخدم تثبيت Chatwoot ذاتي الاستضافة، يرجى إعداد تطبيق إنستجرام الخاص بك كما هو موضح في هذا الدليل. بالنسبة لإصدار Chatwoot السحابي، يرجى اتباع هذا الدليل. المتطلبات الأساسية قبل ربط صندوق إنستجرام الخاص بك بـ Chatwoot، يجب التأكد من أن لديك حساب إنستجرام للأعمال. الخطوة 1. أنشئ حساب إنستجرام للأعمال إذا لم يكن لديك واحد. سيساعدك هذا الدليل من إنستجرام في ذلك. الخطوة 2. تأكد من أن صفحتك على فيسبوك متصلة بهذا الحساب على إنستجرام. لربط فيسبوك بإنستجرام، اتبع الخطوات التالية: 1. انتقل إلى https://www.facebook.com/pages/?category=your_pages. 2. اختر صفحتك. 3. انتقل إلى الإعدادات. 4. اختر "إنستجرام" وقم بتوصيل حساب أعمالك كما هو موضح أدناه: الآن عد إلى تطبيق Chatwoot. كيفية إنشاء صندوق إنستجرام في Chatwoot؟ الخطوة 1. انتقل إلى الإعدادات → الصناديق → "إضافة صندوق". الخطوة 2. اضغط على أيقونة "ماسنجر". الخطوة 3. اضغط على زر تسجيل الدخول إلى فيسبوك. سيفتح نافذة جديدة لتسجيل الدخول. الخطوة 4. صادق باستخدام فيسبوك، اختر حساب إنستجرام واختر الصفحة التي تريد ربطها. فعّل جميع الأذونات الظاهرة في القائمة. سيساعد ذلك Chatwoot في تنفيذ جميع الإجراءات المطلوبة بسلاسة. الخطوة 5. "أضف العملاء" إلى صندوق إنستجرام الخاص بك. لقد أنشأت بنجاح صندوق إنستجرام. في كل مرة يرسل فيها عميل رسالة إلى حسابك على إنستجرام، ستتمكن من رؤيتها والرد عليها في Chatwoot.

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

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

كيف يمكن إعداد قناة الرسائل النصية القصيرة (SMS)؟

يمكنك إعداد صندوق وارد قناة الرسائل النصية القصيرة من خلال مزودين اثنين: 1. تويليو 2. باندويدث إنشاء صندوق وارد للرسائل النصية اتبع الخطوات أدناه. الخطوة 1. افتح لوحة تحكم Chatwoot الخاصة بك. اذهب إلى الإعدادات → الصناديق الواردة → إضافة صندوق وارد. الخطوة 2. انقر على أيقونة "SMS". الخطوة 3. اختر مزود واجهة برمجة التطبيقات الخاص بك وقم بتكوين الصندوق الوارد. سيتم شرح كلا الخيارين أدناه. اختيار "تويليو" كمزود لواجهة برمجة التطبيقات إذا كنت ترغب في استخدام تويليو لإعداد صندوق وارد للرسائل النصية، اختره من القائمة المنسدلة. سيعرض الحقول المطلوبة كما هو موضح أدناه. هذه هي المدخلات المطلوبة لإنشاء هذه القناة: انقر على Create Twilio Channel بعد إدخال المعلومات. تهيئة Chatwoot مع Twilio Studio​ إذا كنت تستخدم Twilio Studio لتدفق محادثة مخصص، فإن تحديث عنوان الـ webhook مباشرة سيؤدي إلى كسر التكامل الحالي لديك. في هذه الحالات، يمكنك الانتقال إلى قسم "Twilio Studio" في هذا الدليل. اختيار "باندويدث" كمزود لواجهة برمجة التطبيقات إذا كنت ترغب في استخدام باندويدث لإعداد صندوق وارد للرسائل النصية، اختره من القائمة المنسدلة. سيعرض الحقول المطلوبة كما هو موضح أدناه. انقر على Create Bandwidth Channel بعد إدخال المعلومات. بعد الانتهاء من هذه الخطوة، تابع بإضافة الوكلاء. الخطوة 4. "أضف وكلاء" إلى صندوقك الوارد. لقد قمت بإنشاء صندوق وارد للرسائل النصية بنجاح. ستبدأ بتلقي الرسائل على لوحة تحكم Chatwoot الخاصة بك. انظر أيضًا: إرسال حملة رسائل نصية إلى مجموعة من جهات الاتصال.

كيفية إعداد قناة على فيسبوك؟

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

مزامنة قوالب واتساب باستخدام رمز إدارة الأعمال

إذا لم يتمكن Chatwoot من جلب أحدث قوالب الرسائل من حساب WhatsApp Business الخاص بك، يمكنك تزويد صندوق البريد المتأثر برمز إدارة أعمال Meta. هذه الميزة متاحة فقط على Chatwoot Cloud لصناديق بريد WhatsApp التي تم إنشاؤها من خلال التسجيل المضمّن، بما في ذلك صناديق بريد التعايش مع تطبيق WhatsApp Business. وهي غير متاحة لصناديق بريد WhatsApp المُعدة يدوياً. لماذا يحتاج Chatwoot إلى هذا الرمز؟ يستخدم Chatwoot عادة بيانات الاعتماد التي تم إنشاؤها أثناء إعداد WhatsApp لمزامنة قوالب الرسائل. في بعض الحالات، قد تسمح هذه البيانات بالرسائل الواردة والصادرة بينما لم تعد تملك الإذن لقراءة أو إدارة أصول أعمال WhatsApp. يوفر رمز إدارة الأعمال الإذن الإضافي whatsapp_business_management المطلوب لجلب القوالب من حساب WhatsApp Business. يستخدم Chatwoot هذا الرمز فقط لمزامنة القوالب. ولا يُستخدم من أجل: - إرسال أو استقبال رسائل WhatsApp - تسليم webhook - تسجيل رقم الهاتف - تغيير حساب WhatsApp Business الخاص بك - إدارة محفظة أعمال Meta الخاصة بك قبل أن تبدأ تأكد من أنك: - مسؤول في محفظة أعمال Meta التي تملك حساب WhatsApp Business. - يمكنك الوصول إلى حساب WhatsApp Business المتأثر في إعدادات أعمال Meta. - لدى عملك تطبيق Meta مرتبط بذلك الحساب في WhatsApp. - أنت مسؤول في حساب Chatwoot. - تم إنشاء صندوق البريد باستخدام التسجيل المضمّن لـ WhatsApp على Chatwoot Cloud. اعتبر الرمز ككلمة مرور. لا ترسله عبر البريد الإلكتروني أو الدردشة أو محادثات الدعم. يمكن لمسؤولي حساب Chatwoot عرض ونسخ الرمز المحفوظ من علامة تبويب الإعدادات في صندوق البريد. قلل من وصول المسؤولين واعتبر هذا الرمز بيانات اعتماد حساسة. الخطوة 1: إنشاء أو اختيار مستخدم نظام 1. افتح إعدادات أعمال Meta. 2. اختر محفظة الأعمال التي تملك حساب WhatsApp Business. 3. انتقل إلى المستخدمون → مستخدمو النظام. 4. اختر مستخدم نظام إداري موجود. إذا لم يكن لديك واحد: 1. انقر إضافة. 2. أدخل اسماً مميزاً، مثل مزامنة قوالب Chatwoot. 3. اختر مسؤول كدور مستخدم النظام. 4. انقر إنشاء مستخدم نظام. استخدم مستخدم نظام مخصص عندما يكون ذلك ممكنًا. هذا يسهل عملية تدوير أو إبطال الرمز دون التأثير على عمليات التكامل الأخرى. الخطوة 2: إسناد حساب WhatsApp Business يجب أن يكون لدى مستخدم النظام حق الوصول إلى نفس حساب WhatsApp Business المستخدم في صندوق بريد Chatwoot الخاص بك. 1. اختر مستخدم النظام. 2. افتح الأصول المسندة. 3. انقر إسناد الأصول. 4. اختر حسابات WhatsApp. 5. اختر حساب WhatsApp Business المتصل بـ Chatwoot. 6. امنحه إذن إدارة الحساب أو فعّل التحكم الكامل. 7. احفظ التغييرات. خصص فقط حساب WhatsApp Business المتأثر. تجنب منح حق الوصول إلى أصول أعمال غير ذات صلة. الخطوة 3: توليد الرمز 1. اختر مستخدم النظام. 2. انقر توليد رمز. 3. اختر تطبيق Meta المرتبط بحساب WhatsApp Business الخاص بك. 4. انقر التالي. الخطوة 4: اختيار فترة انتهاء الصلاحية قد تعرض Meta خيارات مثل: - 60 يومًا: أكثر أمانًا، ولكن يجب عليك استبدال الرمز عند انتهاء صلاحيته. - أبدًا: يقلل من الصيانة التشغيلية، لكنه يتطلب تخزينًا آمنًا وتدويرًا يدويًا. اختر الخيار الذي يتبع سياسة الأمان في منظمتك. حتى رمز غير منتهي الصلاحية قد يتوقف عن العمل إذا تم تغيير أو إبطال مستخدم النظام أو التطبيق أو الإذن أو علاقة العمل أو الأصول. الخطوة 5: اختيار الإذن المطلوب اختر: - whatsapp_business_management هذا هو الإذن الذي يتحقق منه Chatwoot ويستخدمه لمزامنة قوالب الرسائل. لا تحتاج إلى اختيار whatsapp_business_messaging أو whatsapp_business_manage_events لهذا الرمز الخاص بمزامنة القوالب. إذا كان whatsapp_business_management غير متوفر، تحقق من أن: - التطبيق المختار لديه WhatsApp مُكوّن. - لدى مستخدم النظام حق الوصول إلى التطبيق. - تم إسناد حساب WhatsApp Business لمستخدم النظام. - عملك وتطبيقك يحققان متطلبات وصول Meta. الخطوة 6: نسخ الرمز 1. أكمل عملية توليد الرمز. 2. انقر نسخ. 3. خزّن الرمز مؤقتًا في مدير كلمات مرور آمن أو خزينة الأسرار. قد تعرض Meta الرمز الكامل مرة واحدة فقط. الخطوة 7: إضافة الرمز إلى Chatwoot 1. في Chatwoot، انتقل إلى الإعدادات → صناديق البريد. 2. اختر صندوق بريد WhatsApp المتأثر. 3. افتح علامة تبويب الإعدادات. 4. ابحث عن تحديث رمز إدارة الأعمال. 5. الصق الرمز. 6. انقر تحديث. يتحقق Chatwoot من أن الرمز يحتوي على إذن whatsapp_business_management الممنوح قبل حفظه. بعد حفظ الرمز، انقر مزامنة القوالب. يجب أن تظهر قوالب WhatsApp المعتمدة لديك بعد اكتمال المزامنة. لاستبدال الرمز، أنشئ رمزًا جديدًا في إعدادات أعمال Meta وادخله في نفس حقل إعدادات Chatwoot. سيستخدم Chatwoot الرمز الجديد لمزامنة القوالب المستقبلية. سيؤدي إبطال الرمز المحفوظ في Meta دون استبداله في Chatwoot إلى فشل مزامنة القوالب. استكشاف الأخطاء وإصلاحها الرمز لا يحتوي على الإذن المطلوب تأكد من أنه تم اختيار ومنح إذن whatsapp_business_management عند توليد الرمز. لا تملك حق الوصول إلى هذا الحقل ربما لا يملك مستخدم النظام حق الوصول إلى حساب WhatsApp Business المستهدف، أو قد لا يكون التطبيق المختار مخولًا له. أعد التحقق من الأصول المسندة إلى مستخدم النظام وعلاقته بالتطبيق. الرمز غير صالح أو لا يمكن التحقق منه قد يكون الرمز قد انتهت صلاحيته أو تم إبطاله أو تم توليده لتطبيق أو عمل مختلف. أنشئ رمزًا جديدًا وحاول مرة أخرى. تم قبول الرمز، ولكن لا يمكن مزامنة القوالب تحقق من أن: - لدى مستخدم النظام حق الوصول إلى نفس حساب WhatsApp Business المستخدم في صندوق البريد. - معرف حساب الأعمال المُكوّن في Chatwoot صحيح. - القوالب موجودة في حساب WhatsApp Business ذاك. - لم يتم حذف القوالب أو نقلها إلى حساب آخر. قد يكون الإذن صالحًا ولكن لا يزال الوصول إلى أصول WhatsApp المحددة مفقودًا. الرسائل تعمل، لكن مزامنة القوالب تفشل تستخدم عمليات الرسائل وإدارة الأعمال أذونات مختلفة. يمكن أن تظل بيانات الاعتماد ترسل وتستقبل الرسائل بينما تفتقر إلى القدرة على جلب القوالب.

كيف يمكن إنشاء صندوق وارد لقناة واجهة برمجة التطبيقات (API)؟

لإنشاء وتكوين صندوق بريد قناة API في تثبيتات Chatwoot، اتبع الخطوات الموضحة أدناه. إعداد قناة API الخطوة 1. انتقل إلى الإعدادات → صناديق البريد → "إضافة صندوق بريد". الخطوة 2. انقر على أيقونة "API". الخطوة 3. أدخل اسماً للقناة و رابط Callback. فيما يلي مثال: الخطوة 4. "أضف الوكلاء" إلى صندوق بريد API الخاص بك. تم الانتهاء من إعداد صندوق البريد. إرسال الرسائل إلى قناة API لإرسال رسائل إلى قناة API، تأكد من فهمك للنماذج والمصطلحات التالية المستخدمة في Chatwoot. 1. القناة: القناة تحدد نوع مصدر المحادثات. مثل: فيسبوك، تويتر، API، إلخ. 2. صندوق البريد: يمكنك إنشاء مصادر متعددة للمحادثات من نفس نوع القناة. على سبيل المثال: يمكنك ربط أكثر من صفحة فيسبوك بحساب Chatwoot واحد. كل صفحة تعتبر صندوق بريد في Chatwoot. 3. المحادثة: المحادثة هي مجموعة من الرسائل. 4. جهة الاتصال: كل محادثة مرتبطة بشخص حقيقي يسمى جهة اتصال. 5. صناديق جهات الاتصال: هذه هي الجلسة لكل جهة اتصال في صندوق بريد معين. يمكن لجهة الاتصال أن يكون لديها عدة جلسات وعدة محادثات في نفس صندوق البريد. كيف ترسل رسالة في قناة API؟ لإرسال رسالة في قناة API، قم بإنشاء جهة اتصال، وابدأ محادثة، ثم أرسل الرسالة. تتطلب واجهات برمجة التطبيقات api_access_token في ترويسة الطلب. يمكنك الحصول على هذا الرمز من خلال زيارة إعدادات الملف الشخصي → رمز الوصول. 1. إنشاء جهة اتصال مرجع: توثيق API مرر معرف صندوق بريد قناة API مع المعلمات الأخرى المحددة. هذا سيقوم بإنشاء جلسة لك تلقائيًا. سيكون رد العينة كالتالي: { "email": "string", "name": "string", "phone_number": "string", "thumbnail": "string", "additional_attributes": {}, "contact_inboxes": [ { "source_id": "string", "inbox": { "id": 0, "name": "string", "website_url": "string", "channel_type": "string", "avatar_url": "string", "widget_color": "string", "website_token": "string", "enable_auto_assignment": true, "web_widget_script": "string", "welcome_title": "string", "welcome_tagline": "string", "greeting_enabled": true, "greeting_message": "string" } } ], "id": 0, "availability_status": "string" } كما ترى في الحمولة، ستتمكن من مشاهدة الـ contact_inboxes وكل contact_inbox سيحتوي على source_id. معرف المصدر هذا يمكن اعتباره معرف الجلسة. ستستخدم هذا الـsource_id لإنشاء محادثة جديدة كما هو موضح أدناه. 2. إنشاء محادثة مرجع: توثيق API استخدم الـ source_id الذي تم استلامه في طلب API السابق. ستحصل على معرف محادثة يمكن استخدامه لإنشاء رسالة. { "id": 0 } 3. إنشاء رسالة جديدة مرجع: توثيق API هناك نوعان من الرسائل: 1. واردة: الرسائل المرسلة من قبل المستخدم النهائي تصنف كرسالة واردة. 2. صادرة: الرسائل المرسلة من قبل الوكيل تصنف كرسالة صادرة. إذا قمت باستدعاء API بالمحتوى الصحيح، سوف تستلم حمولة مماثلة لما يلي: { "id": 0, "content": "This is a incoming message from API Channel", "inbox_id": 0, "conversation_id": 0, "message_type": 0, "content_type": null, "content_attributes": {}, "created_at": 0, "private": false, "sender": { "id": 0, "name": "Pranav", "type": "contact" } } إذا تم كل شيء بنجاح، سترى المحادثة على لوحة المعلومات كما يلي. سيتم إعلامك عندما يتم إنشاء رسالة جديدة على الرابط الذي حددته أثناء إنشاء قناة API. يمكنك قراءة المزيد عن حمولة الرسالة هنا. استلام الرسائل باستخدام رابط Callback عند إنشاء رسالة جديدة في قناة API، ستتلقى طلب POST إلى رابط Callback المحدد أثناء إنشاء قناة API. ستكون الحمولة كالتالي. اعثر على القائمة الكاملة للأحداث المدعومة من webhook هنا. نوع الحدث: message_created { "id": 0, "content": "This is a incoming message from API Channel", "created_at": "2020-08-30T15:43:04.000Z", "message_type": "incoming", "content_type": null, "content_attributes": {}, "source_id": null, "sender": { "id": 0, "name": "contact-name", "avatar": "", "type": "contact" }, "inbox": { "id": 0, "name": "API Channel" }, "conversation": { "additional_attributes": null, "channel": "Channel::Api", "id": 0, "inbox_id": 0, "status": "open", "agent_last_seen_at": 0, "contact_last_seen_at": 0, "timestamp": 0 }, "account": { "id": 1, "name": "API testing" }, "event": "message_created" } إنشاء واجهات باستخدام API العميل واجهات API المتوفرة لقناة API ستساعدك في بناء واجهات مخصصة للعملاء لبرنامج Chatwoot. هذه الـ APIs مفيدة للحالات كالتالي: 1. استخدام واجهة دردشة مخصصة بدلاً من عنصر دردشة Chatwoot. 2. بناء واجهات محادثة ضمن تطبيقات الموبايل الخاصة بك. 3. إضافة Chatwoot إلى منصات أخرى لا يتوفر لها SDK رسمي من Chatwoot. إنشاء كائنات العملاء يمكنك إنشاء واسترجاع بيانات العملاء باستخدام inbox_identifier و customer_identifier. معرف صندوق البريد يمكنك الحصول على inbox_identifier من قناة API الخاصة بك -> الإعدادات -> التكوين. معرف العميل يمكن الحصول على customer_identifier أو source_id عند إنشاء العميل باستخدام  create API. ستحتاج إلى تخزين هذا المعرف في جانب العميل لديك لإجراء طلبات لاحقة نيابة عن العميل. يمكن تنفيذ ذلك في ملفات الكوكيز أو التخزين المحلي وما إلى ذلك. APIs المتوفرة تم توثيق واجهات API المتوفرة للعملاء هنا. بعض المهام التي يمكنك القيام بها باستخدام هذه الواجهات: - إنشاء، عرض وتحديث جهة اتصال - إنشاء وعرض المحادثات - إنشاء، عرض وتحديث الرسائل مصادقة HMAC تدعم واجهات API للعميل أيضًا مصادقة HMAC. يمكن الحصول على رمز HMAC للقناة عبر تنفيذ الأمر التالي في سطر أوامر Rails الخاص بك. # استبدل api_inbox_id بمعرف صندوق بريدك Inbox.find(api_inbox_id).channel.hmac_token الاتصال بـ WebSockets الخاصة بـ Chatwoot للحصول على التحديثات الفورية من لوحة تحكم الوكيل، اتصل بـ WebSockets الخاصة بـ Chatwoot باستخدام الرابط التالي. <your installation url>/cable مصادقة اتصال WebSocket الخاص بك بعد الاشتراك باستخدام pubsub_token الخاص بالعميل، ستستقبل الأحداث الموجهة إلى كائن العميل الخاص بك. يتم توفير pubsub_token أثناء استدعاء API لإنشاء العميل. مثال const connection = new WebSocket('ws://localhost:3000/cable'); connection.send(JSON.stringify({ command:"subscribe", identifier: "{\\"channel\\":\\"RoomChannel\\",\\"pubsub_token\\":\\""+ customer_pubsub_token+"\\"}" })); اعثر على القائمة الكاملة للأحداث المدعومة على WebSockets هنا. تحقق من Webhook عند إنشاء قناة API، نقوم تلقائيًا بإنشاء مفتاح سري يمكنك استخدامه للتحقق من الحمولة التي تستقبلها تطبيقك. يمكنك قراءة المزيد حول التحقق من Webhook هنا. التنفيذ إليك مثال على واجهة محادثة تم بناؤها فوق واجهات برمجة التطبيقات الخاصة بالعميل.

كيفية إعداد قناة البريد الإلكتروني؟

لإدارة بريد الدعم الفني/تذاكر العملاء في Chatwoot، يمكنك إنشاء صندوق بريد إلكتروني في Chatwoot. هذا دليل شامل لتشغيل قناة البريد الإلكتروني الخاصة بك. تم تقسيم هذا الدليل إلى ثلاثة أجزاء: 1. إنشاء صندوق بريد إلكتروني 2. إعدادات لمستخدمي Gmail 3. إنشاء صندوق بريد إلكتروني من Microsoft يمكنك الانتقال لأي قسم تريده. هيا بنا نبدأ. كيفية إنشاء صندوق بريد إلكتروني في Chatwoot؟ الخطوة 1. افتح لوحة تحكم Chatwoot الخاصة بك. انتقل إلى الإعدادات → صناديق البريد → إضافة صندوق بريد. الخطوة 2. اضغط على أيقونة "البريد الإلكتروني". الخطوة 3. أدخل اسم القناة (الاسم الذي ترغب في استخدامه لهذه القناة) وبريد الدعم الخاص بك، ثم اضغط على زر "إنشاء قناة بريد إلكتروني". ملاحظة: سترى خياراً لاختيار Microsoft كمزود بريد إلكتروني. إذا كنت تستخدم بريد Outlook/Microsoft، انتقل إلى قسم "كيفية إنشاء قناة بريد إلكتروني من Microsoft؟" (آخر قسم). الخطوة 4. "أضف العملاء" إلى صندوق البريد الإلكتروني الخاص بك. لقد تم إنشاء صندوق البريد الإلكتروني بنجاح. الخطوة 5. قم بتهيئة إعدادات البريد الإلكتروني. انتقل إلى الإعدادات → صناديق البريد → إعدادات صندوق البريد الإلكتروني → علامة التبويب "الإعداد". سترى هنا ثلاثة إعدادات رئيسية: 1. إعادة التوجيه للبريد الإلكتروني 2. إعداد IMAP 3. إعداد SMTP جميع هذه الإعدادات مشروحة في الأقسام التالية. كيف تقوم بإعادة توجيه البريد إلى صندوق بريد Chatwoot؟ الخطوة 1. انسخ "عنوان البريد الإلكتروني لإعادة التوجيه" من علامة تبويب الإعداد ضمن إعدادات البريد الوارد. الخطوة 2. قم بتهيئة عنوان البريد المنسوخ كعنوان إعادة توجيه في صندوق البريد الإلكتروني. ملاحظة: راجع قسم Gmail أدناه لمعرفة كيفية إضافة عنوان إعادة توجيه في Gmail. الخطوة 3. أرسل رسالة إلى عنوان إعادة التوجيه المضاف وتحقق من البريد الوارد في Chatwoot للبريد الجديد. كيف تقوم بإعداد IMAP لقناة البريد الإلكتروني؟ إذا كنت تستخدم Gmail، انتقل لأسفل إلى قسم IMAP الخاص بـ Gmail أدناه. الخطوة 1. انتقل إلى الإعدادات → صناديق البريد → إعدادات صندوق البريد الإلكتروني → علامة تبويب الإعداد. الخطوة 2. حدد خانة التحقق تفعيل ضبط IMAP لهذا البريد الوارد. ستظهر لك الخانات المطلوبة كما يلي. 1. العنوان 2. المنفذ 3. البريد الإلكتروني 4. كلمة المرور ملاحظة: إذا كنت تستخدم بريد Gmail مفعل به المصادقة الثنائية، انتقل إلى قسم "كيفية توليد كلمة مرور تطبيق في Gmail؟"؛ إذا كنت تستخدم حساب Gmail عادي، انتقل إلى قسم "كيفية السماح بالوصول الأقل أماناً إلى Gmail؟". الخطوة 3. اختبر إذا كان كل شيء يعمل بشكل جيد. أرسل رسالة إلكترونية إلى البريد المهيأ عبر IMAP في Chatwoot. تحقق من البريد الوارد في Chatwoot للبريد الجديد. افتح المحادثة البريدية في Chatwoot وتحقق من تفاصيل الرسالة. كيف تقوم بإعداد SMTP لقناة البريد الإلكتروني؟ الخطوة 1. انتقل إلى الإعدادات -> صناديق البريد -> صفحة إعدادات صندوق البريد الإلكتروني. الخطوة 2. حدد علامة تبويب "الإعداد". الخطوة 3. لتفعيل SMTP، اختر خانة "تفعيل ضبط SMTP لهذا البريد الوارد". املأ الحقول التالية واضغط على زر "تحديث إعدادات SMTP". 1. العنوان 2. المنفذ 3. البريد الإلكتروني 4. كلمة المرور ملاحظة: إذا كنت تستخدم بريد Gmail مفعل به المصادقة الثنائية، انتقل إلى قسم "كيفية توليد كلمة مرور تطبيق في Gmail؟"؛ إذا كنت تستخدم حساب Gmail عادي، انتقل إلى قسم "كيفية السماح بالوصول الأقل أماناً إلى Gmail؟". 5. النطاق الخطوة 4. افتح محادثة بريد إلكتروني قائمة في Chatwoot. الخطوة 5. اكتب رسالة رد على المحادثة واضغط على زر "إرسال". تحقق من أن الرسالة قد تم تسليمها. يمكنك أيضاً التحقق من بريد المستلم للتأكد من وصول الرسالة. إعدادات لمستخدمي Gmail كيفية تفعيل IMAP لصندوق بريد Gmail؟ الخطوة 1. افتح بريدك في Gmail واضغط على أيقونة الإعدادات في الزاوية العليا اليمنى. اضغط زر "عرض جميع الإعدادات". الخطوة 2. اختر علامة التبويب "إعادة التوجيه وPOP/IMAP" في صفحة الإعدادات. الخطوة 3. اختر خيار "تفعيل IMAP" ضمن قسم الوصول لـIMAP واضغط على زر "حفظ التغييرات". كيفية السماح بالوصول الأقل أماناً إلى Gmail؟ ملاحظة: هذا الخيار غير متاح لحسابات Gmail التي بها تحقق خطوتين أو التي تتم إدارتها من قبل مؤسسة. الخطوة 1. انتقل إلى أمان حساب Google. الخطوة 2. اضغط على "تفعيل الوصول" ضمن قسم "الوصول للتطبيقات الأقل أماناً" في صفحة الأمان. الخطوة 3. قم بتفعيل "السماح للتطبيقات الأقل أماناً" إلى "تشغيل". الآن يمكنك استخدام كلمة مرور حساب Gmail الخاص بك لضبط IMAP/SMTP. كيفية توليد كلمة مرور تطبيق في Gmail؟ ملاحظة: هذا الخيار خاص بحسابات Gmail التي بها تحقق خطوتين أو التي تتم إدارتها من قبل مؤسسة. الخطوة 1. انتقل إلى أمان حساب Google. الخطوة 2. اضغط على "كلمات مرور التطبيقات" ضمن قسم "تسجيل الدخول إلى Google" في صفحة الأمان. الخطوة 3. اختر تطبيق البريد الإلكتروني، وحدد الجهاز، واضغط على "إصدار". استخدم كلمة المرور المولدة لضبط IMAP/SMTP. كيفية إضافة عنوان إعادة توجيه لـGmail؟ الخطوة 1. افتح بريدك في Gmail واضغط على أيقونة الإعدادات في الزاوية العليا اليمنى. اضغط زر "عرض جميع الإعدادات". الخطوة 2. اختر علامة التبويب "إعادة التوجيه وPOP/IMAP" في صفحة الإعدادات. الخطوة 3. اضغط على زر "إضافة عنوان إعادة توجيه". سيطلب منك إدخال عنوان البريد الإلكتروني لإعادة التوجيه. أدخل العنوان من Chatwoot ثم اضغط على زر "التالي". الخطوة 4. قم بتأكيد عنوان إعادة التوجيه في النافذة المنبثقة للمتصفح. سيرسل صندوق البريد الإلكتروني رمز تحقق إلى عنوان البريد الإلكتروني لإعادة التوجيه. الخطوة 5. انسخ رمز التحقق من البريد الوارد الخاص بـ Chatwoot. الخطوة 6. الصق رمز التحقق واضغط على زر "تأكيد". الخطوة 7. اختر خيار "إعادة توجيه نسخة من البريد الوارد". اختر الإجراء المطلوب من القائمة المنسدلة الثانية واضغط على زر "حفظ التغييرات". كيفية إنشاء قناة بريد إلكتروني من Microsoft؟ الخطوة 1. افتح لوحة تحكم Chatwoot الخاصة بك. انتقل إلى الإعدادات → صناديق البريد → إضافة صندوق بريد. الخطوة 2. اضغط على أيقونة "البريد الإلكتروني". الخطوة 3. اضغط على أيقونة "Microsoft". الخطوة 4. أضف بريد Outlook/Microsoft الخاص بك. الخطوة 5. أدخل بيانات اعتماد Microsoft/Outlook الخاصة بك. الخطوة 6. اسمح لتطبيق "Chatwoot" بقراءة بريدك الإلكتروني والرد عليه. الخطوة 7. "أضف العملاء" إلى البريد الإلكتروني الوارد الخاص بك. لقد تم إنشاء صندوق بريد Microsoft بنجاح. الخطوة 5. قم بتهيئة إعدادات البريد الإلكتروني. انتقل إلى الإعدادات → صناديق البريد → إعدادات صندوق البريد الإلكتروني → علامة التبويب "الإعداد". ملاحظة: يرجى عدم تغيير أي شيء في الإعدادات حالياً، فقد استخدمنا القيم الافتراضية لـ IMAP و SMTP. قريباً سنجعل هذه الحقول غير قابلة للتعديل لحسابات Outlook. نستخدم إعدادات IMAP الافتراضية لجلب الرسائل وSMTP للإرسال؛ لا تحتاج لضبط أي شيء من خلال الإعداد. الخطوة 6. إذا انتهت صلاحية رمز الدخول الخاص بك، يجب عليك إعادة مصادقة حساب Microsoft الخاص بك من خلال الذهاب إلى الإعدادات -> الإعداد.

كيفية إنشاء قناة على تيليجرام؟

الخطوة 1. انتقل إلى الإعدادات → صناديق الوارد → "إضافة صندوق وارد". الخطوة 2. انقر على أيقونة "تيليجرام". الخطوة 3. أنشئ بوت تيليجرام جديد باستخدام BotFather. الخطوة 4. أدخل رمز API الخاص ببوت تيليجرام وانقر على "إنشاء قناة تيليجرام". الخطوة 5. "أضف الوكلاء" إلى صندوق الوارد الخاص بك في تيليجرام. تم الانتهاء من إعداد صندوق الوارد. الخطوة 6. انتقل إلى صفحة إعدادات صندوق الوارد وتأكد من أن اسم صندوق الوارد يطابق اسم المستخدم للبوت الذي تم إنشاؤه باستخدام BotFather. الخطوة 7. أرسل رسالة إلى بوت تيليجرام. تحقق من صندوق الوارد في Chatwoot للرسالة الجديدة. الأسئلة الشائعة هل يدعم Chatwoot حسابات بوت تيليجرام للأعمال؟ نعم — تمت إضافة دعم بوتات تيليجرام بوضع الأعمال في Chatwoot إصدار v4.3.0 (18 يونيو 2025). كيف يمكن تفعيل بوتات الأعمال؟ 1. في @BotFather قم بتشغيل /business_mode، اختر البوت الخاص بك، وأكّد العملية. 2. أنشئ صندوق وارد جديد في تيليجرام داخل Chatwoot (الإعدادات → صناديق الوارد → إضافة صندوق وارد → تيليجرام) والصق رمز البوت نفسه. 3. سيكشف Chatwoot تلقائيًا وضع الأعمال ويسجّل الوِب هوك الصحيح. 4. للحصول على أفضل النتائج، احتفظ بهذا البوت المخصص للأعمال في صندوق وارد منفصل، بعيدًا عن أي بوت عادي تستخدمه بالفعل.  المشاكل المعروفة مع بوت الأعمال • نافذة الرد لمدة 24 ساعة – تيليجرام يسمح للبوت (و Chatwoot) بالرد فقط خلال 24 ساعة من آخر رسالة للعميل.  • إذا كان المستخدم قد تواصل مسبقًا مع نفس البوت خارج وضع الأعمال، قد تظهر الردود وكأنها صادرة من البوت بدلاً من حساب الأعمال؛ إنشاء بوت للأعمال وصندوق بريد خاص به يمنع هذا الالتباس. • واجهة برمجة تطبيقات تيليجرام للأعمال لديها ميزات أقل حاليًا مقارنة بواجهة بوت العادية (مثل: لا توجد مؤشرات كتابة، أنواع رسائل محدودة). يفضل ضبط توقعاتك بناءً على ذلك.

كيفية إنشاء قناة على تيك توك؟

إذا كنت تستخدم تثبيت Chatwoot المستضاف ذاتيًا، يرجى إعداد تطبيق TikTok الخاص بك كما هو موضح في هذا الدليل. بالنسبة لإصدار Chatwoot السحابي، يرجى اتباع هذا الدليل. المتطلبات الأساسية قبل إعداد قناة TikTok، تأكد من ما يلي: 1. لديك حساب أعمال على TikTok مسجل في منطقة مؤهلة. 2. تم ضبط حساب TikTok للأعمال على قبول الرسائل المباشرة من الجميع. وإلا، ستحتاج إلى قبول الرسائل يدويًا في تطبيق TikTok. تعرّف على كيفية تحديث إعدادات الرسائل إعداد قناة TikTok الخطوة 1: الانتقال إلى صناديق البريد اذهب إلى الإعدادات > صناديق البريد ثم انقر على إضافة صندوق بريد. اختر TikTok من قائمة القنوات المتاحة. الخطوة 2: ربط حساب TikTok الخاص بك انقر على المتابعة مع TikTok للبدء في عملية المصادقة. الخطوة 4: منح الصلاحيات لتطبيق Chatwoot سيتم توجيهك إلى TikTok. راجع الأذونات المطلوبة ثم انقر على متابعة لمنح الصلاحية لـ Chatwoot للوصول إلى حساب TikTok للأعمال الخاص بك. الخطوة 5: إضافة الوكلاء بعد منح الصلاحية، سيتم إعادتك إلى Chatwoot. قم بإضافة الوكلاء إلى صندوق بريد TikTok حتى يتمكنوا من مشاهدة الرسائل والرد عليها. الآن تم ربط قناة TikTok الخاصة بك. ستظهر الرسائل المباشرة الواردة من TikTok في لوحة تحكم Chatwoot لديك. قيود الرسائل - يجب على العملاء بدء المحادثة، لا يمكن للشركات إرسال الرسائل أولاً. - يمكن للوكلاء إرسال ما يصل إلى 10 رسائل قبل أن يرد العميل. بمجرد رد العميل، تصبح الرسائل غير محدودة. - نافذة الرد هي 48 ساعة من آخر رسالة للعميل. - فقط رسائل النص والصور ومشاركة المنشورات مدعومة حاليًا بسبب قيود واجهة برمجة تطبيقات رسائل الأعمال من TikTok. - سيتم مزامنة الرسائل المرسلة مباشرة من تطبيق TikTok إلى Chatwoot. - الرسائل المستلمة بتنسيقات غير مدعومة (مثل الصوت، الملصقات) ستظهر كـ "هذه الرسالة غير مدعومة. يمكنك عرض هذه الرسالة على تطبيق TikTok." الأسئلة الشائعة لماذا لا يمكنني إرسال رسائل وسائط إلى بعض مستخدمي TikTok؟ يحدث هذا بسبب قيود من TikTok. بعض المناطق لا تسمح بإرسال أو استقبال الصور، وفي حالات أخرى قد يكون حساب المستخدم تم الإبلاغ عنه من قِبل TikTok. ما هي الدول التي تدعم رسائل أعمال TikTok؟ واجهة برمجة تطبيقات رسائل أعمال TikTok غير متوفرة حاليًا في المنطقة الاقتصادية الأوروبية (EEA)، أو سويسرا، أو المملكة المتحدة. قد تكون ميزات الرسائل محدودة أو غير متوفرة للمستخدمين في هذه المناطق. لأحدث المناطق المدعومة والقيود، يرجى الرجوع إلى التوثيق الرسمي الخاص بـ TikTok. التوافر خدمة TikTok متاحة على كل من الخطط السحابية والمستضافة ذاتيًا.