ربط القنوات

JackAI Nexus يدعم أربع قنوات رسائل تتيح لك جذب العملاء أينما يفضلون التواصل. يغطي هذا الدليل كيفية دمج كل قناة وفهم الميزات الأساسية مثل نافذة الرسائل لمدة 24 ساعة وقوالب WhatsApp.

نظرة عامة: القنوات المدعومة

Nexus توحد المحادثات من هذه القنوات الأربع:

يمكنك ربط قنوات متعددة بمنظمة Nexus واحدة. يتم تنظيم المحادثات تلقائياً حسب المنصة في صندوق الوارد.

إعداد تكامل

تتم إضافة كل قناة كـ Integration في Nexus. العملية الأساسية متشابهة للجميع:

1. اذهب إلى Integrations في الشريط الجانبي
2. انقر على + Add Integration
3. حدد قناتك (WhatsApp أو Messenger أو Instagram أو Web Chat)
4. اتبع خطوات الإعداد الخاصة بالقناة (انظر الأقسام أدناه)
5. المصادقة مع بيانات اعتماد حسابك
6. فعّل التكامل لبدء استقبال المحادثات

بمجرد التفعيل ستبدأ في استقبال المحادثات من تلك القناة على الفور.

تكامل WhatsApp

WhatsApp هي واحدة من أكثر القنوات شهرة للتفاعل مع العملاء. Nexus يدعم خياري WhatsApp: واتساب للأعمال (Meta)، وهو Cloud API الرسمي، وواتساب (QR)، أي الرقم الذي تستخدمه الآن مربوطاً بمسح رمز QR.

الخيار 1: واتساب للأعمال (Meta) — Cloud API الرسمي

🎬 شاهد فيديو الشرح على YouTube ↗ (دقيقة ونصف، بالعربية)

API الرسمي من Meta لرسائل حساب WhatsApp Business.

متى يتم الاستخدام:

• تريد الدعم الرسمي والأمان من Meta
• تحتاج إلى قوالب WhatsApp للرسائل الجماعية — الحملات الجماعية تعمل على Cloud API فقط
• تريد نافذة رسائل لمدة 24 ساعة مفروضة (معيار الصناعة)
• يعمل عملك عالمياً

قبل أن تبدأ — تجهيز حساب Meta (مرة واحدة):

1. أنشئ حساب أعمال (Business Portfolio) على business.facebook.com إن لم يكن لديك واحد
2. أنشئ تطبيقاً على developers.facebook.com من النوع Business، ثم أضف إليه منتج WhatsApp
3. أضف رقم هاتفك في صفحة API Setup ووثّقه برمز التحقق — الرقم يجب ألا يكون مستخدماً في تطبيق واتساب العادي
4. أنشئ System User من إعدادات حساب الأعمال، وامنحه صلاحية على تطبيقك وعلى حساب واتساب التجاري، ثم أصدر منه رمز وصول دائماً

⚠️ الرمز الظاهر افتراضياً في صفحة API Setup مؤقت وينتهي خلال 24 ساعة. إذا استخدمته سيتوقف الربط عن العمل في اليوم التالي — استخدم رمز System User الدائم.

💡 توثيق العمل التجاري قد يستغرق من ساعات إلى أيام حسب مراجعة Meta. أنجزه أولاً حتى لا تتوقف عنده لاحقاً.

ما تحتاج إدخاله في Nexus — ثلاث قيم فقط:

خطوات الإعداد:

1. في Integrations انقر + إضافة تكامل واختر WhatsApp Cloud API
2. أدخل القيم الثلاث أعلاه (زر من وين أجيب هذه القيم؟ يفتح دليلاً مصوّراً داخل المنصة)
3. انقر فحص وتابع — سنكتشف أرقام WhatsApp المرتبطة بحسابك تلقائياً ونعرضها مع تقييم جودة كل رقم
4. اختر الأرقام التي تريد ربطها وسمِّ كل قناة، ثم انقر ربط
5. تظهر قائمة تحقق مباشرة أثناء إنشاء القنوات وضبط الـ webhook داخل تطبيق Meta الخاص بك
6. اربط مساعد ذكاء اصطناعي بكل قناة جديدة لتبدأ المحادثات

