স্থানীয়করণ এবং স্থানীয়করণ

ব্যবহারকারীরা বিভিন্ন স্থান থেকে এবং বিভিন্ন ভাষায় যোগাযোগ করেন। যে এজেন্টরা ব্যবহারকারীদের যোগাযোগের পছন্দের প্রতি সংবেদনশীল এবং তাদের অভিজ্ঞতাকে স্থানীয়করণ করে, তারা সেইসব এজেন্টের তুলনায় বেশি ব্যবহারকারীর কাছে পৌঁছায়, আরও সন্তোষজনক ব্যবহারকারীর অভিজ্ঞতা তৈরি করে এবং বারবার যোগাযোগের প্রবণতা বাড়ায়, যারা এই বিষয়ে সংবেদনশীল নয়। বিজনেস মেসেজেস ব্যবহারকারীর লোকেল সেটিংস এজেন্টদের কাছে পাঠিয়ে, এজেন্টদের প্রতিটি লোকেলের জন্য একটি ডিফল্ট লোকেল ও স্বতন্ত্র কথোপকথন সেটিংস নির্দিষ্ট করার সুযোগ দিয়ে এবং ব্যবহারকারীর লোকেল ও কোনো এজেন্ট বা লোকেশনের সমর্থিত লোকেলের মধ্যে মিল খুঁজে বের করার মাধ্যমে এজেন্ট ও লোকেশনগুলোকে ব্যবহারকারীদের পছন্দের প্রতি সংবেদনশীল হতে সক্ষম করে।

লোকেল শনাক্ত করার মাধ্যমে, বিজনেস মেসেজ এজেন্টরা ব্যবহারকারীদের অঞ্চল ও ভাষার পছন্দ সম্পর্কে স্বয়ংক্রিয় এবং লাইভ এজেন্ট ইন্টারঅ্যাকশনগুলোকে সচেতন করে তাদের অভিজ্ঞতাকে স্থানীয়করণ করতে পারে।

ব্যবহারকারীর অবস্থান

যখন কোনো ব্যবহারকারী একজন এজেন্টের সাথে কথোপকথন শুরু করেন এবং প্রতিবার বার্তা পাঠান, তখন বিজনেস মেসেজেস ব্যবহারকারীর ডিভাইসের লোকেল সেটিংস শনাক্ত করে। এজেন্টদের প্রাপ্ত প্রতিটি বার্তায় context.userInfo.userDeviceLocale ফিল্ডে ব্যবহারকারীর লোকেল অন্তর্ভুক্ত থাকে।

বিজনেস মেসেজেস ইউজার ইন্টারফেসের ভাষা পরিবর্তন করতে এবং প্ল্যাটফর্ম দ্বারা তৈরি স্ট্রিংগুলির ভাষা পরিবর্তন করতে ব্যবহারকারীর ডিভাইসের লোকেল ব্যবহার করে।

কথোপকথনের মাঝে userDeviceLocale পরিবর্তিত হতে পারে, যদি ব্যবহারকারী ডিভাইসের ভাষা পরিবর্তন করেন অথবা ভিন্ন লোকেল সেটিংসযুক্ত ডিভাইসের মধ্যে অদলবদল করেন। এজেন্টরা যদি userDeviceLocale পড়েন, তবে প্রতিটি নতুন বার্তার সাথে মানটি পরিবর্তিত হয়েছে কিনা তা তাদের পরীক্ষা করা উচিত এবং পরিবর্তিত হলে সেই অনুযায়ী ব্যবস্থা নেওয়া উচিত। উদাহরণস্বরূপ, একজন এজেন্ট লোকেল পরিবর্তন শনাক্ত করে ব্যবহারকারীকে জিজ্ঞাসা করতে পারেন যে তিনি বর্তমান ভাষায় যোগাযোগ চালিয়ে যেতে চান নাকি নতুন লোকেলের সাথে মেলে এমন একটি ভাষায় কথা বলতে চান।

userDeviceLocale ব্যবহারকারীর ডিভাইস দ্বারা নির্দিষ্ট করা হয় এবং এটি যেকোনো IETF BCP 47 ল্যাঙ্গুয়েজ ট্যাগ হতে পারে।

এজেন্ট এবং অবস্থান

এজেন্ট এবং লোকেশনগুলো তাদের সমর্থিত যেকোনো লোকেলের জন্য কথোপকথনের সেটিংস নির্দিষ্ট করতে পারে। উদাহরণস্বরূপ, একজন এজেন্ট "en" লোকেলের জন্য ইংরেজিতে একটি স্বাগত বার্তা এবং "es" লোকেলের জন্য স্প্যানিশ ভাষায় একই বার্তা নির্দিষ্ট করতে পারেন, অথবা একটি লোকেশন "fr" লোকেলের জন্য সেটিংস নির্দিষ্ট করলেও অন্য লোকেশন তা নাও করতে পারে।

