**لدمج Papo (https://papo.global/) مع Zapier، تستخدم API REST الخاصة بـ Papo لتنفيذ الإجراءات وWebhooks الأصلية أو Flows لإرسال أحداث Papo إلى Zapier. وبذلك، يمكن لحدث مثل محادثة جديدة أو صفقة رابحة في Kanban أن يشغّل تلقائيًا إجراءات في مئات التطبيقات المتصلة بـ Zapier.**

لا تعتمد Papo على موصل حصري للعمل مع Zapier: تعرض المنصة نقاط نهاية REST وتتيح إنشاء Webhooks، وهذه بالضبط هي الآليات التي يستخدمها Zapier لاستقبال وإرسال البيانات. يوضح هذا الدليل الاتصال في اتجاهين: أحداث Papo كمشغلات في Zapier واستدعاءات API الخاصة بـ Papo كإجراءات.

## ملخص التكامل

| الميزة | ما الذي تفعله | أين تُضبط |
| :--- | :--- | :--- |
| API REST Papo | موثّقة بمفتاح سري؛ تتيح سرد الحساب، والمثيلات، وجهات الاتصال، وإرسال الرسائل، واستخدام الذكاء الاصطناعي | `https://app.papo.global/api/v1` مع مفتاح يُنشأ في لوحة التحكم في `https://app.papo.global/developers` |
| Webhook أصلي | يرسل أحداث الحساب إلى عنوان URL مُهيّأ | وحدة الأتمتة |
| Webhook Kanban | يرسل أحداث مسار البيع إلى عنوان URL مُهيّأ | وحدة Kanban |
| Flows | ينشئ أتمتة مرئية؛ يمكن لمشغّل مثل محادثة جديدة أن يستدعي إجراء Webhook | وحدة Flows |
| Webhooks by Zapier | يستقبل Webhook من Papo ويشغّل إجراءات في مئات التطبيقات | Zapier |

## ما تحتاج إليه قبل البدء

- حساب Papo مع وصول إلى لوحة التحكم.
- حساب Zapier.
- المفتاح السري لـ API Papo، المُنشأ في `https://app.papo.global/developers`.
- عنوان URL لـ Webhook من Zapier لاستقبال الأحداث.

يأتي المفتاح السري بالصيغة `sk_live_...` ولا يظهر إلا مرة واحدة عند الإنشاء. احفظه في مكان آمن، لأنه يوثّق استدعاءات API.

## كيف يعمل التكامل في اتجاهين

### من Papo إلى Zapier (مشغّل)

1. في Zapier، أنشئ Zap واختر **Webhooks by Zapier** كمشغّل، ضمن خيار **Catch Hook**. ينشئ Zapier عنوان URL فريدًا.
2. في Papo، أنشئ Webhook أصليًا، أو Webhook Kanban، أو Flow بإجراء Webhook.
3. الصق عنوان URL الخاص بـ Zapier في حقل الوجهة الخاص بـ Webhook أو الإجراء.
4. اضبط الحدث الذي يجب أن يطلق الإرسال. للمحادثات الجديدة، استخدم Flow بمشغّل **محادثة جديدة**. لأحداث مسار البيع، استخدم Webhooks الخاصة بـ Kanban.
5. في Zapier، أضف الإجراء المطلوب: إرسال بريد إلكتروني، إنشاء صف في جدول بيانات، تسجيل lead في CRM آخر، إشعار قناة Slack، إلخ.

### من Zapier إلى Papo (إجراء)

1. في Zapier، استخدم **Webhooks by Zapier** كإجراء، عادةً بطلب مخصص.
2. وجّهه إلى الأساس `https://app.papo.global/api/v1`.
3. أضف الترويسة `Authorization: Bearer sk_live_...` أو `X-Papo-Secret-Key`، وإذا أردت، `X-Papo-Public-Key`.
4. اختر endpoint حسب الإجراء: `POST /api/v1/messages` لإرسال رسالة WhatsApp، `GET /api/v1/contacts` لسرد جهات اتصال Extrator، `GET /api/v1/instances` للاستعلام عن اتصالات WhatsApp، وغيرها.
5. اربط البيانات القادمة من خطوات سابقة في Zap بجسم الطلب.

## أمثلة عملية على الأتمتة

- **محادثة جديدة على WhatsApp تنشئ lead في نظام آخر:** يشغّل Flow Webhook إلى Zapier كلما وصلت محادثة جديدة إلى صندوق وارد. ينسّق Zapier البيانات وينشئ lead في CRM الشركة.
- **صفقة رابحة في Kanban تحدّث جدول بيانات:** يرسل Webhook الخاص بـ Kanban الحدث إلى Zapier، الذي يسجّل البطاقة الرابحة في جدول بيانات أو نظام مالي.
- **رسائل برمجية:** يستدعي Zapier `POST /api/v1/messages` لإرسال تذكير للعميل بعد ملئه نموذجًا في تطبيق آخر.
- **ردود الذكاء الاصطناعي:** يمكن لـ Zapier استدعاء `POST /api/ai/v1/complete` لإنشاء رد باستخدام prompt الحساب في Papo واستخدام النتيجة في تدفق آخر.

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

- **فرق البيع** التي تحتاج إلى مزامنة الصفقات الرابحة مع جداول بيانات أو CRMs أو أدوات الفوترة.
- **فرق الدعم** التي تستخدم قنوات متعددة وتريد تسجيل المحادثات في أنظمة help desk.
- **عمليات التسويق** التي تطلق حملات من أحداث CRM، مثل جهة اتصال جديدة مستخرجة.
- **الشركات ذات stack متنوع** التي تريد تقليل العمل اليدوي بين WhatsApp وCRM والبريد الإلكتروني وجداول البيانات.

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

### هل أحتاج إلى موصل رسمي من Papo في Zapier؟

لا حاجة. يستخدم التكامل API REST وWebhooks الخاصة بـ Papo، وهما يعملان مع تطبيق Webhooks by Zapier. تفاصيل endpoints المتاحة موجودة في وثائق API.

### ما أحداث Papo التي يمكنها بدء Zap؟

يمكنك استخدام Flows لأحداث مثل محادثة جديدة، وWebhooks الأصلية أو الخاصة بـ Kanban لأحداث الأتمتة ومسار البيع. تظهر القائمة الكاملة للـ Webhooks المتاحة في لوحة تحكم Papo.

### كيف أوثّق API الخاصة بـ Papo في Zapier؟

استخدم المفتاح السري في الترويسة `Authorization: Bearer sk_live_...` أو في الترويسة `X-Papo-Secret-Key`. المفتاح العام (`pk_live_...`) اختياري عند إرساله مع المفتاح السري.

### هل يمكنني إرسال رسائل WhatsApp عبر Zapier؟

نعم. يمكنك إجراء طلب إلى `POST /api/v1/messages` مع تحديد رقم الوجهة والنص. تخرج الرسالة عبر WhatsApp المتصل بحسابك في Papo.

### هل يمكن لـ Zapier تحديث بطاقات Kanban؟

نعم، عبر API. تتيح Papo سرد البطاقات، وإنشاء بطاقة في مرحلة، ونقل البطاقات، ووسمها كرابحة أو خاسرة، ويمكن تشغيل ذلك من Zapier.

### ماذا أفعل إذا لم يصل Webhook إلى Zapier؟

تأكد من أن Webhook أو Flow نشط، وأن عنوان URL الخاص بـ Zapier تم لصقه بشكل صحيح، وأن المفتاح المستخدم في الاستدعاءات صالح. تساعد سجلات تنفيذ Flows في تحديد الخطأ.

## اقرأ أيضًا

- [الأتمتة في Papo: القواعد، والماكرو، وFlows، وWebhooks – أيها تستخدم؟](/hc/papo/articles/papo-automations-rules-macros-flows-webhooks-which-to-use)
- [كيفية استخدام API الخاصة بـ Papo لسرد المحادثات وإرسال رسائل برمجية](/hc/papo/articles/how-to-use-papo-api-list-conversations-send-messages)

---

**[ابدأ مجانًا واربط قنواتك →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=integrate-papo-with-zapier-using-api-and-webhooks&utm_content=ar)**

أنشئ حسابك المجاني على Papo لتوحيد الدعم وCRM والأتمتة في لوحة واحدة.