Attach custom conversation attributes to participant data in Architect

In the Architect workflow in Genesys Cloud, you can add custom interaction attributes to the customer participant data through the Set Participant Data action.

  1. Desde la página de inicio de Architect, haga clic o coloque el cursor sobre el Flujos menú y seleccione el tipo de flujo deseado.
  2. Cree un nuevo flujo o seleccione uno existente. Se abre la página de configuración del flujo.
  3. Seleccione la tarea y haga clic en Haga clic para abrir para abrir el editor de tareas.
  1. Desde la caja de herramientas del editor de tareas, expanda el Datos categoría y arrastre el Establecer datos del participante acción a la ubicación deseada en la secuencia de tareas. 
  2. En el formulario de diseño Establecer datos del participante, en el Nombre caja de texto escriba un nombre significativo para la acción. Este nombre se convierte en el nombre de la acción Establecer datos del participante en el flujo de trabajo de la tarea.
  3. In the Attribute Name 1 box, assign a string literal attribute name in the format, “conversationDetails.participantData.<attribute name>”. For example, “conversationDetails.participantData.Account Balance”.
  4. In the Value to Assign 1 box, assign a value to the attribute. You can specify the value type as an optional prefix to the value. For example, “number:1090.56”.
    Note: When retrieving values from dynamic data sources, define the optional prefix as a string literal and append it with the dynamic data expression. For more information, see Use string literals in expressions.

    The following value types are valid prefixes:
    Prefijo Value type Descripción Ejemplo
    checkbox Booleano Displays a read-only checkbox icon that is selected for ‘true’ and cleared for ‘false’ checkbox:true
    fecha Fecha Displays a date formatted based on locale date: 2025-3-12
    datetime Fecha Displays a date and time formatted based on locale datetime: 2025-04-15T10:30:00.000Z
    enum Cuerda Displays a string enum:example
    identifier Cuerda Displays a bold string identifier:example
    integer Número Displays an integer integer:4
    número Número Displays a number number:100.9
    longtext Cuerda Displays a string that is initially truncated to 100 characters and a Show More/Show Less toggle to view the whole string longtext:example long text
    tag Delimiter-separated string

    Displays a tag for each item in the list. Possible delimiters are:
    , ; |

    Note: The most occurring character is used as the delimiter.

    		 tag:a,b,c,d
    text Cuerda Displays a string text:example text
    url URL with either the HTTP or HTTPS protocol Displays a clickable URL that opens in a new tab or window url:https://example.com
  5. To add more attributes, click the Add attribute to retrieve button and repeat steps 6-7.
  6. Continúe construyendo la tarea según su diseño de flujo.

Nota: Los atributos distinguen entre mayúsculas y minúsculas. Si usa un atributo existente en otra parte del flujo, asegúrese de que coincida con las mayúsculas y minúsculas del atributo original.

Example flows with custom conversation attributes

Download these templates and import into your Genesys Cloud organization as you set up your custom conversation details on participant data.

To download a sample flow, complete the following steps:

  1. In the File column, click the .zip file for the desired flow.
  2. Extraiga el archivo .zip y guarde su contenido en un directorio local.
  3. Import the sample flow (.i3xxx or .yaml).

El comando Importar importa una configuración de flujo. La importación de un flujo no se fusionará con la configuración existente. Cuando importa un archivo de configuración de flujo a otro flujo, Architect sobrescribe cualquier configuración existente en el flujo original al realizar la importación. Para importar un flujo:

  1. Desde la página de inicio de Architect, haga clic o coloque el cursor sobre el Flujos menú y seleccione el tipo de flujo deseado.
  2. Haz una de las siguientes:
    • Crea un nuevo flujo.
    • Haga clic en el flujo que desea abrir. Cuando se abra la página de configuración del flujo, haga clic en Editar.
  3. Haga clic en la flecha al final de la Ahorrar menú y seleccione Importar. Se abre el cuadro de diálogo Importar un flujo.
  4. Haga clic en el Seleccione un archivo de configuración para importar enlace y navegue hasta el archivo de configuración .i3flow que desea importar.
  5. Haga clic en el Importar botón.
  6. Opcionalmente, modifique la configuración actual.
  7. Guarde el flujo.

Después de importar el flujo, modifíquelo para adaptarlo a su diseño en función de las necesidades de su organización.

Nota: Genesys Cloud ofrece la posibilidad de definir flujos Architect utilizando YAML. Para obtener más información sobre cómo importar los flujos .yaml de ejemplo de nuevo en Architect, consulte Definir flujos de Architect mediante YAML.

    Nombre Descripción Escribe Expediente
    Conversation Details In-Queue Call Flow

    A sample In-Queue Call flow that contains some custom conversation attributes added through Set Participant Data action.

    		 Architect In-Queue Call flow Conversation Details In-Queue Call Flow
    Conversation Details In-Queue Email Flow

    A sample In-Queue Email flow that contains some custom conversation attributes added through Set Participant Data action. 

    		 Architect In-Queue Email flow Conversation Details In-Queue Email Flow
    Conversation Details In-Queue Message Flow

    A sample In-Queue Message flow that contains some custom conversation attributes added through Set Participant Data action.

    		 Architect In-Queue Message flow Conversation Details In-Queue Message Flow