لدمج حسابك مع أنظمة خارجية مثل CRMs أو ERPs أو منصات الأتمتة (n8n, Zapier)، توفر Papo (https://papo.global/) مفاتيح API (واجهة برمجة التطبيقات) التي يمكن إنشاؤها وإدارتها مباشرة من لوحة التحكم الخاصة بك. تعمل هذه المفاتيح كبيانات اعتماد آمنة تسمح للبرامج الأخرى بالوصول إلى حسابك في Papo وتنفيذ الإجراءات فيه برمجيًا.
تتيح لك Papo API بناء أنظمة عمل متصلة، وأتمتة المهام التي تتراوح من إرسال رسائل واتساب إلى استخراج العملاء المحتملين المؤهلين. لضمان الأمان، تستخدم Papo نظام مفتاحين: مفتاح عام للتعريف، ومفتاح سري للمصادقة.
| نوع المفتاح | الوصف | مستوى الأمان | مثال على الاستخدام |
|---|---|---|---|
المفتاح العام (pk_live_...) |
معرف فريد وثابت لحسابك في Papo. | منخفض. يمكن كشفه علنًا. | تحديد حسابك في نص برمجي في الواجهة الأمامية لموقعك. |
المفتاح السري (sk_live_...) |
"كلمة مرور" لـ API. يصادق طلباتك ويمنح الإذن للعمل نيابة عن حسابك. | عالٍ. يجب الحفاظ عليه بسرية تامة. | مصادقة استدعاء API من الخادم الخاص بك (الخلفية) لإرسال رسالة. |
كيفية إنشاء والعثور على مفاتيح API الخاصة بك
تتم إدارة مفاتيح API في منطقة محددة من حسابك في Papo. اتبع الخطوات أدناه للوصول إليها.
- ادخل إلى لوحة تحكم Papo الخاصة بك وانتقل إلى الإعدادات.
- في قائمة الإعدادات، ابحث عن قسم المطورين أو API.
- في هذه الصفحة، ستجد مفتاحك العام (
pk_live_...)، وهو ثابت ويمكن نسخه في أي وقت. - بالنسبة للمفتاح السري، ستحتاج إلى إنشاء مفتاح جديد. انقر على الزر لإنشاء مفتاح جديد.
- امنح المفتاح اسمًا وصفيًا، يشير إلى مكان استخدامه (مثال: "تكامل CRM"، "أتمتة N8N"). يساعد هذا في تحديد وإلغاء مفاتيح معينة إذا لزم الأمر.
- بعد الإنشاء، سيتم عرض المفتاح السري (
sk_live_...) مرة واحدة فقط. انسخه واحتفظ به في مكان آمن، مثل مدير كلمات المرور أو متغير بيئة على الخادم الخاص بك. لأسباب أمنية، لا تخزن Papo القيمة الأصلية للمفتاح ولن تتمكن من عرضه مرة أخرى.
إذا فقدت مفتاحًا سريًا أو اشتبهت في تسربه، قم بإلغائه فورًا في لوحة التحكم وأنشئ مفتاحًا جديدًا.
كيفية استخدام المفاتيح للمصادقة في API
يجب مصادقة جميع الاتصالات مع Papo API التي تتضمن إجراءات أو الوصول إلى بيانات خاصة. يتم ذلك عن طريق إرسال المفتاح السري في رأس HTTP.
عنوان URL الأساسي لجميع استدعاءات API هو: https://app.papo.global/api/v1
للمصادقة، قم بتضمين مفتاحك السري في رأس Authorization لطلبك، مسبوقًا بكلمة Bearer.
مثال على طلب باستخدام curl للحصول على بيانات حسابك:
curl https://app.papo.global/api/v1/me \
-H "Authorization: Bearer sk_live_SUA_CHAVE_SECRETA_AQUI"
في هذا المثال:
- يجب استبدال
sk_live_SUA_CHAVE_SECRETA_AQUIبمفتاحك السري الحقيقي. - نقطة النهاية
/meتُرجع معلومات حول الحساب المصادق عليه، وتعمل كاختبار جيد للتحقق مما إذا كان مفتاحك يعمل.
يمكن إرسال المفتاح العام (pk_live_...) اختياريًا في رأس X-Papo-Public-Key كتحقق إضافي، ولكن المصادقة الرئيسية تتم دائمًا بواسطة المفتاح السري.
ماذا يمكنك أن تفعل باستخدام Papo API؟
تفتح API مجموعة واسعة من الإمكانيات لأتمتة عملياتك ودمجها. إليك بعض الأمثلة لما يمكنك فعله:
- إرسال رسائل واتساب: أنشئ نصوصًا برمجية لإرسال الإشعارات أو التنبيهات أو الرسائل التفاعلية عبر أحد أرقامك المتصلة.
- البحث عن جهات الاتصال من المستخرج: الوصول إلى قائمة العملاء المحتملين التي استخرجتها باستخدام مستخرج CNPJ لمزامنتها مع نظام CRM الرئيسي الخاص بك.
- إدارة المثيلات: سرد والتحقق من حالة اتصالات واتساب الخاصة بك.
- استخدام الذكاء الاصطناعي: أرسل نصوصًا إلى محرك الذكاء الاصطناعي في Papo واستقبل ردودًا تم إنشاؤها بناءً على مطالباتك المكونة.
- مزامنة البيانات: حافظ على تحديث أنظمتك الداخلية (ERP, BI) بالبيانات التي تم إنشاؤها في Papo.
الأسئلة الشائعة (FAQ)
أين أجد الوثائق الكاملة لـ API؟
الوثائق التقنية المفصلة، مع جميع نقاط النهاية والمعاملات وأمثلة التعليمات البرمجية بلغات مختلفة (JavaScript, Python)، متاحة للجمهور على papo.global/pt/docs.
لقد تسرب مفتاحي السري. ماذا أفعل؟
إذا كنت تشك في أن مفتاحك السري قد تعرض للاختراق، فادخل فورًا إلى منطقة المطورين في لوحة تحكم Papo الخاصة بك، وابحث عن المفتاح المتسرب في القائمة وانقر على إلغائه. بمجرد إلغائه، لن يمكن استخدامه بعد الآن لمصادقة الطلبات. ثم، أنشئ مفتاحًا جديدًا ليحل محل القديم في تكاملاتك.
كم عدد المفاتيح السرية التي يمكنني إنشاؤها؟
يمكنك إنشاء مفاتيح سرية متعددة. من الممارسات الأمنية الجيدة إنشاء مفتاح مختلف لكل نظام أو بيئة تقوم بدمجها (مثال: واحد لنظام CRM الخاص بك، وآخر لنظام الأتمتة الخاص بك، وواحد لبيئة الاختبار، وما إلى ذلك). يتيح لك ذلك إلغاء وصول نظام معين دون التأثير على الأنظمة الأخرى.
هل يمكنني استخدام المفتاح العام في الواجهة الأمامية لموقعي؟
نعم، تم تصميم المفتاح العام (pk_live_...) ليكون آمنًا للاستخدام في البيئات العامة، مثل كود JavaScript لموقعك. وظيفته هي فقط تحديد حسابك، وليس مصادقة الإجراءات. أما المفتاح السري، فلا يجب أبدًا كشفه في كود جانب العميل.
ما الفرق بين Papo API و Webhook؟
الفرق الرئيسي يكمن في من يبدأ الاتصال. مع API، يبدأ نظامك الإجراء: أنت "تطلب" (تسحب) البيانات من Papo أو "تطلب" (تدفع) من Papo القيام بشيء ما، مثل إرسال رسالة. مع Webhook، تبدأ Papo الإجراء: فهي "تدفع" (تدفع) البيانات إلى نظامك تلقائيًا عندما يحدث حدث معين (مثال: وصول جهة اتصال إلى مرحلة في Flow).
ما الفرق بين Papo API وواجهة برمجة تطبيقات واتساب الرسمية؟
تركز واجهة برمجة تطبيقات واتساب الرسمية حصريًا على وظائف قناة واتساب. Papo API هي طبقة تجريد أوسع وأكثر قوة: فهي تتيح لك التحكم ليس فقط في واتساب، ولكن أيضًا في وحدات أخرى من المنصة، مثل CRM، ومستخرج العملاء المحتملين، ومحرك الذكاء الاصطناعي، كل ذلك بمجموعة واحدة من المفاتيح وبطريقة مبسطة.
اقرأ أيضًا
- كيفية استخدام إجراء Webhook في تدفقات الأتمتة للاندماج مع الأنظمة الأخرى
- هل يمكنني استخدام نفس رقم تطبيق واتساب للأعمال في Papo API الرسمية؟
المستخدم الأول مجاني لتتمكن من اختبار الأتمتة والتكاملات على رقمك.