لاختبار اتصال webhook من Papo (https://papo.global/) قبل تفعيل الأتمتة، يمكنك استخدام أداة خارجية مثل Webhook.site للتحقق من عنوان URL الوجهة، وفحص تنسيق حمولة JSON وتصحيح أخطاء الإرسال دون التأثير على جهات الاتصال الحقيقية. تنطبق هذه العملية على webhooks الأصلية للحساب وعلى إجراء "إرسال Webhook" داخل تدفقات الأتمتة.
يمنع التحقق المسبق التكامل المعطل من فقدان البيانات أو مقاطعة رحلات العملاء. باستخدام عنوان URL مؤقت للاختبار، يمكنك فحص ما ترسله Papo بالضبط — الرؤوس، والنص، ورموز الاستجابة — وإجراء التعديلات قبل التوجيه إلى النظام النهائي.
ملخص عملية الاختبار
| المرحلة | الإجراء | الأداة / الموقع |
|---|---|---|
| 1. الحصول على عنوان URL للاختبار | انتقل إلى webhook.site وانسخ عنوان URL الذي تم إنشاؤه. | Webhook.site |
| 2. تكوين webhook في Papo باستخدام عنوان URL للاختبار | أدخل عنوان URL في حقل الوجهة الخاص بـ webhook (في قسم التكاملات أو في إجراء التدفق). | لوحة تحكم Papo |
| 3. تشغيل webhook | بالنسبة لـ webhooks الحساب، أرسل رسالة WhatsApp إلى صندوق الوارد المتصل. بالنسبة لـ webhooks في التدفقات، سجّل جهة اتصال اختبار في التدفق. | صندوق الوارد أو التدفق |
| 4. تحليل الحمولة المستلمة | في لوحة Webhook.site، اطلع على الطلب الوارد: الطريقة، الرؤوس، و JSON النص. | Webhook.site |
| 5. التصحيح والاستبدال بعنوان URL للإنتاج | إذا كانت الحمولة صحيحة، استبدل عنوان URL للاختبار بعنوان URL الحقيقي لنظامك وقم بتفعيل الأتمتة. | لوحة تحكم Papo |
كيفية اختبار webhooks الحساب (التكاملات)
يتم تشغيل webhooks الأصلية في Papo عند كل رسالة جديدة يتم استلامها في صندوق الوارد. للتحقق منها دون مخاطرة:
- في لوحة تحكم Papo، انتقل إلى الإعدادات > التكاملات > Webhooks وأنشئ webhook جديد.
- حدد المشغل — على سبيل المثال، جميع الرسائل — وفي حقل URL، الصق العنوان المؤقت من Webhook.site.
- احفظ webhook.
- أرسل رسالة اختبار (عبر WhatsApp أو قناة أخرى متصلة) إلى صندوق الوارد المراقب.
- في Webhook.site، قم بتحديث اللوحة وحدد الطلب الوارد حديثًا. تحقق من نص JSON: يجب أن يحتوي على بيانات مثل رقم المرسل، ومحتوى الرسالة، ومعرف المحادثة.
- إذا كان JSON فارغًا أو غير صالح، راجع المشغل المختار وتأكد من أن الرسالة قد استلمها صندوق الوارد بالفعل.
- بعد التحقق، قم بتحرير webhook واستبدل عنوان URL بعنوان URL لنظامك الوجهة.
كيفية اختبار إجراء "إرسال Webhook" في تدفقات الأتمتة
داخل محرر التدفقات، يسمح إجراء إرسال Webhook بإرسال البيانات في خطوة محددة من الرحلة. يتم الاختبار باستخدام تدفق نشط مؤقتًا وجهة اتصال تحكم:
- أنشئ التدفق وأضف عقدة إرسال Webhook في النقطة المطلوبة.
- في لوحة تكوين العقدة، املأ URL بعنوان Webhook.site، واختر الطريقة POST، وقم ببناء نص JSON باستخدام متغيرات Papo، مثل
{{contact.name}}و{{contact.phone}}. - قم بتفعيل التدفق.
- في CRM، سجّل يدويًا جهة اتصال اختبار في هذا التدفق (باتباع نفس إجراء اختبار تدفقات الأتمتة).
- تابع سجل تنفيذ التدفق، وفي نفس الوقت راقب Webhook.site.
- يجب أن يُظهر الطلب المستلم JSON بالقيم الحقيقية لجهة اتصال الاختبار، مع استبدال المتغيرات. وإلا، تحقق من النص (استخدم
"nome": "{{contact.name}}"وتأكد من أن جهة الاتصال تحتوي على الحقول المملوءة). - إذا أعاد الطلب خطأ 4xx أو 5xx، تحقق مما إذا كانت الطريقة صحيحة (عادة POST) وما إذا تم تضمين الرأس
Content-Type: application/json. - بعد التحقق، قم بتعطيل التدفق، واستبدل عنوان URL الوجهة بعنوان URL للإنتاج، ثم قم بتفعيله مرة أخرى.
لمن هذه العملية موصى بها
- المسؤولون ومحللو النظام الذين يحتاجون إلى ضمان سلامة التكاملات قبل إطلاقها.
- الفرق التي تبني تدفقات مع webhook لأنظمة CRM أو جداول البيانات أو أدوات الأتمتة وترغب في تصحيح الحمولة دون التأثير على العملاء المحتملين الحقيقيين.
- أي مستخدم يقوم بتخصيص webhooks الحساب ويرغب في تأكيد إرسال الأحداث بشكل صحيح.
الأسئلة الشائعة
هل يمكنني اختبار webhook دون إرسال رسالة حقيقية؟
لا يمكن ذلك بالنسبة لـ webhooks الحساب، لأنها تُشغَّل بواسطة الرسائل الواردة. استخدم رقم WhatsApp للاختبار (خاص بك أو من زميل) لإنشاء الحدث. أما بالنسبة للتدفقات، فإن التسجيل اليدوي لجهة اتصال تحكم يسمح بالاختبار دون أن يكون العميل المحتمل عميلاً حقيقيًا.
هل Webhook.site مجاني؟ هل يجب استخدامه في الإنتاج؟
نعم، يقوم Webhook.site بإنشاء عناوين URL عامة مؤقتة ويعرض حركة المرور في الوقت الفعلي، وهي مثالية لتصحيح الأخطاء. لا تستخدم أبدًا عناوين URL هذه في الإنتاج — بعد الاختبار، استبدلها بعنوان URL لنظامك الوجهة.
تم تشغيل webhook ولكن الحمولة فارغة. ما الذي يجب التحقق منه؟
بالنسبة لـ webhooks الحساب، تحقق من المشغل (ما إذا كان يلتقط نوع الرسالة الصحيح) وأذونات صندوق الوارد. بالنسبة لإجراء التدفق، راجع المتغيرات في النص — لن يتم ملء حقول مثل {{contact.name}} إلا إذا كانت جهة الاتصال تحتوي على حقل الاسم مسجلاً. اختبر مع جهة اتصال تحتوي على بيانات كاملة.
كيف يمكن تصحيح أخطاء 401 (غير مصرح) أو 403 (محظور)؟
تشير هذه الأخطاء إلى أن النظام الوجهة رفض الطلب. أضف رأس مصادقة (على سبيل المثال، Authorization: Bearer seu-token) في حقل Headers في تكوين webhook، وفقًا لما توضحه وثائق الأداة الخارجية.
هل يمكنني اختبار webhooks من Kanban بنفس الطريقة؟
نعم. يمكن اختبار webhooks التي تم تكوينها في وحدة Kanban باستخدام عنوان URL مؤقت من Webhook.site — ما عليك سوى نقل بطاقة من عمود إلى آخر (الإجراء الذي يشغل الحدث) وفحص الحمولة في لوحة الاختبار.
هل أحتاج إلى إبقاء التدفق نشطًا لاختبار webhook؟
نعم. فقط التدفقات ذات الحالة نشط تعالج عقدة webhook. قم بتفعيل التدفق، وأجرِ الاختبار، ثم قم بتعطيله بعد ذلك إذا لزم الأمر.
اقرأ أيضًا
- كيفية اختبار تدفق أتمتة قبل تفعيله
- كيفية إرسال بيانات جهات الاتصال الجديدة إلى Google Sheets عبر webhook
مع المستخدم الأول المجاني، يمكنك بالفعل إنشاء webhooks واختبار التكاملات دون التزام.