لا حاجة لإدخال Phone Number ID ولا لضبط أي webhook يدوياً في لوحة تحكم Meta — نستخرج معرّفات الأرقام من حسابك ونضبط الـ webhook عبر الـ API نيابةً عنك. يمكنك التحقق من التوجيه في أي وقت من تبويب الويب هوك داخل القناة، وهو يقرأ الحالة مباشرة من Meta.

الميزات:

• إرسال واستقبال الرسائل
• إرسال الوسائط (الصور والفيديوهات والمستندات والصوت)
• استخدام قوالب WhatsApp المعتمدة مسبقاً للرسائل خارج النافذة لمدة 24 ساعة
• دعم المتغيرات الديناميكية في القوالب (عناوين URL مخصصة والأسماء إلخ)
• فرض نافذة الرسائل لمدة 24 ساعة (انظر قسم "نافذة الرسائل لمدة 24 ساعة" أدناه)

الخيار 2: واتساب (QR)

🎬 شاهد فيديو الشرح على YouTube ↗ (دقيقتان، بالعربية — الربط بمسح رمز QR من الدقيقة 1:16)

يربط رقم واتساب الذي تستخدمه الآن بمسح رمز QR. ليس واجهة Meta الرسمية ولا يحتاج أي إعداد لدى Meta، ويبقى رقمك يعمل على هاتفك كالمعتاد.

متى يتم الاستخدام:

• تريد إعداد أسرع بدون تسجيل Meta Business Account
• لا تحتاج دعم Meta الرسمي
• تفضل عملية إعداد أكثر مرونة
• لا تحتاج قيود نافذة 24 ساعة عند الرد على عملائك
• تريد أن يرد المساعد على من يراسلك — لا أن ترسل رسالة واحدة للكثيرين

المتطلبات:

• عنوان URL الخادم (يوفره مدير حسابك في Nexus)
• رمز المسؤول للمصادقة

خطوات الإعداد:

1. في Integrations حدد واتساب (QR)
2. أدخل Server URL — العنوان الآمن المقدّم لحسابك
3. أدخل Admin Token — بيانات اعتماد المصادقة (تعمل ككلمة مرور للوصول إلى الخدمة)
4. انقر على Verify لاختبار الاتصال
5. انقر على Save وتكاملك نشط

الميزات:

• إرسال واستقبال الرسائل
• إرسال الوسائط (الصور والفيديوهات والمستندات والصوت)
• لا توجد قيود نافذة الرسائل لمدة 24 ساعة
• لا حاجة لقوالب الرسائل
• لا حملات جماعية. الإرسال الجماعي من رقم مربوط بـ QR هو بالضبط ما يعرّض الأرقام للحظر من WhatsApp، لذلك لا يفعّله Nexus على هذه القناة. المتابعات المجدولة لعميل واحد داخل محادثته تعمل كالمعتاد.

ملاحظة: واتساب (QR) لا يفرض نافذة الرسائل لمدة 24 ساعة لذا يمكنك الرد في أي وقت.

تكامل Facebook Messenger و Instagram

🎬 شاهد فيديو الشرح على YouTube ↗ (بالعربية)

معالج واحد يربط القناتين معاً. Instagram ليس تكاملاً منفصلاً — بل يُربط عبر صفحة Facebook المتصلة به. إذا كانت صفحتك تحتوي على حساب Instagram احترافي مرتبط بها، سيكتشفه المعالج تلقائياً ويتيح لك تفعيله بمربع اختيار واحد بجانب تلك الصفحة.

قبل أن تبدأ — تجهيز حساب Meta (مرة واحدة):

1. أنشئ تطبيقاً على developers.facebook.com من النوع Business، ثم أضف إليه منتج Messenger
2. تأكد أنك مسؤول (admin) على صفحة Facebook التي تريد ربطها — لا حاجة لإنشاء صفحة جديدة
3. أنشئ System User من إعدادات حساب الأعمال (أو استخدم واحداً موجوداً)، وامنحه صلاحية على تطبيقك وعلى صفحتك
4. من قسم الصفحات داخل الـ System User، اختر صفحتك واضغط إنشاء رمز — هذا يُصدر رمز وصول للصفحة (Page Access Token) دائماً بصلاحيات المراسلة

