사용자는 여러 위치에서 여러 언어로 소통합니다. 사용자의 커뮤니케이션 환경설정에 반응하고 경험을 현지화하는 에이전트는 반응하지 않는 에이전트보다 더 많은 사용자에게 도달하고, 더 만족스러운 사용자 경험을 만들고, 더 많은 반복 상호작용을 유도합니다. 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는 사용자 기기의 언어를 식별하고 해당 언어를 사용자가 메시지를 보내는 에이전트 또는 위치에 지정된 언어와 비교하여 사용자 언어와 에이전트 언어 간의 일치를 해결할 수 있습니다. Business Messages가 일치를 해결할 때 에이전트 또는 위치의 defaultLocale이 다른 지원되는 언어보다 우선합니다. 에이전트가 수신하는 각 메시지에는 이
일치가
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를 참고하세요.