**لربط رقم واتساب الخاص بك باستخدام واجهة برمجة التطبيقات الرسمية (Cloud API)، يجب عليك أولاً بدء العملية في منصة Papo (https://papo.global/) بإنشاء صندوق وارد جديد من نوع "WhatsApp – API Cloud (Meta)". بعد ذلك، من الضروري إعداد تطبيق ورقم هاتف في مدير أعمال Meta للحصول على بيانات الاعتماد (معرف الرقم، معرف حساب الأعمال، ورمز الوصول)، والتي سيتم إدخالها في Papo لإنهاء الاتصال.**

يُعد التكامل عبر واجهة برمجة التطبيقات الرسمية لواتساب، والمعروفة أيضًا باسم Cloud API، الحل الأكثر قوة وقابلية للتوسع للشركات التي ترغب في احتراف خدمة العملاء عبر هذه القناة. على عكس تطبيق واتساب للأعمال، تسمح واجهة برمجة التطبيقات لعدة وكلاء باستخدام نفس الرقم، بالإضافة إلى تمكين الأتمتة المتقدمة باستخدام الذكاء الاصطناعي والتكامل مع أنظمة أخرى، مثل أنظمة إدارة علاقات العملاء (CRMs) وأنظمة تخطيط موارد المؤسسات (ERPs).

تُسهّل Papo Global هذا الاتصال، حيث ترشدك خلال العملية وتوحّد واتساب مع قنوات الاتصال الأخرى الخاصة بك في صندوق وارد واحد.

## المتطلبات الأساسية للاتصال

قبل البدء، تأكد من أن لديك:
1.  **حساب في Papo Global:** تحتاج إلى الوصول إلى لوحة تحكم Papo لبدء الإعداد.
2.  **حساب في مدير أعمال Meta (Facebook Business Manager):** يجب أن تكون شركتك مُعدّة ومُوثّقة، من الناحية المثالية، على منصة Meta.
3.  **رقم هاتف حصري:** الرقم الذي ستقوم بربطه **لا يمكن** أن يكون نشطًا في حساب تطبيق واتساب أو واتساب للأعمال. إذا كان كذلك، فستحتاج أولاً إلى حذف حساب واتساب المرتبط بهذا الرقم قبل بدء عملية الترحيل إلى واجهة برمجة التطبيقات.

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

تنقسم العملية إلى خطوات تتم على منصة Papo وفي بيئة Meta.

| الخطوة | الإجراء | المنصة |
| :--- | :--- | :--- |
| **1** | بدء إنشاء صندوق الوارد | Papo Global |
| **2** | إنشاء وتكوين تطبيق | Meta (Facebook for Developers) |
| **3** | إضافة رقم الهاتف والتحقق منه | Meta (WhatsApp Manager) |
| **4** | الحصول على بيانات اعتماد واجهة برمجة التطبيقات | Meta (لوحة تحكم التطبيق) |
| **5** | إدخال بيانات الاعتماد والإنهاء | Papo Global |
| **6** | إنشاء قوالب الرسائل | Meta (WhatsApp Manager) |

### الخطوة 1: بدء الإعداد في Papo Global
الخطوة الأولى هي الإشارة في Papo إلى أنك ترغب في إضافة قناة واتساب جديدة عبر واجهة برمجة التطبيقات الرسمية.

1.  ادخل إلى لوحة تحكم Papo وانتقل إلى **الإعدادات ← صناديق الوارد**.
2.  انقر على زر **"إضافة صندوق وارد جديد"**.
3.  من قائمة القنوات، اختر الخيار **"WhatsApp – API Cloud (Meta)"**.
4.  سيتم توجيهك إلى شاشة الإعداد. أبقِ هذه النافذة مفتوحة، حيث ستحتاجها بعد إعداد كل شيء في Meta.

### الخطوة 2: إنشاء وتكوين تطبيق في Meta
الآن، ننتقل إلى بيئة مطوري Meta لإنشاء الهيكل المطلوب.

1.  ادخل إلى بوابة [Meta for Developers](https://developers.facebook.com/apps/).
2.  انقر على **"إنشاء تطبيق"**.
3.  اختر نوع التطبيق **"شركة"** وانقر على "التالي".
4.  أعطِ اسمًا لتطبيقك (مثال: `خدمة عملاء Papo [اسم الشركة]`) واربطه بحسابك في مدير أعمال Meta.
5.  بعد إنشاء التطبيق، في اللوحة الرئيسية، مرر لأسفل وابحث عن منتج **"WhatsApp"**. انقر على **"إعداد"**.

### الخطوة 3: إضافة رقم الهاتف والتحقق منه
ضمن إعداد منتج واتساب في تطبيقك، ستحتاج إلى ربط رقم الهاتف الذي سيتم استخدامه والتحقق منه.

1.  اتبع التعليمات لربط حسابك في Meta.
2.  في قسم إعداد واجهة برمجة التطبيقات، ستكون هناك خطوة لإضافة رقم هاتف.
3.  أدخل رقم الهاتف الذي ترغب في استخدامه (تذكر: لا يمكن أن يكون نشطًا في تطبيق واتساب آخر).
4.  اختر طريقة تحقق (رسالة نصية قصيرة أو مكالمة صوتية) وأدخل الرمز المستلم لتأكيد ملكية الرقم.

### الخطوة 4: الحصول على بيانات اعتماد واجهة برمجة التطبيقات
مع إنشاء التطبيق والتحقق من الرقم، أصبح لديك الآن وصول إلى بيانات الاعتماد اللازمة للتكامل. توجد هذه البيانات في لوحة إعداد واتساب داخل تطبيقك في Meta.

المعلومات الأساسية الثلاث هي:
*   **معرف رقم الهاتف:** المعرف الفريد لرقمك على منصة Meta.
*   **معرف حساب واتساب للأعمال (WABA ID):** المعرف الخاص بحساب واتساب للأعمال الخاص بك.
*   **رمز الوصول:** مفتاح يخول Papo التواصل مع واجهة برمجة التطبيقات نيابة عن شركتك.

### الخطوة 5: إنهاء الاتصال في Papo Global
عد إلى نافذة Papo التي تركتها مفتوحة في الخطوة 1.

1.  املأ حقول النموذج بالمعلومات التي حصلت عليها من Meta:
    *   **اسم صندوق الوارد:** اسم داخلي لتحديد القناة (مثال: "واتساب الرسمي").
    *   **معرف رقم الهاتف**.
    *   **معرف حساب واتساب للأعمال (WABA ID)**.
    *   **رمز الوصول**.
2.  انقر على **"حفظ"** أو **"إنشاء صندوق وارد"**.

تم! بعد الحفظ، ستقوم Papo بإنشاء الاتصال. في غضون لحظات قليلة، سيكون رقم واتساب الرسمي الخاص بك متصلاً وجاهزًا لاستقبال وإرسال الرسائل مباشرة عبر صندوق الوارد الموحد الخاص بك.

### الخطوة 6: إنشاء قوالب الرسائل (Templates)
لبدء المحادثات مع عملائك أو إرسال إشعارات بعد 24 ساعة من آخر تفاعل لهم، يتطلب واتساب استخدام قوالب الرسائل (المعروفة أيضًا باسم HSM).

1.  في **مدير أعمال Meta** الخاص بك، ادخل إلى **مدير واتساب**.
2.  انتقل إلى قسم **قوالب الرسائل**.
3.  انقر على **"إنشاء قالب"** واتبع التعليمات لتحديد الفئة والاسم واللغة ومحتوى رسالتك.
4.  أرسل القالب للموافقة. عادةً ما تستغرق الموافقة من بضع دقائق إلى بضع ساعات.

## الأسئلة الشائعة (FAQ)

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

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

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

### ما هو WABA ID؟
WABA تعني "حساب واتساب للأعمال" (WhatsApp Business Account). WABA ID هو المعرف الفريد لحساب واتساب للأعمال الخاص بك. من خلال هذا الحساب، يمكنك إدارة أرقام هواتفك، قوالب الرسائل، والتحقق من مقاييس الاستخدام.

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

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

---

**[ابدأ الاستخدام مجانًا ←](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=connect-whatsapp-official-api-cloud-api&utm_content=ar)**

المستخدم الأول مجاني ويتضمن الوصول إلى الذكاء الاصطناعي، نظام إدارة علاقات العملاء (CRM) الكامل، وقنوات متعددة.