الأقلمة واللغات

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

من خلال رصد اللغة، يمكن لوكلاء Business Messages تخصيص تجاربهم لتناسب اللغة والثقافة المحلية عن طريق إتاحة التفاعل مع الوكلاء الآليين والمباشرين مع مراعاة المنطقة الجغرافية للمستخدمين وتفضيلاتهم اللغوية.

لغة المستخدم

عندما يبدأ مستخدم محادثة مع وكيل، وفي كل مرة يرسل فيها المستخدم رسالة، ترصد "الرسائل التجارية" إعدادات اللغة في جهاز المستخدم. تتضمّن كل رسالة يتلقّاها وكلاء الدعم اللغة المحلية للمستخدم في الحقل context.userInfo.userDeviceLocale.

تستخدم "رسائل الأنشطة التجارية" اللغة المحلية لجهاز المستخدم لتغيير اللغة في واجهة المستخدم وتغيير لغة السلاسل التي تنشئها المنصة.

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

يحدّد جهاز المستخدم قيمة userDeviceLocale، ويمكن أن تكون أي علامة لغة IETF BCP 47.

اللغة المحلية للوكيل والموقع الجغرافي

يمكن للوكلاء والمواقع الجغرافية تحديد إعدادات المحادثة لأي لغات محلية متاحة. على سبيل المثال، قد يحدّد الوكيل رسالة ترحيب باللغة الإنجليزية للّغة "en"، ويستخدم الرسالة نفسها باللغة الإسبانية للّغة "es"، أو قد يحدّد موقع جغرافي إعدادات للّغة "fr" بينما لا يحدّدها موقع جغرافي آخر.

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

لتعديل اللغة التلقائية لموظف دعم أو موقع جغرافي، يُرجى الاطّلاع على تعديل اللغة التلقائية. لضبط إعدادات المحادثة للغة معيّنة، راجِع بدء المحادثة.

اللغة التي تم حلّ المشكلة بها

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

تستخدم ميزة "الرسائل التجارية" اللغة المحدّدة لاختيار إعدادات المحادثة (مثل رسائل الترحيب والرسائل غير المتزامنة) والسلاسل (مثل سلسلة اقتراح طلب التحدث مع موظف دعم) التي سيتم عرضها. من أفضل الممارسات أن يتواصل وكلاء الدعم باللغة المحدّدة للحفاظ على تجربة متّسقة للمستخدم.

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

تعديل اللغة التلقائية

لتحديد لغة تلقائية، عليك إرسال طلب PATCH باستخدام Business Communications API لتعديل الحقل defaultLocale الخاص بموقع جغرافي أو وكيل.

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

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

قبل تعديل اللغة التلقائية، يجب توفُّر ما يلي:

  • مسار مفتاح حساب الخدمة لمشروعك على Google Cloud Platform (GCP) على جهاز التطوير

  • بالنسبة إلى اللغة التلقائية للوكيل، استخدِم الوكيل name (على سبيل المثال، "brands/12345/agents/67890").

    إذا كنت لا تعرف name الخاص بالوكيل، يمكنك الاطّلاع على قائمة بجميع الوكلاء التابعين لعلامة تجارية.

  • بالنسبة إلى اللغة التلقائية للموقع الجغرافي، استخدِم الموقع الجغرافي name (على سبيل المثال، "brands/12345/locations/67890").

    إذا كنت لا تعرف name الخاص بالموقع الجغرافي، يمكنك الاطّلاع على قائمة بجميع المواقع الجغرافية الخاصة بعلامة تجارية.

  • اللغة التي سيتم ضبطها كلغة تلقائية، ويجب أن تكون رمز لغة ISO 639-1 مؤلفًا من حرفَين

  • إعدادات المحادثة الخاصة باللغة والموقع الجغرافي التي تم ضبطها للوكيل أو الموقع الجغرافي اطّلِع على بدء المحادثة

إرسال طلب التعديل

لتعديل الوكيل أو الموقع الجغرافي، شغِّل الأمر التالي. استبدِل المتغيرات بالقيم التي حدّدتها في المتطلبات الأساسية.

اللغة التلقائية للوكيل 

# This code sets the default locale of a Business Messages agent.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

# Replace the __BRAND_ID__, __AGENT_ID__ and __DEFAULT_LOCALE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.defaultLocale" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "defaultLocale": "__DEFAULT_LOCALE__"
  }
}'

للاطّلاع على خيارات التنسيق والقيمة، يُرجى الرجوع إلى BusinessMessagesAgent.

اللغة التلقائية للموقع الجغرافي 

# This code updates the default locale of an agent.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.locations/patch

# Replace the __BRAND_ID__ and __LOCATION_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/locations/__LOCATION_ID__?updateMask=defaultLocale" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "defaultLocale": "en"
}'

للاطّلاع على خيارات التنسيق والقيمة، يُرجى الرجوع إلى brands.locations.