إنشاء وكيلك الأول

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

مسار رسالة خلال محادثة مفعَّل فيها "الاستجابة الذكية للرسائل"

المتطلبات الأساسية

قبل البدء في استخدام موظّف الدعم، ستحتاج إلى العناصر التالية:

إعداد جهاز الاختبار

للتواصل مع موظّف دعم لم يطلق ميزة "الرسائل التجارية"، يجب أن يكون الجهاز الاختباري مفعَّلاً عليه خدمة RCS، ولكن لا يمكن لجميع أجهزة Android تلقّي رسائل RCS تلقائيًا. يمكنك التحقّق من حالة RCS على جهازك، وتفعيل RCS عند الضرورة، وذلك من خلال ضبط إعدادات جهازك باستخدام إصدارات تجريبية من تطبيقَي "الرسائل" و"خدمات مشغِّل شبكة الجوّال".

التحقّق من حالة RCS على جهازك

  1. في تطبيق "الرسائل"، انقر على الزر ، ثم انقر على الإعدادات.

  2. انقر على ميزات الدردشة، وابحث عن قيمة الحالة.

    إذا كانت الحالة متصل، يعني ذلك أنّ خدمة RCS مفعَّلة على جهازك.

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

إذا كانت خدمة RCS مفعّلة على جهازك، يعني ذلك أنّك جاهز لإعداد موظّف الدعم. إذا كانت خدمة RCS غير مفعّلة على جهازك، عليك تفعيل خدمة RCS على جهازك قبل أن تتمكّن من اختبار وكيل RBM.

إعداد وكيلك

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

تحديد منطقة موظّف الدعم

تتيح واجهة برمجة التطبيقات RBM API ثلاث نقاط نهاية إقليمية لمساعدة الأنشطة التجارية في الامتثال للمتطلبات الإقليمية وتلك المتعلقة بالنشاط التجاري. يمكن أن يكون وكلاء RBM في إحدى المناطق الثلاث التالية:

  • أمريكا الشمالية
  • أوروبا
  • آسيا والمحيط الهادي

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

تحديد فئة فوترة موظّف الدّعم

إنّ مشغّلي شبكات الجوّال الذين يوافقون على عرض محتوى RBM على شبكاتهم يحصّلون أيضًا رسومًا مقابل إرسال رسائل RBM إلى المشتركين باستخدام إطار عمل الفوترة هذا:

  • محادثة: رسوم مقابل محادثة تتألف من عدة رسائل A2P وP2A خلال فترة زمنية معيّنة.
  • رسالة واحدة: رسوم مقابل رسالة واحدة تحتوي على محتوى مرئي غني (مثل رسالة تحتوي على بطاقة غنية أو لوحة عرض دوّارة).
  • الرسالة الأساسية: يتم تحصيل رسوم مقابل رسالة نصية عادية تضم ما يصل إلى 160 حرفًا.

عند إنشاء موظّف الدعم، اختَر فئة الفوترة التي تشبه سلوك منطق موظّف الدعم:

  • محادثة: يشارك هذا موظّف الدعم في تفاعلات معقدة مع المستخدمين يتم فيها مبادلة الرسائل في كلا الاتجاهين.

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

  • رسالة واحدة: يرسل موظّف الدعم هذا عادةً رسائل غنية بالمحتوى ونادراً ما يتوقّع تلقّي ردود.
  • الرسالة الأساسية: ينفّذ هذا الوكيل عملية ترقية الرسائل القصيرة إلى ميزة "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)"، ولا يتوقع تلقي ردود في أغلب الأحيان. بشكل عام، من المتوقّع أن يرسل موظّف الدعم رسائل نصية عادية يصل عدد أحرفها إلى 160 حرفًا. ولكن لا يتم فرض قيود على موظّف الدعم، إذ يمكنه إرسال محتوى أكثر تفصيلاً إذا تمّت برمجته لذلك، وسيتمّ تحصيل الرسوم منه وفقًا لذلك.

يمكنك تغيير فئة الفوترة لوكيلك قبل إطلاقه. يُرجى التواصل معنا لمناقشة التغيير إلى فئة فوترة مختلفة.

تحديد حالة استخدام موظّف الدعم