⚠️ لا بد أن يكون الرمز صادراً عن الصفحة نفسها. رمز الـ System User وحده لا يرى أي صفحة، فيُظهر المعالج «لا توجد صفحات» رغم أن صفحاتك موجودة. والرمز المُصدر من Graph API Explorer مؤقت وينتهي خلال 24 ساعة.

💡 يمكنك إعادة استخدام نفس تطبيق Meta عبر القنوات — إذا سبق أن ربطت WhatsApp Cloud API أو Messenger أو Instagram من قبل، سيعرض عليك المعالج إعادة استخدام ذلك التطبيق تلقائياً ويطلب منك فقط رمز وصول الصفحة.

ما تحتاج إدخاله في Nexus — قيمة واحدة أو اثنتان:

خطوات الإعداد:

1. في Integrations انقر + إضافة تكامل واختر Facebook Messenger
2. أدخل رمز وصول الصفحة (وسر التطبيق، ما لم تكن تعيد استخدام تطبيق — زر من وين أجيب هذه القيمة؟ يفتح دليلاً مصوّراً داخل المنصة)
3. انقر فحص وتابع — يكتشف Nexus كل صفحة Facebook يمكن للرمز الوصول إليها، مع حساب Instagram المرتبط بكل صفحة
4. اختر الصفحات التي تريد ربطها؛ ولأي صفحة لديها حساب Instagram مرتبط، اختياريّاً فعّله لربط Instagram أيضاً
5. انقر ربط — تظهر قائمة تحقق مباشرة أثناء إنشاء القنوات وضبط الـ webhook داخل تطبيق Meta الخاص بك
6. اربط مساعد ذكاء اصطناعي بكل قناة جديدة لتبدأ المحادثات

لا تختار Messenger و Instagram بشكل منفصل، ولا تضبط أي webhook يدوياً في لوحة تحكم Meta — رمز واحد ومعالج واحد ينتجان القناتين معاً، ويضبط Nexus الـ webhook عبر الـ API نيابةً عنك.

الميزات (Messenger):

• إرسال واستقبال الرسائل
• إرسال الوسائط (الصور والفيديوهات والمستندات)
• مزامنة بيانات العملاء التلقائية (الاسم وصورة الملف الشخصي والهاتف إذا تم توفيره)
• نافذة الرسائل لمدة 24 ساعة تنطبق (انظر أدناه)

الميزات (Instagram، عند ربطه):

• إرسال واستقبال الرسائل المباشرة
• إرسال الوسائط (الصور والفيديوهات والمستندات)
• بيانات ملف العميل الشخصي (الاسم وصورة الملف الشخصي)
• نافذة الرسائل لمدة 24 ساعة تنطبق (انظر أدناه)

ملاحظة: الرسائل المرسلة خارج النافذة لمدة 24 ساعة على أي من القناتين يتم وسمها كدعائية ولن تؤدي إلى تنبيهات العملاء ما لم تستخدم Message Tags (يتطلب إعداد Meta إضافي). يمكنك أيضاً ربط رقم هاتف العميل للمتابعة عبر WhatsApp على كلتا القناتين.

التحقق من الاتصال وإصلاحه

قد تتوقف قناة Messenger أو Instagram عن استقبال الرسائل دون أي إشعار من Meta ودون أي علامة في لوحة التحكم: تبقى القناة «نشطة»، وتبدو الإعدادات سليمة، لكن لا تصل رسائل. يحدث هذا مثلاً إذا ألغى Meta اشتراك التطبيق بصفحتك بعد فترة من فشل التسليم، أو انتهت صلاحية رمز الوصول، أو سُحبت صلاحيتك على الصفحة، أو غيّر نظام آخر إعدادات الويب هوك.

العلامة الأوضح: محادثات جديدة توقفت تماماً بينما يؤكد لك عملاؤك أنهم أرسلوا رسائل.

للتحقق: افتح القناة من Integrations، ثم تبويب الويب هوك، واضغط التحقق من الاتصال. سيعرض Nexus أربعة فحوصات بالترتيب:

