Applications

Go to the Applications page to manage your applications. From here, you can create new applications and make changes to existing ones.

Creating a new application

To create a new application, click Add Application. Enter a Name and select a Type:

• Default

  Select this type to create an application that supports Interactive Voice Response (IVR) and voice call routing. If you enable omnichannel support, it can also support chat interactions.

• Digital

  Select this type if the application is only going to handle digital interactions, such as chat and/or email (no voice calls).

• Callback

  Select this type if the application is only going to be used for outbound callbacks.

Click Create to save it and go back to the Applications page. Or, click Create and Open to save the application and open it for editing.

Viewing application properties

From the Applications list, click an empty spot in an application's row to display its properties on the right-hand side (if you click the application name, it will open for viewing or editing):

Edit the application name, description, or tags

Click the pencil icon to open the editing view.

From the editing view, you can change the application name, description, or manage the tags associated with the application.

Tip

You can also view or make changes to the application name and description by clicking the application name when its flow is open for editing.

Change the status of an application stream

Use the sliders to change the status of an application stream to enabled or disabled.

To enable:

To disable:

Clone an application

Click Clone application to create a new application that is an exact copy of the selected application. Save the clone with a unique name and then manage it like any other application. This can be useful when you want to use the same structure as the selected application, but need to specify different settings or resources.

Export an application

Click Export application to export an application and its associated dependencies (such as media files, speech grammars, business hours, data tables, emergency flags, and special days) into a single archive file (*.dar) that you can then import into another Designer workspace.

Important

Digital Applications

• Exported digital applications that include message resources with references to standard responses will need new IDs assigned to those resources if they are imported into a new Designer workspace.

Tip

Safari users: If you are using Safari to export an application or module, the exported file is downloaded as unknown. The file is valid and can be imported successfully, but you might want to rename it to something more meaningful.

Manage Builds

Click Manage Builds to manage the application builds that are available for the application.

All builds are initially enabled by default.

To disable a build, deselect it. After a build is disabled, you can click the trash icon to delete it.

If your user role has the required permissions, you can click View build to open the build in read-only mode. This can be useful when you want to review or compare the flows of different builds.

For more information about builds, see Application builds.

Manage Phone Numbers

Click Manage in the Phone Number column to select and assign a phone number(s) to the application. When you are finished, click OK.

• You cannot assign a phone number to IVR type applications.
• You cannot assign a phone number to an application that has not been published at least once.
• To assign a large list of phone numbers, you can use the Batch Assign option.
• If you are moving phone numbers from one application to another, you can use the Transfer from Others option.

Tip

If you see a warning symbol beside a phone number that is assigned to your application, it might indicate that the phone number was not assigned by Designer or the application was updated but the changes were not published. The warning only indicates there is a possible problem with the phone number, not whether it is functional. You can ignore the warning if you are certain the phone number is functional. Otherwise, contact your Genesys representative.

Batch Assign

Let's say you have a large list of phone numbers that you want to assign to the application. With Batch Assign, you can copy and paste the phone numbers into a form and assign them in a single operation.

Here's how it works:

Input Numbers

Click Batch Assign and add the numbers you want to assign to the input column. Note that the numbers must be on separate lines. Designer keeps track of the numbers you've added in the Recognized phone numbers column.

When you are finished adding numbers, click Next (review).

Review

You can review the results to see the phone numbers that are ready to be assigned, are already assigned to this application (or another application), or were not found — maybe these were entered incorrectly or are not available for use.

If you need to make changes, click Previous. Otherwise, click Assign the numbers.

Assign

You can monitor the progress as Designer assigns the phone numbers to the application.

Complete

When the operation completes, Designer shows you which numbers were successfully assigned and which (if any) failed.

Click OK to close the window.

Transfer From Others

Use Transfer from Others to transfer multiple phone numbers to another application or to other stream of the current application. To show an example of how this works, let's transfer a phone number to another stream of an application.

We've clicked Manage Phone Numbers for the Joules Coulomb application and selected Transfer from Others:

