قوالب الرسائل

يلزم توفير قالب رسالة لفتح محادثات تسويق ومساعدة ومصادقة مع العملاء. ويمكن أن تكون هذه المحادثات رسائل خدمة عملاء أو تذكيرات بالمواعيد وتحديثات الدفع أو الشحن وتنبيهات والمزيد.

المتطلبات

• يجب الموافقة على قالب الرسالة قبل أن يتم استخدامه لبدء محادثة. تعرف على المزيد.
• لفتح محادثات التسويق والمساعدة والمصادقة مع عميل، يجب أن يكون العميل قد اشترك لتلقي رسائل من نشاطك التجاري. معرفة المزيد.

فئات القوالب المدعومة

راجع الفئات.

الترجمات

عند إرسال قالب رسالة، يجب تحديد اللغة باستخدام الحقل language. ويكون نشاطك التجاري هو المسؤول عن كل الترجمات التي ترغب في استخدامها.

اللغات المدعومة

حِزم اللغات

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

مساحة اسم قالب الرسالة عبارة عن مجموعة من حِزم اللغات الخاصة بنشاط تجاري محدد.

خيارات سياسة اللغة

إذا تم إرسال قالب رسالة يتضمن الحقل language: policy الذي يتم تعيينه على deterministic، القيمة الافتراضية، فسيعرض واتساب قالب الرسالة باللغة والإعداد المحلي المطلوبين بالضبط. ثم يرسل الجهاز استعلامًا إلى الخادم بشأن حزمة اللغة الخاصة بهذه اللغة المحددة.

عند تسليم هذه الرسالة إلى الجهاز، يقوم الجهاز بما يلي:

• التحقق من الرمز/السياسة - عند توفير "policy": "deterministic" و"code": "en"، فهل تم تخزين حزمة اللغة en مؤقتًا على الجهاز؟

  • إذا كانت الإجابة هي نعم، فانتقل إلى التحقق من العنصر.
  • إذا كانت الإجابة هي لا، فهل يمكن العثور على حزمة اللغة en على الخادم؟

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

• التحقق من العنصر - هل العنصر "element": "hello_world" موجود؟

  • إذا كانت الإجابة هي نعم، فقم بفك حزمة المعلمات واعرض الرسالة على الجهاز.
  • إذا كانت الإجابة هي لا:

    • إذا كانت حزمة اللغة واردة من التخزين المؤقت المحلي، يمكنك تنزيل حزمة اللغة en الأحدث من الخادم وتكرار التحقق من العنصر.
    • إذا تم تنزيل حزمة اللغة مؤخرًا من الخادم، فسجّل حالة الفشل وسيقوم الخادم بإرجاع خطأ structure_unavailable عبر حدث Webhook ولن تظهر أية رسائل على الجهاز.

يتم تجاهل إعدادات اللغة/اللغة المحلية على الجهاز بالكامل.

تتمثل المشكلة التي قد تنتج عند استخدام سياسة deterministic فيما إذا كان ما تطلبه غير موجود. وتأكد مما يلي:

• مساحة الاسم صحيحة
• اسم العنصر صحيح
• ترجمة اللغة/الإعداد المحلي متوفرة لهذا العنصر
• عدد المعلمات المرسلة يتطابق مع ما تم تحديده في قالب الرسالة

التطويع المحلي

توفر قوالب الرسائل دعمًا مبتكرًا للترجمة عن طريق ترجمة الرسالة وفقًا لإعدادات اللغة المحلية في الجهاز.

المعلمات القابلة للترجمة

تتضمن القوالب معلمات يتم دمجها ديناميكيًا في الرسالة. وبالنسبة للمثال المُستخدم في هذا المستند، يبدو قالب الرسالة كما يلي:

"You made a purchase for {{1}} using a credit card ending in {{2}}."

بالنسبة لـ "namespace": "cdb2df51_9816_c754_c5a4_64cdabdcad3e" بالقيمة "element_name": "purchase_with_credit_card"، تحل القيمة الأولى التي تدرجها محل المتغير {{1}} الموجود في رسالة القالب، بينما تحل القيمة الثانية التي تدرجها محل المتغير {{2}}.

تكون بعض هذه المعلمات (مثل date_time أو currency) قابلة للترجمة بحيث تظهر بشكل صحيح بناءً على تفضيلات العميل بشأن اللغة واللغة المحلية. وإذا لم ينجح الجهاز في ترجمة أية معلمة، فستتم إعادة التعيين افتراضيًا على fallback_value.

إذا احتجت إلى تحديد العملة والتاريخ بالإضافة إلى fallback_value، فاستخدم الكائنين currency وdate_time. ويتيح ذلك للعميل تطويع البيانات محليًا بأفضل طريقة ممكنة والرجوع افتراضيًا إلى fallback_value فقط في حالة تعذر تطويع البيانات محليًا.

تظهر خيارات localizable_params في الجدول أدناه:

المعلمات

الكائن currency

يحاول عميل واجهة API الخاصة بتطبيق Whatsapp للأعمال تنسيق العملة استنادًا إلى الترجمة المحددة.

مثال

{
    "type": "currency",
    "currency" : {
        "fallback_value": "$230.99",
        "code": "USD",
        "amount_1000": 230990
    }
}  

الكائن date_time

يحاول عميل واجهة API الخاصة بتطبيق Whatsapp للأعمال تنسيق التاريخ/الوقت استنادًا إلى الترجمة المحددة. وتتضمن تنسيقات التاريخ والوقت المدعومة ما يلي:

• التوقيت الأساسي — يتكون الوقت من عدة مكونات (مثل أحد أيام الأسبوع أو الشهر أو الساعة، وما إلى ذلك) وسيظل الوقت المحدد هو نفسه بغض النظر عن المنطقة الزمنية التي يوجد فيها العميل.
• توقيت Unix — يعتمد على الوقت الذي يظهر بالمنطقة الزمنية التي يوجد فيها العميل.

DateTime

DateTimeComponent

مثال

{
    "type": "date_time",
    "date_time" : {
        "fallback_value": "October 25, 2020",
        "day_of_week": "Saturday",
        "day_of_month": 25,
        "year": 2020,
        "month": 10,
        "hour": 12,
        "minute": 0
    }
}

DateTimeUnixEpoch

الخطوات التالية

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

https://developers.facebook.com/docs/whatsapp/message-templates/creation#step-1--create-template-using-the-whatsapp-manager