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

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

• إذا سبق لك التسجيل للحصول على حساب شريك قبل 7 آذار (مارس) 2022، عليك تفعيل واجهة برمجة تطبيقات "الرسائل التجارية". يُرجى الاطِّلاع على تفعيل واجهة برمجة التطبيقات Business Communications API وواجهة برمجة التطبيقات لميزة "الرسائل التجارية".

إنشاء وكيلك

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

في هذه البداية السريعة، ستقوم بما يلي:

• التسجيل كشريك
• إنشاء علامة تجارية ووكيل
• يمكنك اختياريًا استكشاف الميزات في محادثة باستخدام ميزة "الرسائل التجارية". البرنامج المساعِد
• إعداد وكيلك لإرسال الرسائل واستلامها

ولإنشاء وكيل بدون استخدام النموذج، يمكنك الاطّلاع على إنشاء وكيل.

التسجيل كشريك

1. افتح وحدة تحكّم المطوّرين في Business Communications:
2. ضمن الرسائل التجارية، انقر على إنشاء حساب شريك.

3. يُرجى إدخال معلومات الشريك:

   الحقل	القيمة
   اسمك	اسمك بالكامل
   اسم الشريك	اسم مؤسستك
   الموقع الإلكتروني للشريك	الموقع الإلكتروني لمؤسستك
   المنطقة	المنطقة التي تريد استضافة خدمة "الرسائل التجارية" فيها

4. مراجعة وقبول بنود خدمة ميزة "الرسائل التجارية"

5. انقر على إنشاء.

تم تسجيلك الآن كشريك في ميزة "الرسائل التجارية". تم إنشاء مشروع جديد لك على Google Cloud مع تفعيل واجهتَي برمجة التطبيقات "الرسائل التجارية" و"مراسلات Business Communications API". ليس لديك إذن بالوصول إلى هذا المشروع ولن يتداخل مع أي من مشاريعك الحالية على Google Cloud.

يمكنك الآن الوصول إلى واجهات برمجة تطبيقات "الرسائل التجارية" و"اتصالات الأنشطة التجارية".

إنشاء حساب خدمة

1. في الصفحة الرئيسية لوحدة تحكُّم المطوّرين في Business Communications، انقر على إعدادات حساب الشريك.
2. في شريط التنقل الأيمن، انقر على حساب الخدمة:

3. انقر على إنشاء مفتاح، ثم انقر على إنشاء.

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

إنشاء علامة تجارية ووكيل

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

1. افتح مطوّر اتصالات Business وحدة التحكّم وسجِّل الدخول باستخدام حسابك على Google في ميزة "الرسائل التجارية"
2. انقر على إنشاء وكيل.
3. بالنسبة إلى نوع الوكيل، اختَر الرسائل التجارية.
4. أدخِل قيمتَين لكلّ من اسم العلامة التجارية واسم الوكيل.
5. نفِّذ أيًّا ممّا يلي:
   • لإجراء محادثة مع موظف الدعم، يمكنك التعرّف على المتاحة، اختَر تفعيل برنامج تتبُّع "الرسائل التجارية" المساعد.
   • لتخصيص معلومات الوكيل وإعداده للتعامل مع الرسائل، يجب إلغاء اختيار تفعيل برنامج التتبُّع المساعِد لميزة "الرسائل التجارية"
6. انقر على إنشاء وكيل.

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

استكشاف الميزات باستخدام برنامج التتبُّع المساعِد لميزة "الرسائل التجارية"

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

يتيح لك هذا البرنامج

• استكشاف الميزات المنسّقة
• الاطّلاع على طريقة تطبيق الميزات
• العثور على مراجع لإعداد الوكيل

عند تفعيل "برنامج التتبُّع المساعِد"، يرسِل الرسائل ويتلقّىها نيابةً عن الوكيل. لا يلزم الرد التلقائي على الويب. عليك إيقاف برنامج التتبُّع المساعِد. قبل أن تتمكّن من ضبط ردّ تلقائي على الويب أو تفعيل Dialogflow التعامل مع رسائل المستخدمين

بدء محادثة مع "برنامج التتبُّع المساعِد"

بعد تفعيل "برنامج إدارة الرسائل التجارية المساعِد"، يمكنك بدء محادثة. يفتح مربّع حوار فورًا بعد إنشاء الوكيل لمساعدتك في البدء.