We want to transfer a number to a stream of the current application, so we use the search bar to filter the application list for "Joules". We select it, and the stream tabs appear at the bottom.

We want to move a number from LIVE to DEV, so we select the LIVE tab.

There are two numbers assigned to that stream, but we only want to move one of them. We select the number we want to move and click Next (review).

Review the transfer details.

If everything looks ok, click Confirm. If you need to make any changes, click Previous.

Designer shows you the progress of the transfer. When it is complete, the summary lists the numbers that were successfully transferred and also any that failed.

Click OK to close the transfer results window and return to the application properties.

Manage Chat Endpoints

Click Manage Chat Endpoint to assign a chat endpoint to the application.

Note that the endpoint is assigned to each of the application streams, with a naming extension that corresponds to the stream.

Some tips:

• Enter a name that is unique across all applications.
• The name should indicate the origination point of the chat (for example, sales_page or mortgage_division).
• Use alphanumeric characters only. Avoid using spaces or special characters (underscores are okay).

Manage Digital Endpoint

Click Manage Digital Endpoint to assign a digital endpoint to a default application. For example, you might want to add an endpoint for Facebook, WhatsApp, or Twitter, so that if a customer contacts you from one of these social media platforms or services, Designer detects which channel the message is coming from and launches the appropriate application for managing and routing that type of interaction. If applicable, Designer can also send or post messages back to the incoming channel.

Go to the tab for the appropriate service and select the endpoint to assign. (Digital endpoints are configured using Agent Setup. Contact your Genesys representative for more information.)

After you've assigned the endpoint, an icon for the respective service appears in the application properties, under the Digital Endpoints column.

Important

This option is only available for default application types. To assign digital endpoints in digital applications, use the Manage OpenMedia Endpoints setting.

Manage OpenMedia Endpoints

Click Manage OpenMedia Endpoint to select and assign an OpenMedia endpoint to a digital application. For example, you might want to add an endpoint for Facebook, WhatsApp, or Twitter, so that if a customer contacts you from one of these social media platforms or services, Designer detects which channel the message is coming from and launches the appropriate application for managing and routing that type of interaction. If applicable, Designer can also send or post messages back to the incoming channel.

(Digital endpoints are configured using Agent Setup. Contact your Genesys representative for more information.)

If you assign an endpoint for a service such as Facebook, WhatsApp, or Twitter, an icon for the respective service appears in the application properties, under the Digital Endpoints column.

Important

This option is only available for digital application types. To assign digital endpoints in default applications, use the Manage Digital Endpoint setting.

Disconnect Phone Numbers and Chat Endpoint

Click Disconnect Phone Numbers and Chat Endpoint to disconnect all phone numbers and the chat endpoint from the application (you might need to click More to see this option). Once disconnected, the phone numbers or endpoint can be assigned to other applications.

If you want to disconnect specific numbers from an application stream, click Manage under the Phone Numbers column for that stream to deselect the number(s) you want to disconnect.

Managing Application Settings

When an application is open for editing, you can click Settings to access its settings.

General tab

• Application Reporting Title - Specify the name of this application that will be used in reporting.
• Application Version - Specify a version number for this application.
• Stage - Select an application stage. If resource caching is enabled, the application stage also manages how often cached resources are checked for updates. By default, applications are in the Live stage.

Media tab

• Media Resource Collection - Select the Media Collection that this application will use. See the Media Resources page for more information.

Reporting tab

• Milestone Path Prefix - Specify a prefix to use with this application's milestone paths.

DTMF Options

This tab enables you to set global DTMF commands for your application. These DTMF keys can be used at any time within the application to trigger a specified action.

A common use case for this feature is a global command for the DTMF key 0 that routes the caller directly to an agent. In this example, you can set 0 as a global DTMF command that routes directly to the Assisted Service phase. In your application, you can add a Play Message block to announce that callers can press 0 at any time to speak to an agent.

Selecting Enable Global Commands enables global DTMF commands for the application.

