Localizzazione e impostazioni internazionali

Gli utenti comunicano da molte località e in molte lingue. Agenti che adattabile alle esigenze degli utenti preferenze di comunicazione e localizzano le loro esperienze raggiungere più utenti, creare esperienze utente più soddisfacenti e generare più e interazioni ripetute rispetto agli agenti non reattivi. Business Messages consente agli agenti e alle località di rispondere alle esigenze degli utenti le tue preferenze passando impostazioni internazionali utente agli agenti, consentendo loro di specificare impostazioni di conversazione univoche per lingua e risoluzione delle corrispondenze tra gli utenti impostazioni internazionali e quelle supportate da un agente o da una località.

Rilevando le impostazioni internazionali, gli agenti di Business Messages possono localizzare le proprie esperienze rendere le interazioni automatizzate e live con gli agenti consapevoli degli utenti regione e preferenze linguistiche.

Impostazioni internazionali dell'utente

Quando un utente avvia una conversazione con un agente e ogni volta che un utente invia un Business Messages rileva le impostazioni internazionali del dispositivo dell'utente. Ciascuna che gli agenti di messaggistica ricevono includono le impostazioni internazionali dell'utente nel context.userInfo.userDeviceLocale .

Business Messages utilizza le impostazioni internazionali del dispositivo dell'utente per modificare la lingua dell'interfaccia utente e modificare la lingua delle stringhe generate dalla piattaforma.

userDeviceLocale può cambiare all'interno di una conversazione se l'utente modifica la lingua del dispositivo o passa da un dispositivo all'altro con impostazioni internazionali diverse impostazioni. Se gli agenti leggono userDeviceLocale, devono verificare se il valore ha cambiano con ogni nuovo messaggio e si adattano di conseguenza. Ad esempio, un potrebbe rilevare una modifica delle impostazioni internazionali e chiedere all'utente se preferisce continuare a comunicare nella lingua corrente o passare a una che corrisponde alla lingua nuove impostazioni internazionali.

userDeviceLocale viene specificato dal dispositivo dell'utente e può essere qualsiasi BCP IETF 47.

Impostazioni internazionali dell'agente e della località

Gli agenti e le località possono specificare impostazioni di conversazione per qualsiasi lingua supportati. Ad esempio, un agente potrebbe specificare un messaggio di benvenuto in inglese per l'"en" impostazioni internazionali e avere lo stesso messaggio in spagnolo per la lingua "es" impostazioni internazionali o una località può specificare le impostazioni per "fr" impostazioni internazionali mentre un'altra località non lo fa.

Se un agente o una località ha impostazioni di conversazione configurate per una lingua, Business Messages presuppone che l'agente o la sede supportino quella lingua. Gli agenti e le località possono impostare impostazioni internazionali predefinite (defaultLocale) per di solito comunicano.

Per aggiornare le impostazioni internazionali predefinite di un agente o di una località, vedi Aggiornare le impostazioni predefinite impostazioni internazionali. Per configurare le impostazioni di conversazione per una lingua: consulta Inizia la conversazione.

Impostazioni internazionali risolte

Identificando le impostazioni internazionali del dispositivo dell'utente e confrontandole con quelle per l'agente o la sede a cui l'utente invia messaggi, l'attività I messaggi possono risolvere una corrispondenza tra le impostazioni internazionali dell'utente e dell'agente. Un agente o l'attributo defaultLocale della località ha la precedenza su altre impostazioni internazionali supportate quando Business Messages risolve una corrispondenza. Ogni agente di messaggi riceve include corrispondono al context.resolvedLocale .

Business Messages utilizza le impostazioni internazionali risolte per selezionare la conversazione impostazioni (come messaggi di benvenuto e messaggi offline) e stringhe (come Il suggerimento per la richiesta di un operatore stringa) da visualizzare. È consigliabile che gli agenti comunichino nella richiesta le impostazioni internazionali per garantire un'esperienza utente coerente.

Le impostazioni internazionali risolte possono cambiare all'interno di una conversazione se l'utente modifica lingua del dispositivo o passa da un dispositivo all'altro con impostazioni internazionali diverse impostazioni. Gli agenti devono verificare se il valore è cambiato a ogni nuovo messaggio e adattarsi di conseguenza. Ad esempio, un agente potrebbe rilevare la modifica delle impostazioni internazionali e chiedere all'utente se preferisce continuare a comunicare nel lingua o passa a una che corrisponde alla nuova lingua.

Aggiorna le impostazioni internazionali predefinite

Per specificare impostazioni internazionali predefinite, effettua una richiesta PATCH con Business Communications dell'API per aggiornare il campo defaultLocale di un agente o della località.

Per aggiornare le impostazioni della conversazione di un agente o di una località per una lingua, ad esempio messaggio di benvenuto e spunti di conversazione: consulta la sezione Iniziare conversazione.

Prerequisiti

Prima di aggiornare le impostazioni internazionali predefinite, sono necessari i seguenti elementi:

  • Percorso della chiave dell'account di servizio del progetto Google Cloud sulla macchina di sviluppo

  • Per le impostazioni internazionali predefinite dell'agente, l'agente name (ad esempio, "brands/12345/agents/67890")

    Se non conosci il name dell'agente, consulta Elenca tutti gli agenti per un brand.

  • Per le impostazioni internazionali predefinite della località, la località name (ad es. "brands/12345/locations/67890")

    Se non conosci il name di un luogo, consulta Elenca tutte le sedi per un brand.

  • Le impostazioni internazionali da impostare come predefinite, espresse come lingua ISO 639-1 a due caratteri. codice

  • Impostazioni di conversazione specifiche per le impostazioni internazionali configurate per l'agente o la località. Consulta Inizia la conversazione

Invia la richiesta di aggiornamento

Per aggiornare l'agente o la località, esegui questo comando. Sostituisci variabili con i valori identificati nella sezione Prerequisiti.

Impostazioni internazionali predefinite dell'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

Per le opzioni di formattazione e valore, consulta BusinessMessagesAgent.

Impostazioni internazionali predefinite della località 

# 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

Per le opzioni di formattazione e valore, consulta brands.locations.