**لإنشاء مفاتيح API الخاصة بـ Papo (https://papo.global/)، انتقل إلى لوحة التحكم واذهب إلى الإعدادات > المطورين (أو API). هناك ستجد مفتاحك العام الثابت ويمكنك إنشاء مفاتيح سرية مُسمّاة، تُعرض مرة واحدة فقط ويجب تخزينها في مكان آمن، مثل مدير كلمات المرور أو متغيرات البيئة على الخادم.**

تستخدم واجهة برمجة تطبيقات Papo زوجًا من المفاتيح لتحديد هوية حسابك والمصادقة عليه في عمليات التكامل مع أنظمة إدارة علاقات العملاء (CRM) وتخطيط موارد المؤسسات (ERP) ومنصات الأتمتة (n8n، Zapier) والأنظمة الخاصة. إن فهم الفرق بينهما ومعرفة كيفية إنشائهما وحمايتهما هو الخطوة الأولى لبناء أتمتة موثوقة.

| نوع المفتاح | التنسيق | الوظيفة | مستوى الظهور |
| :--- | :--- | :--- | :--- |
| **المفتاح العام** | `pk_live_...` | يحدد حسابك في Papo بشكل فريد. | يمكن عرضه في الواجهة الأمامية أو في نصوص برمجية عامة. |
| **المفتاح السري** | `sk_live_...` | يصادق على الطلبات ويصرح بالإجراءات في حسابك. | **سري** – لا يجب مشاركته أو تضمينه في الكود أبدًا. |

## كيفية إنشاء مفاتيح API

1.  سجّل الدخول إلى لوحة تحكم Papo وانتقل إلى **الإعدادات**.
2.  في القائمة الجانبية، ابحث عن قسم **المطورين** أو **API**.
3.  ستعرض الصفحة **مفتاحك العام (`pk_live_...`)**. إنه ثابت ويمكن نسخه في أي وقت.
4.  للحصول على **مفتاح سري**، انقر على زر إنشاء مفتاح جديد.
5.  أعطِ اسمًا وصفيًا (مثال: "تكامل CRM"، "أتمتة n8n") لتسهيل الإدارة المستقبلية.
6.  سيُعرض المفتاح السري (`sk_live_...`) **مرة واحدة فقط**. انسخه فورًا واحفظه في مكان آمن.

> ⚠️ لأسباب أمنية، تحتفظ Papo فقط بتجزئة (hash) المفتاح السري. إذا فقدت القيمة الأصلية، لن يكون من الممكن استعادتها. في هذه الحالة، قم بإلغاء المفتاح المخترق وأنشئ مفتاحًا جديدًا.

## كيفية تخزين المفاتيح بشكل آمن

- **لا تضع** المفتاح السري مباشرة في الكود المصدري أو مستودعات Git أو الرسائل.
- استخدم **متغيرات البيئة** على خادمك (مثال: `PAPO_SECRET_KEY`) وأشر إليها في الكود.
- خزّن المفتاح في **مدير كلمات المرور** (مثل 1Password أو Bitwarden أو خزانة مزود الخدمة السحابية) للرجوع إليه لاحقًا.
- إذا تسرب المفتاح أو كان هناك شك في اختراقه، انتقل إلى نفس صفحة المطورين، وابحث عن المفتاح في القائمة و**قم بإلغائه** فورًا. ثم أنشئ مفتاحًا جديدًا وحدّث تكاملاتك.

## ما الغرض من هذه المفاتيح؟

تُستخدم المفاتيح في جميع استدعاءات واجهة برمجة تطبيقات Papo التي تتطلب مصادقة. يُرسل المفتاح السري في ترويسة `Authorization` كرمز Bearer. يمكن إرسال المفتاح العام في ترويسة `X-Papo-Public-Key` كتحقق إضافي، لكن المصادقة الأساسية تعتمد دائمًا على المفتاح السري.

بعد حصولك على المفاتيح، يمكنك على سبيل المثال:
- إرسال رسائل واتساب عبر API.
- الاستعلام عن جهات الاتصال المستخرجة بواسطة المُستخرِج.
- تشغيل الذكاء الاصطناعي الخاص بـ Papo من نظامك.
- مزامنة البيانات مع نظام إدارة علاقات العملاء (CRM) الخاص بك.

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

### أين أجد المفتاح العام لحسابي؟
المفتاح العام (`pk_live_...`) يظهر في صفحة **الإعدادات > المطورين (أو API)**. إنه ثابت ويمكن نسخه كلما دعت الحاجة.

### هل يمكنني الحصول على أكثر من مفتاح سري؟
نعم. يمكنك إنشاء عدة مفاتيح سرية، كل منها باسم مختلف (مثال: "الإنتاج"، "الاختبار"، "n8n"). يساعد ذلك في عزل الوصول وإلغاء مفتاح معين دون التأثير على المفاتيح الأخرى.

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

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

### هل يمكنني استخدام المفاتيح في أدوات مثل n8n أو Zapier؟
نعم. مفاتيح API الخاصة بـ Papo متوافقة مع أي أداة تدعم المصادقة عبر Bearer token. ما عليك سوى إدخال المفتاح السري في حقل التفويض الخاص بالأداة.

## اقرأ أيضًا

- [كيفية دمج Papo مع n8n لأتمتة العمليات](/hc/papo/articles/integrate-papo-with-n8n-to-automate-processes)

---

**[ابدأ مجانًا →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=how-to-generate-papo-public-and-secret-api-keys-ar&utm_content=ar)**

أنشئ حسابك المجاني في Papo واحصل على وصول فوري إلى مفاتيح API لدمج أنظمتك.