الفحوصات مرتّبة عمداً، ويُعرض أول فشل فقط كسبب — الباقي يظهر «لم يُفحص». سبب واحد حقيقي أوضح من أربعة أعطال متتالية مصدرها واحد.

زر «إصلاح» يظهر عندما يكون العطل من النوع الذي نستطيع إصلاحه بأنفسنا (تسليم الرسائل أو ملكية الويب هوك). يعيد تسجيل الويب هوك واشتراك الصفحة لدى Meta باستخدام بياناتك المخزّنة، ثم يعيد تشغيل الفحوصات ليريك النتيجة. الضغط عليه آمن حتى لو لم يكن هناك عطل: العملية لا تُنشئ شيئاً مكرراً ولا تغيّر شيئاً سليماً.

حالات لا يُصلحها الزر، وهذا مقصود:

• رمز الوصول لم يعد صالحاً → لا يمكن إصلاحه من هنا. أعد تشغيل معالج الربط برمز جديد من Meta.
• الويب هوك مملوك لجهة أخرى → إذا كان مسجَّلاً لنظام خارجي أو لحساب آخر، يرفض Nexus الاستيلاء عليه تلقائياً حتى لا يقطع خدمة جهة أخرى دون علمك. أعد تشغيل معالج الربط، وسيطلب منك تأكيداً صريحاً يوضّح ما الذي سيُستبدل.
• «تعذّر تشغيل بعض الفحوصات» → هذه ليست حالة عطل. تعني أننا لم نستطع التأكد (انقطاع مؤقت من جهة Meta مثلاً). أعد المحاولة بعد قليل.

⚠️ لا يوجد فحص تلقائي دوري حتى الآن — لا يكتشف النظام هذه الأعطال من تلقاء نفسه، ولن يصلك تنبيه. إذا لاحظت توقف المحادثات على قناة Messenger أو Instagram، اضغط التحقق من الاتصال بنفسك؛ هذه هي الطريقة الوحيدة حالياً لمعرفة السبب.

نصيحة: لا تحذف القناة لإصلاح مشكلة اتصال. الحذف يزيل معها كل المحادثات المرتبطة بها. «التحقق من الاتصال» ثم «إصلاح» — أو إعادة تشغيل المعالج — يعالج الأمر دون فقدان أي شيء.

تكامل Web Chat

دمج عنصر واجهة دردشة في موقعك الإلكتروني للسماح للزوار ببدء محادثات مباشرة.

خطوات الإعداد:

1. في Integrations حدد Web Chat
2. Nexus ينشئ رمز التضمين تلقائياً
3. انسخ مقتطف الرمز المقدم
4. الصقه في HTML الموقع الخاص بك (عادة قبل وسم </body> الإغلاق أو اطلب من مطورك الويب إضافته)
5. تحقق من ظهور الأداة في موقعك الإلكتروني
6. تكاملك نشط

الميزات:

• عنصر دردشة مدمج في موقعك الإلكتروني
• ردود مدعومة بالذكاء الاصطناعي (لا رد يدوي للوكيل في الأداة)
• يمكن للعملاء توفير رقم الهاتف أو البريد الإلكتروني بشكل اختياري
• بمجرد توفير رقم هاتف يمكنهم المتابعة عبر WhatsApp
• لا توجد قيود نافذة الرسائل لمدة 24 ساعة (دردشة الويب غير محدودة)
• أداة تستجيب للهاتف المحمول

تخصيص الأداة: الأداة المدمجة تحترم العلامة التجارية لمنظمة Nexus:

• يظهر شعار منظمتك في رأس الدردشة
• يطابق مظهر اللون لوحة التحكم (فاتح/داكن)
• يمكن تخصيص رسالة الترحيب الافتراضية في إعدادات AI Assistants

القيود:

• لا يمكن للوكلاء الرد مباشرة في عنصر دردشة الويب (الذكاء الاصطناعي فقط)
• إذا كنت بحاجة إلى التصعيد إلى إنسان يتم عرض زر "Continue via WhatsApp" للعميل برابط لبدء محادثة WhatsApp

إدارة التكاملات

