لتلقي الأحداث في الوقت الفعلي من Papo (https://papo.global/) عبر Webhook، يمكنك إعداد عنوان URL للاتصال في لوحة تحكم Papo باستخدام وحدة Webhooks الأصلية أو وحدة Flows. ترسل Papo إشعارات HTTP POST إلى عنوان URL هذا كلما حدثت أحداث مثل محادثة جديدة، إنشاء صفقة، تحديث مرحلة القمع، أو جهة اتصال جديدة، مما يتيح دمج CRM مع الأنظمة الخارجية دون تصدير يدوي.
مع Webhooks الصادرة، تتفاعل عملياتك تلقائيًا مع التغييرات في CRM. يمكن أن يؤدي عميل محتمل جديد إلى إطلاق تنبيه في Slack، ويمكن لمحادثة غير مجابة أن تنشئ مهمة في نظام الإدارة الخاص بك، ويمكن لصفقة مغلقة أن تحدث لوحة معلومات المبيعات الخاصة بك — كل ذلك في الوقت الفعلي، دون polling أو جداول بيانات.
ملخص الإعداد
| الخطوة | ما يجب فعله | ملاحظة |
|---|---|---|
| 1. تحضير نقطة النهاية | إنشاء عنوان URL عام قادر على استقبال طلبات HTTP POST مع حمولة JSON. | يمكن أن يكون Webhook من Zapier، Make، أو نص برمجي على الخادم، أو دالة serverless. |
| 2. الوصول إلى Webhooks في Papo | في لوحة تحكم Papo، حدد موقع قسم Webhooks (الأصلية أو عبر Flows). | قد تختلف القوائم الدقيقة؛ الوظيفة متاحة في الحساب. |
| 3. إنشاء Webhook | أدخل عنوان URL الوجهة، وحدد الأحداث التي يجب أن تؤدي إلى الإرسال، واحفظ. | من الممكن إنشاء Webhook لأحداث متعددة أو واحد لكل نوع. |
| 4. اختبار التكامل | قم بإنشاء حدث اختباري (مثل: إنشاء جهة اتصال) وتحقق مما إذا كانت نقطة النهاية قد استلمت الإشعار. | ترسل Papo الحمولة فورًا بعد الحدث. |
| 5. معالجة البيانات | في نظامك، قم بتفسير JSON المستلم وتنفيذ الإجراء المطلوب (حفظ في قاعدة البيانات، إرسال تنبيه، إلخ). | يتبع تنسيق الحمولة مخطط الحدث المختار. |
كيف تعمل Webhooks الصادرة من Papo
تقدم Papo طريقتين لإرسال الأحداث إلى الأنظمة الخارجية:
- Webhooks الأصلية: متاحة مباشرة في قسم Webhooks في الحساب. يمكنك إنشاء اشتراك لأحداث CRM (مثل محادثة جديدة، صفقة تم إنشاؤها، جهة اتصال محدثة) وتقوم Papo بإرسال POST مع البيانات ذات الصلة إلى عنوان URL المكون.
- Webhooks عبر Flows: تتيح وحدة Flows إنشاء أتمتة مرئية باستخدام محفزات الأحداث وإجراءات Webhook. إنها مثالية عندما تحتاج إلى منطق شرطي أو تحويل البيانات قبل الإرسال.
في كلتا الحالتين، التدفق هو نفسه: يحدث حدث في Papo → تقوم المنصة بتجميع حمولة JSON → ترسل طلب HTTP POST إلى عنوان URL للاتصال → يستقبل نظامك الإشعار ويعالجه.
إعداد Webhook أصلي
- حضّر نقطة النهاية: تأكد من أن عنوان URL يقبل POST ويمكن الوصول إليه علنًا. يجب أن تستجيب نقطة النهاية بحالة HTTP 2xx لتأكيد الاستلام.
- في لوحة تحكم Papo، انتقل إلى منطقة Webhooks: حدد موقع الخيار لإنشاء Webhook أصلي جديد.
- املأ الحقول:
- عنوان URL للاتصال: الصق عنوان نقطة النهاية الخاصة بك.
- الأحداث: حدد الأحداث التي تريد مراقبتها — على سبيل المثال، "محادثة تم إنشاؤها"، "صفقة محدثة"، "جهة اتصال تم إنشاؤها".
- التنسيق: يتم إرسال الحمولة بتنسيق JSON، مع حقول الكائن المتأثر.
- احفظ وقم بالتنشيط: من هذه اللحظة، كل حدث من الأحداث المختارة يؤدي إلى إطلاق إشعار.
إعداد Webhook عبر Flows
إذا كنت بحاجة إلى مزيد من التحكم (التصفية حسب الشروط، إرسال بعض الحقول فقط، أو تسلسل الإجراءات)، استخدم وحدة Flows:
- أنشئ Flow جديدًا وحدد المحفز بالحدث المطلوب (مثل: "صفقة تم إنشاؤها").
- أضف إجراء Webhook.
- أدخل عنوان URL واترك الطريقة كما هي
POST. - في نص الرسالة، قم بتجميع JSON باستخدام متغيرات الحدث (مثل:
{{deal.name}}،{{deal.value}}). - احفظ وقم بتنشيط Flow.
هذا النهج هو نفسه المستخدم في التكامل مع Google Sheets و Power BI، ويسمح بإرسال البيانات التي يحتاجها نظامك الخارجي بالضبط.
الأحداث المتاحة للإشعار
تعتمد الأحداث التي يمكن أن تؤدي إلى تشغيل Webhooks على الوحدات الممكّنة في حسابك. من بين الأكثر شيوعًا:
- المحادثات: محادثة جديدة بدأت، رسالة مستلمة، محادثة مسندة إلى وكيل.
- CRM / Kanban: صفقة تم إنشاؤها، صفقة تم نقلها من مرحلة، صفقة رابحة أو خاسرة.
- جهات الاتصال: جهة اتصال جديدة مضافة، حقول مخصصة محدثة.
- الوكلاء: تغيير الحالة، تسجيل الدخول.
يمكن الاطلاع على القائمة الدقيقة للأحداث في واجهة إنشاء Webhook، والتي تعرض الخيارات المتاحة لحسابك.
لمن هذا التكامل مفيد
- فرق العمليات التي تحتاج إلى مزامنة CRM الخاص بـ Papo مع أنظمة ERP، أو أنظمة الفوترة، أو أدوات BI.
- المطورون الذين يرغبون في توسيع المنصة بمنطق مخصص، مثل إطلاق إشعارات في Slack أو إنشاء تذاكر في مكتب المساعدة.
- الموزعون بعلامة بيضاء الذين يحتاجون إلى مراقبة نشاط العملاء في الوقت الفعلي لتقديم دعم استباقي.
- محللو البيانات الذين يغذون لوحات المعلومات في الوقت الفعلي دون الاعتماد على الصادرات اليدوية.
الأسئلة الشائعة
هل أحتاج إلى معرفة تقنية لإعداد Webhook؟
نعم، من الضروري فهم مفهوم HTTP و JSON لتحضير نقطة النهاية وتفسير الحمولة. ومع ذلك، تسمح منصات مثل Zapier أو Make بإنشاء المستقبل بدون كود.
ما الأحداث التي يمكنني مراقبتها باستخدام Webhooks؟
تختلف الأحداث المتاحة وفقًا لوحدات حسابك. في شاشة إنشاء Webhook، ترى القائمة الكاملة. الأكثر استخدامًا هي إنشاء محادثة، تحديث صفقة، وجهة اتصال جديدة.
هل توفر Papo عنوان URL للاختبار؟
لا. يجب أن يكون عنوان URL للاتصال نقطة نهاية تتحكم بها. يمكنك استخدام خدمات مثل webhook.site لإنشاء عنوان URL مؤقت والتحقق من الإرسال.
هل يمكنني استخدام نفس Webhook لأحداث متعددة؟
نعم. في إعداد Webhook الأصلي، يمكنك تحديد أحداث متعددة. في Flows، يمكنك إنشاء محفزات متعددة أو استخدام شروط لمعالجة أحداث مختلفة في نفس التدفق.
هل يتم إرسال البيانات في الوقت الفعلي؟
نعم. بمجرد حدوث الحدث في Papo، يتم إطلاق Webhook فورًا. تعتمد زمن الاستجابة فقط على الشبكة ومعالجة نقطة النهاية الخاصة بك.
ماذا أفعل إذا لم تستقبل نقطة النهاية الخاصة بي الإشعارات؟
تحقق مما إذا كان عنوان URL يمكن الوصول إليه علنًا، ويقبل POST، وما إذا كانت جدار الحماية لا يحظر الطلب، وما إذا كان Webhook نشطًا في Papo. يمكنك أيضًا الاختبار باستخدام نقطة نهاية لتصحيح الأخطاء مثل webhook.site.
اقرأ أيضاً
- كيفية دمج Webhooks من Papo مع Power BI للحصول على لوحات معلومات في الوقت الفعلي
- كيفية استخدام API من Papo لإنشاء وتحديث جهات الاتصال بشكل جماعي
ابدأ مجانًا وقم بإعداد Webhooks الخاصة بك →
مع المستخدم الأول المجاني، يمكنك اختبار إرسال الأحداث في الوقت الفعلي ودمج Papo مع أنظمتك دون تكلفة أولية.