GETRICHMESSAGE

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

Un phylactère avec des lignes à l'intérieur et une flèche pointant vers le bas.

Transmet un message JSON enrichi à l'action numérique AskCaller action ou TExtMsg action. Cela vous permet d'utiliser des 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.
  • Avant de travailler avec des scripts digital, apprenez-en plus sur les différences entre les scripts ACD traditionnels et les scripts digital.
  • 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.

  • Créez des modèles de messages enrichis pour utiliser cette action sur la page Points de contact numériques dans CXone Mpower. 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. Au lieu de cela, vous devez créer 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

Numérique

Comparaison d'actions similaires

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

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

Add Caption

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.

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 Mpower. 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.

Erreur

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.

Succès

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é Result Set. 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 contactFermé 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 CXone Mpower 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’ASKCALLERaction  ou de l’TeXTMSGaction .