GETRICHMESSAGE

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 de contact numérique dans ACD dans vos scripts au lieu de construire le JSON dans le script.

Dépendances

• Cette action nécessite Digital Experience (DX).
• Avant de travailler avec les scripts numériques, renseignez-vous sur 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.

• La prise en charge du type de contenu de messagerie enrichie varie selon le canal, comme le montre la liste déroulante suivante.

  En savoir plus

  Le tableau suivant présente les types de contenu enrichi Éléments de la messagerie numérique tels que les boutons, les images, les menus et les sélecteurs d’Option. offerts pour chaque canal numérique, et indique s'il peut être affiché dans l'application agent ou envoyé dans des Messages par des intégrations API (comme par les agents virtuels Une application logicielle qui traite les interactions avec les clients à la place d’un agent humain en direct.).

  Les canaux qui ne sont pas répertoriés ne prennent pas encore en charge le contenu enrichi. Si vous envoyez du contenu enrichi à des contacts La personne qui interagit avec un agent, un SRVI ou un robot dans votre centre d’appels. sur ces canaux, ils reçoivent plutôt le texte de repli configuré.

  La façon de configurer le contenu enrichi dépend du type que vous souhaitez envoyer. Certains types de contenu enrichi sont configurables sous Paramètres des Messages enrichis, tandis que d'autres types sont configurables sous clavardage, courriel, Apple Messages for Business, et WhatsApp. Vous pouvez également utiliser le contenu de message enrichi dans les Scripts Studio.

  	Adaptive Cards	Images	Texte HTML & Markdown	Lien enrichi
  Apple Messages for Business	Agents de production : Non API : Utilise le texte de repli	Agents de production : Oui API : Oui	Live Agents: No API : Non	Live Agents: Yes API : Oui
  Clavardage Digital	Live Agents: No API : Oui	Live Agents: Yes API : Oui	Live Agents: No API : Oui	Live Agents: Yes API : Oui
  Courriel	Agents de production : Non API : Utilise le texte de repli	Live Agents: Yes API : Oui	Live Agents: Yes API : Oui	Live Agents: Uses fallback text API : Utilise le texte de repli
  Facebook Messenger	Agents en production : Non API : Utilise le texte de repli	Live Agents: Yes API : Oui	Live Agents: No API : Non	Live Agents: Yes API : Oui
  WhatsApp	Agents en production : Non API : Utilise le texte de repli	Live Agents: Yes API : Oui	Live Agents: Yes API : Oui	Live Agents: Yes API : Oui
  SMS Messaging	Agents en production : Non API : Utilise le texte de repli	Live Agents: Yes API : Oui	Live Agents: No API : Non	Live Agents: Uses fallback text API : Utilisations texte de repli
  Mobile SDK	Live Agents: No API : Non	Live Agents: Yes API : Oui	Live Agents: No API : Non	Live Agents: Yes API : Oui

  Agents en direct : pris en charge dans l'Application Agent API : Pris en charge pour les cas d'utilisation basés sur l'API

  	Réponses rapides	Sélecteur de liste	Sélecteur de temps	Message de formulaire
  Apple Messages for Business	Live Agents: Yes API : Oui	Live Agents: Yes API : Oui	Live Agents: Yes API : Oui	Live Agents: Yes API : Oui
  Clavardage Digital	Live Agents: Yes API : Oui	Live Agents: Yes API : Oui	Live Agents: Uses fallback text API : Utilisations texte de repli	Live Agents: Uses fallback text API : Varie * URL s'ouvre dans le navigateur où les contacts peuvent remplir le formulaire.
  Email	Live Agents: Uses fallback text API : Utilisations texte de repli	Live Agents: Uses fallback text API : Utilisations texte de repli	Live Agents: Uses fallback text API : Utilisations texte de repli	Live Agents: Uses fallback text API : Utilisations texte de repli
  Facebook Messenger	Live Agents: Yes API : Oui	Live Agents: Yes API : Oui	Live Agents: Uses fallback text API : Utilisations texte de repli	Live Agents: Uses fallback text API : Utilisations texte de repli
  WhatsApp	Live Agents: Yes API : Oui	Live Agents: Yes API : Oui	Live Agents: Uses fallback text API : Utilisations texte de repli	Live Agents: Uses fallback text API : Utilisations texte de repli
  SMS Messaging	Live Agents: Uses fallback text API : Utilisations texte de repli	Live Agents: Uses fallback text API : Utilisations texte de repli	Live Agents: Uses fallback text API : Utilisations texte de repli	Live Agents: Uses fallback text API : Utilisations texte de repli
  Mobile SDK	Live Agents: Yes API : Oui	Live Agents: Yes API : Oui	Live Agents: No API : Non	Live Agents: No API : Non

  Agents en direct: pris en charge dans l'Application Agent API: pris en charge pour les cas d'utilisation basés sur l'API

  * L'expérience de clavardage numérique pour les messages de formulaire envoyés par l'agent virtuel Une application logicielle qui traite les interactions avec les clients à la place d’un agent humain en direct. dépend du fournisseur d'agent virtuel que vous utilisez. Parfois, le système envoie une URL de repli. D'autres fois, le message apparaît comme un formulaire natif dans l'interface utilisateur de clavardage.

