Localização e localidades

Os usuários se comunicam de vários locais e em muitos idiomas. Agentes que são responsivo aos usuários as preferências de comunicação e adaptam as experiências alcance mais usuários, crie experiências mais satisfatórias e gere mais repetir interações do que os agentes que não respondem. Mensagens comerciais permite que agentes e locais respondam preferências, transmitindo configurações de localidade do usuário para os agentes, permitindo que eles especifiquem uma localidade padrão e configurações de conversa exclusivas por localidade e resolver correspondências entre localidades e as localidades aceitas de um agente ou local.

Ao detectar a localidade, os agentes do Business Messages podem localizar as experiências deles ao que informam as interações automáticas e em tempo real com os região e preferências de idioma.

Localidade do usuário

Quando um usuário inicia uma conversa com um agente e cada vez que um usuário envia uma o recurso Business Messages detecta as configurações de localidade do dispositivo do usuário. Cada as mensagens que os agentes recebem inclui a localidade do usuário no context.userInfo.userDeviceLocale .

O recurso Business Messages usa a localidade do dispositivo do usuário para mudar o idioma no do usuário e alterar o idioma das strings geradas pela plataforma.

userDeviceLocale pode mudar em uma conversa se o usuário mudar o idioma do dispositivo ou alterna entre dispositivos com localidades diferentes configurações. Se os agentes lerem userDeviceLocale, eles deverão verificar se o valor foi mudam a cada nova mensagem e adaptam-se de acordo, se necessário. Por exemplo, uma de estado pode detectar uma mudança de localidade e perguntar ao usuário se ele prefere continue se comunicando no idioma atual ou mude para um que corresponda ao nova localidade.

userDeviceLocale é especificado pelo dispositivo do usuário e pode ser qualquer IETF BCP 47.

Local do agente e do local

Agentes e locais podem especificar configurações de conversa para qualquer localidade que eles dão suporte. Por exemplo, o agente pode especificar uma mensagem de boas-vindas em inglês para o "en" localidade e têm a mesma mensagem em espanhol para o "es" localidade ou um local pode especificar configurações para "fr" localidade e outro local não funciona.

Se um agente ou local tiver configurações de conversa definidas para uma localidade, O Business Messages pressupõe que o agente ou local oferece suporte a essa localidade. Agentes e locais podem definir uma localidade padrão (defaultLocale) se comunicam.

Para atualizar a localidade padrão de um agente ou local, consulte Atualizar a localidade padrão locale. Para definir as configurações de conversa para uma localidade, faça o seguinte: consulte Começar a conversa.

Localidade resolvida

Identificando a localidade do dispositivo do usuário e comparando com as outras. especificado para o agente ou o local enviado pelo usuário, o endereço As mensagens podem resolver uma correspondência entre as localidades do usuário e do agente. Um agente ou defaultLocale do local tem precedência sobre outras localidades aceitas quando O recurso Business Messages resolve uma correspondência. Cada mensagem que os agentes recebem inclui este na context.resolvedLocale .

O Business Messages usa a localidade resolvida para selecionar qual conversa do usuário (como mensagens de boas-vindas e mensagens off-line) e strings (como a sugestão de solicitação do agente em tempo real string) para exibir. É prática recomendada que os agentes se comuniquem no local para manter uma experiência do usuário consistente.

A localidade resolvida pode mudar dentro de uma conversa se o usuário alterar a idioma do dispositivo ou alterna entre dispositivos com localidades diferentes configurações. Os agentes devem verificar se o valor mudou a cada nova mensagem e e se adaptar, caso necessário. Por exemplo, um agente pode detectar uma mudança de localidade e pergunte ao usuário se ele prefere continuar a se comunicar no ambiente idioma ou mudar para um que corresponda à nova localidade.

Atualizar a localidade padrão

Para especificar uma localidade padrão, faça uma solicitação PATCH com o grupo Business Communications API para atualizar o campo defaultLocale de um agente ou local.

Para atualizar as configurações de conversa de um agente ou local para uma localidade, como mensagem de boas-vindas e sugestões de conversa. Consulte Começar a conversa.

Pré-requisitos

Antes de atualizar a localidade padrão, você precisa dos seguintes itens:

  • Caminho para a chave da conta de serviço do projeto do GCP na máquina de desenvolvimento

  • Para a localidade padrão do agente, o agente name (por exemplo, "brands/12345/agents/67890")

    Se você não souber o name do agente, consulte Listar todos os agentes de um marca.

  • Para a localidade padrão do local, escolha name (por exemplo, "brands/12345/locations/67890").

    Se você não souber a name do local, consulte Listar todos os locais de um marca.

  • A localidade a ser definida como padrão, como um idioma ISO 639-1 de dois caracteres código

  • Configurações de conversa específicas da localidade definidas para o agente ou o local. Consulte Comece o conversa

Enviar a solicitação de atualização

Para atualizar o agente ou o local, execute o comando a seguir. Substituir variáveis pelos valores identificados em Pré-requisitos.

Localidade padrão do agente 

# 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

Para opções de formatação e valor, consulte BusinessMessagesAgent padrão.

Localidade padrão do local 

# 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

Para opções de formatação e valor, consulte brands.locations (link em inglês).