GETRICHMESSAGE

Pasa el mensaje enriquecido JSON a la acción AskCaller action o a la acción TExtMsg action digital. Esto le permite utilizar plantillas de mensajes enriquecidos creadas en la página Punto de Contacto Digital en ACD en sus scripts en lugar de crear el JSON en el script.

Dependencias

• This action requires Digital Experience (DX).
• Before working with digital scripts, learn about the differences between traditional ACD scripts and digital scripts.
• Debe usarse con una de las siguientes acciones: AskCaller o TExtMsg.
• Colocar GETRICHMESSAGE antes AskCaller o TExtMsg en su script.

• El soporte para el tipo de contenido con mensajes enriquecidos varía por canal, según se muestra en el siguiente menú desplegable.

  Obtenga más información

  La siguiente tabla muestra los tipos de contenido enriquecido Elementos en la mensajería digital, como botones, imágenes, menús y selectores de opciones. disponibles para cada canal digital y si se pueden mostrar en la aplicación del agente o enviar en mensajes mediante integraciones de API (como por medio de agentes virtuales Una aplicación de software que maneja las interacciones del cliente en lugar de un agente humano en vivo.).

  Los canales que no aparecen en la lista actualmente no tienen soporte para contenido enriquecido. Si envía contenido enriquecido a contactos La persona que interactúa con un agente, IVR o bot en su centro de contacto. en esos canales, estos recibirán en su lugar el texto alternativo texto sin formato alternativo que se envía cuando el destino no admite contenido multimedia enriquecido. configurado.

  La forma en que configura el contenido enriquecido depende del tipo que desee enviar. Parte del contenido enriquecido se puede configurar en Rich Message Settings, mientras que otros tipos se pueden configurar en chat, email, Apple Messages for Business y WhatsApp. También puede trabajar con contenido de mensaje enriquecido en los Scripts de Studio.

  	Adaptive Cards	Imágenes	HTML y texto en Markdown	Enlace enriquecido
  Apple Messages for Business	Agentes en directo: No API: usos de texto alternativo	Live Agents: Sí API: Sí	Live Agents: No API: No	Live Agents: Yes API: Sí
  Digital Chat	Live Agents: No API: Sí	Live Agents: Yes API: Sí	Live Agents: No API: Sí	Live Agents: Yes API: Sí
  Correo electrónico	Agentes en directo: No API: Usa texto alternativo	Live Agents: Yes API: Sí	Live Agents: Yes API: Sí	Live Agents: Uses fallback text API: Usa texto alternativo
  Facebook Messenger	Agentes en directo: No API: Usa texto alternativo	Live Agents: Yes API: Sí	Live Agents: No API: No	Live Agents: Yes API: Sí
  WhatsApp	Agentes en directo: No API: usos de texto alternativo	Live Agents: Yes API: Sí	Live Agents: Yes API: Sí	Live Agents: Yes API: Sí
  SMS Messaging	Agentes en directo: No API: usos de texto alternativo	Live Agents: Yes API: Sí	Live Agents: No API: No	Live Agents: Uses fallback text API: Utiliza texto alternativo
  Mobile SDK	Live Agents: No API: No	Live Agents: Yes API: Sí	Live Agents: No API: No	Live Agents: Yes API: Sí

  Agentes en vivo: compatible con la aplicación de agente API: Compatible para casos de uso basados en API

  	Respuestas rápidas	Selector de lista	Selector de hora	Mensaje de Formulario
  Apple Messages for Business	Live Agents: Yes API: Sí	Live Agents: Yes API: Sí	Live Agents: Yes API: Sí	Live Agents: Yes API: Sí
  Digital Chat	Live Agents: Yes API: Sí	Live Agents: Yes API: Sí	Live Agents: Uses fallback text API: Usa texto alternativo	Live Agents: Uses fallback text API: Varía * La URL se abre en el navegador donde los contactos pueden llenar el formulario.
  Correo electrónico	Live Agents: Uses fallback text API: Utiliza texto alternativo	Live Agents: Uses fallback text API: usos de texto alternativo	Live Agents: Uses fallback text API: usos de texto alternativo	Live Agents: Uses fallback text API: usos de texto alternativo
  Facebook Messenger	Live Agents: Yes API: Sí	Live Agents: Yes API: Sí	Live Agents: Uses fallback text API: Utiliza texto alternativo	Live Agents: Uses fallback text API: Utiliza texto alternativo
  WhatsApp	Live Agents: Yes API: Sí	Live Agents: Yes API: Sí	Live Agents: Uses fallback text API: usos de texto alternativo	Live Agents: Uses fallback text API: usos de texto alternativo
  SMS Messaging	Live Agents: Uses fallback text API: Utiliza texto alternativo	Live Agents: Uses fallback text API: usos de texto alternativo	Live Agents: Uses fallback text API: Utiliza el texto alternativo	Live Agents: Uses fallback text API: usos de texto alternativo
  Mobile SDK	Live Agents: Yes API: Sí	Live Agents: Yes API: Sí	Live Agents: No API: No	Live Agents: No API: No

  Agentes en vivo: compatible con la aplicación de agente API: compatible con casos de uso basados en API

  La experiencia de conversación digital para los mensajes de formulario enviados por el agente virtual Una aplicación de software que maneja las interacciones del cliente en lugar de un agente humano en vivo. depende del proveedor de agente virtual que utilice. En ocasiones, el sistema envía una URL de alternativa. En otras ocasiones, el mensaje aparece como un formulario nativo en la interfaz de usuario del chat.