যদি কোনো এজেন্ট বা লোকেশনের জন্য কোনো লোকেলের কথোপকথনমূলক সেটিংস সেট করা থাকে, তাহলে বিজনেস মেসেজেস ধরে নেয় যে সেই এজেন্ট বা লোকেশন সেই লোকেলটি সমর্থন করে। এজেন্ট এবং লোকেশনগুলো একটি ডিফল্ট লোকেল ( defaultLocale ) সেট করতে পারে, যেটিতে তারা সাধারণত যোগাযোগ করে।

কোনো এজেন্ট বা অবস্থানের ডিফল্ট লোকেল আপডেট করতে, ‘ডিফল্ট লোকেল আপডেট করুন ’ দেখুন। কোনো লোকেলের জন্য কথোপকথনমূলক সেটিংস সেট করতে, ‘কথোপকথন শুরু করুন’ দেখুন।

সমাধান করা স্থান

ব্যবহারকারীর ডিভাইসের লোকেল শনাক্ত করে এবং সেই লোকেলকে ব্যবহারকারীর মেসেজ পাঠানো এজেন্ট বা অবস্থানের জন্য নির্দিষ্ট লোকেলগুলোর সাথে তুলনা করে, বিজনেস মেসেজেস ব্যবহারকারী এবং এজেন্টের লোকেলের মধ্যে মিল খুঁজে বের করতে পারে। বিজনেস মেসেজেস যখন কোনো মিল খুঁজে বের করে, তখন একজন এজেন্ট বা অবস্থানের defaultLocale অন্যান্য সমর্থিত লোকেলগুলোর চেয়ে অগ্রাধিকার পায়। এজেন্টদের প্রাপ্ত প্রতিটি মেসেজে context.resolvedLocale ফিল্ডে এই মিলটি অন্তর্ভুক্ত থাকে।

বিজনেস মেসেজেস কোন কথোপকথনমূলক সেটিংস (যেমন স্বাগত বার্তা এবং অফলাইন বার্তা) এবং স্ট্রিং (যেমন লাইভ এজেন্ট অনুরোধের পরামর্শ স্ট্রিং) প্রদর্শন করবে তা নির্বাচন করতে নির্ধারিত লোকেল ব্যবহার করে। একটি সামঞ্জস্যপূর্ণ ব্যবহারকারীর অভিজ্ঞতা বজায় রাখার জন্য এজেন্টদের নির্ধারিত লোকেলে যোগাযোগ করাই উত্তম অভ্যাস।

কথোপকথনের মাঝে ব্যবহারকারী যদি ডিভাইসের ভাষা পরিবর্তন করেন অথবা ভিন্ন লোকেল সেটিংসযুক্ত ডিভাইসের মধ্যে অদলবদল করেন, তাহলে নির্ধারিত লোকেল পরিবর্তিত হতে পারে। এজেন্টদের প্রতিটি নতুন বার্তার সাথে মানটি পরিবর্তিত হয়েছে কিনা তা পরীক্ষা করা উচিত এবং পরিবর্তিত হলে সেই অনুযায়ী ব্যবস্থা নেওয়া উচিত। উদাহরণস্বরূপ, একজন এজেন্ট লোকেলের পরিবর্তন শনাক্ত করে ব্যবহারকারীকে জিজ্ঞাসা করতে পারেন যে তিনি বর্তমান ভাষায় যোগাযোগ চালিয়ে যেতে চান নাকি নতুন লোকেলের সাথে মেলে এমন একটি ভাষায় কথা বলতে চান।

ডিফল্ট লোকেল আপডেট করুন

ডিফল্ট লোকেল নির্দিষ্ট করার জন্য, কোনো এজেন্ট বা লোকেশনের defaultLocale ফিল্ড আপডেট করতে বিজনেস কমিউনিকেশনস এপিআই (Business Communications API) ব্যবহার করে একটি PATCH রিকোয়েস্ট করতে হয়।

কোনো লোকালের জন্য একজন এজেন্ট বা অবস্থানের কথোপকথন সেটিংস—যেমন স্বাগত বার্তা এবং কথোপকথন শুরুর বিষয়—আপডেট করতে, ‘কথোপকথন শুরু করুন’ দেখুন।

পূর্বশর্ত

ডিফল্ট লোকেল আপডেট করার আগে, আপনার নিম্নলিখিত আইটেমগুলির প্রয়োজন হবে:

আপনার ডেভেলপমেন্ট মেশিনে আপনার 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 দেখুন।