مع واجهة REST API من Papo، يمكنك عرض صناديق الوارد الحالية وإنشاء اتصالات جديدة لقنوات مثل واتساب وإنستغرام — كل ذلك عبر طلبات مُصادَق عليها، دون فتح اللوحة. إنها الطريقة البرمجية لتجهيز قنوات الدعم، ودمج أنظمة خارجية، والحفاظ على تشغيل متعدد القنوات متوافق مع الأتمتة.
تُتيح واجهة Papo API موارد صناديق الوارد التي تسمح بالاستعلام عن الإعداد الحالي وإضافة قنوات جديدة. وبذلك، تستطيع فرق تقنية المعلومات والمكاملون وموزعو العلامة البيضاء (white label) إدارة الاتصالات على دفعات، ونسخ الإعدادات بين الحسابات، وأتمتة تفعيل القنوات دون الاعتماد على الواجهة.
ملخص عمليات صناديق الوارد عبر API
| العملية | ما الذي تفعله | متى تستخدمها |
|---|---|---|
| عرض الصناديق | تُرجع صناديق الوارد في الحساب، مع القناة المرتبطة (واتساب، إنستغرام، البريد الإلكتروني، إلخ) وتفاصيل الإعداد. | تدقيق القنوات النشطة، أو المزامنة مع أنظمة المراقبة، أو التحضير لعمليات الترحيل. |
| إنشاء صندوق | ينشئ صندوق وارد جديداً، مع تحديد القناة والاسم والوكلاء الذين سيتمكنون من الوصول. | تجهيز القنوات تلقائياً عند دمج عملاء أو وحدات أو علامات جديدة. |
كيف تعمل مصادقة API
تتطلب جميع الاستدعاءات إلى API، بما في ذلك عرض الصناديق، المفتاح السري للحساب. ويجب إرساله كرمز Bearer في الترويسة Authorization. المفتاح العام للحساب اختياري، لكن إذا أُرسل فيجب أن يتوافق مع نفس حساب المفتاح السري.
عنوان URL الأساسي لـ API هو https://app.papo.global/api/v1. تُنشأ المفاتيح في منطقة المطورين في لوحة Papo. يظهر المفتاح السري مرة واحدة فقط عند الإنشاء؛ احتفظ به في مكان آمن وألغِه إذا اشتبهت في تسربه.
للتحقق من المصادقة، يمكنك استدعاء نقطة النهاية GET /api/v1/me، التي تُرجع بيانات الحساب. نمط المصادقة هو نفسه المستخدم في جميع نقاط النهاية الأخرى:
curl https://app.papo.global/api/v1/me \
-H "Authorization: Bearer sk_live_…" \
-H "X-Papo-Public-Key: pk_live_…"
كيفية إدارة صناديق الوارد عملياً
- ادخل إلى منطقة المطورين/API في لوحة Papo وأنشئ مفتاحاً سرياً. انسخ أيضاً المفتاح العام للحساب.
- في كل طلب، صادِق باستخدام المفتاح السري كرمز Bearer. وإذا أردت تعزيز التحقق، أرسل المفتاح العام في الترويسة
X-Papo-Public-Key. - لعرض صناديق الوارد، استدعِ نقطة نهاية عرض الصناديق. تُرجع الاستجابة مُعرّف كل صندوق، والقناة المُعدّة، وخصائص أخرى، مما يتيح لك معرفة ما هو موجود بالفعل قبل إنشاء صناديق جديدة.
- لإنشاء صندوق جديد، أرسل حمولة JSON تتضمن معلومات القناة المطلوبة — على سبيل المثال، واتساب (API الرسمية من Meta)، وإنستغرام، والبريد الإلكتروني، وتيليجرام. ضمّن اسم الصندوق ومُعرّفات الوكلاء الذين يجب أن يتمتعوا بالوصول. راجع الوثائق الرسمية للتنسيق الدقيق للحقول والقيم المقبولة.
- بعد الإنشاء، يصبح الصندوق متاحاً فوراً في اللوحة ويبدأ في تلقي الرسائل بمجرد اكتمال اتصال القناة (في حالة القنوات التي تتطلب إقراناً، مثل واتساب، تُرجع API التعليمات اللازمة).
بما أن API هي REST وتستخدم JSON، يمكن استخدام أي لغة تدعم HTTP لدمج إدارة الصناديق مع النصوص البرمجية، وأدوات الأتمتة (مثل n8n)، أو أنظمة التجهيز. الوثائق الرسمية على https://papo.global/pt/docs تقدم تفاصيل المصادقة والمعاملات والاستجابات وأمثلة على التعليمات البرمجية.
لمن يكون هذا الدمج منطقياً
- فرق تقنية المعلومات التي تجهّز القنوات على دفعات لوحدات جديدة أو امتيازات أو علامات، دون الحاجة إلى الوصول إلى اللوحة واحدة تلو الأخرى.
- موزعو العلامة البيضاء (white label) الذين يرغبون في أتمتة إنشاء صناديق وارد لكل عميل جديد، مع الحفاظ على إعداد موحّد.
- العمليات التي ترحّل أو تنسخ الإعدادات بين الحسابات، باستخدام العرض للتدقيق والإنشاء لعكس القنوات.
- المكاملون الذين يربطون Papo بأنظمة خارجية لإدارة القنوات، بما يضمن أن بيئة الدعم تعكس التغييرات تلقائياً.
الأسئلة الشائعة
هل أحتاج إلى المفتاح السري لعرض صناديق الوارد؟
نعم. يتطلب عرض الصناديق مصادقة بالمفتاح السري للحساب، لأنه يُرجع معلومات حساسة عن الإعداد. النمط هو نفسه في استدعاءات API الأخرى: أرسل رمز Bearer في الترويسة Authorization.
هل يمكنني إنشاء صندوق وارد لواتساب عبر API؟
نعم. عند إنشاء صندوق، تحدد نوع القناة المطلوبة — بما في ذلك واتساب (API الرسمية من Meta) والقنوات الأخرى المدعومة. يجب أن تتبع الحمولة (payload) التنسيق المتوقع للقناة المختارة، وفقاً للوثائق الرسمية.
هل يمكن تحديث صندوق وارد موجود عبر API؟
تتيح API الحالية عرض وإنشاء صناديق الوارد. لتغيير إعدادات صندوق موجود (مثل تبديل الوكلاء أو إعادة التسمية)، يمكنك استخدام لوحة Papo أو، عند الحاجة، إعادة إنشاء الصندوق بالمعاملات الجديدة.
كيف أربط الوكلاء بصندوق أثناء الإنشاء؟
في حمولة الإنشاء، يمكنك تحديد مُعرّفات الوكلاء الذين يجب أن يتمتعوا بالوصول إلى الصندوق. يمكن الحصول على هذه المُعرّفات عبر API الفرق والأعضاء. راجع الوثائق لمعرفة التنسيق الدقيق.
هل المصادقة هي نفسها المستخدمة في نقاط النهاية الأخرى في Papo؟
نعم. جميع الاستدعاءات التي تصل إلى موارد الحساب تستخدم المفتاح السري كرمز Bearer. المفتاح العام اختياري، وإذا أُرسل، يجب أن يتوافق مع نفس الحساب.
أين أجد المسارات الدقيقة وتنسيق الحمولة؟
في الوثائق الرسمية لـ API، المتاحة على https://papo.global/pt/docs. هناك تفاصيل المصادقة والمعاملات والاستجابات وأمثلة التعليمات البرمجية لصناديق الوارد والموارد الأخرى.
اقرأ أيضاً
- كيفية استخدام واجهة Papo API لإدارة الفرق والأعضاء
- كيفية استخدام واجهة Papo API لإنشاء وإدارة الوسوم (tags)
أنشئ حسابك المجاني ودمج القنوات عبر API دون فتح اللوحة.