GETRICHMESSAGE

Cette page d'aide concerne Desktop Studio. Ces informations sont également disponibles pour Studio.

Three shapes containing iconograhic representations of lists, imgs, and music files.

Transmet le JSON de message enrichi à l'action numérique AskCaller action ou TExtMsg action. Cela vous permet d'utiliser les modèles de messages enrichis créés sur la page Point of Contact Digital dans ACD dans vos scripts, au lieu de créer le JSON dans le script.

Dépendances

  • Cette action requiert Digital Experience (DX).
  • Avant de travailler avec des scripts numériques, découvrez les différences entre les scripts ACD traditionnels et les scripts numériques.
  • Doit être utilisé avec l'une des actions suivantes : AskCaller ou TExtMsg.
  • Placez GETRICHMESSAGE avant AskCaller ou TExtMsg dans votre script.
  • Le soutien du type de contenu de messagerie enrichie varie selon le canal.

  • Créer des modèles de messages enrichis à utiliser avec cette action sur la page Digital du Point de contact dans NiCE 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 médias enrichis, vous ne pouvez pas utiliser GETRICHMESSAGE. Au lieu de cela, vous devez créer le JSON dans une action Snippet et le transmettre directement à AskCaller ou TExtMsg. Consultez la section Dépendances dans l'aide en ligne de ces actions pour plus d'informations.

Types de scripts pris en charge

L'icône pour le type de script Digital - un moniteur d'ordinateur avec un smartphone à côté.

Digital

Comparaison d'Actions similaires

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

Propriétés de saisie

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

Propriété

Description

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. La valeur par défaut est le nom de l’action.

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 NiCE CXone. Transmettez le contenu de cette variable à Askcaller ou à TExtmsg en tant que chaîne JSON.

Conditions de la branche résultat

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

Par défaut

Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.

En cas d'Erreur

Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.

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 Action Extrait requis

Cette action peut nécessiter un Extrait action avec le code qui gère les modèles de média riche 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 plus que un modèle, vous avez besoin du code extrait.

  1. créer un modèle sur la page Points of Contact Digital dans l'application ACD et attribuez-le au point de contactClosed The entry point that an inbound contact uses to initiate an interaction, such as a phone number or email address. avec lequel vous souhaitez l'utiliser. Il se peut que vous ayez besoin de l’aide d’un administrateur NiCE CXone pour accomplir cette étape.

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

  3. Ajoutez une GETRICHMESSAGE action et soit une ASKCALLER action soit une TeXTMSG action. Si le point de contact a plus qu'un modèle, vous devez également ajouter une SNIPPET action.
  4. Configurez la propriété ChannelId dans GETRICHMESSAGE avec le point de contact auquel vous avez affecté le modèle.
  5. Add the appropriate code to the SNIPPET action:
    • Si vous n’avez qu’un seul modèle ou si vous souhaitez envoyer uniquement un seul modèle avec ce script, utilisez un code de ce type :

      DYNAMIC json1 
      ASSIGN json1.data[1] = resultset.data[1]
    • Si vous disposez de Multiple modèles et que vous souhaitez pouvoir en envoyer plus que un avec ce script, utilisez un code tel que :

      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 DE variable 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 dans la propriété resultSet de GETRICHMESSAGe. Les variables jsonY sont utilisées dans la propriété Message de AskCaller et Textmsg.
  8. Configure AskCaller or Textmsg: 
    1. Configurez la propriété MessageFormat avec la valeur JSON.
    2. Configurez Message avec le nom de la variable qui contient le JSON du modèle que vous envoyez. Il doit être envoyé sous forme de chaîne JSON. Vous pouvez utiliser la substitution de variable dans ce champ. Si vous le faites, ajoutez du code à un Extrait pour choisir le modèle à envoyer et transmettre la bonne variable.
    3. Configurez les autres propriétés des actions selon les besoins, notamment pour connecter les branches. Consultez l'aide en ligne pour l'action ASKCALLER ou l'action TeXTMSG.

Exemple de script

Cet exemple montre comment cette action peut être utilisée dans les scripts. Il ne s'agit pas d'un script complet. Des scripts supplémentaires peuvent être nécessaires.

Cet exemple montre l'action GETRICHMESSAGE connectée à une action SNIPPET, qui est elle-même connectée à TeXTMSG. Il pourrait également être connecté à 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. Elles sont stockées dans la variable spécifiée dans la propriété resultId. Dans cet exemple, la variable est resultId. Le code de l'Extrait contient un objet de données dynamiques qui contiendra un JSON spécifique de modèle de message enrichi et le transmettra à TeXTMSG.

Un exemple de script contenant les actions BEGIN, GETRICHMESSAGE, SNIPPET et TEXTMSG.

Télécharger ce script.