يدعم منشئ MaviBot أيضًا واجهة برمجة تطبيقات WhatsApp Business الرسمية.

كيفية الاتصال بـ WhatsApp Business

للاتصال بواجهة برمجة تطبيقات WhatsApp Business (WABA) بمشروعك، انتقل إلى قسم Messengers وحدد WhatsApp Business API.

الاتصال بواجهة برمجة تطبيقات WhatsApp Business

في النافذة التي تفتح، قم بتسجيل الدخول باستخدام حساب Facebook الخاص بك. ثم انقر فوق الزر "Connect via Facebook".

إذا لزم الأمر، أدخل كلمة مرور Facebook الخاصة بك للمتابعة.

اكتمل الإعداد الآن. لا تحتاج إلى إبقاء هاتفك متصلاً بالإنترنت في جميع الأوقات؛ سيعمل الروبوت بشكل مستقر ومستقل.

قوالب الرسائل لواجهة برمجة تطبيقات WhatsApp Business

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

خارج نافذة الـ 24 ساعة، يمكن استخدام قوالب رسائل WhatsApp فقط (أو رسائل قالب WhatsApp)، حيث يتم خلالها التواصل مجانًا ضمن الفئة المحددة.

تُستخدم هذه الوظيفة في WhatsApp لمنع الرسائل غير المرغوب فيها عن طريق تحديد عدد الرسائل المسموح بها في فترة زمنية معينة، وكذلك عن طريق تعيين فئة للقوالب.

توجد فئات الرسائل التالية المثبتة لواجهة برمجة تطبيقات WhatsApp Business بواسطة Meta:

  1. قوالب مفيدة (تحتوي على معلومات محددة حول المعاملات والفواتير والمدفوعات وما إلى ذلك)؛

  2. قوالب للتسويق (معلومات حول الشركة أو المؤسسة أو الاستراتيجيات أو الإعلان والترويج)؛

  3. قوالب للتحقق والمصادقة.

يتم الإشراف على القوالب التي تم إنشاؤها لـ WABA.

الأسباب الرئيسية لرفض القوالب

يفشل عدد كبير من القوالب في مراجعة WhatsApp لعدة أسباب:

  1. الإعلان المفرط: يرفض WhatsApp Business القوالب المثقلة بالإعلانات والمحتوى الترويجي. إذا قرر المشرفون أو الذكاء الاصطناعي للمنصة أن الإعلان يطغى على الرسالة الأساسية، فسيتم حظر القالب.
  2. انتهاك سياسة المنتج: سيتم رفض القوالب التي تروج لعناصر محظورة مثل المخدرات أو المواد ذات التأثير النفساني أو الكحول أو التبغ أو الخدمات الحميمة أو أي محتوى يعتبر مهينًا لكرامة الإنسان.
  3. الغموض أو الإغفال أو الادعاء الكاذب: إذا اكتشف مشرفو WhatsApp أي نص خفي أو معلومات مضللة أو نقص في التفاصيل الواضحة حول شركتك أو خدمتك، فلن تتم الموافقة على القالب.
  4. جمع المعلومات السرية: ستفشل القوالب المصممة لجمع بيانات المستخدم الحساسة (مثل أرقام جوازات السفر أو تفاصيل البطاقة المصرفية أو أرقام الهوية الشخصية أو العناوين المنزلية) في المراجعة.
  5. المحتوى المسيء: سيتم رفض أي رسالة تحتوي على معلومات قد تسيء إلى المستخدمين بناءً على العرق أو الجنسية أو الجنس أو الهوية أو معايير أخرى.
  6. الرفض التقديري: يحتفظ مشرفو WhatsApp بالحق في رفض القوالب دون تقديم سبب محدد.

كيفية تثبيت قوالب الرسائل

نظرًا لأن القوالب يتم إنشاؤها من الكتل، يجب عليك أولاً إنشاء كتلة في التدفق الخاص بك قبل استخدامها لقالب واجهة برمجة تطبيقات WhatsApp Business.

  • التكلفة والرسالة الأولى: إرسال رسائل القالب مجاني ضمن نافذة المحادثة التي تبلغ 24 ساعة. يمكن أن تكون الرسالة الأولى للعميل قالبًا تمت الموافقة عليه بواسطة Meta (Facebook) فقط.
  • بعد 24 ساعة: بمجرد مرور 24 ساعة على فتح الدردشة، يمكنك فقط إرسال قالب معتمد آخر لإعادة إشراك المستخدم.
  • ملاحظة حول المراجعة: قد تفشل القوالب في المراجعة إذا كانت تحتوي على متغيرات (بالأحرف السيريلية أو اللاتينية).

