GETRICHMESSAGE

Transmet le JSON de message enrichi à l’action AskCaller numérique ou à l’action TExtMsg.  Vous pouvez ainsi utiliser dans vos scripts les modèles de messages enrichis créés sur la page Point de contact numérique dans ACD, au lieu de concevoir le JSON dans le script.

Dépendances

• Cette action requiert Digital Experience.
• Avant d’utiliser des scripts numériques, découvrez les différences entre les scripts ACD classiques et les scripts numériques.
• Doit être utilisée avec l’une des actions suivantes : AskCaller ou TExtMsg.
• Placez GETRICHMESSAGE avant AskCaller ou TExtMsg dans votre script.

• La prise en charge des types de contenu de messages enrichis varie en fonction du canal, comme le montre la section déroulante ci-dessous.

  En savoir plus

• Créez des modèles de messages enrichis pour utiliser cette action sur la page Points de contact numériques dans CXone. Vous pouvez créer des modèles pour des sélecteurs de listes, des sélecteurs d’heure, des liens enrichis et des réponses rapides. Si vous devez utiliser d’autres éléments multimédias enrichis, vous ne pouvez pas utiliser GETRICHMESSAGE. À la plave, vous devez concevoir le JSON dans une action Snippet et le transmettre directement à AskCaller ou TExtMsg. Pour plus d’informations, reportez-vous à la section Dépendances dans l’aide en ligne pour ces actions.

Types de scripts pris en charge

Digital

Comparaison d'actions similaires

Les actions suivantes ont des fonctions similaires, mais présentent quelques différences essentielles :

• AskCaller : demande des informations relatives au contact sur un canal numérique de type chat. Peut afficher du contenu de message enrichi Éléments de messagerie numérique, tels que des boutons, des images, des menus et des sélecteurs d’options..
• GetRichMessage : récupère les modèles de messages enrichis dans les configurations du canal dans CXone.
• Textmsg : envoie un message texte à un contact. Peut afficher du contenu de message enrichi.

Propriétés d'entrée

Ces propriétés définissent les données que l'action utilise lors de son exécution.

Propriété	Description
une légende	Entrez une courte phrase qui identifie cette action dans le script de manière unique. La légende est affichée sur le canevas de script sous l’icône de l’action. The default is the action name.
channelID	Sélectionne le canal numérique utilisé par le script pour envoyer les messages.

Propriétés de sortie

Ces propriétés contiennent des variables qui stockent les données renvoyées par l'exécution de l'action. Elles sont disponibles à des fins de référence et d’utilisation lorsque l'action est terminée.

Propriété	Description
resultSet	Contient le JSON renvoyé par CXone. Transmettez le contenu de cette variable à Askcaller ou TExtmsg sous forme de chaîne JSON.

Conditions de branche résultantes

Les conditions de branche de résultat vous permettent de créer des branches dans votre script afin de gérer différents résultats lors de l'exécution d'une action.

Condition	Description
Default	Chemin parcouru sauf si le script remplit une condition qui l'oblige à emprunter l'une des autres branches. Il est également suivi si les autres branches de l’action ne sont pas définies.
OnError	Chemin emprunté lorsque l'action ne s'exécute pas correctement. Par exemple, en cas de problème inattendu, comme une mauvaise connectivité, des erreurs de syntaxe, etc. La variable _ERR, avec un caractère de soulignement simple, doit contenir une explication condensée du problème.
OnSucess	Chemin emprunté si l’action se termine sans erreur et si tous les appels d’API ou retours de données ont abouti (codes de réponse 2xx).

Code d'action SNIPPET requis

Cette action peut nécessiter une action action Snippet avec du code qui traite les modèles de médias enrichis renvoyés par l’action GETRICHMESSAGE à partir du point de contact numérique. Si le point de contact n’a qu’un seul modèle, le code snippet est inutile. Vous pouvez utiliser la variable spécifiée dans la propriété resultId. Pour les points de contact qui ont plusieurs modèles, vous avez besoin du code snippet.

1. Créez un modèle sur la page Points de contact numériques dans l’ACD application et assignez-le au point de contact avec lequel vous souhaitez l’utiliser. Il se peut que vous ayez besoin de l’aide d’un administrateur CXone pour accomplir cette étape.

2. Créez un script utilisant le type de média numérique.

3. Ajoutez une action GETRICHMESSAGE, ainsi qu’une action ASKCALLER ou une action TeXTMSG. Si le point de contact a plusieurs modèles, vous avez également besoin d’une action SNIPPET.
4. Configurez la propriété ChannelId dans GETRICHMESSAGE avec le point de contact auquel vous avez assigné le modèle.
5. Ajoutez la ligne de code appropriée à l’action SNIPPET :

   • Si vous n’avez qu’un seul modèle ou souhaitez envoyer un seul modèle avec ce script, utilisez un code de ce type :

     DYNAMIC json1 
     ASSIGN json1.data[1] = resultset.data[1]

   • Si vous avez plusieurs modèles et souhaitez avoir la possibilité d’en envoyer plusieurs avec ce script, utilisez un code de ce type :

     DYNAMIC json1
     DYNAMIC json2
     DYNAMIC json3
     				 
     ASSIGN json1.data[1] = resultset.data[1]
     ASSIGN json2.data[1] = resultset.data[2]
     ASSIGN json3.data[1] = resultset.data[3]

6. Modifiez le numéro d’index qui identifie le modèle que vous voulez envoyer. Dans l’exemple de code de l’étape précédente, vous changeriez les numéros d’index dans la variable resultset.data[x]. Ne modifiez pas l’index dans la variable à laquelle vous assignez le modèle. Dans l’exemple de code, il s’agit de la variablejsonY.data[Z] ; vous pourriez modifier Y, mais pas Z. Chaque variable jsonY contient un seul modèle.
7. Modifiez les noms des variables si vous le souhaitez. Dans ce cas, modifiez-les dans les autres actions du script, au besoin. Par exemple, resultSet est le nom de variable par défaut de la propriété resultSetde GETRICHMESSAGe. Les variables jsonY sont utilisées dans la propriété Message de AskCaller et Textmsg.
8. Configurez AskCaller ou Textmsg :
   1. Configurez la propriété MessageFormat avec la valeur JSON.
   2. Configurez Message avec le nom de la variable contenant le JSON du modèle que vous envoyez. Il doit être envoyé sous forme de chaîne JSON. Vous pouvez utiliser la substitution de variables dans ce champ. Dans ce cas, ajoutez du code à un Snippet pour choisir le modèle à envoyer et transmettre la variable appropriée.
   3. Configurez les autres propriétés des actions selon les besoins, notamment pour connecter les branches. Reportez-vous à l’aide en ligne de l’action ASKCALLER ou de l’action TeXTMSG.

Exemple de script

Cet exemple montre que l’action GETRICHMESSAGE connectée à une action SNIPPET, laquelle est connectée à TeXTMSG. Elle pourrait également être connectée à ASKCALLER. Lorsque le script s’exécute, GETRICHMESSAGE récupère les modèles de messages enrichis disponibles pour le canal numérique spécifié dans channelId. Ils sont stockés dans la variable spécifiée dans la propriété resultId. Dans cet exemple, la variable est resultId. Le code snippet contient un objet de données dynamiques dans lequel se trouvera le JSON du modèle de message enrichi et qui le transmettra à TeXTMSG.

Télécharger ce script.