Schémas JSON pour Canaux numériques

Les schémas JSON définissent la structure des données JSON. Utilisez-les comme modèles pour ajouter du contenu aux messages que vous configurez sur votre Digital Experience (Digital) canaux. Ces schémas vous permettent d’ajouter du contenu multimédia enrichi aux messages. Les médias enrichis incluent des éléments tels que des sélecteurs de liste, des galeries et des menus.

Chaque canalFermé Un moyen pour les contacts d’interagir avec des agents ou des bots. Un canal peut être la voix, la messagerie électronique, le clavardage, les médias sociaux, etc. Digital Experience prend en charge différents types de médias enrichis. Chaque canal nécessite également un schéma différent pour le même contenu média enrichi. Par exemple, le schéma pour inclure une image dans le clavardage en direct Digital Experience est différent du schéma pour inclure une image dans d’autres canaux.

Actuellement, une documentation sur les schémas est disponible pour les canaux de clavardage numérique  (clavardage en direct et messagerie par clavardage) et Apple Messages for Business.

Schémas et Virtual Agent Hub

Les agents virtuelsFermé Une application logicielle qui traite les interactions avec les clients à la place d’un agent en chair et en os. prennent en charge certains canaux Digital Experience. Vous pouvez utiliser des schémas JSON pour les canaux pris en charge afin de configurer les messages que votre agent virtuel textuel doit envoyer aux contacts. Utilisez le schéma du canal avec lequel vous utilisez votre agent virtuel textuel.

Actuellement, les schémas suivants sont pris en charge pour une utilisation avec des agents virtuels :

Lorsque vous souhaitez utiliser du contenu média enrichi dans votre chatbotsFermé Une application logicielle qui traite les interactions avec les clients à la place d’un agent en chair et en os. pour Digital Experience canaux, vous devez ajouter le contenu au bot. Ajoutez-le dans la console de gestion du bot, pas dans le Studio script ou la Virtual Agent Hub application. Le contenu doit respecter le schéma JSON spécifique au canal avec lequel vous utilisez l’agent virtuel.

Regarder la NICE CXone démonstration sur l’utilisation des schémas JSON avec des chatbots (robot logiciel de clavardage). La démo montre l’ajout de contenu avec SmartAssist, Dialogflow etAmazon Lex V1.

Schémas dans les scripts Studio

Vous devez inclure dans votre script des schémas JSON pour les médias enrichis que vous souhaitez inclure dans les messages adressés aux contacts. Vous pouvez le faire de deux manières :

  • Codez en dur le JSON et assignez-le à une variable.
  • Construisez-le dans un objet dynamique dans une action Snippet.

Des exemples de ces deux approches sont présentés dans cette section. Le JSON dans ces exemples est un exemple pour le clavardage Digital Experience. D’autres exemples de clavardage Digital Experience sont disponibles.

L’exemple suivant montre du JSON assigné à une variable :

ASSIGN jsonbody = $"\{\"prompts\":[\{\"transcript\":\"Welcome!  Choose Sales or Support and an agent will be with you shortly.\"},\{\"mediaSpecificObject\":\{\"dfoMessage\":\{\"messageContent\":\{\"type\":\"PLUGIN\",\"payload\":\{\"postback\":\"\",\"elements\":[\{\"id\":\"Ek4tPy1h4\",\"type\":\"TEXT_AND_BUTTONS\",\"elements\":[\{\"id\":\"TID1\",\"type\":\"TEXT\",\"text\":\"Please select an option\"},\{\"id\":\"BID1\",\"type\":\"BUTTON\",\"text\":\"Sales\",\"postback\":\"payment-button-1\"},\{\"id\":\"BID2\",\"type\":\"BUTTON\",\"text\":\"Support\",\"postback\":\"payment-button-2\"}]}]}}}}}]}" 

L’exemple suivant montre le même JSON construit dans un objet dynamique dans une action Snippet  :

DYNAMIC json
json.prompts[1].transcript="Welcome!  Choose Sales or Support and an agent will be with you shortly."
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.type="PLUGIN"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.postback=""
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].id="Ek4tPy1h4"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].type="TEXT_AND_BUTTONS"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[1].id="TID1"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[1].type="TEXT"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[1].text="Please select an option"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[2].id="BID1"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[2].type="BUTTON"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[2].text="Sales"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[2].postback="payment-button-1"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[3].id="BID2"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[3].type="BUTTON"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[3].text="Support"
json.prompts[2].mediaSpecificObject.dfoMessage.messageContent.payload.elements[1].elements[3].postback="payment-button-2"
ASSIGN jsonBody="{json.asJSON()}"		

Vérifier JSON avec l’outil miroir

Vous pouvez vérifier le JSON multimédia enrichi avant de l’ajouter à vos scripts ou aux systèmes de fournisseurs tiers. L’outil miroir JSON est un outil basé sur un script qui est configuré pour fonctionner avec un canal basé sur le clavardage, tel que le clavardage en direct.

Grâce à cet outil, vous pouvez coller dans JSON et voir le résultat pour les contacts et les agents. Le script le traite et affiche le résultat dans la fenêtre de clavardage. Cela vous permet de tester votre JSON et de vous assurer qu’il est correct avant de l’ajouter à vos scripts ou à la console de votre agent virtuel ou de votre fournisseur de canaux numériques.