للتفاعل مع برنامج التتبُّع المساعِد، اتّبِع الخطوات التالية من مربّع الحوار هذا:

1. الوصول إلى عناوين URL التجريبية للوكيل تتوفر بضعة طرق لتنفيذ ذلك:

   • انقر على الزر Android أو الزر iOS. ثم امسح رمز الاستجابة السريعة ضوئيًا على الجهاز الجوّال المطابق والنقر على إطلاق. يمكنك بدلاً من ذلك النقر على نسخ عنوان URL لنظام التشغيل Android أو نسخ عنوان URL لنظام التشغيل iOS لنسخه. عنوان URL التجريبي للوكيل.
   • انقر على إرسال لإرسال عناوين URL إلى عنوان بريدك الإلكتروني.

2. افتح عنوان URL على جهازك الجوّال. (تتطلب أجهزة iOS خرائط Google app.)

إيقاف "برنامج التتبُّع المساعِد"

قبل أن تتمكّن من تخصيص وكيلك وإعداده للإطلاق، عليك إجراء ما يلي: إيقاف برنامج التتبُّع المساعِد لميزة "الرسائل التجارية"

لإيقاف "برنامج التتبُّع المساعِد"،

1. افتح مطوّر اتصالات Business Console.
2. اختَر وكيلك.
3. في شريط التنقّل الأيمن، انقر على عمليات الدمج.
4. بالنسبة إلى برنامج التتبُّع المساعِد، انقر على إيقاف.

عندما يتم إيقاف "برنامج التتبُّع المساعِد"، يتوقّف عن إرسال رسائل إلى وكيلك. يمكنك الآن إعداد وكيلك للتعامل مع إرسال الرسائل.

إعداد الوكيل للتعامل مع الرسائل

في هذا الدليل، ستعمل على نشر برنامج Echo Bot في Google Cloud Platform (GCP) مع الرد التلقائي على الويب لمعالجة رسائل المستخدمين.

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

عليك إكمال الخطوات التالية:

• نشر نموذج Echo Bot في Google Cloud Platform
• ضبط عنوان URL للردّ التلقائي على الويب لحساب الشريك في ميزة "الرسائل التجارية"
• تقديم معلومات أساسية عن وكيلك

في نهاية هذا الدليل، سيكون وكيلك جاهزًا لإرسال الرسائل واستلامها.

نشر تطبيق الويب على Google Cloud Platform

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

إنشاء بيئة سحابة إلكترونية

أنت بحاجة إلى بيئة سحابة إلكترونية لنشر عيّنة من برنامج Echo Bot.

لإنشاء مشروع Google Cloud Platform كبيئة سحابة إلكترونية، اتبع الخطوات التالية:

1. افتح أداة اختيار المشاريع على Google Cloud Console

   في حال لم يسبق لك إنشاء مشروع على Google Cloud، عليك قبول البنود والخدمات.

2. انقر على إنشاء مشروع.

3. إدخال اسم لمشروعك الجديد وموقعه الجغرافي

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

4. انقر على إنشاء.

5. انقر على menuالقائمة.

6. انقر على الفوترة.

7. انقر على ربط حساب فوترة.

8. إنشاء حساب فوترة جديد أو إضافة حساب فوترة حالي إلى المشروع يمكنك الاطّلاع على ميزات برنامج Google Cloud المجاني لفهم خيارات الدفع.

نشر نموذج Echo Bot

1. ثبِّت gcloud CLI. ستستخدم هذا الرمز لنشر الرمز النموذجي في Google Cloud.

2. تنزيل عينة Echo Bot واستخراجها (Node.js، Java Python).

3. انسخ ملف بيانات اعتماد JSON الذي نزّلته. إنشاء حساب خدمة في مجلد موارد النموذج وأعِد تسمية بيانات الاعتماد إلى "bm-agent-service-account-credits.json". يعتمد المسار إلى ملف بيانات الاعتماد هذا على النموذج الذي نزّلته.

   Node.js

   ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

   Java

   ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

   Python

   ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

4. في الوحدة الطرفية، انتقِل إلى الدليل Full_ sample الخاص بالنموذج.

