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

يمكنك استخدام نقطة النهاية /messages لإرسال قوالب رسائل إلى عملائك. يمكن أن يكون قالب الرسالة مستندًا إلى النص أو مستندًا إلى الوسائط أو تفاعليًا.

لمعرفة المزيد حول قوالب الرسائل، راجع الرسائل، الرسائل التي بدأها النشاط التجاري.

قبل البدء

تأكد من إكمال الإجراءات في الرسائل — وثائق المتطلبات الأساسية.

الخطوة الأولى: إنشاء قالب باستخدام مدير WhatsApp

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

عند إنشاء قالب رسالة، يجب أن يتوفر لديك ما يلي:

1. اسم قالب الرسالة — لا يمكن أن يحتوي إلا على أحرف أبجدية رقمية صغيرة وشرطات سفلية ( _ ). وغير مسموح باستخدام أية أحرف أخرى أو مسافات بيضاء.
2. مكونات قالب الرسالة — املأ القالب بالمكونات النصية و/أو مكونات الوسائط، بما في ذلك العناصر النائبة للمعلمات، كما هو مطلوب. وتأكد من أنه لا يحتوي على سطور جديدة أو علامات تبويب أو أكثر من 4 مسافات متتالية ويلبي التقييدات المفروضة على الطول كما هو موضح في مدير الأعمال أو واجهة API إدارة WhatsApp للأعمال.
3. كل الترجمات الأخرى التي يحتاج إليها نشاطك التجاري.

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

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

أمثلة

إنشاء رسالة ترحيبية حيث يكون اسم قالب الرسالة هو welcome وتكون الرسالة هي

  "Welcome {{1}}. We look forward to serving you on WhatsApp." 

إنشاء رسالة تأكيد على طلب حيث يكون اسم قالب الرسالة هو order_confirmation وتكون الرسالة هي

  "Your order {{1}} for a total of {{2}} is confirmed. The expected delivery is {{3}}." 

الترجمات

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

• الترجمات
• اللغات المدعومة

الخطوة الثانية: إجراء طلب POST إلى /messages

بمجرد الحصول على القالب، يمكنك إرساله إلى العملاء عبر الكائن template:

POST /v1/messages
{
  "to": "recipient_wa_id",
  "type": "template",
  "template": {
        "namespace": "your-namespace",
        "name": "your-template-name",
        "language": {
            "code": "your-language-and-locale-code",
            "policy": "deterministic"
        },
        "components": [{
            "type": "body",
            "parameters": [
                {
                    "type": "text",
                    "text": "your-text-string"
                },
                {
                    "type": "currency",
                    "currency": {
                        "fallback_value": "$100.99",
                        "code": "USD",
                        "amount_1000": 100990
                    }
                },
                {
                    "type": "date_time",
                    "date_time" : {
                        "fallback_value": "February 25, 1977",
                        "day_of_week": 5,
                        "day_of_month": 25,
                        "year": 1977,
                        "month": 2,
                        "hour": 15,
                        "minute": 33
                    }
                },
                {
                "type": "date_time",
                    "date_time" : {
                    "fallback_value": "February 25, 1977",
                    "timestamp": 1485470276
                    }
                }
            ]
        }]
    }
}

المعلمات

• المعلمات المشتركة لكل طلبات الرسائل
• معلمات قوالب الرسائل: الكائن template والكائن components والكائن parameters والكائن language.
• اللغة: خيارات سياسة اللغة والكائن language والمعلمات القابلة للترجمة.

الخطوة الثالثة: التحقق من استجابة واجهة API

تتضمن الاستجابة الناجحة كائن messages بالمعرف id.

{
  "messages": [{
    "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
  }]
}  

تتضمن الاستجابة غير الناجحة كائن خطأ بسلسلة خطأ ورمز خطأ ومعلومات أخرى. لمزيد من المعلومات، يمكنك الرجوع إلى رموز الخطأ والحالة.

تقييدات رسائل قالب التسويق لكل مستخدم

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

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

إذا لم يتم تسليم رسالة قالب التسويق إلى مستخدم معين بسبب التقييد، فسترجع API داخل المواقع رمز الخطأ 1026. ومع ذلك، لاحظ أن رمز الخطأ هذا يغطي نطاقًا واسعًا من المشكلات التي يمكن أن تؤدي إلى عدم تسليم الرسالة، ولأسباب تتعلق بالخصوصية، لن نكشف عما إذا كان لم يتم تسليم الرسالة بالفعل بسبب التقييد. راجع "لماذا لا يصل معدل التسليم إلى 100%؟" الأسئلة المتكررة لمزيد من المعلومات.

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

سنواصل تحسين نهجنا ونقدر شراكتك بينما نستثمر في جعل تجربة واتساب أفضل لنشاطك التجاري وعملائك.