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

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

إنشاء وكيل

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إيقاف برنامج الإدارة المساعِد

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

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

  1. افتح وحدة تحكم مطوّري برامج اتصالات الأعمال.
  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. انقر على القائمة.

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

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

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

نشر نموذج Echo Bot

  1. ثبِّت واجهة سطر أوامر gcloud. وستستخدم هذا الرمز لنشر نموذج للرمز إلى 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

    لغة 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. في الوحدة الطرفية، انتقِل إلى الدليل الكامل للعينة.

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

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

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

    لغة Java

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

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

    لغة Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

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

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

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

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

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

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

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

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

بدء المحادثة

للتفاعل مع برنامج تتبُّع الصدى، اتبع الخطوات التالية:

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

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

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

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

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

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

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