تشغيل تدفق Typebot على WhatsApp مع Coexistence

ما حقول Typebot التي تأخذ قيمها من الرقم المتصل؟

يطلب معالج WhatsApp في Typebot، تحت تبويب Share في أي روبوت، أربعة أشياء: App secret وSystem User Token وWhatsApp Business Account ID وPhone number ID.

ثلاثة منها تأتي مباشرة من الاتصال. تعرض لوحة التحكم معرّف WABA ومعرّف رقم الهاتف ورمز الوصول للرقم، وتعيد الأداة get_api_credentials القيم نفسها إذا كان مساعد يجلبها لك. الصقها في الحقول المطابقة.

أما App secret فهو الحقل الذي يُترك فارغًا. يستخدمه Typebot لغرض واحد في الحركة الواردة: فحص ترويسة X-Hub-Signature-256 التي تضيفها Meta إلى كل تسليم. في الرقم المتصل عبر Tech Provider توقّع Meta بسر تطبيق المزوّد، وهو لا يُشارك أبدًا، فأي قيمة تكتبها هناك تجعل Typebot يرفض كل رسالة حقيقية. وعندما يكون الحقل فارغًا يتخطى Typebot هذا الفحص ويقبل التسليم.

إلى أين يذهب عنوان callback URL ورمز التحقق الخاصان بـ Typebot؟

إلى وجهة webhook الخاصة بالرقم، وليس إلى لوحة تحكم تطبيق Meta.

يطلب معالج Typebot لصق Callback URL وVerify Token في إعدادات WhatsApp في تطبيق Meta الخاص بك. مع Coexistence عبر EasyCoexistence لا يوجد تطبيق خاص بك في العملية: توجّه Meta أحداث الرقم إلى الوجهة المحددة في الاتصال. لذا انسخ القيمتين من الخطوة الأخيرة في Typebot واعتمدهما وجهةً، من لوحة التحكم أو عبر set_webhook_destination.

بعدها ترسل Meta طلب التحقق GET إلى Typebot، فيرد بقيمة challenge، ومن تلك اللحظة تصل كل رسالة إلى الرقم إلى الروبوت. رمز التحقق في Typebot يُستخدم مرة واحدة: يُحذف من قاعدة بيانات Typebot لحظة نجاح التحقق. إذا ضبطت الوجهة مرة أخرى لاحقًا، فأنشئ رمزًا جديدًا بتشغيل المعالج من جديد أولًا.

ماذا يفعل الروبوت مع نافذة 24 ساعة؟

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

الحالة الحرجة هي التدفق الذي ينتظر. كتلة Wait، أو جلسة تُستأنف بعد أن يصمت العميل أكثر من يوم، ستحاول إرسال نص حر خارج النافذة، فترفضه Meta بالخطأ 131047. مهلة انتهاء الجلسة في Typebot، وهي 4 ساعات افتراضيًا ويمكن رفعها إلى 48، تحدد متى يبدأ العميل العائد محادثة جديدة، لا ما إذا كانت Meta تقبل الرسالة.

ولأن هذا Coexistence، يرى الفريق كل محادثة في تطبيق WhatsApp Business، ويستطيع التدخل من الهاتف متى لم يكن على الروبوت أن يجيب.

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

• لصق App secret من تطبيق Meta في Typebot. تُوقَّع التسليمات بسر Tech Provider، فيرفض Typebot كل رسالة بحجة أن التوقيع غير صالح.
• إعادة استخدام رمز تحقق قديم في Typebot. يُحذف بعد أول تحقق ناجح، لذا يحتاج ضبط الوجهة من جديد إلى رمز جديد من المعالج.
• مشاركة callback URL. مع إيقاف فحص التوقيع، معرفة العنوان هي ما يسمح للطلب بالدخول، فعامله كما تعامل كلمة المرور.

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

تابع القراءة