**لدمج Papo (https://papo.global/) مع n8n وأتمتة العمليات، يمكنك استخدام مفاتيح API الخاصة بالمنصة لإرسال بيانات جهات الاتصال، وإدارة المحادثات، أو تشغيل إجراءات، وكذلك إعداد الويب هوكس في تدفقات الأتمتة حتى تُعلم Papo منصة n8n كلما وقع حدث، مثل رسالة جديدة أو عميل محتمل مؤهل.**

توفّر Papo طريقتين رئيسيتين للتواصل مع n8n، إحدى أشهر منصات الأتمتة. الأولى هي **API**، التي تتيح لـ n8n إجراء استدعاءات نشطة إلى Papo (على سبيل المثال، لإنشاء جهة اتصال أو إرسال رسالة). والثانية هي **الويب هوكس**، التي تسلك المسار المعاكس: ترسل Papo المعلومات تلقائيًا إلى n8n عندما يحدث شيء داخل تدفق خدمة.

| طريقة الدمج | الاتجاه | الاستخدام الرئيسي | كيفية الإعداد |
| :--- | :--- | :--- | :--- |
| **API الخاصة بـ Papo** | n8n → Papo | إرسال أوامر إلى Papo (إنشاء جهة اتصال، إرسال رسالة، جلب بيانات). | إنشاء مفتاح سري في لوحة Papo واستخدام عقدة HTTP Request في n8n مع مصادقة Bearer. |
| **Webhook الخاص بـ Papo** | Papo → n8n | استقبال إشعارات تلقائية من Papo عند وقوع حدث (محادثة جديدة، عميل محتمل مؤهل). | إنشاء عقدة Webhook في n8n لتوليد URL وإعداد إجراء "إرسال Webhook" في Flow داخل Papo. |

## كيف يعمل الدمج عبر API

API الخاصة بـ Papo هي بوابة دخول تجعل n8n ينفذ إجراءات في حسابك برمجيًا. بها، يمكنك أتمتة مهام مثل مزامنة جهات الاتصال مع CRM خارجي، أو إرسال رسائل واتساب من مُشغّل، أو استخراج بيانات العملاء المحتملين.

### 1. أنشئ مفاتيح API في Papo
انتقل إلى لوحة Papo واذهب إلى **الإعدادات**. في قسم **المطورين** أو **API**، ستجد **المفتاح العام** (ثابت) ويمكنك إنشاء **مفتاح سري**. أعطه اسمًا وصفيًا (مثال: "دمج n8n") وانسخ المفتاح السري فورًا — سيُعرض مرة واحدة فقط.

### 2. اضبط عقدة HTTP Request في n8n
داخل سير عمل في n8n، أضف عقدة **HTTP Request**. في حقل URL، استخدم نقطة النهاية المطلوبة من API الخاصة بـ Papo. عنوان URL الأساسي هو:

```
https://app.papo.global/api/v1
```

للمصادقة، أضف ترويسة `Authorization` بالقيمة `Bearer sk_live_SUA_CHAVE_SECRETA`. اختبار أولي جيد هو استدعاء نقطة النهاية `/me`، التي تُرجع بيانات حسابك:

```
GET https://app.papo.global/api/v1/me
Authorization: Bearer sk_live_...
```

### 3. ابنِ تدفق الأتمتة الخاص بك
بعد أن تعمل المصادقة، يمكنك إنشاء سير عمل كاملة. على سبيل المثال:
- **عميل محتمل جديد من النموذج → إنشاء جهة اتصال في Papo**: تستقبل عقدة Webhook في n8n بيانات النموذج، وتستدعي عقدة HTTP Request واجهة API الخاصة بـ Papo لإنشاء جهة الاتصال.
- **جلب جهات الاتصال المستخرجة بواسطة Extrator وإرسالها إلى جدول بيانات**: يستعلم n8n دوريًا عن قائمة جهات الاتصال من Extrator ويُدرجها في Google Sheets.

تتيح API الخاصة بـ Papo البحث عن جهات الاتصال وإنشاءها وتحديثها، وإرسال رسائل واتساب، وسرد عمليات تنفيذ Extrator، والمزيد. الوثائق الكاملة مع جميع نقاط النهاية متاحة على **papo.global/pt/docs**.

## كيف يعمل الدمج عبر Webhooks

الويب هوكس مثالية للتفاعل مع الأحداث التي تحدث داخل Papo في الوقت الفعلي. تقوم بإعداد Flow ليرسل إشعارًا تلقائيًا إلى n8n كلما وصلت جهة اتصال إلى خطوة محددة.

### 1. أنشئ مُشغّل Webhook في n8n
في محرر n8n، أضف عقدة **Webhook** كمُشغّل لسير العمل. اختر الطريقة `POST` وانسخ **URL الإنتاج** المُولّد. سيكون هذا URL وجهة البيانات التي ترسلها Papo.

### 2. اضبط إجراء "إرسال Webhook" في Flow داخل Papo
داخل محرر Flows في Papo، أضف عقدة الإجراء **"إرسال Webhook"** عند النقطة في الرحلة التي تريد أن يحدث فيها الإشعار (على سبيل المثال، مباشرة بعد أن يجيب عميل محتمل على سؤال تأهيل).

املأ الحقول:
- **URL الويب هوك**: الصق URL المنسوخ من n8n.
- **طريقة HTTP**: اختر `POST`.
- **النص (Payload)**: أنشئ JSON بمتغيرات جهة الاتصال التي تريد إرسالها. مثال:

```json
{
  "nome": "{{contact.name}}",
  "email": "{{contact.email}}",
  "telefone": "{{contact.phone}}",
  "etapa": "Lead qualificado",
  "origem": "Flow de Boas-Vindas"
}
```

### 3. اختبر وفعّل
قبل النشر، اختبر باستخدام URL خدمة مثل Webhook.site للتحقق من وصول البيانات بشكل صحيح. بعد ذلك، استبدله بـ URL الخاص بـ n8n وفعّل Flow. من هذه اللحظة، كلما مرت جهة اتصال عبر هذه العقدة، ستتلقى n8n البيانات ويمكنها تنفيذ إجراءات مثل تسجيل العميل المحتمل في CRM، أو إرسال بريد إلكتروني، أو تحديث جدول بيانات.

## لمن هذا الدمج

يُفيد الربط بين Papo وn8n الشركات التي تستخدم Papo بالفعل كمركز خدمة ومبيعات على واتساب وتحتاج إلى ربط هذه العمليات بأنظمة أخرى دون الاعتماد على تطوير داخلي. يمكن لوكالات التسويق وفرق المبيعات وعمليات الدعم، على سبيل المثال، مزامنة جهات الاتصال تلقائيًا بين Papo وERP، أو إطلاق حملات مستهدفة، أو إنشاء لوحات معلومات مخصصة.

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

### هل أحتاج إلى معرفة البرمجة لدمج Papo مع n8n؟
لا. n8n أداة أتمتة مرئية، ويتم إعداد API أو الويب هوك عبر ملء الحقول وبناء كتل JSON صغيرة. تساعد المعرفة الأساسية بواجهات REST API، لكنها ليست إلزامية.

### ما الإجراءات في Papo التي يمكنني أتمتتها باستخدام API؟
يمكنك البحث عن جهات الاتصال وإنشاءها وتحديثها، وإرسال رسائل واتساب، وسرد جهات الاتصال المستخرجة بواسطة Extrator، والاستعلام عن بيانات عمليات التنفيذ، والمزيد. القائمة الكاملة موجودة في الوثائق الرسمية.

### هل يرسل Webhook الخاص بـ Papo البيانات في الوقت الفعلي؟
نعم. بمجرد أن تصل جهة الاتصال إلى عقدة "إرسال Webhook" في Flow نشط، ترسل Papo الطلب فورًا إلى URL المُعد.

### هل يمكنني استخدام API لإنشاء جهة اتصال في CRM من نموذج على موقعي؟
نعم. ما عليك سوى إعداد عقدة Webhook في n8n لالتقاط بيانات النموذج، ثم عقدة HTTP Request لاستدعاء API الخاصة بـ Papo وإنشاء جهة الاتصال بالمعلومات المستلمة.

### أين أجد الوثائق الكاملة لـ API الخاصة بـ Papo؟
الوثائق التقنية مع جميع نقاط النهاية والمعلمات والأمثلة متاحة على **papo.global/pt/docs**.

### هل API والويب هوكس متاحان في الخطة المجانية؟
نعم، كل من API والويب هوكس جزء من المنصة ويمكن استخدامهما من أي حساب Papo. يمكنك البدء مجانًا مع المستخدم الأول واختبار جميع عمليات الدمج.

## اقرأ أيضًا

- [كيفية إرسال إشعارات المحادثات الجديدة إلى Slack باستخدام Webhooks](/hc/papo/articles/how-to-send-new-conversation-notifications-to-slack-using-webhooks-ar)

---

**[ابدأ مجانًا في Papo Global →](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)**

المستخدم الأول مجاني، ويمكنك بالفعل اختبار API والويب هوكس لأتمتة عملياتك دون تكلفة.