يتواصل المستخدمون من مواقع جغرافية متعددة وبلغات متعددة. يمكن للوكلاء الذين يتجاوبون مع الإعدادات المفضّلة للتواصل مع المستخدمين ويترجمون تجاربهم الوصول إلى المزيد من المستخدمين، وتوفير تجارب مستخدمين أكثر إرضاءً، وزيادة التفاعلات التكميلية مقارنةً بالوكلاء الذين لا يستجيبون لذلك. وتتيح ميزة "الرسائل التجارية" للوكلاء والمواقع أن تكون متجاوبة مع الإعدادات المفضّلة للمستخدمين من خلال تمرير إعدادات لغة المستخدم إلى الوكلاء، ما يتيح للوكلاء تحديد لغة تلقائية وإعدادات محادثات فريدة لكل لغة، وحلّ حالات المطابقة بين لغات المستخدمين واللغات المحلية أو الوكلاء المتوافقين مع ذلك.
من خلال رصد اللغة، يمكن لموظّفي "الرسائل التجارية" ترجمة تجاربهم من خلال التفاعلات المبرمَجة والمباشرة مع موظّفي الدعم الذين يفضّلون منطقة المستخدمين وإعدادات اللغة المفضّلة لديهم.
لغة المستخدم
عندما يبدأ مستخدم محادثة مع وكيل، وفي كل مرة يرسل فيها مستخدم رسالة، يرصد تطبيق "الرسائل التجارية" إعدادات اللغة على جهاز المستخدم. ويتضمّن كل
وكلاء يتلقّون الرسائل لغة المستخدم في الحقل
context.userInfo.userDeviceLocale.
تستخدم ميزة "الرسائل التجارية" لغة جهاز المستخدم لتغيير اللغة في واجهة المستخدم وتغيير لغة السلاسل التي يتم إنشاؤها من خلال النظام الأساسي.
يمكن تغيير userDeviceLocale ضمن محادثة إذا غيّر المستخدم لغة الجهاز أو يبدّل بين الأجهزة التي تحتوي على إعدادات لغة مختلفة. وإذا قرأت الوكلاء userDeviceLocale، يجب التحقّق مما إذا كانت القيمة قد تغيّرت مع كل رسالة جديدة وتعديلها وفقًا لذلك. على سبيل المثال، قد يرصد وكيل تغييرًا للغة ويسأل المستخدم ما إذا كان سيفضّل مواصلة التواصل باللغة الحالية أو التبديل إلى لغة تتطابق مع اللغة الجديدة.
يتم تحديد userDeviceLocale من خلال جهاز المستخدم، ويمكن أن يكون أي علامة لغة IETF BCP
47.
الوكيل والموقع الجغرافي
يمكن للوكلاء والمواقع الجغرافية تحديد إعدادات المحادثات لأي لغة تتوافق معها. على سبيل المثال، قد يحدد وكيل رسالة ترحيب باللغة الإنجليزية للغة "en" وينشر الرسالة نفسها باللغة الإسبانية باللغة "es"، أو قد يحدّد موقع واحد إعدادات اللغة "fr" بينما لا يحدد موقع آخر.
في حال ضبط أي موقع جغرافي أو وكيل على أي لغة محادثة،
يفترض تطبيق "الرسائل التجارية" أنّ الوكيل أو الموقع الجغرافي يتيحان ذلك تلك اللغة.
يمكن للوكلاء والمواقع ضبط لغة تلقائية (defaultLocale) يتواصلون فيها عادةً.
لتعديل اللغة التلقائية للوكيل أو الموقع الجغرافي، يُرجى الاطّلاع على القسم تعديل اللغة التلقائية. لضبط إعدادات المحادثة للغة، يُرجى الاطّلاع على القسم بدء المحادثة.
لغة تم حلّها
من خلال تحديد لغة جهاز المستخدم ومقارنة اللغة مع اللغات المحدّدة للوكيل أو الموقع الجغرافي الذي سيرسله المستخدم، يمكن لميزة "الرسائل التجارية" حلّ مشكلة المطابقة بين لغة المستخدم وشبكة الوكيل. تحظى وكيل defaultLocale أو الموقع الجغرافي بالأولوية على اللغات المتاحة الأخرى عندما يحلّ تطبيق "الرسائل التجارية" المطابقة. ويتضمّن كل وكلاء استلام الرسائل هذه
المطابقة في الحقل
context.resolvedLocale.
تستخدم ميزة "الرسائل التجارية" اللغة التي تم حلّها لاختيار إعدادات المحادثات (مثل رسائل الترحيب والرسائل بلا اتصال بالإنترنت) وسلاسل البيانات (مثل سلسلة اقتراح موظّف الدعم المباشر) التي سيتم عرضها. ومن بين أفضل الممارسات التي يحتاج إليها الوكلاء التواصل في اللغة التي تم حلّها للحفاظ على تجربة متّسقة للمستخدم.
يمكن أن تتغير اللغة التي تم حلها ضمن المحادثة إذا غيّر المستخدم لغة الجهاز أو يبدّل بين الأجهزة التي تحتوي على إعدادات لغة مختلفة. على الوكلاء التحقّق مما إذا كانت القيمة قد تغيّرت مع كل رسالة جديدة وتعديلها وفقًا لذلك. على سبيل المثال، قد يرصد وكيل تغييرًا للغة ويسأل المستخدم ما إذا كان سيفضّل مواصلة التواصل باللغة الحالية أو التبديل إلى لغة تتطابق مع اللغة الجديدة.
تعديل اللغة التلقائية
لتحديد لغة تلقائية، يمكنك تقديم طلب تصحيح باستخدام واجهة برمجة تطبيقات اتصالات الأنشطة التجارية
لتعديل حقل defaultLocale الخاص بالوكيل أو الموقع الجغرافي.
لتعديل إعدادات المحادثة للوكيل أو الموقع الجغرافي للغة معيّنة، مثل رسالة الترحيب وأدوات بدء المحادثة، يُرجى الاطّلاع على بدء المحادثة.
المتطلبات الأساسية
قبل تعديل اللغة التلقائية، ستحتاج إلى العناصر التالية:
- المسار إلى مفتاح حساب خدمة مشروع Google Cloud Platform على جهاز التطوير
بالنسبة إلى اللغة التلقائية للوكيل،
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.