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

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

إنشاء الوكيل

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

في هذا الدليل السريع، ستنفّذ ما يلي:

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

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

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

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

  3. أدخِل معلومات الشريك:

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

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

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

أنت مسجَّل الآن كشريك في "الرسائل التجارية". تم إنشاء مشروع جديد لك على Google Cloud مع تفعيل واجهتَي Business Messages وBusiness Communications API. ليس لديك إذن الوصول إلى هذا المشروع، ولن يتعارض مع أي من مشاريعك الحالية على Google Cloud.

يمكنك الآن الوصول إلى واجهات برمجة التطبيقات Business Messages وBusiness Communications.

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

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

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

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

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

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

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

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

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

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

يتيح لك "البرنامج المساعِد" إجراء ما يلي:

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

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

بدء محادثة مع البرنامج المساعِد

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

للتفاعل مع Helper Bot، اتّبِع الخطوات التالية من هذا المربع الحواري:

  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 على GCP
  • ضبط عنوان URL الخاص بخدمة الويب هوك لحساب الشريك في Business Messages
  • تقديم المعلومات الأساسية عن الوكيل

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

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

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

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

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

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

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

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

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

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

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

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

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

  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-credentials.json". يعتمد مسار ملف بيانات الاعتماد هذا على النموذج الذي نزّلته.

    Node.js

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

    جافا

    ./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.

    جافا

    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 للتطبيق الذي تم نشره في ناتج الأمر الأخير. هذا هو أساس رابط ويب هوك الخاص بك:

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

ضبط الويب هوك

بعد نشر Echo Bot، عليك تحديد عنوان URL لـ Webhook (الذي تديره) لبدء تلقّي الرسائل.

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

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

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

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

  5. في Developer 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. تعرض هذه الميزة الرسائل التي ترسلها إليك. بالإضافة إلى ذلك، يمكنك طلب الميزات الغنية بصريًا من خلال إرسال سلاسل محددة: "لوحة عرض دوّارة" أو "بطاقة" أو "شرائح".

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

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