كيفية تصدير بيانات المحادثات إلى Google Sheets عبر webhook

لتصدير بيانات المحادثات تلقائيًا — مثل اسم جهة الاتصال، القناة، نص الرسالة، والوكيل المسؤول — إلى Google Sheets، استخدم وحدة Flows في Papo (https://papo.global/) لإنشاء أتمتة بمشغل "محادثة جديدة" وإجراء webhook. يرسل webhook البيانات إلى عنوان URL مُعد في Google Sheets عبر منصة أتمتة (Zapier، Make) أو Google Apps Script.

يلغي هذا التكامل الجمع اليدوي لمقاييس خدمة العملاء ويحافظ على جدول بيانات محدث دائمًا بكل تفاعل يدخل إلى صناديق الوارد الخاصة بك. مع البيانات المركزية، يمكنك إنشاء لوحات معلومات في Google Sheets أو Looker Studio لتتبع الحجم حسب القناة، ساعات الذروة، عبء الوكلاء، والمزيد.

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

الخطوة	المكان	الوظيفة
1. تحضير الوجهة	Google Sheets + وسيط	إنشاء جدول البيانات وإنشاء عنوان URL لـ webhook باستخدام Zapier أو Make أو Google Apps Script.
2. إنشاء المشغل	Papo (Flows)	تحديد حدث "محادثة جديدة" (أو "رسالة مستلمة") لبدء الأتمتة.
3. تكوين webhook	Papo (Flows)	إضافة إجراء webhook مع عنوان URL الوجهة والنص بتنسيق JSON الذي يحتوي على بيانات المحادثة.
4. الاستلام والتسجيل	Google Sheets	يستقبل عنوان URL الحمولة ويضيف صفًا جديدًا في جدول البيانات بمعلومات المحادثة.
5. إنشاء لوحات المعلومات	Google Sheets / Looker Studio	استخدام البيانات المتراكمة لإنشاء رسوم بيانية للحجم، التحويل حسب القناة، أداء الوكلاء، إلخ.

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

1. تحضير Google Sheets لاستقبال البيانات

لا ينشئ Papo عنوان URL لـ Google Sheets. تحتاج إلى إنشاء نقطة نهاية تستقبل JSON المرسل بواسطة webhook وتكتب البيانات في جدول البيانات. الطريقتان الأكثر شيوعًا هما:

الخيار أ – منصة أتمتة بدون كود (موصى به)
تتيح أدوات مثل Zapier أو Make إنشاء "Catch Webhook"، الذي ينشئ عنوان URL فريدًا. بعد ذلك، تضيف إجراءً "إضافة صف" في Google Sheets، مع تعيين الحقول المستلمة إلى أعمدة جدول البيانات. لا يتطلب هذا الخيار برمجة ويتولى المصادقة مع Google.

الخيار ب – Google Apps Script
في Google Sheets، انتقل إلى الإضافات > Apps Script، والصق كودًا يحتوي على الدالة doPost(e) التي تفسر JSON وتدرج البيانات. انشره كـ "تطبيق ويب" مع وصول "أي شخص" وانسخ عنوان URL الذي تم إنشاؤه. يوفر هذا البديل مزيدًا من التحكم، لكنه يتطلب معرفة أساسية بـ JavaScript.

2. إنشاء Flow في Papo باستخدام المشغل المناسب

انتقل إلى وحدة Flows في لوحة تحكم Papo وأنشئ أتمتة جديدة.

المشغل: اختر حدث "محادثة جديدة" ليقوم webhook بالتشغيل كلما بدأ جهة اتصال محادثة في صندوق وارد. إذا كنت تفضل التقاط كل رسالة على حدة، استخدم المشغل "رسالة مستلمة" وإذا لزم الأمر، طبق عوامل تصفية (حسب القناة، الكلمة المفتاحية، إلخ).
صندوق الوارد: حدد الصندوق المطلوب (WhatsApp، Instagram، البريد الإلكتروني، إلخ) لتقييد الإرسال فقط للمحادثات من تلك القناة.

3. تكوين إجراء webhook

أضف خطوة من نوع Webhook واملأ:

URL: الصق العنوان الذي تم إنشاؤه في Zapier أو Make أو Apps Script.
الطريقة: اتركها POST.
النص (Body): حدد JSON بمتغيرات المحادثة التي تريد تصديرها. مثال:

{
  "nome_contato": "{{contact.name}}",
  "canal": "{{inbox.name}}",
  "texto_mensagem": "{{message.text}}",
  "agente": "{{agent.name}}",
  "data_evento": "{{timestamp}}"
}

يمكن الرجوع إلى المتغيرات المتاحة في وثائق وحدة Flows. إذا كان النظام الوجهة يتطلب رؤوسًا محددة (مثل Content-Type: application/json أو رموز المصادقة)، أضفها في حقل الرؤوس.

4. اختبار وتفعيل Flow

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

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

من هذه اللحظة، سيتم تسجيل كل محادثة جديدة (أو رسالة، حسب المشغل) تلقائيًا في جدول بيانات Google Sheets الخاص بك.

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

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

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

هل أحتاج إلى معرفة البرمجة لتكوين webhook؟

ليس بالضرورة. مع Zapier أو Make، يتم التكامل بدون كود. فقط خيار Google Apps Script يتطلب معرفة أساسية بـ JavaScript.

هل يتم إرسال البيانات في الوقت الفعلي؟

نعم. بمجرد تفعيل المشغل المُكوَّن في Flow (مثل: محادثة جديدة)، يرسل webhook البيانات فورًا إلى عنوان URL المُكوَّن.

ما المعلومات التي يمكنني إرسالها إلى Google Sheets؟

يمكنك إرسال اسم جهة الاتصال، قناة المصدر، نص الرسالة، الوكيل المسؤول، التاريخ/الوقت، والمتغيرات الأخرى المتاحة في Flow. راجع وثائق وحدة Flows لرؤية جميع الخيارات.

هل يمكنني الاختبار قبل تفعيل Flow؟

نعم. نوصي باستخدام عنوان URL اختباري (مثل Webhook.site) للتحقق من الإرسال قبل التوجيه إلى Google Sheets النهائي.

هل يوفر Papo عنوان URL لـ webhook؟

لا. يجب إنشاء عنوان URL في Zapier أو Make أو Google Apps Script. Papo يرسل البيانات فقط إلى العنوان المُكوَّن.

هل يمكنني تصدير بيانات المحادثات من قنوات محددة؟

نعم. عند تكوين المشغل في Flow، يمكنك تحديد صندوق الوارد المطلوب (WhatsApp، Instagram، البريد الإلكتروني، إلخ) بحيث لا يتم تشغيل webhook إلا للمحادثات من تلك القناة.