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

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

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

إنشاء وكيلك

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. يمكنك الوصول إلى عناوين URL التجريبية للوكيل من خلال اتّباع عدة طرق:

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

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

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

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

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

1. افتح وحدة تحكُّم مطوّري مراسلات Business Communications.
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. افتح إعدادات الحساب في وحدة تحكّم المطوّرين في Business Communications.
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 Communications.
2. في شريط التنقّل الأيمن، انقر على معلومات الوكيل.

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

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

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

بدء المحادثة

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

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

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

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

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

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

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

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

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

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

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

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

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