Blocco di flusso: Imposta attributi contatti

Descrizione

Archivia le coppie chiave-valore come attributi del contatto. Imposti un valore cui viene fatto riferimento in seguito in un flusso.

Ad esempio, crea un saluto personalizzato per i clienti instradati a una coda in base al tipo di account del cliente. Puoi anche definire un attributo per un nome di società o linea di business da includere nelle stringhe di sintesi vocale pronunciate a un cliente.

Il blocco Imposta attributi contatti è utile per copiare attributi recuperati da origini esterne in attributi definiti dall'utente.

Per ulteriori informazioni sugli attributi di contatto, consulta Uso degli attributi di contatto di Amazon Connect.

Canali supportati

La tabella seguente elenca il modo in cui questo blocco instrada un contatto che utilizza il canale specificato.

Canale	Supportato?
Voce	Sì
Chat	Sì
Attività	Sì

Tipi di flusso

È possibile utilizzare questo blocco nei seguenti tipi di flusso:

• Tutti i flussi

Proprietà

L'immagine seguente mostra la pagina delle proprietà del blocco Imposta attributi contatti. È configurato per impostare un attributo definito dall'utente sul Contatto corrente con la chiave greetingPlayed e il valore Vero.

Puoi scegliere di impostare gli attributi su:

• Contatto corrente: gli attributi sono impostati sul contatto su cui è in esecuzione questo flusso. Gli attributi sono accessibili da altre aree di Amazon Connect, come altri flussi, moduli, Lambda, record di contatti e l'API GetMetricData V2.

• Contatto correlato: gli attributi sono associati a un nuovo contatto che contiene una copia delle proprietà del contatto originale.

  Nel record dei contatti, questo è il. RelatedContactId

• Flusso: gli attributi sono limitati al flusso in cui sono configurati.

  Gli attributi di flusso sono utili in situazioni in cui non desideri conservare i dati in tutto il contatto, ad esempio quando devi utilizzare informazioni sensibili come il numero della carta di credito del cliente per eseguire un data dip Lambda.

  • Gli attributi di flusso sono variabili temporanee archiviate localmente e utilizzate solo nel flusso. Non sono visibili da nessuna parte al di fuori del flusso, nemmeno quando il contatto viene trasferito su un altro flusso.

  • Possono pesare fino a 32 KB (la dimensione massima della sezione degli attributi del record di contatto).

  • Non vengono trasferiti a Lambda a meno che non siano configurati esplicitamente come parametri: nel blocco Richiama funzione AWS Lambda, scegli Aggiungi un parametro.

  • Non vengono trasferiti ai moduli. Puoi impostare un attributo di flusso all'interno di un modulo, ma non verrà trasferito al di fuori del modulo.

  • Non vengono visualizzati nel record di contatto.

  • Non vengono visualizzati dall'agente nel CCP.

  • L'API GetContactAttributes non può esporli.

  • Se la registrazione è abilitata nel flusso, la chiave e il valore vengono visualizzati nel log di Cloudwatch.

Come fare riferimento agli attributi

• Per la sintassi JSON per ogni attributo, consulta Elenco degli attributi di contatto disponibili e relativo riferimento JSONPath.

• Per fare riferimento agli attributi che contengono caratteri speciali nel nome, ad esempio spazi, racchiudi il nome dell'attributo tra parentesi e virgolette singole. Ad esempio: $.Attributes.['user attribute name'].

• Per fare riferimento agli attributi nello stesso spazio dei nomi, ad esempio un attributo di sistema, utilizza il nome dell'attributo o il nome specificato come Destination key (Chiave di destinazione).

• Per fare riferimento ai valori in uno spazio dei nomi diverso, ad esempio un attributo esterno, specifica la sintassi JSONPath per l'attributo.

• Per utilizzare gli attributi di contatto per accedere ad altre risorse, imposta un attributo definito dall'utente nel flusso e utilizza il nome della risorsa Amazon (ARN) della risorsa a cui desideri accedere come valore per l'attributo.

Esempi Lambda

• Per fare riferimento al nome di un cliente da una ricerca della funzione Lambda, utilizzare $.External. AttributeKey, sostituendo AttributeKey con la chiave (o il nome) dell'attributo restituito dalla funzione Lambda.

• Per utilizzare un prompt Amazon Connect in una funzione Lambda, imposta un attributo definito dall'utente all'ARN per il prompt, quindi accedi a tale attributo dalla funzione Lambda.

Esempi di Amazon Lex

• Per fare riferimento a un attributo di un bot Amazon Lex, utilizza il formato $.Lex. e quindi includi la parte del bot Amazon Lex a cui fare riferimento, ad esempio $.Lex. IntentName.

• Per fare riferimento all'input del cliente in uno slot dell'Amazon Lex Bot, utilizza $.Lex.Slots.slotName, sostituendo slotName con il nome dello slot nel bot.

Cosa succede quando gli attributi superano i 32 KB

Gli attributi possono avere una dimensione massima di 32 KB, che è la dimensione massima della sezione degli attributi dei record di contatto. Quando gli attributi di un contatto superano i 32 KB, il contatto viene indirizzato lungo il ramo Error. Come mitigazione, prendete in considerazione le seguenti opzioni:

• Rimuovi gli attributi non necessari impostando i relativi valori su vuoti.

• Se gli attributi vengono utilizzati solo in un flusso e non è necessario fare riferimento all'esterno di tale flusso (ad esempio, da una Lambda o da un altro flusso), utilizza gli attributi di flusso. In questo modo non trasferisci inutilmente i 32 KB di informazioni da un flusso all'altro.

Consigli per la configurazione

• Quando utilizzi una chiave di destinazione definita dall'utente, puoi denominarla come preferisci ma non includere i caratteri $ e . (punto). Non sono consentiti perché vengono entrambi utilizzati nella definizione dei percorsi degli attributi in JSONPath.

• Puoi utilizzare il blocco Imposta attributo di contatto per impostare l'attributo della lingua richiesto per un bot Amazon Lex V2. (L'attributo della lingua in Amazon Connect deve corrispondere al modello linguistico utilizzato per creare il bot Amazon Lex V2.) L'immagine seguente mostra un attributo della lingua impostato su spagnolo.

  

  In alternativa, puoi utilizzare il blocco Set voice (Imposta voce) per impostare la lingua richiesta per un bot Amazon Lex V2.

Per ulteriori informazioni sull'utilizzo degli attributi di contatto, consulta Uso degli attributi di contatto di Amazon Connect.

Blocco configurato

L'immagine seguente mostra un esempio dell'aspetto del blocco quando viene configurato. Presenta due rami: Successo ed Errore.

Flussi di esempio

Amazon Connect include una serie di flussi di esempio. Per istruzioni che spiegano come accedere ai flussi di esempio nel designer del flusso, consulta Flussi di esempio. Di seguito sono riportati gli argomenti che descrivono i flussi di esempio che includono questo blocco.

• Flusso in entrata di esempio (esperienza primo contatto)

Scenari

Vedi questi argomenti per gli scenari che utilizzano questo blocco:

• Come fare riferimento agli attributi di contatti