القنوات

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

القناة	طريقة الربط	يستطيع الوكيل البدء بالكتابة	المرفقات
البريد الإلكتروني	SendGrid أو Resend أو Postmark أو Custom SMTP، مع webhook الوارد لدى المزوّد	نعم	25 MB
الدردشة المباشرة (الويدجت)	سكربت على موقعك	نعم	10 MB
Telegram	رمز البوت	لا	نعم
WhatsApp	حساب Meta Business	القوالب فقط	نعم
نموذج ويب	التسويق ← النماذج	لا	نعم
الهاتف	مزوّدك أو الاتصالات الهاتفية المدمجة	نعم	-

تظهر Messenger وInstagram وViber والرسائل النصية SMS ثنائية الاتجاه كبطاقات قريبًا.

البريد الإلكتروني

اختر خدمة البريد الإلكتروني التي ترسل بريدك وتستقبله: SendGrid أو Resend أو Postmark أو Custom SMTP (أي خادم بريد آخر: المضيف والمنفذ والتشفير واسم الدخول وكلمة المرور). تُربط الثلاثة الأولى بمفتاح API. حدّد اسم المرسل وعنوانه وعنوان Reply-To اختياريًا.

يصل البريد الوارد إلى RolChat عبر webhook الوارد لدى المزوّد. تعرض القناة عنوان webhook جاهزًا: انسخه بنفسك إلى المزوّد، ولن يصل شيء قبل أن يعرفه المزوّد. يثبت سرّ أن البريد قادم من مزوّدك: مع Postmark أضِفه إلى العنوان على هيئة ?token=<secret>؛ ومع Resend الصق سر التوقيع من صفحة webhook لديه.

التسلسل: الرد على بريد الوكيل ينضم إلى المحادثة الموجودة وفق ترويساته؛ والرد خلال 30 يومًا من الحل يعيد فتحها؛ أما الردود الأقدم والمواضيع الجديدة فتبدأ محادثة جديدة. يُعرض بريد HTML في عرض مقروء مع مفتاح لعرض المصدر؛ وتُحفظ عناوين CC.

ويدجت الدردشة المباشرة

زر عائم واحد تتبع محتوياته الوحدات المفعّلة: الدردشة، وطلب معاودة الاتصال، وحجز اجتماع، وترك طلب، والبحث في قاعدة المعرفة. التثبيت موضح في صفحة ثبّت الويدجت.

إعدادات كل موقع في الإعدادات ← الويدجت: الألوان، والموضع، والتحية، ونقاط الدخول، والصورة الرمزية، واللغة الافتراضية، والسلوك خارج التواجد، وتفعيل المرفقات أو تعطيلها، وساعات العمل. يُعرَّف الزوار حسب الجلسة؛ ويربط window.rolchat.identify() الجلسة بجهة اتصال. يتبع الويدجت لغة متصفح الزائر (40 لغة، ومن اليمين إلى اليسار للعربية والعبرية) ويستوفي WCAG 2.1 AA. حزمة التحميل الأول صغيرة عمدًا كي لا تضر بسرعة صفحاتك.

يسجّل كل حساب بوته الخاص عبر @BotFather ويلصق الرمز. يتحقق RolChat منه ويسجّل الـ webhook. ردود البوت على /start و/help قابلة للتعديل. تحصل جهات الاتصال على اسم Telegram وصورته الرمزية؛ وتصل الصور والفيديو والمستندات والرسائل الصوتية والملصقات. يمكن ربط عدة بوتات. لا يسمح Telegram للوكيل بالبدء بالكتابة.

اربط عبر الربط مع Meta: اختر الحساب التجاري وحساب WhatsApp Business ورقم الهاتف؛ ويُسجَّل الـ webhook تلقائيًا. لا يمكن ربط الرقم الواحد إلا بنظام واحد.

تنطبق قواعد Meta: الردود النصية الحرة خلال 24 ساعة من آخر رسالة للعميل، ورسائل القوالب المعتمدة بعد ذلك. تُدار القوالب في الإعدادات ← القنوات ← WhatsApp ← القوالب (الاسم، والفئة، واللغة، والنص مع متغيرات {{1}})، وتُرسل إلى Meta وتُزامن حالة اعتمادها. تظهر حالات التسليم (مُرسلة، مُسلَّمة، مقروءة) على الرسائل. تُحل محادثات WhatsApp تلقائيًا بعد 20 ساعة كي تبقى إعادة الفتح داخل النافذة.

نماذج الويب

تُبنى نماذج العملاء المحتملين ونماذج الحجز في التسويق ← النماذج وتُضمَّن داخل الصفحة أو كنافذة منبثقة أو كرابط. يُنشئ الإرسال عميلًا محتملًا (وتذكرة اختياريًا)؛ ويُنشئ الحجز اجتماعًا وعميلًا محتملًا. راجع التسويق.

الهاتف

RolChat طبقة برمجية: تأتي بمزوّد اتصالات من سوق يضم 21 محوّلًا (Twilio وTelnyx وBandwidth وVonage وSinch وPlivo وMessageBird وDatagroup وغيرها)، أو تربط أي خط SIP من مشغّل محلي، أو تستخدم الأرقام المدمجة في RolChat والمحتسبة في فاتورتك. تصبح المكالمات محادثات بقيمة channel = phone. كل ما عدا ذلك موجود في دليل الهاتف.

حالات حدّية يستحسن معرفتها

صندوق وارد معطّل: تُرفض الرسائل الجديدة على تلك القناة أو توضع في قائمة الانتظار (قابل للضبط)؛ وتبقى المحادثات الموجودة.
العميل نفسه يكتب على Telegram بينما توجد محادثة WhatsApp مفتوحة: محادثتان، واحدة لكل قناة. ادمجهما يدويًا عند الحاجة.
فشل التحقق من توقيع webhook من مزوّد: يُسقط التسليم ويُسجَّل ويخضع لحد المعدل؛ ولا يصل شيء إلى صندوق الوارد.