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 des scripts numériques, découvrez les différences entre les ACD Scripts traditionnels 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

  Le tableau suivant indique 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. disponibles pour chaque canal numérique, et s'il peut être affiché dans l'application Agent ou envoyé dans des messages par des intégrations API (telles que par des 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 actuellement pas 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 à la place le texte DE repli Une solution de rechange en texte brut envoyée lorsque la destination ne prend pas en charge le contenu multimédia enrichi. configuré.

  La façon de configurer le contenu enrichi dépend du type que vous souhaitez envoyer. Certains contenus enrichis sont configurables dans Rich Message Settings, tandis que d'autres types sont configurables dans chat, email, Apple Messages for Business, et WhatsApp. Vous pouvez également travailler avec du contenu de Message enrichi dans les Scripts Studio.

  	Adaptive Cards	Images	Texte HTML & Markdown	Lien enrichi
  Apple Messages for Business	Agents actifs : Non API : Utilise le texte DE repli	Live Agents : Oui API : Oui	Live Agents: No API : Non	Live Agents: Yes API : Oui
  Digital Chat numérique	Live Agents: No API : Oui	Live Agents: Yes API : Oui	Live Agents: No API : Oui	Live Agents: Yes API : Oui
  Email	Agents actifs : Non API : Utilise un 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 actifs : non API : Utilise un texte DE repli	Live Agents: Yes API : Oui	Live Agents: No API : Non	Live Agents: Yes API : Oui
  WhatsApp	Agents actifs : 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 actifs : Non API : Utilise le texte DE repli	Live Agents: Yes API : Oui	Live Agents: No API : Non	Live Agents: Uses fallback text API : Utilise le 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 du 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
  Digital Chat	Live Agents: Yes API : Oui	Live Agents: Yes API : Oui	Live Agents: Uses fallback text API : Utilise le texte DE repli	Live Agents: Uses fallback text API : Varie * L'URL s'ouvre dans le navigateur où les contacts peuvent remplir le formulaire.
  Email	Live Agents: Uses fallback text API : Utilise le texte DE repli	Live Agents: Uses fallback text API : Utilise le texte DE repli	Live Agents: Uses fallback text API : Utilise le texte DE repli	Live Agents: Uses fallback text API : Utilise le texte DE repli
  Facebook Messenger	Live Agents: Yes API : Oui	Live Agents: Yes API : Oui	Live Agents: Uses fallback text API : Utilise le texte DE repli	Live Agents: Uses fallback text API : Utilise le texte DE repli
  WhatsApp	Live Agents: Yes API : Oui	Live Agents: Yes API : Oui	Live Agents: Uses fallback text API : Utilise le texte DE repli	Live Agents: Uses fallback text API : Utilise le texte DE repli
  SMS Messaging	Live Agents: Uses fallback text API : Utilise le texte DE repli	Live Agents: Uses fallback text API : Utilise le texte DE repli	Live Agents: Uses fallback text API : Utilise le texte DE repli	Live Agents: Uses fallback text API : Utilise le 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 du clavardage.

• Créez des modèles de messages enrichis pour utiliser cette action sur la page Points de contact numériques 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 é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

Digital

Comparaison d'actions similaires

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

• 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 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 dans les configurations du canal dans NiCE 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
Ajouter 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.
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 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	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.
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éer un modèle sur la page Points de contact Digital dans l'application ACD et affectez-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 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 action GETRICHMESSAGE action et soit une action ASKCALLER action soit une action TeXTMSG action. Si le point de contact a plus qu'un modèle, vous avez également besoin d'une action SNIPPET action.
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 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 le suivant :

     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é en tant que chaîne JSON. Vous pouvez utiliser la substitution de variable 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 les autres propriétés des actions selon les besoins, notamment pour connecter les branches. Reportez-vous à l'aide en ligne pour l'ASKCALLER action ou l'TeXTMSG action.

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é Result Set. 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.