استخدم رقم Coexistence كصندوق وارد WhatsApp Cloud في Chatwoot

كيف تربط رقم Coexistence بـ Chatwoot خطوة بخطوة؟

في موضعين، وبهذا الترتيب.

في Chatwoot، أضف صندوق وارد واختر WhatsApp، ثم اختر مزوّد WhatsApp Cloud مع الإعداد اليدوي. أدخل الرقم ومعرّف رقم الهاتف ومعرّف WhatsApp Business Account ورمز الوصول، وكلها تعرضها لوحة التحكم في EasyCoexistence للاتصال، أو تعيدها الأداة get_api_credentials إلى المساعد. بعدها يعرض Chatwoot عنوان URL لـ webhook وverify token للصندوق.

في EasyCoexistence، اضبط وجهة webhook للرقم على ذلك العنوان وأدخل verify token نفسه. ترسل Meta طلب التحقق إلى Chatwoot، فيرد عليه، ومن حينها تصل كل رسالة إلى الرقم في صندوق الوارد. لا شيء يعمل في الوسط، فلا يوجد سير عمل تحتاج إلى إبقائه حيًا.

هل تظهر في Chatwoot الردود المرسلة من الهاتف؟

نعم. في رقم Coexistence، تبلغ Meta عن الرد المكتوب في تطبيق WhatsApp Business بحدث smb_message_echoes، وتتعرف مهمة webhook في Chatwoot على هذا الحقل وتسجل الرسالة كرسالة صادرة في المحادثة الصحيحة. يصف الكود المصدري لـ Chatwoot هذه الحالة صراحةً: أنشطة تجارية ترد من Chatwoot ومن التطبيق معًا، مع مزامنة الرسائل إلى Chatwoot.

هذا ما يجعل التقسيم يعمل عمليًا. يستطيع المالك مواصلة الرد على العملاء الدائمين من الهاتف، ويعمل الفريق على الصندوق المشترك من المكتب، ويرى كل طرف ما أرسله الآخر دون أن يحوّل أحد لقطات الشاشة.

تخرج الرسائل المرسلة من Chatwoot عبر Cloud API على الرقم نفسه، فتظهر على الهاتف أيضًا.

لماذا تترك حقل app secret فارغًا؟

لأن عمليات التسليم موقّعة بسر لا تملكه. توقّع Meta كل webhook بـ app secret الخاص بالتطبيق المالك للاشتراك، وهو تطبيق EasyCoexistence، ولا يُشارك هذا السر مع أحد.

في الكود المصدري الحالي لـ Chatwoot، لا يفحص الترويسة X-Hub-Signature-256 في قناة WhatsApp Cloud المضبوطة يدويًا إلا إذا خُزّن عليها app secret، أو إذا أُنشئت القناة عبر Embedded Signup الخاص بـ Chatwoot نفسه. الصندوق اليدوي الذي لا يحمل app secret يقبل عمليات التسليم، أما الصندوق الذي أُدخل فيه أي app secret فيرفضها كلها باعتبارها غير مصرح بها.

الحماية المطبقة هنا هي verify token. اختر قيمة عشوائية طويلة، لأنها ما يتيح لـ Chatwoot التمييز بين طلب التحقق من Meta وطلب أي جهة أخرى.

ما الذي لا يستطيع Chatwoot فعله على هذا الرقم؟

استقبال webhook في موضع ثانٍ في الوقت نفسه. توجّه Meta webhook الرقم إلى وجهة واحدة، فما دام Chatwoot يحملها لن يتلقى سير عمل n8n الأحداث نفسها. إذا احتجت إلى الاثنين، وجّه الوجهة إلى وسيط صغير من إعدادك يمرر كل عملية تسليم إلى Chatwoot وإلى سير العمل.

تسري حدود Coexistence كما في أي مكان: ترسل واجهة برمجة التطبيقات (API) حتى 20 رسالة في الثانية، ولا يخرج النص الحر إلا خلال 24 ساعة من آخر رسالة للعميل، وتغطي القوالب كل ما بعد ذلك.

ما زال تطبيق WhatsApp Business يحتاج إلى فتحه مرة واحدة على الأقل كل 14 يومًا، وتتولى EasyCoexistence مراقبة ذلك.

الأخطاء الشائعة

• ملء app secret في صندوق Chatwoot. تُوقَّع عمليات التسليم بسر تطبيق EasyCoexistence، فيرفضها Chatwoot كلها باعتبارها غير مصرح بها.
• استخدام verify token في EasyCoexistence يختلف عن الذي يعرضه Chatwoot. يفشل تحقق Meta ولا تصل أي رسالة إلى الصندوق أبدًا.
• اختيار Embedded Signup في Chatwoot بدل الإعداد اليدوي. هذا يربط الرقم عبر تطبيق Meta الخاص بـ Chatwoot، وهو اتصال منفصل.

الأسئلة الشائعة

تابع القراءة