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

| إجراء API | ما يفعله | مثال على الاستخدام |
| :--- | :--- | :--- |
| إدراج صناديق WhatsApp | يُرجع صناديق الوارد WhatsApp Cloud API المرتبطة بالحساب | تحديد الصندوق الصحيح قبل الإرسال |
| إدراج القوالب المعتمدة | يُرجع قوالب الرسائل (HSM) بحالة "معتمد" لصندوق وارد معين | التحقق من HSMs المتاحة للإرسال |
| إرسال HSM إلى جهة اتصال | يرسل قالبًا معتمدًا إلى رقم هاتف واحد، مع تعبئة المتغيرات | إشعار الطلب، تذكير الموعد |
| إرسال HSM إلى عدة جهات اتصال | يرسل نفس القالب إلى قائمة جهات اتصال دفعة واحدة | حملة تسويقية، إعلان جماعي |

## كيف يعمل إرسال HSM عبر API

تعكس واجهة برمجة تطبيقات Papo وظائف المنصة. لإرسال قالب رسالة WhatsApp، لا تحتاج إلى إنشاء أي شيء جديد عبر الكود: يتم إنشاء القوالب وتقديمها مباشرة في مدير أعمال Meta، وبعد الموافقة عليها، تظهر تلقائيًا في حسابك على Papo. تقوم API فقط بالاستعلام عن قائمة القوالب المعتمدة وتنفيذ الإرسال.

يتكون تدفق التكامل النموذجي من:
1. إنشاء رمز مميز لواجهة برمجة التطبيقات في لوحة تحكم Papo.
2. تحديد صندوق الوارد WhatsApp Cloud API حيث تمت مزامنة القالب.
3. الحصول على قائمة القوالب المعتمدة (HSM) من هذا الصندوق.
4. تحضير الطلب بالمعلمات اللازمة: معرف القالب، اللغة، رقم المستلم مع رمز الدولة وقيم المتغيرات (إذا كان القالب يحتوي على `{{1}}`، `{{2}}` إلخ).
5. إرسال الطلب — سواء إلى جهة اتصال واحدة أو إلى مجموعة أرقام، كل منها بمتغيراته المخصصة.

## خطوة بخطوة لاستخدام API

### 1. أنشئ رمزًا مميزًا لواجهة برمجة التطبيقات
في قائمة إعدادات حسابك على Papo، انتقل إلى قسم API أو رموز الوصول. أنشئ رمزًا مميزًا بالأذونات اللازمة لإدارة المحادثات والرسائل. احفظ الرمز في مكان آمن؛ سيتم إرساله في رأس جميع الطلبات.

### 2. أدرج صناديق WhatsApp المتاحة
قبل إرسال أي قالب، تحتاج إلى معرفة صندوق الوارد (inbox) الذي يحتوي على القوالب المعتمدة. استخدم نقطة النهاية التي تُرجع صناديق WhatsApp Cloud API لحسابك. دوّن معرف الصندوق الذي تنوي استخدامه — سيكون إلزاميًا في الخطوات التالية.

### 3. استعلم عن القوالب المعتمدة (HSM)
بعد الحصول على معرف الصندوق، استدعِ نقطة النهاية التي تُدرج القوالب بحالة `APPROVED`. ستعرض الاستجابة لكل قالب الاسم، اللغة المتاحة، الفئة (تسويق، منفعة، أو مصادقة) والمعلمات المتوقعة. هذه الخطوة مهمة للتأكد من أن القالب مُفرج عنه ولمعرفة المتغيرات التي يجب تعبئتها.

### 4. جهّز طلب الإرسال
تتطلب عملية الإرسال إلى جهة اتصال واحدة أساسًا:
- معرف القالب (أو الاسم، حسب التنفيذ).
- لغة القالب (على سبيل المثال، `pt_BR`).
- رقم هاتف جهة الاتصال، بما في ذلك رمز الدولة (مثال: `5511999999999`).
- كائن يحتوي على قيم المتغيرات، إذا كان القالب يحتوي على عناصر نائبة.

