باستخدام API REST من Papo، يمكنك أتمتة إدارة الفرق دون فتح لوحة التحكم: سرد الفرق، إنشاء الفرق، سرد أعضاء الفريق، إضافة مستخدمين إلى فريق، وسرد أو إنشاء صناديق الوارد. إنها الطريقة البرمجية للحفاظ على هيكل خدمة العملاء متزامنًا مع الأنظمة الخارجية والعمليات الكبيرة وإعادة البيع بالعلامة البيضاء.
تعرض API Papo موارد الفرق والصناديق بنفس المصادقة المستخدمة في نقاط النهاية الأخرى للمنصة. باستخدامها، يمكن لفريقك توفير هياكل جديدة، وتدقيق من ينتمي إلى كل مجموعة، وإعداد توجيه المحادثات دون تدخل يدوي في لوحة التحكم.
ملخص عمليات الفرق والأعضاء عبر API
| العملية | ما تفعله | متى تستخدمها |
|---|---|---|
| سرد الفرق | تُرجع الفرق المسجلة في الحساب. | تدقيق الهيكل قبل إنشاء فريق جديد. |
| إنشاء فريق | ينشئ فريقًا باسم ووصف اختياري. | توفير فريق جديد عبر برنامج نصي أو ERP أو CRM. |
| سرد أعضاء الفريق | تُرجع المستخدمين الذين ينتمون إلى ذلك الفريق. | التحقق ممن هم مدرجون وتجنب الوصول غير الصحيح. |
| إضافة مستخدمين إلى الفريق | يضم مستخدمًا واحدًا أو أكثر مع تحديد المعرفات مفصولة بفواصل. | مزامنة الفريق مع قائمة الوكلاء الحالية. |
| سرد الصناديق | تُرجع الصناديق مع القناة، في عرض المسؤول. | التحقق من القنوات المتاحة وكيفية تنظيمها. |
| إنشاء صندوق وارد | ينشئ صندوق وارد جديد. | توفير قنوات جديدة مع هيكل الفرق. |
كيف تعمل مصادقة API
تتطلب عمليات الكتابة، بما في ذلك عمليات الفرق والأعضاء، المفتاح السري للحساب. يجب إرساله كرمز Bearer في رأس التفويض. المفتاح العام للحساب اختياري، ولكن إذا تم إرساله، يجب أن يتوافق مع نفس حساب المفتاح السري.
عنوان URL الأساسي لواجهة API هو https://app.papo.global/api/v1. يتم إنشاء المفاتيح في منطقة المطورين في لوحة تحكم Papo. يظهر المفتاح السري مرة واحدة فقط عند الإنشاء؛ احتفظ به في مكان آمن وأبطله إذا كان هناك شك في تسربه.
خطوات إدارة الفرق والأعضاء عبر API
- انتقل إلى منطقة المطورين/API في لوحة تحكم Papo وأنشئ مفتاحًا سريًا. انسخ أيضًا المفتاح العام للحساب إذا كنت تريد تحققًا إضافيًا.
- في كل طلب، قم بالمصادقة باستخدام المفتاح السري كرمز Bearer. إذا كنت تعزز التحقق، أرسل المفتاح العام في الرأس المحدد في الوثائق.
- اسرد الفرق الموجودة لرسم خريطة الهيكل الحالي قبل إنشاء فرق جديدة.
- أنشئ فريقًا عن طريق إرسال حمولة JSON تحتوي على الاسم، وإذا لزم الأمر، الوصف. راجع الوثائق الرسمية للتنسيق الدقيق.
- اسرد أعضاء الفريق لتدقيق من هم مدرجون بالفعل وتجنب التكرار.
- أضف مستخدمين إلى الفريق مع تحديد المعرفات مفصولة بفواصل. هذه الخطوة تزامن الفريق مع قائمة الوكلاء الحالية.
- اسرد صناديق الوارد بعرض المسؤول للتحقق من القنوات الموجودة واستخدم API أيضًا لإنشاء صناديق عند الحاجة.
نظرًا لأن API هي REST وتستخدم JSON، يمكن استخدام أي لغة تدعم HTTP لدمج الفرق والأعضاء في البرامج النصية أو أنظمة ERP أو CRM أو أدوات الأتمتة. تجلب الوثائق الرسمية على https://papo.global/pt/docs تفاصيل المصادقة والمعلمات والاستجابات وأمثلة التعليمات البرمجية.
لمن يكون هذا التكامل منطقيًا
- العمليات الكبيرة التي تحتاج إلى إنشاء وتعديل الفرق بشكل متكرر دون فتح لوحة التحكم يدويًا.
- فرق تكنولوجيا المعلومات والأتمتة التي تزامن هيكل الوكلاء مع الأدلة أو الموارد البشرية أو الأنظمة الداخلية.
- إعادة البيع بالعلامة البيضاء التي توفر حسابات العملاء بطريقة موحدة، مع إعادة استخدام نفس منطق الفرق والصناديق.
- الشركات التي تستخدم بالفعل API Papo لجهات الاتصال والمحادثات وترغب في إكمال التدفق بإدارة الفرق.
تدير API هيكل الفرق وإدراج الأعضاء. تظل أدوار المستخدم، مثل وكيل أو مسؤول، والأذونات التفصيلية محددة في لوحة التحكم. عند إضافة مستخدم إلى فريق وربطه بصناديق الوارد ذات الصلة، فإنك تتحكم في الوصول التشغيلي إلى المحادثات.
الأسئلة الشائعة
هل تحدد API Papo دور المستخدم، مثل وكيل أو مسؤول؟
لا. تركز API الفرق والأعضاء على إنشاء الفرق، وسرد الأعضاء، وإدراج المستخدمين. يتم تحديد الدور والأذونات لكل مستخدم في لوحة التحكم. عند تضمين مستخدم في فريق وفي الصناديق الصحيحة، فإنك تقيد الوصول إلى المحادثات التشغيلية.
هل يمكنني إنشاء فريق دون إضافة أعضاء في نفس الخطوة؟
نعم. تسمح API بإنشاء فريق باسم ووصف اختياري، دون تضمين مستخدمين على الفور. بعد ذلك، يمكنك إضافة أعضاء باستخدام عملية الإدراج المجمّع.
كيف تحدد API الحساب في الطلبات؟
من خلال المفتاح السري المرسل كرمز Bearer. المفتاح العام اختياري، وإذا تم إرساله، يجب أن يتوافق مع نفس حساب المفتاح السري.
هل تعمل هذه API لإعادة البيع بالعلامة البيضاء؟
نعم. يمكن للموزعين استخدام API لتوفير الفرق والأعضاء في حسابات العملاء بطريقة موحدة، مما يقلل التكوين اليدوي ويحافظ على الاتساق بين العمليات.
أين أجد المسارات الدقيقة وتنسيق الحمولة؟
في الوثائق الرسمية لواجهة API، المتاحة على https://papo.global/pt/docs. هناك تجد تفاصيل المصادقة والمعلمات والاستجابات وأمثلة التعليمات البرمجية للفرق والأعضاء والموارد الأخرى.
اقرأ أيضًا
- كيفية استخدام API Papo لإنشاء وإدارة العلامات (tags)
- كيفية إدارة المستخدمين والأذونات داخل منصتك ذات العلامة البيضاء
ابدأ مجانًا وأتمت الفرق والأعضاء عبر API →
المستخدم الأول مجاني للأبد، لذا يمكنك التحقق من التكامل قبل هيكلة عملياتك.