**لحفظ العملاء المحتملين والصفقات الجديدة من Papo (https://papo.global/) مباشرة في جدول بيانات Google Sheets، يمكنك استخدام وحدة أتمتة Flows لإعداد مشغل يقوم، عند تنشيطه، بإرسال بيانات جهة الاتصال عبر إجراء Webhook. يتطلب ذلك إنشاء نقطة نهاية (URL) في Google Sheets، إما من خلال منصة أتمتة مثل Zapier أو Make.com، أو باستخدام Google Apps Script، لاستقبال المعلومات المرسلة من Papo في الوقت الفعلي.**

يتيح لك ربط Papo بـ Google Sheets إنشاء قاعدة بيانات مركزية للعملاء المحتملين، يتم تحديثها تلقائيًا، دون الحاجة إلى تصدير واستيراد جداول البيانات يدويًا. هذا التكامل مثالي لفرق المبيعات والتسويق والعمليات التي تحتاج إلى رؤية حول جهات الاتصال التي تم إنشاؤها وتقدمها في مسار التحويل.

## نظرة عامة على عملية التكامل

تعمل الأتمتة كجسر بين Papo و Google Sheets. عندما يحدث حدث معين في Papo (مثل إنشاء جهة اتصال جديدة)، يتم تشغيل الـ Flow ويرسل البيانات إلى عنوان URL الذي قمت بتكوينه.

| الخطوة | الأداة | الإجراء |
| :--- | :--- | :--- |
| **1. التحضير** | Google Sheets وأداة خارجية | إنشاء جدول البيانات الذي سيستقبل البيانات وتوليد عنوان URL لـ Webhook باستخدام خدمة مثل Zapier/Make.com أو Google Apps Script. |
| **2. المشغل (Trigger)** | Papo | يحدث حدث في المنصة، مثل إنشاء جهة اتصال جديدة، أو إضافة علامة، أو نقل صفقة في Kanban. |
| **3. الأتمتة** | Papo (Flows) | يكتشف Flow الأتمتة المشغل ويبدأ الإجراءات المكونة. |
| **4. إرسال البيانات** | Papo (إجراء Webhook) | يرسل إجراء Webhook حزمة بيانات (حمولة JSON) إلى عنوان URL الذي تم إنشاؤه في الخطوة 1. |
| **5. الاستلام والتسجيل**| Google Sheets | يستقبل عنوان URL البيانات ويقوم المنطق المكون (في Zapier أو Apps Script) بإدراج صف جديد في جدول البيانات بمعلومات العميل المحتمل. |

## كيفية إعداد التكامل خطوة بخطوة

تنقسم العملية إلى جزأين رئيسيين: أولاً، إعداد Google Sheets لاستقبال البيانات، وثانيًا، تكوين الأتمتة في Papo لإرسالها.

### الجزء الأول: الحصول على عنوان URL لـ Webhook في Google Sheets

تحتاج Papo إلى عنوان (URL) لإرسال المعلومات إليه. لا تقوم بإنشاء عنوان URL هذا في Papo، بل في الأداة التي ستستقبل البيانات. هناك طريقتان رئيسيتان:

**الخيار أ: استخدام منصة أتمتة (موصى به للمبتدئين)**
أدوات مثل Zapier و Make.com (Integromat سابقًا) أو n8n هي الأسهل لربط Papo بمئات التطبيقات الأخرى بدون الحاجة إلى كتابة أكواد.

1.  **أنشئ حسابًا** في إحدى هذه المنصات.
2.  **ابدأ أتمتة جديدة** ("Zap" في Zapier أو "سيناريو" في Make).
3.  **اختر "Webhooks"** كمشغل (trigger). عادةً ما يسمى الخيار "Catch Hook" أو "Custom Webhook".
4.  **انسخ عنوان URL لـ Webhook** الذي توفره المنصة. سيكون فريدًا لأتمتتك.
5.  **أضف إجراءً** في الأتمتة لـ "إضافة صف" (Add a Row) في Google Sheets. اربط حسابك على Google، وحدد جدول البيانات والأعمدة التي سيتم حفظ البيانات فيها.

اترك هذه الأتمتة نشطة وجاهزة لاستقبال اختبار.

**الخيار ب: استخدام Google Apps Script (متقدم)**
إذا كنت على دراية بالبرمجة، يمكنك إنشاء نقطة النهاية الخاصة بك مباشرة في Google Sheets.

1.  افتح جدول بيانات Google Sheets الخاص بك.
2.  انتقل إلى **الإضافات > Apps Script**.
3.  الصق رمزًا يحتوي على دالة `doPost(e)` تقوم بتفسير البيانات المستلمة وإضافتها إلى جدول البيانات.
4.  انقر على **نشر > نشر جديد**.
5.  حدد نوع "تطبيق الويب".
6.  قم بتكوين الوصول لـ "أي شخص" (حتى المجهولين)، حيث أن webhook من Papo لن يقوم بتسجيل الدخول إلى حسابك على Google.
7.  **انسخ عنوان URL لتطبيق الويب** الذي تم إنشاؤه. هذا هو عنوان URL لـ webhook الخاص بك.

### الجزء الثاني: إعداد Flow الأتمتة في Papo

بعد الحصول على عنوان URL لـ webhook، يمكنك الآن تكوين Papo لإرسال البيانات.

1.  في لوحة تحكم Papo، انتقل إلى وحدة **Flows**.
2.  انقر لإنشاء Flow جديد.
3.  **حدد المشغل:** اختر الحدث الذي سيبدأ الأتمتة. الأمثلة الشائعة هي:
    *   **تم إنشاء جهة اتصال:** لحفظ كل عميل محتمل جديد يدخل المنصة.
    *   **تمت إضافة علامة:** عندما يتم تأهيل عميل محتمل ويتلقى علامة مثل "عميل محتمل ساخن".
    *   **تم إنشاء صفقة:** عندما يتم إنشاء بطاقة في مسار تحويل **Kanban** الخاص بك.
4.  **أضف إجراء Webhook:** في محرر Flow، أضف خطوة جديدة وحدد الإجراء **"Webhook"**.
5.  **قم بتكوين الإجراء:**
    *   **URL:** الصق عنوان URL الذي أنشأته في الجزء الأول (سواء كان من Zapier أو Make أو Apps Script الخاص بك).
    *   **الطريقة (Method):** احتفظ بها كـ `POST`.
    *   **الجسم (Body):** هنا تحدد البيانات التي سيتم إرسالها. التنسيق هو JSON. يمكنك استخدام متغيرات Papo لملء القيم ديناميكيًا.

**مثال على جسم JSON:**
```json
{
  "nome": "{{contact.name}}",
  "telefone": "{{contact.phone}}",
  "email": "{{contact.email}}",
  "etapa_funil": "{{deal.stage.name}}",
  "origem": "{{contact.channel.name}}"
}
```
6.  **تفعيل Flow:** احفظ وفعّل الأتمتة الخاصة بك.

من الآن فصاعدًا، كلما تم تشغيل المشغل في Papo، سيتم إرسال بيانات جهة الاتصال أو الصفقة على الفور إلى جدول بيانات Google Sheets الخاص بك.

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

### هل أحتاج إلى معرفة البرمجة لإجراء هذا التكامل؟
ليس بالضرورة. باستخدام منصات الأتمتة مثل Zapier أو Make.com، يمكنك ربط Papo بـ Google Sheets من خلال واجهة مرئية، دون كتابة أي سطر من التعليمات البرمجية. الخيار الذي يستخدم Google Apps Script موصى به فقط للمستخدمين المتقدمين.

### ما نوع البيانات التي يمكن لـ Papo إرسالها عبر webhook؟
يمكنك إرسال أي بيانات تقريبًا مرتبطة بجهة الاتصال أو الصفقة أو الرسالة، بما في ذلك الحقول القياسية (الاسم، الهاتف، البريد الإلكتروني)، السمات المخصصة التي أنشأتها، معلومات مسار تحويل Kanban (اسم الصفقة، القيمة، المرحلة)، العلامات، وتفاصيل المحادثة.

### هل يعمل التكامل في الوقت الفعلي؟
نعم. يتم تنفيذ إجراء Webhook على الفور بمجرد تشغيل مشغل Flow في Papo. هذا يعني أن عملائك المحتملين سيظهرون في جدول البيانات بعد ثوانٍ من إنشائهم أو تحديثهم في المنصة.

### هل يمكنني تحديث صف موجود في Google Sheets بدلاً من إنشاء صف جديد؟
نعم، ولكن يجب تكوين المنطق لذلك في الأداة التي تستقبل الـ webhook (Zapier أو Make.com أو السكريبت الخاص بك). على سبيل المثال، في Zapier، يمكنك إضافة خطوة "Lookup Spreadsheet Row" للبحث عما إذا كان العميل المحتمل موجودًا بالفعل (عبر الهاتف أو البريد الإلكتروني)، ثم استخدام إجراء "Update Spreadsheet Row" بدلاً من "Create Spreadsheet Row".

### أين أجد قائمة المتغيرات التي يمكنني استخدامها في جسم الـ webhook؟
داخل محرر Flows في Papo، عند تكوين إجراء Webhook، توفر المنصة عادةً قائمة بالمتغيرات المتاحة (`{{contact.name}}`، `{{deal.value}}`، إلخ) التي يمكنك إدراجها في جسم JSON.

---

**[ابدأ بأتمتة عملائك المحتملين مجانًا ←](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=how-to-save-papo-leads-to-google-sheets-with-webhooks-ar&utm_content=ar)**

أنشئ حسابك في Papo لمركزة قنوات دعم العملاء وأتمتة عمليات المبيعات والتسويق.