بمجرد إضافة التكاملات يمكنك عرضها وإدارتها من صفحة Integrations.

لكل تكامل يمكنك:

الإجراءات الشائعة:

• إذا رأيت حالة Error تحقق من بيانات الاعتماد وأعد التحقق
• Pause التكاملات التي تريد تعطيلها مؤقتاً بدون حذفها
• استخدم View Activity لاستكشاف الأخطاء — إذا لم يكن هناك نشاط حديث تحقق من أن التكامل نشط

فهم نافذة الرسائل لمدة 24 ساعة

نافذة الرسائل لمدة 24 ساعة هي قاعدة معيار الصناعة التي تفرضها WhatsApp Cloud API و Facebook Messenger و Instagram. إليك ما تحتاج معرفته:

ما هي نافذة 24 ساعة؟

بعد **إرسال العميل رسالة لديك 24 ساعة للرد. يمكن لذكاء الاصطناعي الرد في أي وقت خلال هذه النافذة. خارج النافذة لا يمكنك إرسال رسائل حرة الشكل.

مثال:

• يرسل العميل رسالة على WhatsApp الاثنين الساعة 3 مساءً
• لديك حتى الثلاثاء الساعة 3 مساءً للرد
• بعد الثلاثاء الساعة 3 مساءً تغلق النافذة

القنوات التي تفرضها

خارج نافذة 24 ساعة

بمجرد إغلاق النافذة ستعرض Nexus بانر يشير إلى انتهاء صلاحية النافذة. خياراتك تعتمد على القناة:

WhatsApp Cloud API:

• يمكنك إرسال قالب WhatsApp معتمد مسبقاً (انظر قسم "قوالب WhatsApp" أدناه)
• يمكنك المتابعة عبر WhatsApp إذا لم تنغلق نافذة العميل

Messenger و Instagram:

• يمكن إرسال القوالب مع Message Tags (يتطلب إعداد Meta)
• بدلاً من ذلك متابعة عبر WhatsApp إذا كان لديك رقم هاتف العميل

Web Chat:

• لا توجد قيود نافذة — يمكنك الرد أو المتابعة في أي وقت
• لكن يمكنك عرض زر "Continue via WhatsApp" لنقل المحادثة هناك

العملاء الذين يخفي واتساب أرقامهم

صار واتساب يتيح للناس التسجيل باسم اسم مستخدم بدل رقم الهاتف، وعندما يراسلك أحدهم لا يشارك واتساب رقمه مع نشاطك التجاري. وهذا يخصّ قنوات WhatsApp Cloud API.

ما يبقى يعمل كالمعتاد:

• يحصل كل منهم على محادثة خاصة وسجل جهة اتصال خاص، كأي عميل آخر
• يرد عليهم مساعدك الذكي كالعادة
• يمكنك الرد يدوياً، ويمكنك إرسال القوالب — فهم قابلون للوصول خارج نافذة الـ24 ساعة أيضاً
• وإذا أرسلوا STOP يُحترم انسحابهم وتتوقف حملاتك عن الوصول إليهم

وما يختلف:

• تظهر بطاقة جهة الاتصال بلا رقم هاتف، لأن واتساب لم يوفّره أصلاً
• لا يمكن مطابقتهم بالشخص نفسه على قناة أخرى — فرقم الهاتف هو ما يربط محادثات جهة الاتصال على واتساب وماسنجر وانستغرام معاً
• لا يمكن استهدافهم بحملة مبنية على أرقام الهواتف. وتخبرك صفحة الحملة بعدد جهات الاتصال التي تعذّر وصولها لهذا السبب (راجع الحملات)

ولا يوجد ما تضبطه ولا ما تصلحه — فهذه هي طريقة عمل واتساب الآن. والأثر العملي ببساطة أن الحملات الصادرة لا تصل هؤلاء العملاء، أما المحادثات التي يبدأونها فتصلك كالمعتاد.

مؤشرات النافذة في Nexus

عند عرض محادثة:

• مؤشر أخضر — النافذة مفتوحة؛ يمكنك الرد برسائل حرة الشكل
• تحذير أصفر — النافذة تغلق قريباً (في غضون ساعتين)
• مؤشر أحمر مغلق — النافذة مغلقة؛ فقط القوالب أو متابعة WhatsApp متاحة