إنشاء القوالب في MaviBot

  1. انتقل إلى قسم Channels، وحدد WhatsApp Business API، ثم اختر Message templates.

  1. انقر فوق الزر "Create template". يفتح هذا صفحة إنشاء القالب.
  2. ترتبط القوالب بالكتل في التدفق الخاص بك. افتراضيًا، يتم سحب محتوى القالب من الكتلة، ولكن يمكنك تحديد نص وأزرار مخصصة.

  1. سيتم إرسال قالب الرسالة للمراجعة عند إنشائه. يمكنك فقط استخدام القوالب المعتمدة. تستغرق المراجعة عادةً حوالي 8 ساعات، بحد أقصى 48 ساعة.

أنواع القوالب

هناك 3 أنواع من القوالب المتاحة للاختيار من بينها.

يمكنك إرفاق صورة بقالب MARKETING بالتنسيقات التالية: SVG وPNG وJPG وGIF.

كيفية تمرير المتغيرات في القوالب

يتم التعامل مع المتغيرات في القوالب بنفس الطريقة كما في جميع أنحاء MaviBot، وليس وفقًا للتنسيق الأصلي لـ WhatsApp.

نظامنا مُكيَّف لمتغيرات MaviBot ولا يدعم المتغيرات بتنسيق {{1}}

استخدام المتغيرات في رسائل قالب WhatsApp

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

إذا كان القالب يحتوي على متغير، ولكن الروبوت لا يعين قيمة له أو كانت القيمة مفقودة، لن يتم إرسال الرسالة!

كيفية عمل الأزرار في القوالب

تدعم قوالب الرسائل الأزرار. في MaviBot، يتم تعيين الأزرار بشكل مشابه لصيغة واجهة برمجة تطبيقات Facebook. يمكنك التعرف عليها باتباع الرابط:

يتم تعيين الأزرار بتنسيق مصفوفة JSON.

معلمات إنشاء الزر:

المعامل مطلوب الوصف
type نعم القيم: PHONE_NUMBER وURL وQUICK_REPLY
text نعم نص الزر
url لا

عنوان URL الذي سيتم فتحه

عند النقر على الزر. يمكنك استخدام متغيرات

لإنشاء روابط ديناميكية.
phone_number لا

رقم الهاتف الذي سيتم

الاتصال به عند الضغط على الزر
example لا

يوفر مثالاً للبيانات المحتملة لقالبك. يساعد هذا في عملية المراجعة والموافقة حتى

تفهم الرسالة التي تخطط لإرسالها. تأكد

من أن هذه أمثلة ولا تحتوي على أي معلومات سرية أو شخصية.

على سبيل المثال: رسالة بزرين: [{"type":"QUICK_REPLY", "text": "Yes, convenient"}, {"type":"QUICK_REPLY", "text": "Inconvenient"}]

ميزات الأزرار في القوالب

هناك نوعان من الأزرار المتاحة في رسائل القالب:

  1. Call-To-Action (CTA): زر لرابط أو رقم هاتف (يتم عرضه مع أيقونة رابط أو سماعة هاتف بجانب نصه).
  2. Quick Reply: أزرار نصية قياسية بحد أقصى 20 حرفًا.

القيود:

  • يمكن أن يحتوي القالب الواحد على ما يصل إلى 3 أزرار Quick Reply وما يصل إلى زرين Call-to-Action. ومع ذلك، لا يمكنك استخدام رابطين أو رقمي هاتف في نفس الوقت.
  • لا يمكن أن تتضمن الأزرار متغيرات أو فواصل أسطر أو رموزًا تعبيرية أو رموز تنسيق.

السلوك:

  • يؤدي النقر فوق زر Quick Reply إلى إرسال نصه كرسالة رد من المستخدم.
  • يمكن لزر Call-to-Action فتح رابط لملف.
  • يؤدي النقر فوق زر Call-to-Action لإجراء مكالمة هاتفية إلى فتح برنامج الاتصال القياسي. على WhatsApp Web، ستظهر رسالة تفيد بأنه لا يمكن إجراء المكالمات من إصدار سطح المكتب.

كيف تعمل مراجعة القوالب

يتم إرسال كل قالب للمراجعة فور إنشائه. تستغرق العملية عادةً حوالي 8 ساعات، بحد أقصى لوقت المراجعة 48 ساعة.

يمكنك تتبع حالة المراجعة في قائمة القوالب الخاصة بك.

إذا تم رفض قالب، فسيتم تقديم سبب الرفض.

القوالب ذات الاحتمالية العالية للموافقة عادةً:

  • تستخدم لغة واضحة واحترافية.
  • تخدم حالة استخدام محددة وشرعية (مثل تذكيرات المواعيد أو تحديثات الطلبات).

مهم: يمكن أن يكون النص المائل متغيرًا وقابلاً للتخصيص.

مرحبًا، لم نتمكن من الوصول إليك. هل سيكون مناسبًا لك مواصلة التواصل هنا؟

مرحبًا، تركت رسالة على الموقع وطلبت منا الاتصال بك. (قابل للتغيير)

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

القوالب التي لن تجتاز المراجعة:

أي نص إعلاني

