**باستخدام واجهة برمجة التطبيقات REST الخاصة بـ [Papo](https://papo.global/)، يمكنك سرد الوسوم الموجودة، وإنشاء وسوم جديدة، وتطبيق وسم على جهة اتصال لديها محادثة مفتوحة — كل ذلك عبر طلبات مصادق عليها، دون فتح لوحة التحكم. إنها الطريقة البرمجية لأتمتة تصنيف وتنظيم خدمة العملاء من أنظمة خارجية أو أنظمة إدارة علاقات العملاء (CRM) أو أدوات الأتمتة.**

تعرض واجهة برمجة تطبيقات Papo موارد المحادثات التي تتضمن إدارة الوسوم. باستخدامها، يمكن لفريقك الحفاظ على تصنيف متسق، وإعداد فئات قبل الحملات، وتصنيف جهات الاتصال والمحادثات في الوقت الفعلي، باستخدام نفس المصادقة المستخدمة في نقاط النهاية الأخرى للمنصة.

## ملخص عمليات الوسوم عبر واجهة برمجة التطبيقات

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

## كيف تعمل مصادقة واجهة برمجة التطبيقات

تتطلب جميع مسارات الكتابة، بما في ذلك عمليات الوسوم، المفتاح السري للحساب. يجب إرساله كرمز Bearer في رأس التفويض. المفتاح العام للحساب اختياري، ولكن إذا تم إرساله، يجب أن يتوافق مع نفس حساب المفتاح السري.

عنوان URL الأساسي لواجهة برمجة التطبيقات هو `https://app.papo.global/api/v1`. يتم إنشاء المفاتيح في منطقة المطور في لوحة تحكم Papo. يظهر المفتاح السري مرة واحدة فقط عند الإنشاء؛ احتفظ به في مكان آمن وقم بإلغائه إذا كان هناك شك في تسربه.

## كيفية الاستخدام عمليًا

1. انتقل إلى منطقة المطور/واجهة برمجة التطبيقات في لوحة تحكم Papo وقم بإنشاء مفتاح سري. انسخ أيضًا المفتاح العام للحساب.
2. في كل طلب، قم بالمصادقة باستخدام المفتاح السري كرمز Bearer. إذا كنت تريد تعزيز التحقق، أرسل المفتاح العام في الرأس المشار إليه في الوثائق.
3. لسرد الوسوم، استدعِ نقطة نهاية سرد الوسوم في واجهة برمجة التطبيقات. تُرجع الاستجابة الوسوم المسجلة، مما يسمح بتعيين ما هو موجود بالفعل قبل إنشاء وسوم جديدة.
4. لإنشاء وسم دون تطبيقه، أرسل حمولة JSON تحتوي على معلومات الوسم في نقطة نهاية الإنشاء. راجع الوثائق الرسمية للحصول على التنسيق الدقيق.
5. لتطبيق وسم على جهة اتصال لديها محادثة مفتوحة، استدعِ نقطة نهاية الوسم. إذا لم يكن الوسم موجودًا بعد، فسيتم إنشاؤه تلقائيًا وتطبيقه على جهة الاتصال والمحادثة المفتوحة.

نظرًا لأن واجهة برمجة التطبيقات هي REST وتستخدم JSON، يمكن استخدام أي لغة تدعم HTTP لدمج الوسوم في النصوص البرمجية أو أنظمة تخطيط موارد المؤسسات (ERP) أو أنظمة إدارة علاقات العملاء (CRM) أو أدوات الأتمتة. توفر الوثائق الرسمية على `https://papo.global/pt/docs` تفاصيل المصادقة والمعلمات والاستجابات وأمثلة التعليمات البرمجية.

## لمن يكون هذا التكامل منطقيًا

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

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

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

### هل ينطبق الوسم المطبق عبر واجهة برمجة التطبيقات على جهة الاتصال والمحادثة؟
نعم. يطبق مورد الوسم الوسم على جهة الاتصال والمحادثة المفتوحة، مما يساعد في تصنيف كل من سجل العميل المحتمل وخدمة العملاء الجارية.

### هل المصادقة هي نفسها المستخدمة في نقاط النهاية الأخرى لـ Papo؟
نعم. تتطلب مسارات الكتابة المفتاح السري للحساب، المرسل كرمز Bearer. المفتاح العام اختياري، وإذا تم إرساله، يجب أن يتوافق مع نفس الحساب.

### أين أجد المسارات الدقيقة وتنسيق الحمولة؟
في الوثائق الرسمية لواجهة برمجة التطبيقات، المتاحة على `https://papo.global/pt/docs`. هناك تجد تفاصيل المصادقة والمعلمات والاستجابات وأمثلة التعليمات البرمجية للوسوم والموارد الأخرى.

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

## اقرأ أيضًا

- [كيفية استخدام واجهة برمجة تطبيقات Papo لإنشاء وتحديث جهات الاتصال بشكل جماعي](/hc/papo/articles/how-to-use-papo-api-create-update-contacts-bulk)
- [كيفية استخدام واجهة برمجة تطبيقات Papo لإرسال قوالب رسائل WhatsApp (HSM)](/hc/papo/articles/how-to-use-papo-api-to-send-whatsapp-hsm-templates)

---

**[ابدأ مجانًا →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=papo-api-create-manage-tags&utm_content=ar)**

أنشئ حسابك المجاني واجمع WhatsApp وInstagram والبريد الإلكتروني والرسائل النصية القصيرة في صندوق وارد واحد، مع وسوم لتنظيم خدمة العملاء.