على كل موظّف دعم مبيعات تفاعلية أن يكون لديه حالة استخدام محدّدة مسبقًا تعكس طبيعة المحادثات التي يُراد إجراؤها مع المستخدمين النهائيين ومساعدة الأنشطة التجارية في الالتزام بقواعد النشاط التجاري. تتيح ميزة RBM أربع حالات استخدام:

  • OTP: هي كلمات المرور المطلوبة للمصادقة على حساب بشكل آمن أو confirm a transaction (تأكيد معاملة).
  • الرسائل المتعلّقة بالمعاملات: الإشعارات أو التعديلات أو التنبيهات لمشاركة معلومات مرتبطة مباشرةً بالخدمات أو المنتجات الحالية للعميل، مثل التنبيهات بشأن الأنشطة المريبة في الحساب وتأكيدات الشراء وإشعارات الشحن
  • الرسائل الترويجية: رسائل المبيعات والتسويق والرسائل الترويجية المرسَلة إلى العملاء الجُدد أو الحاليين بهدف زيادة الوعي والتفاعل والمبيعات
  • الاستخدام المتعدّد: مسارات المحادثات التي تجمع بين حالات الاستخدام المتعلقة بالمعاملات والحملات الترويجية، مثل إرسال إشعار بشأن الحساب ثم منح خصم أو ترقية لمنتج وخدمة جديدَين

اطّلِع على مقالة اختيار حالة الاستخدام المناسبة للحصول على وصف أكثر تفصيلاً لحالات الاستخدام ومعرفة متى يجب استخدام كل حالة.

لا يمكنك تغيير حالة الاستخدام بعد إرسال وكيلك لبدء المراجعة. احرص على مراجعة حالات الاستخدام وقواعد النشاط التجاري لبلدك قبل إرسال وكيلك.

إنشاء الوكيل

اتّبِع هذه التعليمات لإنشاء موظّف الدعم في "مراسلات الأنشطة التجارية" Developer Console.

  1. افتح Business Communications Developer Console وسجِّل الدخول باستخدام حسابك على Google الخاص بشريكك في برنامج "الإعلانات على شبكة البحث".
  2. انقر على إنشاء وكيل.
  3. بالنسبة إلى نوع موظّف الدعم، اختَر مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS).
  4. بالنسبة إلى العلامة التجارية، اختَر العلامة التجارية التي سيمثّلها موظّفك، أو انقر على إضافة علامة تجارية جديدة وأدخِل اسمها.
  5. أدخِل اسم موظّف الدعم واختَر منطقة موظّف الدعم وفئته للفوترة وحالة الاستخدام. بعد ذلك، انقر على إنشاء وكيل.
  6. عندما يصبح موظّف الدعم متاحًا، انقر على اسمه.

بعد توفّر موظّف الدعم، يمكنك إضافة معلومات النشاط التجاري والعلامة التجارية. اطّلِع على العوامل.

دعوة جهاز الاختبار

بعد أن أصبح لديك وكيل وأصبح جهازك التجريبي مزوّدًا بخدمة RCS، يمكنك دعوة جهازك لاختبار الوكيل.

  1. في شريط التنقّل الأيمن، انقر على الأجهزة.
  2. بالنسبة إلى إضافة أجهزة اختبارية، أدخِل رقم هاتف جهازك وانقر على إضافة.
  3. على جهاز الاختبار، اقبل طلب المختبِر الخاص بالوكيل.

إذا لم تصلك دعوة على جهازك التجريبي، تأكَّد من تفعيل خدمات الاتصالات التفاعلية (RCS) على جهازك.

إرسال رسالة

باستخدام جهاز اختبار مسجّل، يمكن لوكيلك الآن إرسال الرسائل.

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

في وحدة طرفية على جهاز التطوير، شغِّل الأمر التالي:

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'contentMessage': {
    'text': 'Hello, world!'
  }
}"
  • استبدِل REGION بـ asia أو europe أو us، استنادًا إلى منطقة موظّف الدعم.
  • استبدِل PHONE_NUMBER برقم هاتف الجهاز التجريبي. أدرِج رمز البلد ورمز المنطقة وعلامة + في بداية الرقم، ولكن لا تُدرِج فواصل. على سبيل المثال، +14155555555.
  • استبدِل AGENT ID برقم تعريف موظّف الدعم، والذي يمكن العثور عليه في صفحة معلومات موظّف الدعم في وحدات تحكّم المطوّرين في Business Communications.
  • استبدِل PATH_TO_SERVICE_ACCOUNT_KEY بالمسار إلى المفتاح الذي أنشأته سابقًا.

من المفترض أن تتلقّى رسالة "مرحبًا بالجميع" من موظّف الدعم على جهاز الاختبار. إذا لم تتلقَّ رسالة على جهاز الاختبار، تأكَّد من إدخال رقم الهاتف ومسار مفتاح حساب الخدمة بالتنسيق الصحيح في الأمر.

لإرسال أنواع مختلفة من الرسائل، مثل الردود المقترَحة والبطاقات التفاعلية، اطّلِع على إرسال الرسائل.

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

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

بعد إعداد نموذج موظّف الدعم، راجِع أفضل الممارسات المتعلّقة بميزة "إدارة الطلبات" وتعرَّف على كيفية إرسال وتلقّي الرسائل من موظّفي الدعم.

السابق
إعداد حساب الشريك