Localización y configuración regional

Los usuarios se comunican desde muchas ubicaciones y en muchos idiomas. Los agentes que responden a las preferencias de comunicación de los usuarios y localizan sus experiencias llegan a más usuarios, crean experiencias más satisfactorias y generan más interacciones repetidas que los agentes que no responden. Los Mensajes de la Empresa permiten que los agentes y las ubicaciones respondan a las preferencias de los usuarios pasando la configuración regional del usuario a los agentes, lo que permite que los agentes especifiquen una configuración regional predeterminada y una configuración de conversación única por configuración regional, y resuelvan las coincidencias entre las configuraciones regionales de los usuarios y las configuraciones regionales admitidas de un agente o una ubicación.

Al detectar la configuración regional, los agentes de Mensajes de la Empresa pueden localizar sus experiencias haciendo que las interacciones automatizadas y con agentes en vivo tengan en cuenta las preferencias de idioma y región de los usuarios.

Configuración regional del usuario

Cuando un usuario inicia una conversación con un agente y cada vez que envía un mensaje, Business Messages detecta la configuración de la configuración regional del dispositivo del usuario. Cada mensaje que reciben los agentes incluye la configuración regional del usuario en el campo context.userInfo.userDeviceLocale.

Mensajes de la Empresa usa la configuración regional del dispositivo del usuario para cambiar el idioma en la interfaz de usuario y cambiar el idioma de las cadenas generadas por la plataforma.

userDeviceLocale puede cambiar dentro de una conversación si el usuario cambia el idioma del dispositivo o cambia entre dispositivos que tienen diferentes parámetros de configuración de la configuración regional. Si los agentes leen userDeviceLocale, deben verificar si el valor cambió con cada mensaje nuevo y adaptarse en consecuencia si lo hizo. Por ejemplo, un agente podría detectar un cambio de configuración regional y preguntarle al usuario si prefiere seguir comunicándose en el idioma actual o cambiar a uno que coincida con la nueva configuración regional.

userDeviceLocale se especifica en el dispositivo del usuario y puede ser cualquier etiqueta de idioma IETF BCP 47.

Configuración regional del agente y la ubicación

Los agentes y las ubicaciones pueden especificar la configuración de conversación para cualquier configuración regional que admitan. Por ejemplo, un agente puede especificar un mensaje de bienvenida en inglés para la configuración regional "en" y tener el mismo mensaje en español para la configuración regional "es", o bien una ubicación puede especificar la configuración para la configuración regional "fr" mientras que otra ubicación no lo hace.

Si un agente o una ubicación tienen algún parámetro de configuración de conversación establecido para una configuración regional, Mensajes de Negocios supone que el agente o la ubicación admiten esa configuración regional. Los agentes y las ubicaciones pueden establecer una configuración regional predeterminada (defaultLocale) en la que suelen comunicarse.

Para actualizar la configuración regional predeterminada de un agente o una ubicación, consulta Actualiza la configuración regional predeterminada. Para establecer la configuración de conversación de una configuración regional, consulta Cómo comenzar la conversación.

Configuración regional resuelta

Al identificar la configuración regional del dispositivo del usuario y compararla con las configuraciones regionales especificadas para el agente o la ubicación a la que el usuario envía mensajes, Mensajes de Negocios puede resolver una coincidencia entre las configuraciones regionales del usuario y del agente. El defaultLocale de un agente o una ubicación tiene prioridad sobre otros parámetros de configuración regional admitidos cuando Business Messages resuelve una coincidencia. Cada mensaje que reciben los agentes incluye esta coincidencia en el campo context.resolvedLocale.

Business Messages usa la configuración regional resuelta para seleccionar qué parámetros de configuración de conversación (como mensajes de bienvenida y mensajes sin conexión) y cadenas (como la cadena de sugerencia de solicitud de agente en vivo) mostrar. Se recomienda que los agentes se comuniquen en el idioma resuelto para mantener una experiencia del usuario coherente.

La configuración regional resuelta puede cambiar dentro de una conversación si el usuario cambia el idioma del dispositivo o cambia entre dispositivos que tienen diferentes parámetros de configuración regional. Los agentes deben verificar si el valor cambió con cada mensaje nuevo y adaptarse según corresponda si lo hizo. Por ejemplo, un agente podría detectar un cambio de configuración regional y preguntarle al usuario si prefiere seguir comunicándose en el idioma actual o cambiar a uno que coincida con la nueva configuración regional.

Actualiza la configuración regional predeterminada

Para especificar una configuración regional predeterminada, realiza una solicitud PATCH con la API de Business Communications para actualizar el campo defaultLocale de un agente o una ubicación.

Para actualizar la configuración de conversación de un agente o una ubicación para una configuración regional, como el mensaje de bienvenida y los iniciadores de conversación, consulta Cómo iniciar la conversación.

Requisitos previos

Antes de actualizar la configuración regional predeterminada, necesitas los siguientes elementos:

  • Ruta de acceso a la clave de la cuenta de servicio de tu proyecto de GCP en tu máquina de desarrollo

  • Configuración regional predeterminada del agente, agente name (por ejemplo, "brands/12345/agents/67890")

    Si no conoces el name del agente, consulta Cómo enumerar todos los agentes de una marca.

  • Configuración regional predeterminada de la ubicación, ubicación name (por ejemplo, "brands/12345/locations/67890")

    Si no conoces el name de la ubicación, consulta Cómo enumerar todas las ubicaciones de una marca.

  • Es la configuración regional que se establecerá como predeterminada, como un código de idioma ISO 639-1 de dos caracteres.

  • Es la configuración de conversación específica de la configuración regional establecida para el agente o la ubicación. Consulta Cómo iniciar la conversación.

Envía la solicitud de actualización

Para actualizar el agente o la ubicación, ejecuta el siguiente comando. Reemplaza las variables por los valores que identificaste en Requisitos previos.

Configuración regional predeterminada del 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 conocer las opciones de formato y valores, consulta BusinessMessagesAgent.

Configuración regional predeterminada de la ubicación 

# 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 conocer las opciones de formato y valores, consulta brands.locations.