للإرسال المجمع (جهات اتصال متعددة)، يقبل الاستدعاء قائمة مستلمين، كل منهم برقمه واختياريًا متغيراته الخاصة. القالب هو نفسه للجميع.

### 5. أطلق وتحقق من الاستجابة
تُرجع API تأكيدًا متزامنًا بأن طلب الإرسال قد تم قبوله. لمتابعة حالة التسليم الفعلية (تم التسليم، تمت القراءة، فشل)، يمكنك تكوين webhook صادر — تقوم Papo بإخطار أحداث المحادثة في الوقت الفعلي. تشرح المقالة حول استقبال الأحداث في الوقت الفعلي (المدرجة في "اقرأ أيضًا") كيفية تنشيط هذه الميزة.

## من يجب عليه استخدام API لإرسال HSM

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

تكون API مفيدة بشكل خاص عندما تكون القاعدة التي تحدد **متى** يتم إرسال القالب موجودة في برنامج آخر — على سبيل المثال، نظام لوجستي يطلق إشعار التسليم بمجرد خروج الحزمة للنقل.

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

### هل لواجهة برمجة تطبيقات Papo تكلفة إضافية؟
API متاحة في خطط Papo. يمكنك إنشاء رموز مميزة واستخدام نقاط النهاية وفقًا للخطة المشتركة. تفاصيل الحدود والرسوم لكل طلب موجودة في صفحة الخطط ووثائق API.

### هل أحتاج إلى إنشاء قوالب الرسائل عبر API؟
لا. يجب إنشاء القوالب وتقديمها للموافقة في مدير أعمال Meta. بمجرد الموافقة عليها، تتم مزامنتها تلقائيًا في Papo وتظهر في قائمة قوالب API.

### هل يمكنني إرسال HSM إلى أرقام غير موجودة في CRM الخاص بـ Papo؟
نعم. لا يحتاج المستلم إلى أن يكون مسجلاً مسبقًا في CRM الخاص بالمنصة. يكفي تقديم رقم WhatsApp (مع رمز الدولة ورمز المنطقة) في الطلب. ومع ذلك، يجب أن يكون لديك موافقة (opt-in) من العميل لتلقي الاتصال، خاصة إذا كان القالب من فئة التسويق.

### كيف أعرف ما إذا تم تسليم الرسالة؟
تؤكد الاستجابة الفورية من API أن الطلب قد تم قبوله وإرساله إلى WhatsApp. لمراقبة الفشل والتسليم والقراءات في الوقت الفعلي، من الضروري تنشيط webhook الأحداث (الصادر) من Papo. راجع دليل webhooks في مركز المساعدة.

### هل هناك حد للسرعة للإرسال عبر API؟
نعم. تطبق Papo حدودًا للمعدل لحماية استقرار الخدمة واحترام سياسات WhatsApp. يُنصح بالحفاظ على سرعات معتدلة — تجنب الارتفاعات المفاجئة يساعد في الحفاظ على صحة الرقم. القيم الدقيقة موجودة في وثائق API.

### هل يمكنني استخدام API لحملات تسويقية جماعية؟
نعم، بشرط أن تستخدم حصريًا قوالب معتمدة من فئة التسويق وأن يكون لديك opt-in صريح من المستلمين. إرسال رسائل غير مرغوب فيها قد يؤدي إلى شكاوى ويعرض رقمك لخطر الحظر. خطط للإرسال مع التحكم في الإيقاع واحترم دائمًا سياسات WhatsApp.

## اقرأ أيضًا

- [كيفية استقبال أحداث Papo في الوقت الفعلي عبر Webhook (الصادر)](/hc/papo/articles/receive-real-time-events-papo-webhook-outbound)
- [كيفية استخدام API Papo لإنشاء وتحديث جهات الاتصال بشكل جماعي](/hc/papo/articles/how-to-use-papo-api-create-update-contacts-bulk)

---

**[ابدأ في أتمتة إرسال HSM الآن – جرب مجانًا →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=how-to-use-papo-api-to-send-whatsapp-hsm-templates&utm_content=ar)**

أنشئ حسابك على Papo وأرسل قوالب رسائل معتمدة بدون تكلفة للمستخدم الأول.