**لتصدير إحصائيات مكالمات الصوت من Papo (https://papo.global/) للتحليل الخارجي — سواء في جداول بيانات مثل Excel أو Google Sheets، أو في لوحات معلومات ذكاء الأعمال — يجب عليك استخدام API العام للمنصة. توفر وحدة «تقرير المكالمات» عرضاً ومرشحات مفصلة، لكن التصدير الآلي والقابل للبرمجة يعتمد على التكامل عبر API، الذي يعيد بيانات المكالمات بصيغة JSON.**

تجمع Papo جميع مقاييس الصوت في لوحة أصلية، مع معلومات مثل إجمالي المكالمات، والاتجاه (واردة أو صادرة)، والحالة (تم الرد، لم يتم الرد، مشغولة)، والطريقة (PapoCall، مكالمات واتساب، إلخ) والتسجيلات (عند توفرها). لدمج هذه البيانات مع مصادر أخرى، أو حساب مؤشرات أداء خاصة، أو تغذية أدوات خارجية، فإن API هو المسار الموصى به.

## ملخص طرق الحصول على بيانات المكالمات الصوتية

| الطريقة | مثالية لـ | كيف تعمل في Papo |
| :--- | :--- | :--- |
| **API الخاص بـ Papo** | استعلامات مجدولة، لوحات معلومات مخصصة، وتكامل مع الجداول/ذكاء الأعمال | نقاط نهاية REST تسلّم مقاييس المكالمات بصيغة JSON. يمكنك استهلاك البيانات عبر نصوص برمجية أو أدوات ETL أو موصلات. |
| **العرض في تقرير المكالمات** | تحليل ظرفي، مرشحات يدوية، وتدقيق تفاعلات محددة | وحدة أصلية تعرض السجل، الإجماليات حسب الاتجاه/الحالة/الطريقة وتتيح الاستماع إلى التسجيلات، لكنها لا تتضمن زر تنزيل مباشر إلى CSV. |

## كيفية تصدير إحصائيات المكالمات عبر API

توفر المنصة API موثّقاً يعرض، من بين موارد أخرى، بيانات الصوت. لجلب هذه المقاييس إلى جدول بيانات أو لوحة معلومات:

1. **أنشئ بيانات اعتماد API**  
   في لوحة Papo، انتقل إلى إعدادات API وأنشئ زوجاً من المفاتيح (العامة والسرية). احتفظ بهذه البيانات في مكان آمن.

2. **راجع وثائق API**  
   بعد تسجيل الدخول، تسرد الوثائق الرسمية نقاط النهاية المتاحة، بما في ذلك النقطة التي تعيد إحصائيات المكالمات. ستجد هناك التنسيق الدقيق لعنوان URL، والمعلمات المقبولة (مثل `since` و`until` بطابع زمني Unix) وأمثلة على الاستجابات.

3. **جهّز الطلب**  
   مثال نظري: طلب `GET` إلى نقطة نهاية إحصائيات الصوت، مُصادَق عليه بمفاتيحك، يمكن أن يعيد محتوى مشابهاً لـ:

   ```json
   {
     "total_calls": 1250,
     "inbound": 800,
     "outbound": 450,
     "answered": 1100,
     "missed":  120,
     "busy":     30,
     "avg_duration_s": 145,
     "calls_by_method": {
       "papocall": 900,
       "wavoip":  300,
       "whatsapp": 50
     }
   }
   ```

   تعتمد الحقول الدقيقة والبنية على إصدار API الموثّق.

4. **استورد البيانات إلى أداتك**  
   مع وجود JSON بين يديك، يمكنك:
   - في **Google Sheets**، استخدام نص برمجي من Apps Script يقوم بالطلب ويملأ الخلايا تلقائياً.
   - في **Excel**، استخدام Power Query لاستيراد JSON وإنشاء جداول قابلة للتحديث.
   - في **أدوات ذكاء الأعمال** (Looker Studio، Power BI، Tableau)، الاتصال مباشرة بنقطة النهاية عبر موصلات API/Web.

5. **أتمت التحديث**  
   للحفاظ على البيانات محدثة دائماً، جدولة تنفيذ النص البرمجي (على سبيل المثال، مشغلات زمنية في Apps Script) أو إعداد روتين تحديث في أداة ذكاء الأعمال.

## لمن يفيد هذا التصدير

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

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

### هل تتضمن وحدة تقرير المكالمات تصديراً مباشراً إلى CSV؟

لا. يقدم التقرير الأصلي عرضاً كاملاً للسجل والإحصائيات، لكنه لا يتضمن زر تنزيل مباشر. لنقل البيانات إلى جدول بيانات أو لوحة معلومات، فإن API هي المسار الموصى به.

### ما مقاييس الصوت التي يمكنني استخراجها عبر API؟

تعيد API نفس المؤشرات المعروضة في وحدة تقرير المكالمات، مثل إجمالي المكالمات، والتوزيع حسب الاتجاه (واردة/صادرة)، والحالة (تم الرد، لم يتم الرد، مشغولة)، والطريقة/المزود المستخدم ومتوسط المدة. الحقول الدقيقة موجودة في الوثائق الرسمية.

### هل أحتاج إلى معرفة البرمجة لاستخدام API؟

يلزم معرفة أساسية بطلبات HTTP (GET، المصادقة، معالجة JSON). ومع ذلك، فإن العديد من الأدوات مثل Google Sheets (عبر Apps Script) أو منصات الأتمتة (Zapier، Make) تبسّط العملية للمستخدمين غير التقنيين.

### هل يمكنني جدولة التصدير تلقائياً؟

نعم. بعد إعداد التكامل، يمكنك استخدام مشغلات زمنية (مثل المشغلات الزمنية في Apps Script) أو مجدول أداة ETL الخاصة بك لتحديث البيانات يومياً أو أسبوعياً أو على فترات مخصصة.

### هل تتضمن البيانات المستخرجة تسجيلات المكالمات؟

توفر API البيانات الوصفية للمكالمة (التاريخ، المدة، الحالة، الوكيل، إلخ)، وإذا كان التسجيل نشطاً لدى مزود الهاتف، فقد تتضمن نقطة النهاية عنوان URL للصوت. يعتمد توفر التسجيل نفسه على إعداد قناة الصوت.

### هل توجد طريقة لتلقي البيانات في الوقت الفعلي؟

يتم الاستعلام عبر API عند الطلب (pull). للسيناريوهات التي تتطلب إشعارات في الوقت الفعلي (مثل أحداث المكالمات الجديدة)، سيكون من الضروري استخدام webhooks؛ ومع ذلك، يجب التحقق من توفر مشغلات محددة لأحداث الصوت في الوثائق المحدثة للمنصة.

## اقرأ أيضاً

- [كيفية استخدام API الخاص بـ Papo لسرد المحادثات وإرسال رسائل برمجية](/hc/papo/articles/how-to-use-papo-api-list-conversations-send-messages)
- [كيفية تصدير تقرير ملخص القمع للتحليل الخارجي](/hc/papo/articles/export-funnel-summary-report-external-analysis)

---

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

اجمع واتساب وإنستغرام والبريد الإلكتروني والرسائل النصية القصيرة في صندوق وارد واحد وأتمت خدمة عملائك بالذكاء الاصطناعي.