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

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

يتفاعل المستخدمون مع الوكلاء من خلال تطبيق مراسلة متوافق مع خدمات الاتصالات التفاعلية (RCS)، مثل رسائل Google، على أجهزتهم. في هذا الدليل السريع، ستنشئ وكيلًا أساسيًا في RCS for Business يمكنه إرسال رسالة بسيطة إلى جهاز اختبار وتلقّي رد.

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

قبل البدء في استخدام الوكيل، ستحتاج إلى ما يلي:

• اسم العلامة التجارية التي سيمثّلها الوكيل
• وكيلك
  • الاسم
  • المنطقة التي سيعمل فيها الوكيل
  • فئة الفوترة
  • حالة الاستخدام
• جهاز Android مزوّد برقم هاتف نشط
• جهاز تطوير يمكنه تشغيل نموذج الرمز البرمجي

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

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

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

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

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

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

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

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

إعداد الوكيل

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

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

يمكن أن يتوفّر وكلاء "خدمات الاتصالات التفاعلية (RCS) للرسائل التجارية" في إحدى المناطق الثلاث التالية: أمريكا الشمالية وأوروبا وآسيا والمحيط الهادئ. تتيح واجهة برمجة تطبيقات RBM ثلاث نقاط نهاية إقليمية لمساعدة الأنشطة التجارية في الامتثال للمتطلبات الإقليمية والتجارية.

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

إذا لم تكن أنت أو المستخدمون المقصودون من هذه المناطق، اختَر المنطقة الأقرب إليك لتقليل وقت الاستجابة. على سبيل المثال:

• إذا كنت مقيمًا في أمريكا اللاتينية، اختَر منطقة أمريكا الشمالية.
• إذا كنت مقيمًا في أفريقيا، اختَر منطقة أوروبا.
• إذا كنت مقيمًا في أستراليا، اختَر منطقة آسيا والمحيط الهادئ.

لا تحدّد منطقة الوكيل استنادًا إلى شركات النقل المستهدَفة. تتوفّر لجميع المناطق إمكانية الوصول إلى شركات النقل في جميع أنحاء العالم.

ملاحظة: لا يمكنك تغيير منطقة الوكيل بعد إنشائه.

تحديد فئة فوترة الوكيل

عند إنشاء وكيل "مراسلة الأنشطة التجارية في RCS"، عليك تحديد فئة الفوترة استنادًا إلى طريقة تفاعل الوكيل مع المستخدمين. اختَر الفئة التي تتطابق بشكل كبير مع السلوك المقصود للوكيل:

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

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

لا يمكنك تغيير فئة الفوترة للوكيل إلا قبل إطلاقه. أرسِل رسالة إلكترونية إلى [e-mail] إذا كنت بحاجة إلى تغيير فئة الفوترة بعد الإطلاق.

لمزيد من المعلومات حول نموذج الفوترة العادي في RCS أو نموذج الفوترة في "الرسائل من الشركات"، يُرجى الرجوع إلى الأسئلة الشائعة حول الفوترة.

تحديد حالة استخدام الوكيل

يجب أن يكون لكل وكيل في "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)" حالة استخدام محدّدة مسبقًا. يساعد ذلك في تصنيف برنامجك الآلي وتطبيق قواعد النشاط التجاري المناسبة لتقديم تجربة مستخدم جيدة. تتيح ميزة "خدمات الاتصالات التفاعلية (RCS) للمؤسسات" أربع حالات استخدام:

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

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

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

إنشاء الوكيل

اتّبِع هذه التعليمات لإنشاء وكيلك في Business Communications Developer Console.

ملاحظة: لإنشاء وكيل باستخدام RBM Management API، يُرجى الرجوع إلى مستندات إدارة الوكلاء.

لإنشاء وكيل، اتّبِع الخطوات التالية:

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

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

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

بعد إنشاء وكيل وتفعيل خدمات الاتصالات التفاعلية (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!"
  },
  "messageTrafficType": "PROMOTION"
}'

• استبدِل REGION بـ asia أو europe أو us، حسب المنطقة التي يقع فيها الوكيل.
• استبدِل PHONE_NUMBER برقم هاتف جهازك التجريبي. يجب تضمين رمز البلد ورمز المنطقة ورقم بادئ +، ولكن بدون تضمين فواصل. على سبيل المثال، [phone].
• استبدِل AGENT ID برقم تعريف الوكيل، والذي يمكن العثور عليه في صفحة معلومات الوكيل في "وحدات تحكّم المطوّرين في Business Communications".
• استبدِل PATH_TO_SERVICE_ACCOUNT_KEY بمسار المفتاح الذي أنشأته سابقًا.

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

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

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

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

بعد إعداد نموذج الوكيل، راجِع أفضل الممارسات في "مراسلة الأنشطة التجارية من خلال خدمات الاتصالات التفاعلية (RCS)"، وتعرَّف على كيفية إرسال وتلقّي الرسائل من خلال الوكلاء.