Localizzazione e impostazioni internazionali

Gli utenti comunicano da molte località e in molte lingue. Gli agenti che rispondono alle preferenze di comunicazione degli utenti e localizzano le loro esperienze raggiungono più utenti, creano esperienze utente più soddisfacenti e generano più interazioni ripetute rispetto agli agenti che non rispondono. Business Messages consente ad agenti e sedi di rispondere alle preferenze degli utenti passando le impostazioni delle impostazioni internazionali dell'utente agli agenti, consentendo agli agenti di specificare una lingua predefinita e impostazioni di conversazione uniche per lingua e risolvendo le corrispondenze tra le lingue degli utenti e le lingue supportate di un agente o di una sede.

Rilevando le impostazioni internazionali, gli agenti Business Messages possono localizzare le loro esperienze rendendo le interazioni automatiche e con agenti live consapevoli delle preferenze di lingua e regione degli utenti.

Impostazioni internazionali utente

Quando un utente inizia una conversazione con un agente e ogni volta che invia un messaggio, Business Messages rileva le impostazioni delle impostazioni internazionali del dispositivo dell'utente. Ogni messaggio che gli agenti ricevono include le impostazioni internazionali dell'utente nel campo context.userInfo.userDeviceLocale.

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

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

userDeviceLocale è specificato dal dispositivo dell'utente e può essere qualsiasi tag di lingua IETF BCP 47.

Locale dell'agente e della località

Gli agenti e le sedi possono specificare le impostazioni conversazionali per le lingue che supportano. Ad esempio, un agente potrebbe specificare un messaggio di benvenuto in inglese per le impostazioni internazionali "en" e lo stesso messaggio in spagnolo per le impostazioni internazionali "es", oppure una sede potrebbe specificare le impostazioni per le impostazioni internazionali "fr" mentre un'altra sede non lo fa.

Se un agente o una sede ha impostato delle impostazioni conversazionali per una lingua, Business Messages presuppone che l'agente o la sede supporti quella lingua. Gli agenti e le sedi possono impostare una lingua predefinita (defaultLocale) in cui comunicano di solito.

Per aggiornare le impostazioni internazionali predefinite di un agente o di una sede, consulta Aggiornare le impostazioni internazionali predefinite. Per impostare le impostazioni conversazionali per un locale, vedi Inizia la conversazione.

Impostazioni internazionali risolte

Identificando le impostazioni internazionali del dispositivo dell'utente e confrontandole con quelle specificate per l'agente o la posizione a cui l'utente invia messaggi, Business Messages può risolvere una corrispondenza tra le impostazioni internazionali dell'utente e dell'agente. Il defaultLocale di un agente o di una sede ha la precedenza su altre impostazioni internazionali supportate quando Business Messages risolve una corrispondenza. Ogni messaggio ricevuto dagli agenti include questa corrispondenza nel campo context.resolvedLocale.

Business Messages utilizza le impostazioni internazionali risolte per selezionare le impostazioni conversazionali (come i messaggi di benvenuto e i messaggi offline) e le stringhe (come la stringa Suggerimento per la richiesta di un operatore in tempo reale) da visualizzare. La best practice per gli agenti è comunicare nella lingua risolta per mantenere un'esperienza utente coerente.

Le impostazioni internazionali risolte possono cambiare all'interno di una conversazione se l'utente cambia la lingua del dispositivo o passa da un dispositivo all'altro con impostazioni internazionali diverse. Gli agenti devono verificare se il valore è cambiato con ogni nuovo messaggio e adattarsi di conseguenza in caso affermativo. Ad esempio, un agente potrebbe rilevare una modifica delle impostazioni regionali e chiedere all'utente se preferisce continuare a comunicare nella lingua corrente o passare a una lingua che corrisponda alle nuove impostazioni regionali.

Aggiornare le impostazioni internazionali predefinite

Per specificare una lingua predefinita, invia una richiesta PATCH con l'API Business Communications per aggiornare il campo defaultLocale di un agente o di una sede.

Per aggiornare le impostazioni di conversazione di un agente o di una sede per una località, ad esempio il messaggio di benvenuto e gli spunti di conversazione, consulta Inizia la conversazione.

Prerequisiti

Prima di aggiornare le impostazioni internazionali predefinite, devi disporre di quanto segue:

  • Percorso della chiave del service account del progetto GCP sulla macchina di sviluppo

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

    Se non conosci l'name dell'agente, consulta Elenco di tutti gli agenti per un brand.

  • Per le impostazioni internazionali predefinite della sede, sede name (ad esempio "brands/12345/locations/67890")

    Se non conosci il name della sede, consulta Elenco di tutte le sedi di un brand.

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

  • Impostazioni conversazionali specifiche per le impostazioni internazionali impostate per l'agente o la sede. Vedi Inizia la conversazione

Inviare la richiesta di aggiornamento

Per aggiornare l'agente o la posizione, esegui questo comando. Sostituisci le variabili con i valori che hai identificato in 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__"
  }
}'

Per le opzioni di formattazione e valore, vedi 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"
}'

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