5. شغِّل الأوامر التالية في الوحدة الطرفية لنشر النموذج:

   Node.js

   gcloud config set project PROJECT_ID
   gcloud app create
   gcloud app deploy

   PROJECT_ID هو رقم تعريف المشروع الذي أنشأته في إنشاء بيئة Cloud يتم إدراج رقم تعريف المشروع في لوحة بيانات المشروع في Google Cloud.

   Java

   gcloud config set project PROJECT_ID
   gcloud app create
   mvn appengine:deploy

   PROJECT_ID هو رقم تعريف المشروع الذي أنشأته في إنشاء بيئة Cloud يتم إدراج رقم تعريف المشروع في لوحة بيانات المشروع في Google Cloud.

   Python

   gcloud config set project PROJECT_ID
   gcloud app create
   gcloud app deploy

   PROJECT_ID هو رقم تعريف المشروع الذي أنشأته في إنشاء بيئة Cloud يتم إدراج رقم تعريف المشروع في لوحة بيانات المشروع في Google Cloud.

6. دوِّن عنوان URL للتطبيق المنشور في مخرجات الأمر الأخير. هذه هي قاعدة عنوان URL للردّ التلقائي على الويب:

   Deployed service [default] to [https://PROJECT_ID.appspot.com]

ضبط الرد التلقائي على الويب

والآن بعد أن تم نشر Echo Bot، تحتاج إلى تحديد عنوان URL للرد التلقائي على الويب (الذي تشغيل) لبدء واستلام الرسائل.

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

4. بالنسبة إلى عنوان URL لنقطة نهاية الرد التلقائي على الويب، أدخِل عنوان URL للتطبيق + " /callback".

   ستتّبع نقطة النهاية التنسيق التالي: "https://PROJECT_ID.appspot.com/callback".

   تكون نقطة النهاية هذه محددة مسبقًا في منطق التطبيق للعينة التي إلى Google Cloud Platform.

5. في Play Console، انقر على إثبات الملكية.

   عندما تتحقّق ميزة "الرسائل التجارية" من ردّك التلقائي على الويب، يتم إغلاق مربّع الحوار.

لضبط الردّ التلقائي على الويب باستخدام Business Communications API، اطّلِع على مثال: تعديل عنوان URL للردّ التلقائي على الويب

يمكنك استخدام إطار عمل اختبار ميزة "الرسائل التجارية" لاختبار ما إذا كان ردّك التلقائي على الويب يتجاوب بنجاح مع حمولات بيانات "الرسائل التجارية"

إدخال معلومات الوكيل

قدِّم بعض المعلومات الأساسية لإكمال إعداد الوكيل.

1. افتح مطوّر اتصالات Business Console.
2. في شريط التنقّل الأيمن، انقر على معلومات الوكيل.

3. عدِّل القيم كما تريد أو استخدِم الاقتراحات التالية:

   الحقل	القيمة
   رسالة ترحيب	مرحبًا بك في محادثة Echo Bot
   سياسة الخصوصية	https://policies.google.com/privacy

4. انقر على حفظ.

بدء المحادثة

للتفاعل مع Echo Bot، اتبع الخطوات التالية:

1. افتح مطوّر اتصالات Business Console.
2. في شريط التنقّل الأيمن، انقر على معلومات الوكيل.
3. ضمن عناوين URL التجريبية للوكيل، انقر على الزرّ Android أو الزر iOS.

4. امسح رمز الاستجابة السريعة ضوئيًا باستخدام الجهاز الجوّال المعني، أو انقر على نسخ. عنوان URL لنظام التشغيل Android أو نسخ عنوان URL لنظام التشغيل iOS لنسخ عنوان URL التجريبي للوكيل

   ويمكنك أيضًا النقر على إرسال لإرسال عناوين URL إلى عنوان بريدك الإلكتروني.

5. افتح عنوان URL على جهازك الجوّال. (تتطلب أجهزة iOS خرائط Google).

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

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

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

• اطّلِع على مزيد من المعلومات عن آلية عمل ميزة "الرسائل التجارية".

• راجِع المتطلبات والإرشادات المتعلقة بميزة "الرسائل التجارية".

• عدِّل Echo Bot وردّ بمنطق نشاطك التجاري من خلال مراجعة كيفية استلام الرسائل.

• تحقّق من البنية الأساسية.

• توفير المزيد من الوكلاء والمواقع الجغرافية