محلی سازی و محلی سازی

کاربران از مکان های مختلف و به زبان های زیادی ارتباط برقرار می کنند. عواملی که به اولویت‌های ارتباطی کاربران پاسخ می‌دهند و تجربیاتشان را بومی‌سازی می‌کنند، به کاربران بیشتری دسترسی پیدا می‌کنند، تجربیات کاربر رضایت‌بخش‌تری ایجاد می‌کنند و تعاملات تکراری بیشتری نسبت به عواملی که پاسخگو نیستند، ایجاد می‌کنند. «پیام‌های تجاری» به نمایندگان و مکان‌ها این امکان را می‌دهد تا با انتقال تنظیمات محلی کاربر به نمایندگان، به نمایندگان امکان تعیین یک منطقه پیش‌فرض و تنظیمات مکالمه منحصربه‌فرد در هر منطقه، و حل موارد منطبق بین مناطق کاربر و محلی‌های پشتیبانی شده یک نماینده یا مکان، به تنظیمات برگزیده کاربران پاسخ دهند.

با شناسایی منطقه، نمایندگان Business Messages می‌توانند تجربیات خود را بومی‌سازی کنند و تعاملات مستقیم و خودکار عامل را از اولویت‌های منطقه و زبان کاربران آگاه کنند.

محل کاربر

هنگامی که کاربر مکالمه ای را با یک نماینده شروع می کند و هر بار که کاربر پیامی ارسال می کند، Business Messages تنظیمات محلی دستگاه کاربر را شناسایی می کند. هر پیامی که نمایندگان دریافت می‌کنند شامل محل کاربر در قسمت context.userInfo.userDeviceLocale است.

Business Messages از محلی دستگاه کاربر برای تغییر زبان در رابط کاربری و تغییر زبان رشته های تولید شده توسط پلت فرم استفاده می کند.

اگر کاربر زبان دستگاه را تغییر دهد یا بین دستگاه‌هایی که تنظیمات محلی متفاوتی دارند جابجا شود، userDeviceLocale می‌تواند در یک مکالمه تغییر کند. اگر عامل ها userDeviceLocale می خوانند، باید بررسی کنند که آیا مقدار با هر پیام جدید تغییر کرده است یا خیر و اگر تغییر کرده است، مطابق با آن سازگار شوند. به عنوان مثال، یک عامل ممکن است یک تغییر محلی را تشخیص دهد و از کاربر بپرسد که آیا ترجیح می‌دهد به زبان فعلی به برقراری ارتباط ادامه دهد یا به زبانی که با منطقه جدید مطابقت دارد سوئیچ کند.

userDeviceLocale توسط دستگاه کاربر مشخص می شود و می تواند هر برچسب زبان IETF BCP 47 باشد.

محل نمایندگی و مکان

نمایندگان و مکان‌ها می‌توانند تنظیمات مکالمه را برای هر محلی که پشتیبانی می‌کنند مشخص کنند. به عنوان مثال، یک نماینده ممکن است یک پیام خوشامدگویی را به زبان انگلیسی برای منطقه "en" مشخص کند و همان پیام را به زبان اسپانیایی برای منطقه "es" داشته باشد، یا یک مکان ممکن است تنظیمات محلی "fr" را مشخص کند در حالی که مکان دیگری این کار را انجام نمی دهد. .

اگر یک نماینده یا مکان دارای تنظیمات مکالمه ای برای یک منطقه باشد، Business Messages فرض می کند که نماینده یا مکان از آن منطقه پشتیبانی می کند. عوامل و مکان‌ها می‌توانند یک محلی پیش‌فرض ( defaultLocale ) که معمولاً در آن ارتباط برقرار می‌کنند، تنظیم کنند.

برای به‌روزرسانی محلی پیش‌فرض یک نماینده یا مکان، به به‌روزرسانی منطقه پیش‌فرض مراجعه کنید. برای تنظیم تنظیمات مکالمه برای یک منطقه، به شروع مکالمه مراجعه کنید.

منطقه حل شد

پیام‌های تجاری می‌توانند تطابق بین زبان‌های کاربر و نماینده را با شناسایی محلی دستگاه کاربر و مقایسه آن با مناطق تعیین‌شده برای نماینده یا مکانی که کاربر پیام می‌دهد، حل کند. هنگامی که Business Messages یک تطابق را حل می‌کند، defaultLocale یک نماینده یا مکان بر دیگر زبان‌های پشتیبانی‌شده اولویت دارد. هر پیامی که نمایندگان دریافت می کنند شامل این تطابق در قسمت context.resolvedLocale است.

Business Messages از محلی حل‌شده برای انتخاب تنظیمات مکالمه (مانند پیام‌های خوش‌آمدگویی و پیام‌های آفلاین) و رشته‌ها (مانند رشته پیشنهاد درخواست نماینده زنده ) برای نمایش استفاده می‌کند. این بهترین روش برای نمایندگان است که در محلی حل شده برای حفظ یک تجربه کاربری سازگار با یکدیگر ارتباط برقرار کنند.

اگر کاربر زبان دستگاه را تغییر دهد یا بین دستگاه‌هایی که تنظیمات محلی متفاوتی دارند جابجا شود، محلی حل‌شده می‌تواند در یک مکالمه تغییر کند. نمایندگان باید بررسی کنند که آیا مقدار با هر پیام جدید تغییر کرده است یا خیر و اگر تغییر کرده است مطابق با آن تطبیق دهند. به عنوان مثال، یک عامل ممکن است یک تغییر محلی را تشخیص دهد و از کاربر بپرسد که آیا ترجیح می‌دهد به زبان فعلی به برقراری ارتباط ادامه دهد یا به زبانی که با منطقه جدید مطابقت دارد سوئیچ کند.

محلی پیش فرض را به روز کنید

برای تعیین یک منطقه پیش‌فرض، یک درخواست PATCH با Business Communications API برای به‌روزرسانی فیلد defaultLocale یک نماینده یا مکان ارائه می‌کنید.

برای به‌روزرسانی تنظیمات مکالمه نماینده یا مکان برای یک منطقه (مانند پیام خوش‌آمدگویی و آغازگر مکالمه) به شروع مکالمه مراجعه کنید.

پیش نیازها

قبل از به‌روزرسانی محلی پیش‌فرض، به موارد زیر نیاز دارید:

  • مسیر کلید حساب سرویس پروژه 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__"
  }
}'
update-agent-bm-defaultLocale.sh

برای گزینه‌های قالب‌بندی و مقدار، 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"
}'
update-location-bm-defaultLocale.sh

برای گزینه‌های قالب‌بندی و ارزش، به brands.locations مراجعه کنید.