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 de usuario más satisfactorias e impulsan más interacciones repetidas que los agentes que no responden. Business Messages permite 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 especifiquen una configuración regional predeterminada y una conversación única por cada configuración regional, y que resuelvan las coincidencias entre las configuraciones regionales compatibles de los usuarios y los agentes.
Si detectan la configuración regional, los agentes de Business Messages pueden localizar sus experiencias al hacer que las interacciones automatizadas y en vivo de los agentes conozcan 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 este envía un mensaje, Business Messages detecta 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.
Business Messages usa la configuración regional del dispositivo del usuario para cambiar el idioma en la interfaz de usuario y las strings que genera la plataforma.
userDeviceLocale puede cambiar en una conversación si el usuario cambia el idioma del dispositivo o alterna entre dispositivos con diferentes configuraciones regionales. Si los agentes leen userDeviceLocale, deben verificar si el valor cambió con cada mensaje nuevo y adaptarse según corresponda. Por ejemplo, un agente puede detectar un cambio de configuración regional y preguntar 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 mediante el dispositivo del usuario y puede ser cualquier etiqueta de idioma IETF BCP 47.
Agente y ubicación
Los agentes y las ubicaciones pueden especificar una 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 no.
Si un agente o una ubicación tienen alguna configuración de conversación establecida para la configuración regional, Business Messages asume que el agente o la ubicación admite esa configuración regional.
Los agentes y las ubicaciones pueden establecer una configuración regional predeterminada (defaultLocale) en la que se suelen comunicar.
Para actualizar la configuración regional predeterminada de un agente o ubicación, consulta Cómo actualizar la configuración regional predeterminada. Para establecer la configuración de conversación de una configuración regional, consulta Cómo iniciar la conversación.
Configuración regional resuelta
Mediante la identificación de la configuración regional del dispositivo del usuario y la comparación de la configuración regional con la especificada para el agente o la ubicación a la que envía el mensaje de usuario, Business Messages puede resolver una coincidencia entre la configuración regional del usuario y la del agente. El defaultLocale de un agente o una ubicación tiene prioridad sobre otras configuraciones regionales compatibles 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é configuración de conversación (como mensajes de bienvenida y mensajes sin conexión) y strings (como la string de sugerencia de solicitudes de agentes en vivo) mostrar. Se recomienda que los agentes se comuniquen en la configuración regional resuelta para mantener una experiencia del usuario coherente.
La configuración regional resuelta puede cambiar en una conversación si el usuario cambia el idioma del dispositivo o cambia entre dispositivos que tienen una configuración regional diferente. Los agentes deben verificar si el valor cambió con cada mensaje nuevo y adaptarse según corresponda. Por ejemplo, un agente puede detectar un cambio de configuración regional y preguntar 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 a fin de actualizar el campo defaultLocale de un agente o ubicación.
Para actualizar la configuración de la conversación de un agente o una ubicación a fin de configurar una configuración regional, como un mensaje de bienvenida y disparadores 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
Para la configuración regional predeterminada del agente, agente
name(por ejemplo, "brands/12345/agents/67890")Si no conoces el
namedel agente, consulta Enumera todos los agentes de una marca.Para la configuración regional predeterminada de la ubicación, ubicación
name(por ejemplo, "brands/12345/locations/67890")Si no conoces la
namede la ubicación, consulta Enumera todas las ubicaciones de una marca.La configuración regional que se establecerá como predeterminada como un código de idioma ISO 639-1 de dos caracteres.
Configuración regional de conversación específica 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.
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 ver las opciones de formato y de valor, 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 ver las opciones de formato y de valor, consulta brands.locations.