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

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

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

زبان کاربر

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

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

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

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

محل نماینده و موقعیت مکانی

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

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

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

زبان محلی حل شده

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

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

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

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

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

برای به‌روزرسانی تنظیمات مکالمه یک عامل یا مکان برای یک زبان - مانند پیام خوش‌آمدگویی و شروع‌کننده‌های مکالمه - به «شروع مکالمه» مراجعه کنید.

پیش‌نیازها

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

درخواست به‌روزرسانی را ارسال کنید

برای به‌روزرسانی عامل یا مکان، دستور زیر را اجرا کنید. متغیرها را با مقادیری که در پیش‌نیازها شناسایی کرده‌اید، جایگزین کنید.

زبان پیش‌فرض عامل 

# 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 مراجعه کنید.