ローカライズ

ユーザーはさまざまな場所や言語でさまざまなコミュニケーションをとっています。対象のエージェントユーザーの要求に応じてコミュニケーションの好みを学習し、エクスペリエンスをローカライズします。より多くのユーザーにリーチし、より充実したユーザーエクスペリエンスを生み出して、やり取りの繰り返しは、応答がないエージェントよりも多くなっています。ビジネスメッセージこれにより、エージェントとビジネス情報は、ユーザーの設定を渡します。ユーザーロケール設定をエージェントに提供します。エージェントはデフォルトのロケールを指定し、一意の会話設定を作成し、ユーザーの言語間の一致を解決するエージェントまたはロケーションでサポートされている言語 / 地域です。

ビジネスメッセージエージェントは、言語 / 地域を検出することで、人間のエージェントと人間のエージェントによる対話をリージョンと [言語設定] をクリックします。

ユーザーの言語 / 地域

ユーザーがエージェントとの会話を開始したとき。また、ユーザーがメッセージを送信するたびに、ビジネスメッセージによって、ユーザーデバイスの言語 / 地域設定が検出されます。各エージェントが受信するメッセージにユーザーのロケールが context.userInfo.userDeviceLocale 表示されます。

ビジネスメッセージでは、ユーザーのデバイスの言語 / 地域を使用して、プラットフォームで生成される文字列の言語を変更できます。

ユーザーがスペースを変更すると、会話内の userDeviceLocale も変更されることがありますデバイスの言語を設定したり、言語 / 地域が異なるデバイスを切り替えたりできる設定。エージェントが userDeviceLocale を読み込んだ場合、その値が次の条件を満たしているかどうかを確認する必要があります。新しいメッセージごとに変更され、変更されている場合はそれに応じて調整します。たとえば、エージェントがロケールの変更を検出し、ユーザーが変更を希望するかどうかを尋ねることがあります。現在の言語でのコミュニケーションを継続するか、選択します。

userDeviceLocale は、ユーザーのデバイスで指定され、任意の IETF BCP です。 47 言語タグを使用します。

エージェントと場所のロケール

エージェントとロケーションは、どの言語 / 地域でも会話の設定を指定できます。サポートします。たとえば、エージェントは英語のウェルカムメッセージを指定できます。 "en"「es」のスペイン語と同じメッセージが言語 / 地域、 1 つの場所で「fr」と別のロケーションではできません。

エージェントまたはビジネス情報のロケールに会話の設定が設定されている場合、ビジネスメッセージでは、エージェントまたはビジネスがそのロケールをサポートしていることを前提としています。エージェントとロケーションは、デフォルトの言語 / 地域（defaultLocale）を設定できます。やり取りできます

エージェントまたはロケーションのデフォルトの言語 / 地域を更新するには、デフォルトの言語 / 地域を更新する言語 / 地域。特定の言語 / 地域の会話機能を設定するには、選択します。

解決済みの言語 / 地域

ユーザーデバイスの言語 / 地域を識別し、その言語 / 地域と比較するユーザーがメッセージを送信した場所、メッセージでは、ユーザーとエージェントのロケールの一致を解決できます。エージェントまたは次の場合は、地域の defaultLocale が他のサポートされている言語 / 地域よりも優先されます。ビジネスメッセージによって一致が解決されます。エージェントが受け取る各メッセージには一致 context.resolvedLocale 表示されます。

ビジネスメッセージでは、解決された言語 / 地域を使用して、設定（ウェルカムメッセージやオフラインメッセージなど）と文字列（ライブ対応のエージェントリクエストの提案 string）が表示されます。エージェントは、解決済みのケースでコミュニケーションを取ることがユーザーエクスペリエンスの一貫性を維持します。

解決されたロケールは、ユーザーが会話内で変更されると、デバイスの言語を設定したり、言語 / 地域が異なるデバイスを切り替えたりできる設定。エージェントは、新しいメッセージごとに値が変更されたかどうかを確認する必要があります。状況に合わせて調整してください。たとえば、エージェントがロケールの変更を検出し、引き続き現在のコミュニケーション環境を希望されるかどうかを新しい言語 / 地域と一致する言語 / 地域に切り替えてください。

デフォルトの言語 / 地域を更新する

デフォルトのロケールを指定するには、PATCH リクエストを行います。 Business Communications の API ビジネス情報の defaultLocale フィールドを更新します。

言語 / 地域に応じたエージェントや位置情報の会話の設定（（「ウェルカムメッセージと会話のきっかけ」など）は、選択します。

前提条件

デフォルトの言語 / 地域を更新する前に、次の項目が必要です。

開発マシン上の GCP プロジェクトのサービスアカウントキーのパス
エージェントのデフォルトの言語 / 地域の場合、エージェント name（例: 「brands/12345/agents/67890」）

エージェントの name がわからない場合は、エージェントの全エージェントを一覧表示するブランド。
場所のデフォルトの言語 / 地域: name（例: 「brands/12345/locations/67890」）

場所の name が不明な場合は、サービスのすべての地域を一覧表示するブランド。
デフォルトとして設定する言語 / 地域。2 文字の 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。