Resumen de los factores desencadenantes

Un disparador es un recurso dentro de Genesys Cloud que permite a los clientes configurar una reacción a eventos específicos que ocurren dentro de Genesys Cloud. Las acciones son flujos de trabajo que puede crear a través de Architect. Para obtener más información sobre cómo crear flujos de trabajo, consulte Acerca de Architect.

Un activador incluye tres componentes principales:

  • Nombre del tema: El tema o el evento para el que desea invocar una acción.
  • Destino del flujo de trabajo: La acción a tomar en los eventos coincidentes.
  • Condiciones: Los criterios que debe cumplir un suceso para que se actúe sobre él.

Nombre del tema

Los nuevos temas se actualizan periódicamente y los temas pueden variar en función de su organización.

  • v2.users.{id}.activity
  • v2.detail.events.conversation.{id}.acd.end
  • v2.detail.events.conversation.{id}.acd.start
  • v2.detail.events.conversation.{id}.acw
  • v2.detail.events.conversation.{id}.wrapup
  • v2.detail.events.conversation.{id}.attributes
  • v2.detail.events.conversation.{id}.customer.end
  • v2.detail.events.conversation.{id}.customer.start
  • v2.detail.events.conversation.{id}.outbound
  • v2.detail.events.conversation.{id}.user.end
  • v2.detail.events.conversation.{id}.user.start
  • v2.detail.events.conversation.{id}.voicemail.end
  • v2.detail.events.conversation.{id}.voicemail.start
  • v2.outbound.email.campaigns.contact.preContact
  • v2.outbound.email.campaigns.contact.postContact
  • v2.outbound.messaging.campaigns.contact.preContact
  • v2.outbound.messaging.campaigns.contact.postContact
  • v2.outbound.whatsapp.campaigns.contact.preContact
  • v2.outbound.whatsapp.campaigns.contact.postContact
  • v2.quality.evaluations
  • v2.operations.events.{id}
  • v2.detail.events.collaboratechat.adhoc.{id}.messages
  • v2.detail.events.collaboratechat.group.{id}.messages
  • v2.workforcemanagement.managementunits.{id}.adherence
  • v2.workforcemanagement.teams.{id}.adherence
  • v2.users.{id}.wem.coaching.notification
  • v2.users.{id}.wem.learning.assignment
  • v2.users.{id}.workforcemanagement.adherence
  • v2.users.{id}.workforcemanagement.schedules
  • v2.users.{id}.workforcemanagement.notifications
  • v2.users.{id}.workforcemanagement.timeoffrequests
  • v2.users.{id}.integrationpresence
  • v2.users.{id}.integrations.calendar.teams
  • v2.speechandtextanalytics.conversation.{id}.topics
  • v2.speechandtextanalytics.conversation.{id}.sentiment
  • v2.speechandtextanalytics.conversation.{id}.empathy

Al seleccionar el tema en la vista de activación, se muestra el esquema de eventos del tema como referencia. Puede obtener una lista de los temas disponibles para su organización mediante una solicitud GET. Para obtener más información, consulte API de automatización de procesos y Temas disponibles.

Objetivo del flujo de trabajo

Los administradores crean flujos de trabajo en Architect. En la vista de activación, sólo puede seleccionar flujos de trabajo activos y publicados como destino del flujo de trabajo. El formato de datos en el que se envían los parámetros de entrada al flujo de trabajo puede ser campos primitivos de nivel superior o JSON.

  • Las primitivas de nivel superior, como cadenas, enums, números y booleanos se envían al flujo de trabajo.
  • Para el formato de datos JSON, el evento completo se envía al flujo de trabajo como un objeto JSON. Configure tel flujo de trabajo con una variable de entrada llamada jsonData de tipo JSON.
Nota: Los atributos de flujo de trabajo en Architect distinguen entre mayúsculas y minúsculas. Cuando haga referencia a un atributo en el flujo de trabajo, asegúrese de utilizar la misma letra que aparece en el esquema del evento.

Para obtener más información sobre los flujos de trabajo, consulte Trabajar con flujos de trabajo.

Condiciones

Nota: Cuando no se establece ninguna condición, el disparador invoca el flujo de trabajo por defecto. Asegúrese de respetar los límites de invocación de si desea aprovechar este comportamiento.

Las condiciones son la lista de criterios bajo los cuales el disparador invoca el objetivo del flujo de trabajo. La expresión de la condición incluye tres partes:

  • Ruta JSON: Define la parte del evento a comparar. Exprese la condición utilizando JSONPath, el lenguaje utilizado para recorrer y analizar documentos JSON para encontrar elementos específicos. También puede utilizar el Jayway JsonPath Evaluator o la herramienta de utilidad de prueba JSONPath para comprobar la respuesta de su carga útil JSON y las declaraciones JSONPath.
  • Operador: Define el tipo de comparación utilizado para comparar la salida de la ruta JSON con el valor. Las comparaciones de cadenas distinguen entre mayúsculas y minúsculas.En la vista de activación, para ver una descripción de la lista de operadores, haga clic en Ver ayuda sobre operadores de filtro.
  • Valor: Valor o valores definidos por el usuario para las operaciones que toman un único valor o una lista de valores. El valor de entrada puede ser una cadena, un número o un valor booleano. En función de la selección del operador, el tipo de entrada del valor cambia en consecuencia. El tipo de entrada del valor garantiza la precisión de la comparación.
    Operador Tipo de entrada
    MayorQueIgual Número
    LessThanOrEqual Número
    Igual

    Objeto
    NotEqual

    Objeto
    Menos que

    Número
    GreaterThan

    Número
    En

    Conjunto de objetos
    NoEn

    Conjunto de objetos
    Contiene

    Objeto
    Todos

    Matriz de objetos
    Existe

    Booleano
    Talla

    Número
    Nota: Un desencadenante puede tener hasta 10 condiciones, todas las cuales deben cumplirse para iniciar el flujo de trabajo. Para invocar un flujo de trabajo cuando cualquiera de las diversas condiciones es verdadera (lógica OR), debe crear varios activadores, cada uno con su propio conjunto de condiciones.

Configuración de temporización

Por ejemplo, si hay un retraso en el procesamiento del desencadenante para un flujo de trabajo de cambio de estado, entonces no es relevante ejecutar el flujo de trabajo después del tiempo establecido.

Límites del campo de configuración del activador

Cuando se configura un activador en Genesys Cloud, se aplican los siguientes límites:

  • Nombre del activador - Longitud máxima 162 caracteres
  • Condiciones:
    • Ruta JSON - Longitud máxima 500 caracteres
    • Valor - Longitud máxima de 512 caracteres para un único valor
    • Lista de valores
      • Número de entradas - Máximo 740 valores
      • Longitud de cada entrada - Máximo 2440 caracteres

A continuación, aprenda a crear un disparador.