Localizzazione e impostazioni internazionali

Gli utenti comunicano da molte posizioni e in molte lingue. Gli agenti che rispondono alle preferenze di comunicazione degli utenti e localizzano le esperienze raggiungono più utenti, creano esperienze più soddisfacenti e generano più interazioni rispetto agli agenti che non rispondono. Business Messages consente agli agenti e alle località di rispondere alle preferenze degli utenti trasmettendo le impostazioni internazionali per gli utenti agli agenti, consentendo loro di specificare impostazioni internazionali predefinite e di conversazione singole per le impostazioni internazionali e risolvendo le corrispondenze tra le impostazioni internazionali degli utenti e le impostazioni internazionali supportate da un agente o una località.

Rilevando le impostazioni internazionali, gli agenti di Business Messages possono localizzare le loro esperienze rendendo le interazioni con gli agenti automatiche e in tempo reale consapevoli delle preferenze relative alla lingua e alla lingua 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 internazionali del dispositivo. Ogni agente dei messaggi ricevuto include le impostazioni internazionali dell'utente nel campo context.userInfo.userDeviceLocale.

Business Messages utilizza le impostazioni internazionali del dispositivo dell'utente per modificare la lingua dell'interfaccia utente e 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 internazionali diverse. Se gli agenti leggono userDeviceLocale, devono verificare se il valore è cambiato a 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 corrente o passare a una che corrisponde alla nuova lingua.

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

Impostazioni internazionali dell'agente e della località

Gli agenti e le località possono specificare le impostazioni di conversazione per qualsiasi lingua supportata. Ad esempio, un agente potrebbe specificare un messaggio di benvenuto in inglese per le impostazioni internazionali e le stesse impostazioni per le impostazioni internazionali e viceversa.

Se un agente o una località ha impostazioni di conversazione configurate per un'area geografica, Business Messages presume che l'agente o la località supporti l'impostazione locale. Gli agenti e le località possono impostare le impostazioni internazionali predefinite (defaultLocale) in cui comunicano solitamente.

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

Impostazioni internazionali risolte

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

Business Messages utilizza le impostazioni internazionali risolte per selezionare le impostazioni di conversazione (come i messaggi di benvenuto e i messaggi offline) e le stringhe (ad esempio, la stringa Richiesta di agente in tempo reale da visualizzare). È consigliabile che gli agenti comunichino nelle aree geografiche risolte per mantenere un'esperienza utente coerente.

Le impostazioni internazionali modificate 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 a 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 corrente oppure passare a una che corrisponde alla nuova lingua.

Aggiorna le impostazioni internazionali predefinite

Per specificare le impostazioni internazionali predefinite, devi effettuare 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 località per un'area geografica, ad esempio il messaggio di benvenuto e gli spunti di conversazione, vedi Iniziare la conversazione.

Prerequisiti

Prima di aggiornare le impostazioni internazionali predefinite, devi disporre dei seguenti elementi:

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

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

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

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

    Se non conosci l'indirizzo name della località, consulta l'articolo Elencare tutte le sedi per un brand.

  • Impostazioni internazionali da impostare come predefinite, come codice lingua ISO 639-1 a due caratteri

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

Invia la richiesta di aggiornamento

Per aggiornare l'agente o la località, esegui il comando seguente. Sostituisci le variabili con i valori identificati 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__"
  }
}'
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.