كيفية التحقق مما إذا كنت ضمن نافذة الـ 24 ساعة

يمكنك تحديد عدد الأيام التي مرت منذ آخر رسالة للعميل باستخدام الدالة days_from_last_message() في شرط المشغل الخاص بك.

مثال للتحقق من نافذة الـ 24 ساعة:

days_from_last_message() == 0

القيود المفروضة على الحسابات غير الموثقة

تواجه حسابات Facebook Business غير الموثقة القيود التالية:

  • 50 رسالة قالب يوميًا (مشمولة في الرسوم الشهرية).
  • لا توجد قيود على الرسائل الواردة.

لرفع هذه القيود، يجب على شركتك إكمال عملية التحقق من النشاط التجاري، والتي تستغرق عادةً 2-3 أسابيع.

أنظمة الدفع

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

يتم الدفع مباشرة إلى 360dialog.

أخطاء إرسال الرسائل

الأسباب المحتملة لفشل التسليم:

  1. رقم هاتف المستلم غير مسجل على WhatsApp.
  2. محاولة إرسال قالب من فئة "Authentication" إلى مستخدم WhatsApp برمز الدولة +91 (الهند). حاليًا، لا يمكن تسليم قوالب فئة المصادقة إلى المستخدمين في الهند.
  3. لم يقبل المستلم شروط الخدمة وسياسة الخصوصية المحدثة.
  4. لم يتم تسليم الرسالة للحفاظ على تجربة مستخدم عالية الجودة (هذا حظر سياسة عام).

تحويلات إعلانات Click-to-WhatsApp

إضافة إلى توثيق الدالة fb_pixel_event().

تضع Meta* علامة على كل نقرة من إعلان Click-to-WhatsApp بمعرف نقرة ctwa_clid. يتم استلامه مع أول رسالة WhatsApp من العميل ويستخدم لإسناد تحويل من المحادثة إلى إعلان محدد - على غرار كيفية إسناد أحداث البكسل إلى نقرة على موقع ويب.

التوقيع

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

المعاملات الجديدة

المعامل الوصف
ctwa_clid معرّف النقر لإعلان "انقر إلى واتساب". إذا لم يتم توفير هذا المعامل، يتم استخدام متغير العميل ctwa_clid، الذي يحفظه البوت تلقائيًا. اختياري.
messaging_channel قناة المراسلة التي حدث فيها التحويل. القيمة الافتراضية هي whatsapp. اختياري.

قيمة action_source الجديدة

يتم إضافة الصف التالي إلى جدول قيم action_source:

القيمة الوصف
business_messaging حدث التحويل في محادثة بعد أن نقر العميل على إعلان "انقر إلى واتساب".

يتم إرسال الحدث كتحويل مراسلة إذا تم استيفاء شرط واحد على الأقل من الشروط التالية:

  • تم توفير action_source="business_messaging"؛
  • تم توفير ctwa_clid؛
  • تم توفير messaging_channel.

في هذه الحالة، تتلقى Meta* مجموعة action_source + messaging_channel + ctwa_clid. بدون هذه المجموعة، لن يُنسب النقر على الإعلان إلى التحويل.

يجب عدم استخدام قيمة website لتحويلات المراسلة: سيصل الحدث إلى البكسل، لكنه لن يُنسب إلى الإعلان.

متغيرات العميل

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

المتغير الوصف
ctwa_clid معرّف النقر. يُضاف تلقائيًا إلى الحدث.
ctwa_clid_time الوقت الذي تم فيه استلام المعرّف، بتنسيق وقت Unix. يمكن استخدامه لتحديد مقدار الوقت المنقضي منذ النقر.
wa_ads_data بيانات الإعلان بتنسيق JSON: رابط الإعلان، معرّف الإعلان (source_id)، العنوان، الوصف، نوع الإبداع، ورابط الإبداع.

يتم أخذ معرّف النقر تلقائيًا من متغير العميل، لذلك لا تحتاج إلى تمريره إلى الدالة بشكل صريح.

يتم إضافة رقم هاتف العميل تلقائيًا إلى الحدث إذا لم يتم توفيره في data.

لا يتم استخدام معامل event_source_url لتحويلات المراسلة.

القيود

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

توفر Meta* ctwa_clid للنقرات من تطبيقي Facebook* وInstagram* على Android وiOS.

لا يتم توفير المعرّف عندما ينقر العميل من متصفح أو ينقر على منشور عادي بدلاً من زر الإعلان. لا يمكن نسب التحويلات من هذه التفاعلات إلى الإعلان.

إذا نقر العميل على إعلان آخر لاحقًا، يتم استبدال المتغيرات. يُنسب التحويل إلى أحدث إعلان جاء منه العميل.

إذا كان معرّف النقر مفقودًا من كل من معاملات الدالة ومتغيرات العميل، تُرجع الدالة الخطأ No ctwa_clid variable in client variables ولا يتم إرسال الحدث.