To set a global DTMF command, select the drop-down menu beside the corresponding DTMF key that you want to use. In the drop-down menu, select a target block or phase for the DTMF key. Click OK when you are done setting global DTMF commands.

Global DTMF commands can target the Self Service, Assisted Service, or Finalize phase, or any block within the Self Service phase.

Important

• If the same DTMF key is also used by a block within your application, Designer first processes the command in the block.
• You can also use global DTMF commands with Self Service type shared modules.

Speech Recognition tab

Configure settings for speech recognition (ASR). See the User Input block page for more information.

Global Retry tab

Configure global settings for menu retries. See the Menu block page for more information.

Digital tab

To enable a Default application type for chat interactions, select Enable omni-channel support for Default applications.

Predictive Routing tab

Select this option to enable support for predictive routing (as required for the Predictive Routing block).

Contextual Data tab

Select Enable Customer Profile to allow Designer to retrieve certain details about the customer, such as their name and contact information. When this option is enabled, you can also choose to select the amount of interaction history data that Designer should collect for the customer.

Important

This option must be enabled if you are using the Last Called Agent option in the Route Agent block.

Caching tab

Resource caching can improve overall system performance, but it can also cause a delay in how long it takes for changes in Designer to take effect (changes to Data Tables and Business Controls take effect immediately).

In most cases, it is best to leave Use workspace cache settings selected (it is already selected by default), as each application stage has optimized settings for how often a resource is checked. But you can disable it if you want the application to regularly check the cached resources for updates, and enter your own values for each resource.

The following resources are cached:

• Media Resources
• Speech Grammars

Important

Default values are set by Genesys for optimal performance. Although you can change these values, doing so might negatively impact application performance. Contact your Genesys representative for additional information that might apply to your environment.

Misc tab

PTE (Parallel Test Environment)

Enable the PTE (Parallel Test Environment) option if you want non-production streams (DEV, QA, UAT) to use test versions of resources instead of the resources being used in the LIVE production environment.

For more information, see Parallel Test Environment (PTE) on the Application Workflow page.

Tracing

Enabling the Tracing option enables additional data to be collected while the application runs, which can later be used for debugging.

Important

This option should only be enabled when required, as it impacts application performance.

Enabling Your Application

After you have assigned a phone number to your application, you can enable it by clicking the switch icon in the Status column. The switch icon turns green when the application is enabled.

Viewing the application summary

When an application is displayed the flow section, you can use Views > Summary to generate a visualization of the application.

The resulting diagram is similar to a hierarchical flow-chart, with each node representing a block in the application flow:

The application summary view shows all the possible paths that an interaction can take through the application. The diagram is divided into sections for each application phase, and for nodes that need to be expanded into their own sections due to their size or complexity.

For example, this section shows a Segmentation node:

Filtering

Use the Filter by options to focus on specific details. You can choose to filter the diagram by Decisions, Reporting, User Interaction, Navigation, or External Data.

Select No Filter to clear any selected filtering options.

Session playback

You can use Select a Timestamp to Trace to select and display the path that a specific session took through the application, or click Trace Last Call to load the path of the last session that was processed.

The path that the session took is indicated by red flashing connecting lines and highlighted nodes:

Click Reset to clear the playback details for the selected session.

Variable tracing

Likewise, you can also select a specific variable to trace:

This lets you track a variable as it moves and changes through the various nodes, which can be useful for discovering and resolving potential trouble spots.

Importing an Application

You can import an application that was previously exported from another Designer workspace by clicking Import Application.

Click Choose file to browse to the location of the exported file, then click Upload. Designer will review the file and let you know if there are any potential conflicts or errors that need your attention. If you are ready to proceed with the import, click Confirm.

Important

• In Designer 9.0, you can only import applications that were created using a 9.0 version. Applications exported from non-9.0 releases are not compatible.
• If you are importing a digital application and it includes message resources with references to standard responses, you must generate new IDs for those resources before running the application (resource IDs are unique to each Designer workspace, so the resource IDs included with the import will not be found). To do this, re-select the standard responses for each impacted message resource and save the changes.

See also: How to export a Designer application