قوالب WhatsApp

تتيح القوالب المعتمدة مسبقاً لك إرسال رسائل خارج نافذة 24 ساعة على WhatsApp Cloud API.

ما هي القوالب؟

القوالب هي تنسيقات رسائل معتمدة من Meta ومكتوبة مسبقاً تتضمن:

• نص ثابت (نص الرسالة)
• متغيرات ديناميكية (محتوى مخصص مثل اسم العميل أو معرّف الطلب)
• وسائط غنية (رأس صورة أو فيديو أو مستند اختياري)
• أزرار تفاعلية (أزرار استدعاء إلى الإجراء أو الهاتف أو الرد السريع)

مثال قالب:

Hi {{1}},
Your order {{2}} is ready for pickup.
[Image of product]
[Button: Track Order] [Button: Call Us]

عند الإرسال يصبح:

Hi John,
Your order #12345 is ready for pickup.
[Image of product]
[Button: Track Order] [Button: Call Us]

أنواع القوالس والرؤوس

القوالب تدعم أنواع رؤوس مختلفة لجعل الرسائل أكثر جاذبية:

إعداد وإرسال القوالب

1. أنشئ قوالب في Meta Business Manager الخاص بك (قائمة WhatsApp → Templates)
2. Meta يراجع ويعتمد عليها (عادة في غضون ساعات قليلة)
3. في Nexus انتقل إلى محادثة بنافذة منتهية
4. انقر على زر Send Template
5. حدد قالبك من القائمة المنسدلة
6. املأ أي متغيرات ديناميكية (حقول الشخصنة)
7. راجع المعاينة
8. انقر على Send

سيستقبل العميل القالب كرسالة WhatsApp رسمية.

أفضل الممارسات للقوالس

• اجعل القوالب بسيطة — الرسائل الواضحة والموجزة تؤدي أداء أفضل
• استخدم الشخصنة — المتغيرات الديناميكية (الاسم ومعرّف الطلب والتاريخ) تجعل الرسائل شخصية
• اختبر قبل الموافقة — أرسل قوالب اختبار لنفسك قبل الانتقال للعمل الفعلي
• استخدم الأزرار بشكل استراتيجي — أدرج أزرار استدعاء الإجراء حيث تكون ذات صلة (Schedule أو Track أو Call إلخ)
• اتبع إرشادات WhatsApp — تجنب لغة تشبه الرسائل غير المرغوب فيها؛ Meta يرفض القوالب المريبة

مراقبة صحة التكامل

Nexus يراقب التكاملات تلقائياً:

مؤشرات التكامل السليم:

• الحالة تعرض Active
• طابع زمني آخر نشاط حديث (في آخر ساعات/دقائق)
• اختبار الاتصال ينجح
• المحادثات تتدفق إلى صندوق الوارد

علامات المشكلة:

• الحالة تعرض Error
• آخر نشاط قديم (لا تحديثات في ساعات)
• اختبار الاتصال يفشل
• لا توجد محادثات جديدة تصل على الرغم من حركة المرور

إذا فشل التكامل:

1. اذهب إلى صفحة التكامل
2. تحقق من رسالة الخطأ (عادة تشير إلى انتهاء الدوال أو مشكلة API)
3. انقر على Edit وتحقق من صحة بيانات اعتماداتك وحدثها
4. انقر على Test Connection للتحقق
5. إذا استمر الفشل اتصل بدعم Meta (للـ APIs الرسمية) أو دعم Nexus لواتساب (QR)

الخطوات التالية

مع ربط قنواتك أنت جاهز لـ:

• تكوين مساعد الذكاء الاصطناعي — إعداد ردود الذكاء الاصطناعي وتحميل قاعدة المعرفة لرسائل أذكى
• إدارة المحادثات — عرض المحادثات والرد والتصعيد إلى أعضاء الفريق
• إدارة العملاء المحتملين — تقييم العملاء المحتملين وتنظيم خط الأنابيب الخاص بك

لاستكشاف الأخطاء انظر الأسئلة الشائعة والاستكشاف.