Les utilisateurs communiquent depuis de nombreux pays et dans de nombreuses langues. Les agents qui sont et réactifs aux besoins des utilisateurs leurs préférences de communication et de localiser leurs expériences de toucher davantage d'utilisateurs, de créer des expériences utilisateur plus satisfaisantes des interactions répétées que les agents non réactifs. Business Messages permet aux agents et aux établissements d'être réactifs aux besoins les préférences en transmettant paramètres régionaux de l'utilisateur aux agents, ce qui permet à ceux-ci de spécifier des paramètres régionaux par défaut et des paramètres de conversation uniques par paramètre régional et résoudre les correspondances entre les et les paramètres régionaux pris en charge d'un agent ou d'un lieu.
Grâce à la détection des paramètres régionaux, les agents Business Messages peuvent localiser leurs expériences Permettre aux interactions automatisées et avec des agents réels de tenir compte de l'état la région et préférences linguistiques.
Paramètres régionaux de l'utilisateur
Lorsqu'un utilisateur entame une conversation avec un agent, et chaque fois qu'il envoie une requête
Business Messages détecte les paramètres régionaux de l'appareil de l'utilisateur. Chaque
que les agents reçoivent inclut les paramètres régionaux de l'utilisateur
context.userInfo.userDeviceLocale
.
Business Messages utilise les paramètres régionaux de l'appareil de l'utilisateur pour modifier la langue du l'interface utilisateur et modifier la langue des chaînes générées par la plate-forme.
userDeviceLocale peut changer dans une conversation si l'utilisateur modifie le
la langue d'un appareil ou passer d'un appareil à un autre avec des paramètres régionaux différents.
paramètres. Si les agents lisent userDeviceLocale, ils doivent vérifier si la valeur a été
change à chaque nouveau message
et s'adapte en conséquence si c'est le cas. Par exemple, un
l'agent peut détecter un changement de paramètres régionaux et demander à l'utilisateur s'il préfère
continuer à communiquer dans la langue actuelle ou passer à une langue qui correspond à la
nouveaux paramètres régionaux.
userDeviceLocale est spécifié par l'appareil de l'utilisateur et peut correspondre à n'importe quel BCP IETF.
47.
Paramètres régionaux de l'agent et de l'emplacement
Les agents et les emplacements peuvent spécifier des paramètres de conversation pour n'importe quel paramètre régional qu'ils prennent en charge. Par exemple, un agent peut spécifier un message de bienvenue en anglais. pour "en" et afficher le même message en espagnol pour "es" paramètres régionaux ou un emplacement peut spécifier des paramètres pour le paramètre "fr" les paramètres régionaux, tandis qu'un autre emplacement ne fonctionne pas.
Si des paramètres de conversation sont définis pour un agent ou un établissement pour un paramètre régional,
Business Messages suppose que l'agent ou l'établissement sont compatibles avec ces paramètres régionaux.
Les agents et les emplacements peuvent définir des paramètres régionaux par défaut (defaultLocale) qu'ils
communiquent habituellement.
Pour mettre à jour les paramètres régionaux par défaut d'un agent ou d'un établissement, consultez Mettre à jour les paramètres régionaux par défaut paramètres régionaux. Afin de définir des paramètres de conversation pour un paramètre régional, procédez comme suit : consultez la section Commencer le conversationnelle.
Paramètres régionaux résolus
En identifiant les paramètres régionaux de l'appareil de l'utilisateur et en les comparant aux paramètres régionaux
spécifié pour l'agent ou l'établissement envoyé par l'utilisateur,
Les messages peuvent résoudre une correspondance entre les paramètres régionaux de l'utilisateur et de l'agent. Un agent
Le defaultLocale de l'emplacement est prioritaire sur les autres paramètres régionaux pris en charge lorsque
Business Messages résout une correspondance. Chaque message reçu par les agents inclut
correspondance dans
context.resolvedLocale
.
Business Messages utilise les paramètres régionaux résolus pour sélectionner le type de conversation (messages de bienvenue ou messages hors connexion, par exemple) et chaînes (comme la suggestion de demande d'agent actif ) à afficher. Il est recommandé que les agents communiquent pour garantir une expérience utilisateur cohérente.
Les paramètres régionaux résolus peuvent changer au sein d'une conversation si l'utilisateur modifie la la langue d'un appareil ou passer d'un appareil à un autre avec des paramètres régionaux différents. paramètres. Les agents doivent vérifier si la valeur a changé à chaque nouveau message et s’adapter en conséquence si c’est le cas. Par exemple, un agent peut détecter un changement de paramètres régionaux. et demandez à l’utilisateur s’il préfère continuer à communiquer dans la ou sélectionnez-en une correspondant aux nouveaux paramètres régionaux.
Mettre à jour les paramètres régionaux par défaut
Pour spécifier des paramètres régionaux par défaut, vous devez effectuer une requête PATCH
avec le cours Business Communications
API
pour mettre à jour le champ defaultLocale d'un agent ou d'un établissement.
Pour mettre à jour les paramètres de conversation d'un agent ou d'un établissement pour des paramètres régionaux tels que message de bienvenue et amorces de conversation, consultez la section Commencer le conversationnelle.
Prérequis
Avant de mettre à jour les paramètres régionaux par défaut, vous avez besoin des éléments suivants:
- Chemin d'accès à la clé du compte de service de votre projet GCP sur votre ordinateur de développement
Pour les paramètres régionaux par défaut de l'agent, agent
name(par exemple, "brands/12345/agents/67890")Si vous ne connaissez pas le
namede l'agent, consultez Lister tous les agents pour une marque.Pour les paramètres régionaux par défaut de l'emplacement,
name(par exemple, "brands/12345/locations/67890")Si vous ne connaissez pas le
namede l'établissement, consultez la section Répertorier tous les établissements d'une marque.Paramètres régionaux à définir par défaut, sous la forme d'une langue ISO 639-1 à deux caractères du code
Paramètres de conversation spécifiques aux paramètres régionaux définis pour l'agent ou l'emplacement. Voir Commencez le conversation
Envoyer la demande de mise à jour
Pour mettre à jour l'agent ou l'emplacement, exécutez la commande suivante. Remplacer les variables avec les valeurs que vous avez identifiées dans la section Conditions préalables.
# 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__" } }'
Pour connaître les options de mise en forme et de valeur, consultez BusinessMessagesAgent :
# 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" }'
Pour connaître les options de mise en forme et de valeur, consultez brands.locations