ربط بوت Botpress بـ WhatsApp عبر Coexistence
استخدم تكامل WhatsApp في Botpress عبر Manual Configuration. الصق رمز الوصول (token) الخاص بالرقم المتصل ومعرّف رقم الهاتف، واختر رمز تحقق من عندك، واترك App ID وClient Secret فارغين. ثم اضبط عنوان URL الخاص بـ خطاف الويب (webhook) في Botpress مع رمز التحقق نفسه وجهةً لـ webhook الرقم، فتسلّم Meta كل رسالة إلى البوت.
حقل Client Secret في Botpress: إذا ترك فارغاً يتخطى النظام التحقق من توقيع webhook.
حقول webhook التي يشترك بها دليل Botpress، ومنها الرسائل وتحديثات حالة القوالب.
نافذة خدمة العملاء التي تفتحها رسالة العميل، ويمكن خلالها إرسال أي رسالة خدمة.
ما إعداد Botpress الذي يعمل مع رقم Coexistence؟
Manual Configuration. الخيارات الأخرى تربط الرقم عبر تطبيق Meta الخاص بـ Botpress، وهذا تسجيل منفصل للرقم وليس طريقة لاستخدام رقم متصل أصلاً.
في تكامل WhatsApp افتح القائمة المنسدلة Configuration واختر Manual Configuration. سيطلب منك Verify Token وAccess Token وDefault Bot Phone Number ID، وبشكل اختياري App ID وClient Secret وWABA ID.
رمز الوصول ومعرّف رقم الهاتف ومعرّف WABA تأتي من الاتصال: تعرضها لوحة التحكم، ويعيدها get_api_credentials إلى المساعد. أما رمز التحقق فهو أي نص تختاره. يبقى App ID وClient Secret فارغين. يعرض دليل Botpress السر كحقل يجب ملؤه، لكن تعريف التكامل لديهم يعتبره اختيارياً وينص على أنه بدونه يتم تخطي التحقق من التوقيع. وهذا مهم، لأن Meta توقّع كل عملية تسليم بسر تطبيق Tech Provider، وهو سر لا يملكه أي عميل.
كيف يستلم webhook في Botpress رسائل Meta؟
عبر وجهة webhook الخاصة بالرقم. يطلب منك دليل Botpress لصق عنوان URL الخاص به ورمز التحقق في إعدادات WhatsApp داخل تطبيق Meta. هنا لا يوجد تطبيق Meta خاص بك: Meta توجّه أحداث الرقم إلى الوجهة التي يحددها الاتصال. لذلك انسخ عنوان URL الذي يعرضه Botpress للتكامل واضبطه، مع رمز التحقق نفسه، وجهةً في لوحة التحكم أو عبر set_webhook_destination.
ترسل Meta طلب GET للتحقق، ويجيب عنه Botpress، ثم يبدأ التسليم. وعند حفظ الإعداد اليدوي يتحقق Botpress أيضاً من الرمز بسؤال Graph عن التطبيق الذي أصدره، فيفشل الرمز غير الصالح أو الملغى وقت الحفظ لا عند أول رسالة.
كما يعالج Botpress الحدث smb_message_echoes، وهو الحدث الذي ترسله Meta عندما يرد شخص من تطبيق WhatsApp Business. وهكذا يرى البوت رد الهاتف ولا يغيب عنه.
| Required? | What to enter | |
|---|---|---|
| Access Token | Required | The connected number's token |
| Default Bot Phone Number ID | Required | The connected number's phone number id |
| Verify Token | Required | Any string, reused in the webhook destination |
| WABA ID | Optional | The connected number's WABA id |
| App ID and Client Secret | Optional | Leave both empty |
ماذا ينبغي أن يعرف البوت عن Coexistence؟
أن إنساناً قد يكون في المحادثة أصلاً. يستمر تطبيق WhatsApp Business بالعمل على الرقم، فقد يتلقى العميل رداً من الهاتف ورداً من البوت خلال الدقيقة نفسها. قرّر داخل التدفق ما يحدث عند وصول صدى (echo): معظم الفرق توقف البوت مؤقتاً لهذا العميل، حتى لا يُقاطع الشخص الذي تدخل.
الأمر الثاني هو التوقيت. البوت الذي يجيب عن الرسائل الواردة يعمل ضمن نافذة خدمة العملاء البالغة 24 ساعة، حيث يُسمح بالنص الحر. أما تدفق يرسل شيئاً بعد يوم، كمتابعة أو تذكير، فيحتاج إلى قالب معتمد، والنص الحر هناك يعيد الخطأ 131047. ولهذا النوع من الرسائل الاستباقية يشترك دليل Botpress في حقول حالة القوالب.
والسرعة ثابتة عند 20 رسالة في الثانية لرقم Coexistence، وهذا أعلى بكثير مما يرسله بوت محادثة.
الأخطاء الشائعة
- ملء Client Secret بسر تطبيق Meta الخاص بك. لن يتطابق التوقيع أبداً، ويردّ Botpress على كل عملية تسليم بالخطأ 401.
- اختيار OAuth أو sandbox بدل Manual Configuration. هذه الخيارات تربط الرقم عبر تطبيق Botpress نفسه، لا عبر الرقم المتصل أصلاً.
- تجاهل الأصداء. دون قاعدة للردود المرسلة من الهاتف، يجيب البوت فوق شخص تدخل بالفعل.
اربط الرقم على easycoexistence.com، والصق رمز الوصول ومعرّف رقم الهاتف في Manual Configuration داخل Botpress، واضبط عنوان URL الخاص بـ webhook في Botpress وجهةً. ابتداءً من US$ 9 لكل رقم شهرياً، وينخفض إلى US$ 1 كلما زاد عدد الأرقام، مع أول 3 أيام مجانية.
الأسئلة الشائعة
هل تخطي التحقق من التوقيع آمن؟
هو ينقل الحماية إلى عنوان URL. يولّد Botpress عنوان webhook لكل تكامل على حدة، فأبقِه سرياً. وتبقى الوسائط تُجلب من Meta بالرمز، وهذا ما لا يستطيع حدث مزوّر تقليده.
هل يمكن للرقم نفسه تغذية n8n أيضاً؟
للرقم وجهة webhook واحدة. وجّهها إلى نظام واحد وأعد التوجيه منه إذا احتاج نظام ثانٍ إلى الأحداث.
هل يحتاج Botpress إلى معرّف WABA؟
يعتبره تعريف التكامل اختيارياً حالياً وينص على أنه سيصبح مطلوباً في إصدار رئيسي قادم، لذا املأه من بيانات الاتصال.
هل تمر الرسائل عبر EasyCoexistence؟
لا. تسلّم Meta مباشرة إلى عنوان URL الخاص بـ webhook في Botpress، ولا يُخزَّن المحتوى لدينا أبداً.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في