Localização e localidades

Os usuários se comunicam de vários locais e em vários idiomas. Os agentes que são responsivos às preferências de comunicação dos usuários e localizam as experiências deles alcançam mais pessoas, criam experiências mais satisfatórias e geram mais interações repetidas do que os agentes que não são responsivos. As Mensagens Comerciais permitem que agentes e locais respondam às preferências dos usuários transmitindo as 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, além de resolver correspondências entre as localidades dos usuários e as localidades aceitas de um agente ou local.

Ao detectar a localidade, os agentes do Business Messages podem adaptar as experiências automatizando e informando as interações com agentes reais sobre a região e as preferências de idioma dos usuários.

Localidade do usuário

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

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

userDeviceLocale pode mudar em uma conversa se o usuário mudar o idioma do dispositivo ou alternar entre dispositivos com configurações de localidade diferentes. Se os agentes lerem userDeviceLocale, eles precisarão verificar se o valor mudou a cada nova mensagem e se adaptar de acordo. Por exemplo, um agente pode detectar uma mudança de localidade e perguntar ao usuário se ele prefere continuar se comunicando no idioma atual ou mudar para um que corresponda à nova localidade.

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

Localidade do agente e do local

Os agentes e locais podem especificar configurações de conversa para qualquer localidade compatível. Por exemplo, um agente pode especificar uma mensagem de boas-vindas em inglês para a localidade "en" e ter a mesma mensagem em espanhol para a localidade "es", ou um local pode especificar configurações para a localidade "fr" enquanto outro local não faz isso.

Se um agente ou local tiver configurações de conversa definidas para uma localidade, as Mensagens Comerciais vão presumir que o agente ou local oferece suporte a essa localidade. Os agentes e locais podem definir um local padrão (defaultLocale) em que costumam se comunicar.

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

Localidade resolvida

Ao identificar a localidade do dispositivo do usuário e compará-la com as localidades especificadas para o agente ou o local em que o usuário envia mensagens, o Google Mensagens pode resolver uma correspondência entre as localidades do usuário e do agente. Um agente ou defaultLocale de um local tem precedência sobre outros locais compatíveis quando o Business Messages resolve uma correspondência. Cada mensagem que os agentes recebem inclui essa correspondência no campo context.resolvedLocale.

O Business Messages usa a localidade resolvida para selecionar quais configurações de conversa (como mensagens de boas-vindas e off-line) e strings (como a string Sugestão de solicitação de atendimento ao vivo) serão mostradas. É uma prática recomendada que os agentes se comuniquem no localidade resolvida para manter uma experiência do usuário consistente.

A localidade resolvida pode mudar em uma conversa se o usuário mudar o idioma do dispositivo ou alternar entre dispositivos com configurações de localidade diferentes. Os agentes precisam verificar se o valor mudou a cada nova mensagem e adaptar a resposta de acordo com a mudança. Por exemplo, um agente pode detectar uma mudança de localidade e perguntar ao usuário se ele prefere continuar se comunicando no idioma atual 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 a API Business Communications 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 iniciadores 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 sua máquina de desenvolvimento

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

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

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

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

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

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

Enviar o pedido de atualização

Para atualizar o agente ou o local, execute o seguinte comando: Substitua as 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__"
  }
}'

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

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"
}'

Para opções de formatação e valores, consulte brands.locations.