> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkiasoft.com/llms.txt
> Use this file to discover all available pages before exploring further.

# قوالب واتساب

> حالة الاعتماد، والعناصر النائبة، والأزرار، والاستيراد من مكتبة ميتا.

خارج نافذة خدمة العملاء (24 ساعة) — وهو الحال دائمًا تقريبًا لأي شيء يبدأه نظامك — لا يقبل واتساب
إلا **القوالب المعتمدة**. وتغطي هذه الصفحة ما تحتاج معرفته لبناء قالب يُرسَل بشكل صحيح.

اعرض القوالب التي تستطيع القناة إرسالها عبر
[`GET /v1/templates`](/api-reference/templates/list-approved-templates-for-a-channel).

## الحالة

```json theme={null}
{ "name": "ticket_resolved", "language": "ar", "status": "APPROVED", "category": "UTILITY" }
```

| الحالة             | هل يمكنك إرساله؟                                 |
| ------------------ | ------------------------------------------------ |
| `APPROVED`         | نعم                                              |
| `PENDING`          | لا — قيد مراجعة ميتا، عادةً أقل من 24 ساعة       |
| `REJECTED`         | لا — صحّح المحتوى وأعد التقديم، أو قدّم اعتراضًا |
| `IN_APPEAL`        | لا — يُعاد النظر في رفض                          |
| `PAUSED`           | لا — أوقفت ميتا التسليم، عادةً بعد تقييمات سلبية |
| `DISABLED`         | لا — معطّل نهائيًا من ميتا                       |
| `PENDING_DELETION` | لا — يُزال بعد مهلة 24 ساعة                      |

وتغييرات الحالة لا تُدفع إلى مستهلكي الـ API. فإذا كنت تنشئ القوالب برمجيًا، استطلع
[`GET /v1/templates`](/api-reference/templates/list-approved-templates-for-a-channel)
بدل افتراض أن التقديم اجتاز المراجعة.

<Warning>
  القالب يُعتمد **لكل لغة**. فـ`ticket_resolved` بالعربية و`ticket_resolved` بالإنجليزية يُراجَعان
  منفصلين — واعتماد أحدهما لا يقول شيئًا عن الآخر. ويجب أن يطابق `templateLanguage` اللغة المعتمدة
  تمامًا.
</Warning>

## العناصر النائبة

العناصر النائبة في النص مرقّمة `{{1}}` و`{{2}}` وهكذا. وتملؤها بـ`templateParams`
**بالترتيب**:

```json theme={null}
{
  "templateName": "ticket_resolved",
  "templateLanguage": "ar",
  "templateParams": ["Ahmed", "4821"]
}
```

فمع نص مثل `مرحباً {{1}}، تم حل تذكرتك رقم {{2}}.` يُرسَل *«مرحباً Ahmed، تم حل تذكرتك رقم 4821.»*

ويجب أن يتطابق العدد تمامًا. فعنصران نائبان ومعامل واحد يُفشل الإرسال — ولا يعود إلى نص فارغ.

<Warning>
  اكتب `{{1}}` ولا تكتب `{{ 1 }}` أبدًا. فميتا تعتمد العنصر النائب ذا المسافات كـ**نص حرفي**، فيجتاز
  القالب المراجعة ثم يرفض كل إرسال بمعاملات بالخطأ `#132000`. ونحن نُطبّع المسافات في القوالب
  المنشأة عبر هذا الـ API، لكن القالب المنشأ في مكان آخر قد يظل يحمل المشكلة.
</Warning>

و**النص** وحده هو ما يأخذ معاملات هنا. فالقالب الذي يحتوي رأسه أو أزراره على متغيرات لا يمكن
إرساله عبر هذا الـ API — أعد بناءه برأس ثابت.

## الأزرار

يمكن أن تحمل القوالب أزرارًا، ونوع الزر يحدد ما إذا كان القالب يظل قابلًا للإرسال:

| نوع الزر          | ملاحظات                                               |
| ----------------- | ----------------------------------------------------- |
| رد سريع           | ضغطة العميل تصل كرسالة واردة عادية على المحادثة.      |
| رابط (ثابت)       | لا مشكلة.                                             |
| رابط (ديناميكي)   | يحتوي متغيرًا — **غير قابل للإرسال عبر هذا الـ API**. |
| الاتصال برقم هاتف | لا مشكلة.                                             |

وضغطات الردود السريعة تعود كرسائل واردة عادية، فأي شيء يقرأ أصلًا
[`GET /v1/conversations/{id}/messages`](/api-reference/conversations/list-messages-in-a-conversation)
يلتقطها دون عمل إضافي.

## مكتبة قوالب ميتا

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

في لينكياسوفت، افتح باني القوالب واختر **استيراد من المكتبة**. اختر قالب المكتبة، وقدّم القيم
النموذجية التي يطلبها، ثم قدّمه. ولأن النص معتمد من ميتا مسبقًا، تتخطى هذه القوالب المراجعة كليًا
بدل الجلوس في حالة `PENDING`.

<Warning>
  إذا كان قالب المكتبة يحمل **أزرار روابط أو هواتف**، فيجب أن تقدّم مدخلًا واحدًا لكل زر وبالترتيب
  نفسه. وإغفال واحد يجعل ميتا ترفض الإنشاء برسالة عن مطابقة عدد مدخلات الأزرار لأزرار المكتبة.
</Warning>

## الفئة

| الفئة            | استخدمها لـ                                                      |
| ---------------- | ---------------------------------------------------------------- |
| `UTILITY`        | رسائل معاملات عن شيء فعله العميل — تأكيد طلب، حل تذكرة.          |
| `MARKETING`      | العروض وإعادة التفاعل. أعلى سعرًا، ويمكن للعملاء إلغاء الاشتراك. |
| `AUTHENTICATION` | رموز المرور لمرة واحدة.                                          |

صنّف بصدق. فميتا تعيد تصنيف القوالب التي ترى أنها مصنّفة خطأ، والمحتوى التسويقي المرسل كـ`UTILITY`
يخاطر بإيقاف القالب.

## عند فشل الإرسال

افحص `error_reason` على الرسالة:

| العرض                               | السبب                                                                      |
| ----------------------------------- | -------------------------------------------------------------------------- |
| `#132000`                           | عدم تطابق عدد المعاملات، أو عنصر نائب بمسافات `{{ 1 }}` اعتُمد كنص حرفي.   |
| رفض عند الإنشاء يذكر مدخلات الأزرار | قالب مكتبة بأزرار روابط أو هواتف أُنشئ دون مدخل لكل زر بالترتيب.           |
| القالب غير موجود                    | القالب موجود، لكن ليس باللغة `templateLanguage` التي طلبتها.               |
| قُبل ثم `failed`                    | افحص `error_reason` على الرسالة.                                           |
| قُبل لكنه لا يصل أبدًا              | السبب دائمًا تقريبًا رقم المستلم — راجع [البداية السريعة](/ar/quickstart). |