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é greetingPlayed et 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 l'API GetMetricData V2.

• 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 des enregistrements de 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 ne sont pas visibles par l'agent dans le CCP.

  • L'API GetContactAttributes ne peut 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 syntaxe JSON de chaque attribut, consultez Liste des attributs de contact disponibles et leur référence JSONPath.

• 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, comme un attribut externe, vous devez spécifier la syntaxe JSONPath associée à l'attribut.

• Pour utiliser les attributs de contact afin d'accéder à d'autres ressources, définissez un attribut défini par l'utilisateur dans votre flux et utilisez l'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 pour l'ARN de l'invite, puis accédez à cet attribut à partir de 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 l'entrée client dans un emplacement de bot Amazon Lex, utilisez $.Lex.Slots.slotName, en remplaçant slotName par le nom de l'option dans le bot.

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 dans JSONPath.

• 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