사용자는 다양한 위치에서 다양한 언어로 소통합니다. 사용자의 커뮤니케이션 환경설정에 반응하고 경험을 현지화하는 에이전트는 응답하지 않는 에이전트보다 더 많은 사용자에게 도달하고 더 많은 사용자 경험을 만들며 더 많은 상호작용을 유도합니다. Business Messages를 사용하면 에이전트에 사용자 위치 설정을 에이전트에 전달하고 에이전트에 언어별 기본 대화 설정을 지정할 수 있으며 사용자 언어와 에이전트 또는 위치의 지원되는 언어 간의 일치 항목을 확인하여 에이전트와 위치가 사용자의 환경설정에 반응할 수 있습니다.
Business Messages 에이전트는 언어를 감지하여 사용자의 에이전트와 사용자의 언어 및 선호도를 자동으로 인식하는 실시간 에이전트 상호작용을 할 수 있습니다.
사용자 언어
사용자가 에이전트와 대화를 시작하고 사용자가 메시지를 전송할 때마다 Business Messages가 사용자 기기의 언어 설정을 감지합니다. 에이전트가 수신하는 각 메시지에는 사용자의 언어가 context.userInfo.userDeviceLocale 필드에 포함됩니다.
Business Messages는 사용자 기기의 언어를 사용하여 사용자 인터페이스의 언어와 플랫폼에서 생성된 문자열의 언어를 변경합니다.
사용자가 기기의 언어를 변경하거나 언어 설정이 다른 기기 간에 전환하는 경우 userDeviceLocale는 대화 내에서 변경될 수 있습니다. userDeviceLocale를 읽는 경우 새 메시지마다 값이 변경되었는지 확인하고 값이 적절하게 조정되어야 합니다. 예를 들어 에이전트는 언어 변경을 감지하고 사용자에게 현재 언어로 계속 커뮤니케이션할지 아니면 새 언어와 일치하는 언어로 전환할지 사용자에게 물어볼 수 있습니다.
userDeviceLocale는 사용자 기기에 의해 지정되며 IETF BCP 47 언어 태그일 수 있습니다.
에이전트 및 위치 언어
에이전트 및 위치는 지원하는 모든 언어의 대화 설정을 지정할 수 있습니다. 예를 들어 에이전트에서 'en' 언어로 환영 메시지를 영어로 지정하고 'es' 언어로는 동일한 메시지를 스페인어로 만들 수 있습니다. 또는 한 위치에서 'fr' 언어로 설정을 지정하는 반면 다른 위치에서는 지정하지 않을 수도 있습니다.
에이전트 또는 위치에 특정 언어로 설정된 대화 설정이 있는 경우 Business Messages는 에이전트 또는 위치에서 해당 언어를 지원한다고 가정합니다.
에이전트와 위치는 일반적으로 통신하는 기본 언어 (defaultLocale)를 설정할 수 있습니다.
에이전트 또는 위치의 기본 언어를 업데이트하려면 기본 언어 업데이트를 참고하세요. 언어의 대화 설정을 지정하려면 대화 시작하기를 참고하세요.
확인된 언어
사용자 기기의 언어를 식별하고 에이전트에 지정된 언어 또는 사용자가 메시지를 보내는 위치와 비교함으로써 Business Messages는 사용자와 에이전트 언어 간의 일치 항목을 확인할 수 있습니다. 에이전트 또는 위치의 defaultLocale는 Business Messages에서 일치 항목을 확인할 때 지원되는 다른 언어보다 우선합니다. 각 메시지 에이전트에는 context.resolvedLocale 필드에 이러한 일치 항목이 포함됩니다.
Business Messages는 확인된 언어를 사용하여 표시할 대화 설정 (예: 환영 메시지 및 오프라인 메시지)과 문자열 (예: 실시간 에이전트 요청 제안 문자열)을 선택합니다. 에이전트가 일관된 사용자 환경을 유지하기 위해 확인된 언어로 통신하는 것이 가장 좋습니다.
사용자가 기기의 언어를 변경하거나 언어 설정이 다른 기기 간에 전환하면 확인된 언어는 대화 내에서 변경될 수 있습니다. 에이전트는 새 메시지마다 값이 변경되었는지 확인하고 값이 있으면 적절하게 조정해야 합니다. 예를 들어 에이전트가 언어 변경을 감지하고 사용자에게 현재 언어로 계속 커뮤니케이션할지 아니면 새 언어와 일치하는 언어로 전환할지 사용자에게 물어볼 수 있습니다.
기본 언어 업데이트
기본 언어를 지정하려면 Business Communications API로 PATCH 요청을 실행하여 에이전트 또는 위치의 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__"
}
}'
형식 지정 및 값 옵션은 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를 참조하세요.