• Cree plantillas de mensajes enriquecidos para usar esta acción en la página de Punto de Contacto Digital en NiCE CXone. Puede crear plantillas para selectores de listas, selectores de tiempo, enlaces enriquecidos y respuestas rápidas. Si requiere utilizar otros medios enriquecidos, no puede utilizar GETRICHMESSAGE. En su lugar, debe construir 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 dichas acciones para más información.

Tipos de scripts 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 digital basado en chats. Puede desplegar contenido de mensajes enriquecidos Elementos en la mensajería digital, como botones, imágenes, menús y selectores de opciones..
• 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.

Las propiedad	Descripción
Caption	Ingrese 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. The default is the action name.
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.

Las propiedad	Descripción
resultSet	Preserva el JSON que devuelve NiCE CXone. Pasar el contenido de esta variable a Askcaller o TExtmsg como una cadena JSON.

Condiciones de la rama de resultados

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

Condición	Descripción
Default	Recorrido a menos que el script cumple una condición que requiere uno de los otros poderes. También se considera si no están definidas las demás ramas de la acción.
OnError	Ruta tomada cuando la acción no se ejecuta correctamente. Por ejemplo, cuando haya un problema inesperado como una mala conectividad, errores de sintaxis, etc. La variable _ERR, con un único carácter de subrayado, debe llenarse con una explicación condensada del problema.
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).

Se requiere de código de acción para el SNIPPET

Esta acción puede requerir una Snippet acción con código que manipula las plantillas de medios enriquecidos que devuelve la GETRICHMESSAGE acción a partir del punto de contacto digital. Si el punto de contacto únicamente tiene una plantilla, no requiere código para el snippet. Puede utilizar la variable que se especifica en la propiedad resultId . En el caso de los puntos de contacto que tienen más de una plantilla, necesita de código para el snippet.

1. Create a template on the Points of Contact Digital page in the ACD application and assign it to the point of contact punto de entrada que utiliza un contacto entrante para iniciar una interacción, como un número de teléfono o una dirección de correo electrónico. you want to use it with. You may need assistance from a NiCE CXone administrator to complete this step.

2. Create a script with the digital media type.

3. Add a GETRICHMESSAGE action and either an ASKCALLER action or a TeXTMSG action. If the point of contact has more than one template, you also need a SNIPPET action.
4. Configure the ChannelId property in GETRICHMESSAGE with the point of contact you assigned the template to.
5. Add the appropriate code to the SNIPPET action:

   • If you only have one template or if you only want to send one template with this script, use code such as:

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

   • If you have multiple templates and want to be able to send more than one with this script, use code such as:

     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. Change the index number that identifies the template you want to send. In the example code from the previous step, you would change the index numbers in the resultset.data[x] variable. Do not change the index in the variable you're assigning the template to. In the example code, the variable is jsonY.data[Z], and you could change Y but not Z. Each jsonY variable holds one template.
7. Modify the variable names if you want. If you do, change the variable names as needed in the other actions in the script. For example, resultSet is the default variable name in the resultSet property of GETRICHMESSAGe. The jsonY variables are used in the Message property of AskCaller and Textmsg.
8. Configure AskCaller or Textmsg: 
   1. Set the MessageFormat property to JSON.
   2. Configure Message with the name of the variable that holds the JSON of the template you're sending. It must be sent as a JSON string. You can use variable substitution in this field. If you do, add code to a Snippet to choose the template to send and pass the right variable on.
   3. Configure other properties of the actions as needed, including connecting the branches. Refer to the online help for the ASKCALLER action or TeXTMSG action.

Ejemplo de secuencia de comandos

Este ejemplo muestra la acción GETRICHMESSAGE conectada a una acción SNIPPET, que se conecta a TeXTMSG. También podría estar conectada a ASKCALLER. Cuando se ejecuta el script, GETRICHMESSAGE obtiene las plantillas de mensajes enriquecidos disponibles para el canal digtal especificado en channelId. Se almacenan en la variable especificada en la propiedad resultId. En este ejemplo, la variable es resultId. El código de snippet contiene un objeto dinámico de datos que almacenará una plantilla de mensaje enriquecido JSON y la transfiere a TeXTMSG.

Descargue este script.