현지화 및 언어

사용자는 다양한 위치에서 다양한 언어로 커뮤니케이션합니다. 다음에 해당하는 상담사 즉각적으로 반응하여 선호하는 커뮤니케이션 방식을 더 많은 사용자에게 도달하고 더욱 만족스러운 사용자 경험을 제공하며 상호작용을 반복하는 경향이 있습니다 비즈니스 메시지 에이전트와 위치가 사용자의 환경설정을 에이전트에 사용자 언어 설정을 제공하여 에이전트가 기본 언어와 언어를 지정할 수 사용자 간 매칭을 해결하는 방법과 상담사 또는 위치에서 지원되는 언어

Business Messages 에이전트는 언어를 감지함으로써 자동화된 실시간 에이전트 상호작용을 통해 리전 및 언어 환경설정을 탭합니다.

사용자 언어

사용자가 상담사와 대화를 시작할 때, 그리고 사용자가 메시지가 표시되면 Business Messages에서 사용자 기기의 언어 설정을 감지합니다. 각 수신하는 메시지 에이전트는 context.userInfo.userDeviceLocale 드림 필드를 확인합니다.

Business Messages는 사용자 기기의 언어를 사용하여 사용자 인터페이스를 실행하고 플랫폼에서 생성한 문자열의 언어를 변경합니다.

userDeviceLocale 사용자가 기기 언어 또는 언어가 다른 기기 간에 전환 설정을 변경할 수 있습니다. 상담사는 userDeviceLocale 값을 읽는 경우 값이 다음과 같은지 확인해야 합니다. 새로운 메시지마다 달라진다면 그에 맞춰 적절하게 조정하세요. 예를 들어 상담사가 언어 변경을 감지하고 사용자에게 언어 변경을 원하는지 물어볼 수 있습니다. 현재 언어로 계속 대화하거나 새 언어로 번역됩니다.

userDeviceLocale는 사용자 기기에서 지정하며 임의의 IETF BCP일 수 있습니다. 47 언어 태그.

상담사 및 위치 언어

상담사 및 위치에서 언어에 관계없이 대화 설정을 지정할 수 있음 있습니다. 예를 들어 에이전트는 환영 메시지를 영어로 지정할 수 있습니다. 'en' 'es'에 대해 스페인어로 된 동일한 메시지를 사용해야 합니다. 언어 한 위치는 'fr'에 대한 설정을 지정할 수 있음 다른 위치는 않습니다.

에이전트 또는 위치에 특정 언어로 설정된 대화 설정이 있는 경우 Business Messages는 에이전트 또는 위치에서 해당 언어를 지원한다고 가정합니다. 에이전트 및 위치는 원하는 기본 언어 (defaultLocale)를 일반적으로 통신할 수 있습니다

에이전트 또는 위치의 기본 언어를 업데이트하려면 기본 언어 업데이트 언어를 선택합니다. 언어에 대한 대화 설정을 지정하려면 다음 단계를 따르세요. 대화의 내용입니다.

확인된 언어

사용자 기기의 언어를 식별하고 해당 언어를 언어와 비교 사용자가 메시지를 보내는 상담사 또는 위치에 대해 메시지는 사용자와 상담사 언어 간의 일치를 확인할 수 있습니다. 상담사 또는 위치의 defaultLocale은 다음 경우 지원되는 다른 언어보다 우선합니다. Business Messages는 일치 항목을 확인합니다. 메시지 에이전트가 수신하는 각 메시지에는 다음이 포함됩니다. 일치 context.resolvedLocale 드림 필드를 확인합니다.

Business Messages는 확인된 언어를 사용하여 어떤 대화인지 선택합니다. 설정 (예: 환영 메시지 및 오프라인 메시지) 및 문자열 (예: 실시간 상담사 요청 제안 문자열)입니다. 상담사는 문제가 해결되었을 때 언어를 사용하여 일관된 사용자 환경을 유지할 수 있습니다.

해결된 언어는 사용자가 기기 언어 또는 언어가 다른 기기 간에 전환 설정을 변경할 수 있습니다. 상담사는 새 메시지마다 값이 변경되었는지 확인해야 하며 적절하게 조정할 수 있습니다 예를 들어 에이전트는 언어 변경을 감지할 수 있습니다. 사용자에게 현재 상태의 상황에서 계속 대화하고 싶은지 물어봅니다 새 언어와 일치하는 언어로 전환하세요.

기본 언어 업데이트

기본 언어를 지정하려면 PATCH 요청을 실행합니다. 비즈니스 커뮤니케이션 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입니다.