Bloc de flux : Définir des attributs de contact

Description

Stocke les paires clé-valeur en tant qu'attributs de contact. Vous définissez une valeur qui sera référencée ultérieurement dans un flux.

Par exemple, créez un message d'accueil personnalisé pour les clients acheminés vers une file d'attente selon le type de compte client. Vous pouvez également définir un attribut pour un nom de société ou un secteur d'activité à inclure dans les chaînes de synthèse vocale énoncées à un client.

Le bloc Définir des attributs de contact permet, par exemple, de copier des attributs récupérés depuis des sources externes vers des attributs définis par l'utilisateur.

Pour plus d'informations sur les attributs de contact, consultez Utilisation des attributs de contact Amazon Connect.

Canaux pris en charge

Le tableau suivant indique comment ce bloc achemine un contact qui utilise le canal spécifié.

Canal	Pris en charge ?
Voix	Oui
Chat	Oui
Tâche	Oui

Types de flux

Vous pouvez utiliser ce bloc dans les types de flux suivants :

• Tous les flux

Propriétés

L'image suivante illustre la page Propriétés du bloc Définir des attributs de contact. Il est configuré pour définir un attribut défini par l'utilisateur sur le contact actuel avec la clé greetingPlayedet la valeur true.

Vous pouvez choisir de définir des attributs sur :

• Contact actuel : les attributs sont définis sur le contact sur lequel ce flux s'exécute. Les attributs sont accessibles par d'autres zones d'Amazon Connect, telles que d'autres flux, modules, Lambdas, enregistrements de contacts et le GetMetricData V2API.

• Contact associé : les attributs sont associés à un nouveau contact qui contient une copie des propriétés du contact d'origine.

  Dans le dossier de contact, il s'agit du RelatedContactId.

• Flux : les attributs de flux sont limités au flux dans lequel ils sont configurés.

  Ils sont utiles lorsque vous ne souhaitez pas conserver les données tout au long du contact, par exemple lorsque vous devez utiliser des informations sensibles telles que le numéro de carte de crédit du client pour effectuer une analyse des données Lambda.

  • Les attributs de flux sont des variables temporaires stockées localement et utilisées uniquement dans le flux. Ils ne sont visibles nulle part en dehors du flux, même lorsque le contact est transféré vers un autre flux.

  • Ils peuvent atteindre 32 Ko (taille maximale de la section des attributs de l'enregistrement des contacts).

  • Ils ne sont transmis à une fonction Lambda que s'ils sont explicitement configurés en tant que paramètres : dans le bloc Appeler une fonction AWS Lambda, choisissez Ajouter un paramètre.

  • Ils ne sont pas transmis aux modules. Vous pouvez définir un attribut de flux dans un module, mais il ne sera pas transmis en dehors du module.

  • Ils ne figurent pas dans l'enregistrement des contacts.

  • Ils n'apparaissent pas aux yeux de l'agent dans leCCP.

  • Ils ne GetContactAttributes API peuvent pas les exposer.

  • Si la journalisation est activée dans le flux, la clé et la valeur apparaissent dans le journal Cloudwatch.

Comment référencer des attributs

• Pour connaître la JSON syntaxe de chaque attribut, consultezListe des attributs de contact disponibles et leur JSONPath référence.

• Pour référencer des attributs dont le nom contient des caractères spéciaux, tels que des espaces, placez le nom de l'attribut entre crochets et guillemets simples. Par exemple : $.Attributes.['user attribute name'].

• Pour référencer des attributs dans le même espace de noms, comme un attribut système, vous devez utiliser le nom de l'attribut ou le nom que vous avez spécifié comme Clé de destination.

• Pour référencer des valeurs dans un espace de noms différent, par exemple pour référencer un attribut externe, vous devez spécifier la JSONPath syntaxe de l'attribut.

• Pour utiliser les attributs de contact pour accéder à d'autres ressources, définissez un attribut défini par l'utilisateur dans votre flux et utilisez le Amazon Resource Name (ARN) de la ressource à laquelle vous souhaitez accéder comme valeur de l'attribut.

Exemples Lambda

• Pour référencer le nom d'un client à partir d'une recherche de fonction Lambda, utilisez $.External. AttributeKey, en AttributeKey remplaçant par la clé (ou le nom) de l'attribut renvoyé par la fonction Lambda.

• Pour utiliser une invite Amazon Connect dans une fonction Lambda, définissez un attribut défini par l'utilisateur sur le correspondant à l'invite, puis accédez à cet attribut ARN depuis la fonction Lambda.

Exemples Amazon Lex

• Pour référencer un attribut d'un bot Amazon Lex, vous utilisez le format $.Lex., puis vous incluez la partie du bot Amazon Lex à référencer, telle que $.Lex. IntentName.

• Pour référencer les entrées du client à un emplacement de bot Amazon Lex, utilisez $.Lex.Slots. slotName, en le slotNameremplaçant par le nom de l'emplacement dans le bot.

Que se passe-t-il lorsque les attributs dépassent 32 Ko

Les attributs peuvent atteindre 32 Ko, ce qui correspond à la taille maximale de la section des attributs des enregistrements de contacts. Lorsque les attributs d'un contact dépassent 32 Ko, le contact est acheminé vers le bas de la branche Error. À titre d'atténuation, considérez les options suivantes :

• Supprimez les attributs inutiles en définissant leurs valeurs sur vides.

• Si les attributs ne sont utilisés que dans un flux et qu'il n'est pas nécessaire d'y faire référence en dehors de ce flux (par exemple, par un Lambda ou un autre flux), utilisez les attributs de flux. De cette façon, vous ne faites pas inutilement perdurer les 32 Ko d'informations d'un flux à l'autre.

Conseils de configuration

• Lorsque vous utilisez une clé de destination définie par l'utilisateur, vous pouvez lui donner le nom que vous voulez, mais n'incluez pas les caractères $ et . (point). Ils ne sont pas autorisés car ils sont tous deux utilisés pour définir les chemins d'attributs dansJSONPath.

• Vous pouvez utiliser le bloc Définir l'attribut de contact pour définir l'attribut de langue requis pour un bot Amazon Lex V2. (Votre attribut de langue dans Amazon Connect doit correspondre au modèle de langage utilisé pour créer votre bot Amazon Lex V2.) L'image suivante montre un attribut de langue défini sur Espagnol.

  

  Vous pouvez également utiliser le bloc Définir la voix pour définir l'attribut de langue requis pour un bot Amazon Lex V2.

Pour de plus amples informations sur l'utilisation des attributs de contact, veuillez consulter Utilisation des attributs de contact Amazon Connect.

Bloc configuré

L'image suivante montre un exemple de ce à quoi ressemble ce bloc lorsqu'il est configuré. Il comporte deux branches : Réussite et Erreur.

Exemples de flux

Amazon Connect inclut un ensemble d'exemples de flux. Pour obtenir des instructions expliquant comment accéder aux exemples de flux dans le concepteur de flux, consultez Exemples de flux. Les rubriques suivantes décrivent les exemples de flux qui incluent ce bloc.

• Exemple de flux entrant (expérience de premier contact)

Scénarios

Consultez les rubriques suivantes pour voir des scénarios qui utilisent ce bloc :

• Comment référencer les attributs de contact