مع Papo (https://papo.global/)، يمكنك استخدام API REST لسرد المحادثات، وإرسال الرسائل النصية، وتطبيق الوسوم، وتعيين المحادثات للوكلاء، مما يؤتمت عمليات خدمة العملاء دون الوصول إلى الواجهة. توفر API نقاط نهاية تحاكي وظائف وحدة المحادثات، مما يسمح للأنظمة الخارجية بإدارة التفاعلات برمجيًا.
| إجراء API | ما الذي يفعله | مثال على الاستخدام |
|---|---|---|
| سرد المحادثات | يعيد المحادثات الخاصة بالحساب، مع تصفية حسب الحالة أو الوسم أو الوكيل | مراقبة المحادثات النشطة أو المغلقة من نظام CRM خارجي |
| إرسال رسالة نصية | يرسل رسالة نصية إلى جهة اتصال (مع مراعاة نافذة الـ 24 ساعة الخاصة بـ WhatsApp) | إخطار العميل بتحديث الطلب |
| تطبيق وسم | ينشئ وسمًا (إذا لم يكن موجودًا) ويطبقه على جهة الاتصال والمحادثة المفتوحة | وضع علامة على المحادثات كـ "عاجل" أو "ما بعد البيع" تلقائيًا |
| تعيين محادثة | يعين المحادثات المفتوحة لجهة اتصال معينة إلى وكيل محدد | توجيه العملاء المحتملين إلى البائع المسؤول عن المنطقة |
كيف تعمل API المحادثات من Papo
تتبع API Papo معيار REST، مع مصادقة عبر مفتاح سري (Bearer token) واستجابات بصيغة JSON. تستخدم جميع العمليات الموصوفة هنا نفس قاعدة المصادقة ويمكن دمجها لإنشاء سير عمل مؤتمت — على سبيل المثال، نظام فرز يستقبل عميلًا محتملًا جديدًا، ويسرد المحادثات الأخيرة، ويطبق وسم "جديد"، ويعينه للوكيل المناوب.
قاعدة API هي https://app.papo.global/api/v1. لاستخدام نقاط نهاية المحادثات والوسوم والتعيينات، تحتاج إلى رمز API تم إنشاؤه في لوحة تحكم Papo. الوثائق الكاملة مع نقاط النهاية المحددة والمعلمات متاحة على papo.global/pt/docs.
خطوات استخدام ميزات API
1. أنشئ رمز API
في لوحة تحكم Papo، انتقل إلى قسم المطور أو رموز الوصول. أنشئ مفتاحًا سريًا (sk_live_…) بالأذونات المناسبة لإدارة المحادثات. احفظ الرمز في مكان آمن — سيتم إرساله في ترويسة Authorization لجميع الطلبات.
2. اسرد المحادثات
استخدم نقطة نهاية سرد المحادثات للحصول على محادثات الحساب. يقبل الطلب معلمات تصفية مثل:
- الحالة: محادثات مفتوحة، مغلقة، أو الكل.
- الوسم: تصفية حسب وسم واحد أو أكثر مطبق.
- الوكيل: تقييد المحادثات المعينة لمستخدم معين.
- الفترة: نطاق تاريخي لتحديد الاستعلام.
تتضمن الاستجابة معرف المحادثة، وجهة الاتصال، والقناة، والحالة، وآخر الرسائل. باستخدام هذه البيانات، يمكنك مراقبة حجم المحادثات أو تشغيل إجراءات شرطية من نظام خارجي.
3. أرسل رسالة نصية
لإرسال رسالة نصية إلى جهة اتصال، استخدم نقطة نهاية إرسال الرسائل. يتطلب الطلب:
- رقم المستلم بالتنسيق الدولي (مثال:
5511999999999). - نص الرسالة.
- معرف المثيل (اختياري) — إذا كان حسابك يحتوي على أكثر من اتصال WhatsApp، يمكنك تحديد أي منها تستخدم.
تعيد API تأكيدًا بقبول الطلب. تذكر أن إرسال الرسائل النصية يخضع لنافذة الـ 24 ساعة الخاصة بـ WhatsApp؛ للتواصل خارج هذه الفترة، من الضروري استخدام قوالب رسائل (HSM) معتمدة مسبقًا.
4. طبق الوسوم على جهات الاتصال والمحادثات
تسمح API بإدارة الوسوم بطريقتين:
- إنشاء وسم في الحساب: حدد عنوانًا ولونًا ووصفًا للوسم الجديد.
- تطبيق وسم: اربط وسمًا موجودًا بجهة اتصال والمحادثة المفتوحة لتلك الجهة. إذا لم يكن الوسم موجودًا بعد، فسيتم إنشاؤه تلقائيًا أثناء التطبيق.
هذا مفيد لتصنيف المحادثات تلقائيًا بناءً على قواعد نظامك — على سبيل المثال، وضع علامة "شكوى" عندما يرسل العميل كلمة مفتاحية محددة.
5. عيّن المحادثات للوكلاء
باستخدام نقطة نهاية التعيين، يمكنك تعيين وكيل لجميع المحادثات المفتوحة لجهة اتصال معينة. ما عليك سوى تقديم معرف جهة الاتصال ومعرف المستخدم/الوكيل. يمكن الحصول على قائمة وكلاء الحساب من خلال نقطة نهاية سرد المستخدمين، والتي تعيد الاسم والبريد الإلكتروني والمعرف لكل عضو في الفريق.
هذه الوظيفة ضرورية للتوجيه التلقائي: يمكن لنظام CRM، عند تحديد ملف العميل المحتمل، تعيينه للبائع الصحيح دون تدخل يدوي.
من يجب أن يستخدم API المحادثات
- العمليات التي تستخدم بالفعل أنظمة خارجية (ERP، CRM، منصات التجارة الإلكترونية) وترغب في دمج خدمة عملاء Papo دون مضاعفة الجهود.
- فرق الدعم ذات قواعد التوجيه المعقدة، التي تحتاج إلى تصنيف وتوجيه المحادثات تلقائيًا بناءً على بيانات العميل.
- المطورون الذين يبنون لوحات معلومات مخصصة أو يطلقون إشعارات من أحداث خدمة العملاء.
- الموزعون بعلامة بيضاء الذين يديرون حسابات متعددة ويرغبون في أتمتة إعداد الوسوم والتعيينات لكل عميل.
الأسئلة الشائعة
هل أحتاج إلى رمز API لاستخدام نقاط النهاية هذه؟
نعم. تتطلب جميع الطلبات إلى API Papo مصادقة عبر مفتاح سري، يتم إرساله في ترويسة Authorization: Bearer sk_live_…. يتم إنشاء الرموز في لوحة تحكم الحساب.
هل تسمح API بإرسال رسائل خارج نافذة الـ 24 ساعة الخاصة بـ WhatsApp؟
يحترم إرسال الرسائل النصية عبر API نافذة الـ 24 ساعة. للتواصل الاستباقي خارج هذه الفترة، من الضروري استخدام قوالب رسائل (HSM) معتمدة. توفر Papo نقاط نهاية محددة لإرسال HSM.
هل يمكنني سرد المحادثات حسب الوسم؟
نعم. تقبل نقطة نهاية سرد المحادثات تصفية حسب الوسم، مما يسمح لك باسترداد المحادثات المميزة بوسم واحد أو أكثر محدد.
كيف أطبق وسمًا على جهة اتصال عبر API؟
استخدم نقطة نهاية الوسوم، مع تقديم معرف الوسم (أو بيانات الإنشاء) ومعرف جهة الاتصال. سيتم تطبيق الوسم على جهة الاتصال والمحادثة المفتوحة المقابلة.
هل تعيد API سجل المحادثة الكامل؟
يعيد سرد المحادثات البيانات الوصفية وآخر الرسائل. للحصول على سجل الرسائل الكامل لمحادثة معينة، راجع وثائق API، التي تفصل نقاط نهاية استرداد الرسائل.
هل يمكن تعيين محادثة لوكيل دون معرفة معرف المستخدم؟
يمكنك أولاً سرد مستخدمي الحساب (نقطة نهاية الوكلاء) للحصول على المعرفات ثم استخدام نقطة نهاية التعيين. تتضمن قائمة الوكلاء الاسم والبريد الإلكتروني، مما يسهل التعريف.
اقرأ أيضًا
- كيفية استخدام API Papo لإدارة عملاء الموزع بعلامة بيضاء
- كيفية استخدام API Papo لإدارة السمات المخصصة لجهات الاتصال
جرّب API وجميع وحدات Papo دون تكلفة — المستخدم الأول مجاني ولا يتطلب بطاقة ائتمان.