**لإعادة توجيه البيانات الوصفية للمحادثات التي تجري في Papo — مثل اسم العميل، القناة، نص الرسالة، والوكيل المسؤول — إلى أداة Business Intelligence، استخدم إجراء “إرسال Webhook” داخل Flows في Papo (https://papo.global/). مع كل محادثة جديدة أو رسالة واردة، تُرسل البيانات تلقائيًا إلى نقطة النهاية المُعدّة، مما يغذي نظام BI لديك بمعلومات محدّثة في الوقت الفعلي ويلغي الحاجة إلى التصدير اليدوي.**

مع هذا التكامل، تحوّل كل تفاعل على WhatsApp أو Instagram أو البريد الإلكتروني أو أي قناة أخرى إلى نقطة بيانات للوحات المعلومات، وتقارير حجم الدعم، وتحليل التحويل حسب القناة وغير ذلك. ما عليك سوى إعداد Flow باستخدام المشغّل المناسب وتوجيه Webhook إلى عنوان URL الذي توفره منصة BI لديك أو أدوات وسيطة مثل Zapier أو Make أو n8n أو نقطة نهاية خاصة بك.

| الخطوة | الوصف | مثال لـ BI |
| :--- | :--- | :--- |
| **1. الحصول على عنوان URL للـ Webhook** | يجب أن يوفر النظام الهدف نقطة نهاية HTTP قادرة على استقبال طلبات POST بحمولة JSON. | عنوان URL الذي ينشئه Power Automate أو Zapier أو Make أو n8n أو BI نفسه (مثل: REST API). |
| **2. إنشاء Flow في Papo** | في وحدة Flows، أنشئ تدفقًا بمشغّل يُفعّل عند بدء محادثة أو استلام رسالة. | مشغّل “محادثة جديدة” في صندوق وارد WhatsApp Gold. |
| **3. إضافة إجراء “إرسال Webhook”** | أدخل عنوان URL الهدف، أبقِ الطريقة POST، وأنشئ جسم الطلب باستخدام متغيرات المحادثة. | Payload: `{"الاسم": "{{contact.name}}", "القناة": "{{inbox.name}}", "النص": "{{message.text}}"}`. |
| **4. الاختبار والتفعيل** | استخدم عنوان URL تجريبيًا (مثل Webhook.site) للتحقق من الإرسال قبل توجيهه إلى البيئة الفعلية. | تحقق من ظهور الحقول بشكل صحيح في المستقبِل، ثم فعّل Flow بعد التأكيد. |

## كيف يعمل – خطوة بخطوة

### 1. جهّز نقطة النهاية في نظام BI لديك

لا تولّد Papo عنوان URL الهدف — تحتاج إلى خدمة تستقبل البيانات وتخزّنها. الطرق الرئيسية:

- **منصة أتمتة (موصى بها)**: يستطيع Zapier أو Make (Integromat) أو n8n إنشاء “Catch Webhook”، وتوليد عنوان URL فريد، ثم ربط البيانات المستلمة بـ BI (Google Data Studio، Power BI، Tableau) أو بقاعدة بيانات.
- **Webhook مباشر من BI**: بعض البيئات، مثل Power BI، تقبل بث البيانات عبر API. في هذه الحالة، اتبع تعليمات المنصة لتوفير نقطة نهاية.
- **Backend خاص**: إذا كانت لديك API خاصة، يمكنك بناء نقطة نهاية تعالج البيانات وتُدخلها في مستودع البيانات لديك.

### 2. أنشئ Flow في Papo باستخدام المشغّل المناسب

انتقل إلى وحدة **Flows** وأنشئ تدفقًا جديدًا. المشغّل الأكثر شيوعًا لتغذية BI هو “**محادثة جديدة**” — وبذلك يُنشئ كل جهة اتصال جديدة تصل إلى صندوق وارد سجلًا في نظام التحليل لديك.

يمكنك أيضًا استخدام مشغّل **رسالة واردة** وضبط عوامل التصفية:

- **كل الرسائل**: يُفعّل Webhook لأي تفاعل.
- **رسائل محددة**: يُفعّل فقط عندما تحتوي الرسالة على كلمة مفتاحية معينة، أو تأتي من قناة محددة، إلخ.

اختر صندوق الوارد المطلوب (مثل: WhatsApp، Instagram، البريد الإلكتروني) بحيث تُرسل محادثات تلك القناة فقط.

### 3. اضبط إجراء “إرسال Webhook”

أضف عقدة إجراء من نوع **Webhook** واملأ:

- **URL**: الصق نقطة النهاية التي حصلت عليها في الخطوة 1.
- **طريقة HTTP**: أبقِ `POST`.
- **الجسم (Payload)**: حدّد بيانات المحادثة التي ستُرسل. استخدم المتغيرات المتاحة في Flow، مثل:

  ```json
  {
    "اسم_العميل": "{{contact.name}}",
    "بريد_العميل": "{{contact.email}}",
    "قناة_المصدر": "{{inbox.name}}",
    "نص_الرسالة": "{{message.text}}",
    "تاريخ_الحدث": "{{timestamp}}",
    "الوكيل_الحالي": "{{agent.name}}"
  }
  ```

يمكنك تضمين أي متغير من سياق المحادثة — راجع وثائق Flows للاطلاع على كل الخيارات.

إذا لزم الأمر، أضف رؤوسًا (headers) مثل `Content-Type: application/json` أو رموز مصادقة يطلبها النظام الهدف.

### 4. اختبر Flow وفعّله

قبل التشغيل في الإنتاج، قم بإجراء اختبار:

1. استخدم عنوان URL تجريبيًا (مثل Webhook.site) بدلًا من العنوان النهائي، وأطلق محادثة في صندوق الوارد المُعدّ.
2. تحقق من وصول الحمولة (payload) بشكل صحيح، مع كل الحقول والقيم المتوقعة.
3. استبدل العنوان بالعنوان النهائي وفعّل Flow.

من هذه اللحظة، ستُفعّل كل محادثة (أو رسالة، حسب المشغّل) Webhook تلقائيًا.

## لمن يكون هذا التكامل مفيدًا

- **محللو البيانات وBI** الذين يحتاجون إلى تجميع مقاييس الدعم دون الاعتماد على تصدير CSV يدوي.
- **مديرو العمليات** الذين يرغبون في لوحات معلومات تعرض حجم المحادثات حسب القناة، وساعة الذروة، وحمل الوكلاء.
- **فرق التسويق والمبيعات** التي تريد ربط بيانات المحادثات بالحملات ومسارات التحويل في CRM.
- **الشركات التي تستخدم بالفعل أدوات مثل Power BI أو Tableau أو Looker Studio** وترغب في تغذية لوحات المعلومات ببيانات حقيقية من WhatsApp والقنوات الأخرى.

## الأسئلة الشائعة (FAQ)

### ما البيانات الوصفية للمحادثات التي يمكنني إرسالها إلى BI؟
يمكنك إرسال أي متغير متاح في سياق Flow، مثل اسم جهة الاتصال، ومحتوى الرسالة، وقناة المصدر، والبريد الإلكتروني، والهاتف، والوكيل المعيّن، والتاريخ/الوقت. يتيح الجمع بين هذه الحقول إنشاء تقارير عن الحجم، ووقت الاستجابة، ومصدر العملاء المحتملين.

### نظام BI لدي لا يحتوي على Webhook أصلي. كيف أقوم بالتكامل؟
أبسط طريقة هي استخدام منصة أتمتة (Zapier، Make، n8n). تولّد هذه الأدوات عنوان URL للـ Webhook، وتستقبل بيانات Papo، ثم توجّهها إلى BI عبر موصلات جاهزة أو APIs. وبذلك لا تحتاج إلى برمجة نقطة نهاية خاصة بك.

### هل يمكنني تصفية المحادثات التي تُرسل البيانات؟
نعم. في مشغّل Flow، يمكنك اختيار صندوق وارد محدد وضبط خيار “رسائل محددة”، وتحديد كلمات مفتاحية أو معايير أخرى. وبذلك لا تُفعّل Webhook إلا التفاعلات المطابقة للتصفية.

### هل تُرسل البيانات في الوقت الفعلي؟
نعم. يُفعّل Webhook بمجرد حدوث الحدث المُعدّ (محادثة جديدة أو رسالة واردة)، مما يسمح بتحديث BI لديك شبه فوري.

### ماذا يحدث إذا فشل طلب Webhook؟
يسجّل Flow في Papo الخطأ. يمكنك مراجعة سجل التنفيذ في Flow لتحديد الأعطال، وإذا أردت، ضبط إجراءات احتياطية (مثل إرسال بريد إلكتروني للتنبيه) لضمان عدم فقدان أي معلومات حرجة.

### هل هناك حدود لاستخدام Webhooks؟
ميزات Flows وإرسال Webhooks مضمنة في المنصة. المعلومات المحددة حول حدود الطلبات وحجم البيانات، إن وُجدت، تُعرض على موقع Papo أو في لوحة التحكم وفقًا للخطة المشتركة.

## اقرأ أيضًا

- [كيفية إرسال بيانات جهات الاتصال الجديدة إلى Google Sheets عبر Webhook](/hc/papo/articles/send-new-contact-data-to-google-sheets-via-webhook)
- [كيفية تصدير مقاييس التقارير إلى جداول بيانات خارجية](/hc/papo/articles/how-to-export-report-metrics-to-external-spreadsheets-ar)

---

**[ابدأ مجانًا →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)**

وحّد دعمك على WhatsApp وغذِّ لوحات معلومات مخصصة ببيانات حقيقية من المحادثات، دون تصدير يدوي.