GETRICHMESSAGE

Pasa el JSON de mensaje enriquecido a la AskCaller acción digital o a la TExtMsg acción. Esto le permite usar plantillas de mensaje enriquecido creadas en la página Digital de Point of Contact en ACD en sus scripts en lugar de crear el JSON en el script.

Dependencias

• Esta acción requiere Digital Experience (DX).
• Antes de trabajar con scripts digitales, conozca las diferencias entre los scripts tradicionales de ACD y los scripts digitales.
• Debe utilizarse con una de las siguientes acciones: AskCaller o TExtMsg.
• Coloque GETRICHMESSAGE antes de AskCaller o TExtMsg en su script.

• El soporte para el tipo de contenido de mensajería enriquecida varía según el canal.

• Crear plantillas de mensaje enriquecido para usar con esta acción en la página Point of Contact Digital en NiCE CXone. Puede crear plantillas para selectores de listas, selectores de tiempo, enlaces enriquecidos y respuestas rápidas. Si necesita usar otro medio enriquecido, no puede usar GETRICHMESSAGE. Instead, you must compilar el JSON en una acción Snippet y pasarlo directamente a AskCaller o TExtMsg. Consulte la sección Dependencias en la ayuda en línea para esas acciones a fin de obtener más información.

Tipos de secuencias de comandos compatibles

Digital

Comparación de acciones similares

Las siguientes acciones tienen funciones similares, pero con algunas diferencias clave:

• AskCaller: Solicita información de un contacto en un canal basado en conversación digital. Puede desplegar contenido de mensajes enriquecidos Elements in digital messaging such as buttons, images, menus, and option pickers..
• GetRichMessage: Obtiene plantillas de mensajes enriquecidos de las configuraciones del canal en NiCE CXone.
• Textmsg: Envía un mensaje de texto a un contacto. Puede mostrar contenido de mensajes enriquecidos.

Propiedades de entrada

Estas propiedades definen los datos que utiliza la acción al ejecutarse.

Propiedad	Descripción
Caption	Introduzca una frase corta que identifique de forma única esta acción en el script. La leyenda aparece en el lienzo del script debajo del ícono de acción. El valor predeterminado es el nombre de acción.
channelID	Seleccione el canal digital que use este script para enviar mensajes.

Propiedades de salida

Estas propiedades contienen variables que incluyen datos que se evuelven al ejecutar la acción. Están disponibles como referencia y para usarse cuando se completa la acción.

Propiedad	Descripción
resultSet	Preserva el JSON que devuelve NiCE CXone. Pase el contenido de esta variable a Askcaller o TExtmsg como un cadena JSON.

Condiciones de la rama de resultado

Las condiciones de las ramas de resultado le permiten crear ramas en su script para manejar diferentes resultados cuando se ejecuta una acción.

Condición	Descripción
Por defecto	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.
OnError	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	Ruta que se toma si la acción finaliza sin errores y cualquier llamada API o devolución de datos se realiza correctamente (códigos de respuesta 2xx).

Código de Acción SNIPPET requerido

This action may require a Snippet action with code that handles the rich media templates that the GETRICHMESSAGE action returns from the digital point of contact. If the point of contact only has one template, you don't need snippet code. You can use the variable specified in the resultId property. For points of contact that have more than one template, you need snippet code.

1. Crear una plantilla en la página Points of Contact Digital de la aplicación ACD y asígnela al punto de contacto The entry point that an inbound contact uses to initiate an interaction, such as a phone number or email address. con el que desea usarla. Puede requerir ayuda de un administrador NiCE CXone para concluir este paso.

2. Crear un script con el tipo de medio digital.

3. Agregue una GETRICHMESSAGE acción y, o bien una ASKCALLER acción o una TeXTMSG acción. Si el punto de contacto tiene más de una plantilla, también necesita una SNIPPET acción.
4. Configure la propiedad ChannelId en GETRICHMESSAGE con el punto de contacto al que asignó la plantilla.
5. Add the appropriate code to the SNIPPET action:

   • Si usted tiene únicamente una plantilla o si únicamente quiere enviar una plantilla con este script, use código como:

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

   • Si tiene múltiples plantillas y desea poder enviar más que una con este script, utilice un código como el siguiente:

     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. Cambie el número de índice que identifica la plantilla que desee enviar. En el código de ejemplo del paso previo, puede cambiar los números de índice en la variable resultset.data[x]. No cambie el índice en la variable a la que le está asignando la plantilla. En el código de ejemplo, la variable es jsonY.data[Z], y podría cambiar Y pero no Z. Cada variable jsonY almacena una plantilla-
7. Modifique los nombres DE variable si lo desea. Si lo hace, cambie los nombres DE variable según sea necesario en las demás acciones del script. Por ejemplo, resultSet es el nombre DE variable predeterminado en la propiedad resultSet de GETRICHMESSAGe. Las variables jsonY se usan en la propiedad Mensaje de AskCaller y Textmsg.
8. Configure AskCaller or Textmsg: 
   1. Defina la propiedad MessageFormat a JSON.
   2. Configure Mensaje con el nombre de la variable que contiene el JSON de la plantilla que está enviando. Debe enviarse como una cadena JSON. Puede utilizar la sustitución de variables en este campo. Si lo hace, agregue código a un Snippet para elegir la plantilla que se enviará y pasar la variable correcta.
   3. Configure las demás propiedades de las acciones según sea necesario, incluida la conexión de las ramas. Consulte la ayuda en línea de la acción ASKCALLER o la acción TeXTMSG.

Ejemplo de Script

Este ejemplo muestra la acción GETRICHMESSAGE conectada a una acción SNIPPET, la cual está conectada a TeXTMSG. Esto también podría estar conectado a ASKCALLER. Cuando se ejecuta el script, GETRICHMESSAGE recupera las plantillas de mensaje enriquecido disponibles para el canal digital especificado en channelId. Se almacenan en la variable especificada en la propiedad resultId. En este ejemplo, la variable es resultId. El código del snippet contiene un objeto de datos dinámicos que contendrá un JSON de plantilla de mensaje enriquecido específico y lo pasará a TeXTMSG.

Descargar este script.