قوالب واتساب

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

الحالة

{ "name": "ticket_resolved", "language": "ar", "status": "APPROVED", "category": "UTILITY" }

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

وتغييرات الحالة لا تُدفع إلى مستهلكي الـ API. فإذا كنت تنشئ القوالب برمجيًا، استطلع GET /v1/templates بدل افتراض أن التقديم اجتاز المراجعة.

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

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

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

{
  "templateName": "ticket_resolved",
  "templateLanguage": "ar",
  "templateParams": ["Ahmed", "4821"]
}

فمع نص مثل مرحباً {{1}}، تم حل تذكرتك رقم {{2}}. يُرسَل «مرحباً Ahmed، تم حل تذكرتك رقم 4821.» ويجب أن يتطابق العدد تمامًا. فعنصران نائبان ومعامل واحد يُفشل الإرسال — ولا يعود إلى نص فارغ.

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

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

الأزرار

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

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

وضغطات الردود السريعة تعود كرسائل واردة عادية، فأي شيء يقرأ أصلًا GET /v1/conversations/{id}/messages يلتقطها دون عمل إضافي.

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

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

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

الفئة

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

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

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

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

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

البداية

المراسلة

محادثة الموقع

إدارة العملاء

Webhooks

التكاملات

قوالب واتساب

الحالة

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

الأزرار

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

الفئة

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

​الحالة

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

​الأزرار

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

​الفئة

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

الحالة

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

الأزرار

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

الفئة

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