Localização e localidades

Os usuários se comunicam de muitos locais e idiomas. Os agentes que respondem às preferências de comunicação dos usuários e localizam as experiências deles alcançam mais usuários, criam experiências mais satisfatórias e geram mais interações repetidas do que os que não respondem. O Business Messages permite que os agentes e locais respondam às preferências dos usuários transmitindo configurações de localidade dos usuários, permitindo que os agentes especifiquem uma localidade padrão e configurações de conversa únicas por localidade e resolvendo correspondências entre as localidades dos usuários e as localidades compatíveis com um agente ou local.

Ao detectar a localidade, os agentes do Business Messages podem localizar as experiências informando as interações automáticas e em tempo real sobre as preferências de região e idioma dos usuários.

Localidade do usuário

Quando um usuário inicia uma conversa com um agente e todas as vezes que ele envia uma mensagem, o Business Messages detecta as configurações de localidade do dispositivo do usuário. Cada mensagem recebida pelos agentes 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 nas strings geradas pela plataforma.

userDeviceLocale pode mudar em uma conversa se o usuário mudar o idioma do dispositivo ou alternar entre dispositivos que têm configurações de localidade diferentes. Se os agentes lerem userDeviceLocale, precisarão verificar se o valor foi alterado com cada nova mensagem e adaptá-la de acordo com a alteração. 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 uma correspondente à nova.

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 local 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 outra localização não.

Se um agente ou local tiver configurações de conversa definidas para uma localidade, o Business Messages presumirá que o agente ou local é compatível com ele. Os agentes e locais podem definir uma localidade padrão (defaultLocale) em que geralmente se comunicam.

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

Localidade resolvida

Identificando a localidade do dispositivo do usuário e comparando-a com as localidades especificadas para o agente ou o local para o qual o usuário envia mensagens, o Business Messages pode resolver uma correspondência entre o usuário e as localidades do agente. O defaultLocale de um agente ou local tem precedência sobre outras localidades compatíveis quando o Business Messages resolve uma correspondência. Cada mensagem recebida pelos agentes 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 agente em tempo real) que serão exibidas. A prática recomendada para os agentes é se comunicar na localidade resolvida para manter uma experiência do usuário consistente.

A localidade resolvida pode mudar em uma conversa se o usuário alterar o idioma do dispositivo ou alternar entre dispositivos com configurações de localidade diferentes. Os agentes precisam verificar se o valor foi alterado a cada nova mensagem e adaptá-lo se isso tiver ocorrido. Por exemplo, um agente pode detectar uma mudança de localidade e perguntar ao usuário se prefere continuar se comunicando no idioma atual ou mudar para uma 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, por exemplo, para iniciar uma conversa e ver uma mensagem de boas-vindas, consulte Iniciar 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 seu projeto do GCP na sua máquina de desenvolvimento

  • Para a localidade padrão do 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 o local padrão, name (por exemplo, "marcas/12345/locais/67890")

    Se você não souber a 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 o local. Consulte Iniciar a conversa.

Enviar a solicitação de atualização

Para atualizar o agente ou o local, execute o comando a seguir. 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__"
  }
}'
update-agent-bm-defaultLocale.sh

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"
}'
update-location-bm-defaultLocale.sh

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