• Créez des modèles de messages enrichis à utiliser avec cette action sur la page Point d’accès numérique dans NiCE CXone. Vous pouvez créer des modèles pour les sélecteurs de liste, les sélecteurs de temps, les liens enrichis et les 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 passer directement à AskCaller ou TExtMsg. Pour plus d’informations, consultez la section Dépendances dans l’aide en ligne de ces actions.

Types de scripts pris en charge

Digital

Comparaison d’actions similaires

Les actions suivantes ont des fonctions semblables, mais avec quelques différences clés :

• AskCaller : Demande des informations à un contact sur un canal de clavardage numérique. Peut afficher le contenu des messages enrichis Éléments de la messagerie numérique tels que les boutons, les images, les menus et les sélecteurs d’Option..
• GetRichMessage : Récupère les modèles de messages enrichis à partir des configurations du canal dans NiCE CXone.
• Textmsg : Envoie un message textuel à un contact. Peut afficher le contenu des messages enrichis.

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
Ajouter une légende	Entrez une courte phrase qui identifie de façon unique cette action dans le script. La légende apparaît sur le canevas du script sous l’icône de l’action.
channelID	Sélectionnez le canal numérique utilisé par ce script pour envoyer des messages.

Propriétés de sortie

Ces propriétés contiennent des variables qui conservent 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 sous la forme d’une chaîne JSON.

Conditions de la branche de 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
Default	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.
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.
Réussite	Chemin emprunté si l’action se termine sans erreur et si les appels à l’API ou les retours de données ont été un succès (codes de réponse 2xx).

Code d’action SNIPPET requis

Cette action peut nécessiter une action Snippet avec un code qui gère les modèles de médias enrichis que l’action GETRICHMESSAGE renvoie du point d’accès numérique. Si le point d’accès n’a qu’un seul modèle, vous n’avez pas besoin d’extrait de code. Vous pouvez utiliser la variable spécifiée dans la propriété Result Set. Pour les points d’accès qui ont plus d’un modèle, vous avez besoin d’un extrait de code.

1. Créez un modèle sur la page Points of Contact Digital dans l'application ACD et attribuez-le au point de contact point d’entrée qu’un contact entrant utilise pour amorcer une interaction, comme un numéro de téléphone ou une adresse courriel. avec lequel vous voulez l'utiliser. Vous pourriez avoir besoin de l'aide d'un administrateur NiCE CXone pour terminer cette étape.

2. Créer un script avec le type de support numérique.

3. Ajoutez une action GETRICHMESSAGE ainsi qu'une action ASKCALLER ou une action TeXTMSG. Si le point de contact possède plus qu'un modèle, vous avez également besoin d'une action SNIPPET.
4. Configurez la propriété ChannelId dans GETRICHMESSAGE avec le point de contact auquel vous avez attribué le modèle.
5. Add the appropriate code to the SNIPPET action:

   • Si vous avez uniquement un modèle ou si vous voulez envoyer uniquement un modèle avec ce script, utilisez un code comme celui-ci :

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

   • Si vous avez plusieurs modèles et que vous voulez pouvoir en envoyer plus qu'un avec ce script, utilisez un code comme celui-ci :

     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 devriez modifier les numéros d'index dans la variable resultset.data[x]. Ne modifiez pas l'index dans la variable à laquelle vous attribuez le modèle. Dans l'exemple de code, la variable est jsonY.data[Z], et vous pourriez modifier Y mais pas Z. Chaque variable jsonY contient un modèle.
7. Modifiez les noms de variable si vous le souhaitez. Si vous le faites, modifiez les noms de variable au besoin dans les autres actions du script. 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. Définissez la propriété MessageFormat sur 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 variables dans ce champ. Si vous le faites, ajoutez du code à un Snippet pour choisir le modèle à envoyer et transmettre la bonne variable.
   3. Configurez d'autres propriétés pour les actions si nécessaire, y compris la connexion des branches. Consultez l'aide en ligne pour l'action ASKCALLER ou l'action TeXTMSG.

Exemple de script

Cet exemple montre l’action GETRICHMESSAGE connectée à une action SNIPPET, elle-même connectée à TeXTMSG. Elle pourrait également être connectée à ASKCALLER. Lorsque le script est exécuté, 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é Result Set. Dans cet exemple, la variable est resultId. Le code de l’extrait contient un objet de données dynamiques qui contiendra un modèle de message enrichi JSON spécifique et le transmettra à TeXTMSG.

Téléchargez ce script.