ربط WhatsApp بـ Activepieces على رقم Coexistence

كيف تربط رقم Coexistence بـ Activepieces؟

أنشئ اتصال WhatsApp Business في Activepieces بقيمتين: رمز الوصول ومعرّف حساب WhatsApp Business. تعرض لوحة التحكم في EasyCoexistence القيمتين للاتصال، وتعيدهما get_api_credentials إلى المساعد. تتحدث تعليمات القطعة عن إنشاء تطبيق Meta ومستخدم نظام، لأنها تفترض أنك لا تملك أياً منهما. أما هنا فالرقم متصل أصلاً، فانتقل مباشرة إلى لصق القيمتين.

ثم ابنِ تدفقاً يبدأ بمشغّل New Incoming Message، وحدّد عليه رمز تحقق (verify token) من اختيارك، وانشر التدفق. انسخ عنوان URL الخاص بـ webhook المشغّل إلى وجهة webhook الرقم في EasyCoexistence مع رمز التحقق نفسه. ترسل Meta طلب التحقق، فيجيب عنه المشغّل، ويبدأ تشغيل جديد مع كل رسالة تصل إلى الرقم.

لماذا يجب أن يبقى سر التطبيق فارغاً؟

لأن السر الذي يوقّع عمليات التسليم هذه ليس لك لتلصقه. توقّع Meta كل webhook بسر التطبيق الذي يملك الاشتراك، وفي رقم متصل عبر EasyCoexistence هذا هو تطبيق EasyCoexistence، ولا يُشارك سره أبداً.

تعدّ القطعة الحقل اختيارياً. فإذا تُرك فارغاً قبلت مشغّلاتها عمليات التسليم كما ترد. وإذا مُلئ بسر أي تطبيق آخر، فشلت كل عملية تسليم في فحص X-Hub-Signature-256 وتُتجاهل بصمت، وهذا يشبه تماماً أن الرسائل لا تصل.

أما ما يمنع الغرباء من إتمام المصافحة فهو رمز التحقق. اختر قيمة عشوائية طويلة، وأبقِ عنوان URL الخاص بالمشغّل سرياً، لأنه العنوان الذي يشغّل تدفقك.

ماذا يستطيع التدفق أن يفعل بعد وصول الرسالة؟

يمرّر المشغّل إلى التدفق رسالة مبسّطة الهيكل: المرسل، واسم الملف الشخصي، ومعرّف الرسالة، والنوع، والنص، ومعرّف أي وسائط، وردود الأزرار والقوائم، ومعرّف رقم الهاتف المستقبِل. ومن هنا يصبح تدفق Activepieces عادياً عبر قطعه الأخرى، مثل CRM أو جدول بيانات أو خطوة ذكاء اصطناعي.

تستخدم الردود القطعة نفسها. يرسل Send Message نصاً حراً، ولا يُسلَّم إلا خلال 24 ساعة من آخر رسالة للعميل. ويرسل Send Template Message قالباً معتمداً، وهو الوحيد الذي يُسلَّم بعد انقضاء تلك المدة. أما الأزرار التفاعلية والقوائم والوسائط والموقع وردود الفعل فكل منها إجراء مستقل.

تنبّه تعليمات Activepieces نفسها إلى أن Meta تقبل عنوان URL واحداً للاستدعاء لكل تطبيق. ومع وجهات لكل رقم يصبح الحد عنواناً واحداً لكل رقم، فإذا كان على التدفق معالجة عدة أنواع من الأحداث فليتفرّع داخل تدفق واحد.

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

تصل إلى webhook، لكن ليس إلى هذا المشغّل. في رقم Coexistence ترسل Meta صدى لكل رد يُكتب في تطبيق WhatsApp Business إلى الوجهة نفسها، ضمن الحقل smb_message_echoes. أما مشغّل New Incoming Message في القطعة فيقرأ الحقل messages وحده ويتجاهل كل ما سواه.

إذا احتجت ردود الهاتف في التدفق، فابدأه بقطعة Webhook العامة في Activepieces، وهي تقبل أي طريقة HTTP، وأجب عن طلب GET الخاص بالتحقق بخطوة Return Response على عنوان URL المتزامن الخاص بها. بعدها تحلل الحمولة الخام بنفسك، بما فيها الحقلان معاً.

وفي معظم التدفقات يبقى مشغّل القطعة الخيار الأبسط: فهو يتفاعل مع العملاء، وتظل ردود الفريق ظاهرة في التطبيق على الهاتف.

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

• لصق سر تطبيق في اتصال WhatsApp. تُوقَّع عمليات التسليم بسر تطبيق EasyCoexistence، فتُتجاهل كلها.
• ضبط الوجهة قبل نشر التدفق. تتحقق Meta فوراً، والتدفق غير المنشور لا يستطيع الرد.
• توقّع أن يرى مشغّل New Incoming Message الردود المكتوبة على الهاتف. فهو لا يقرأ smb_message_echoes بل الحقل messages فقط.

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

تابع القراءة