Jump to: navigation, search

Customizing your Agent Desktop

As an administrator, you can customize what a given agent sees when they login to their Agent Desktop. You also have flexibility in deciding who gets to see what — for example, you can apply a given customization to a single agent at a time (set this on the Person) or to a whole group of agents at once (set this on the Agent Group).

You have three options for customizing what your agents see when they open their Agent Desktop:

You also have the option to configure inactivity timeouts for your agents:

Since these customizations are unique to you and your business, they are not available out of the box. To get started on any of these customizations, you need to contact Genesys first. We will do the initial set up for you — create the phone numbers, URLs, or caller IDs that you tell us you need for your business.

If any of the custom configurations need to be set up once for all Agents, contact Genesys.

Once things are set up in the system, you decide who can access the customization — by setting options in Person or Agent Group objects in Platform Administrator (see Configuration Notes below).

Let’s take a closer look at the options available to you.

Setting up custom web content


You can integrate external web sites into Agent Desktop, displayed in dedicated tabs.

These tabs give your agents quick access to any web sites that you decide they need, without their having to leave Agent Desktop. For example, your company's knowledge base or corporate search page.

You can set up these web sites to appear in either the Main View or the Interaction View.


First, contact Genesys to get codes set up for each URL that you want to add to the Agent Desktop.

  • Main View — You can set the Main View so that multiple tabs appear for different URLs. After you get your codes from Genesys enter them as a comma-separated list in workspace.web-content.
    For example,
  • Interaction View — For Interaction View, you can only set up a single web site to appear when the interaction opens. When you get your code from Genesys, enter it in interaction.web-content.
    For example,
[+] See sample configuration

Setting up Caller ID selection

To get the initial setup for this customization added to your system, submit a service request to Genesys.

When the Caller ID feature is enabled, a "Please select your Caller Identification" popup box will appear to your agents when making a call.

Agents can then select the appropriate caller ID from your predefined list to display to the person receiving the call.


To setup the Caller ID list, contact Genesys. You will receive a code that maps to the list that you want displayed in the Caller ID popup.

Once you get this code, enter it in the intercommunication.voice.make-call-caller-id-business-attribute option.

For example,


The change will show up for the next time your agent logs in or starts a new session.

[+] See sample configuration

Setting up corporate favorites


A corporate favorite is an internal target or contact that people in your company need to call frequently, or who you want your agents to find quickly.

In your agents' Team Communicator, corporate favorites are marked by a locked gold star (IW Team Comm Corporate Favorite Icon 850.png).

[+] See a screenshot.

You can designate corporate favorites as context-sensitive, determined by a user role, or by the contact you are currently interacting with.


Basically, you need to create new options for a Person or an Agent Group objects to:

  • Define corporate favorites
  • Display corporate favorites for select Person(s) or Agent Group(s) in Agent Desktop Team Communicator

Define corporate favorites

To do this, in Platform Administrator, open the properties for the Agent or Agent Group you want to modify and go to Options. Add a new entry and enter the details as follows:

  • For the Section, enter any name of your choosing.
  • For the Key, enter one of the options available for the section type (see Corporate Favorite Options by Type, below). For example, you could enter category, id, type, or display-name.
    You can only enter one key at a time, so you will need to repeat this process for each option. Make sure to use the same Section name so that the keys are grouped together.
  • For the Value, enter an option that applies to the key. For example, an id key would have a value of the Agent's user ID. A type key would have a value such as AgentGroup, Agent, Skill, or RoutingPoint. If you are entering more than one value, separate them with semi-colons.

Display corporate favorites for select Person(s) or Agent Group(s) in Agent Desktop Team Communicator

After you have defined the section and applicable key/value pairs, create a new section to display the Corporate Favorites in Agent Desktop Team Communicator:

  • For the Section, enter interaction-workspace.
  • For the Key, enter teamcommunicator.corporate-favorites.
  • For the Value, enter the name of the section(s) you want the favorites to apply to. If you are entering more than one value, separate them with semi-colons.
[+] See sample configuration

Corporate Favorite Options by Type

Expand each section to see the available key and value options for each Corporate Favorite type:


[+] Show options.

Agent Group

[+] Show options.


[+] Show options.

Custom Contact

[+] Show options.

Interaction Queue

[+] Show options.


You can configure Agent Desktop to log out an agent from the application if the agent has not used the keyboard or mouse for a period of time. Agent Desktop saves the agent's work, ends the session, logs out the agent on all media channels, and returns to the login page.


To set this up, configure the following options in the [interaction-workspace] section:

  • security.inactivity-timeout
    This option specifies how long (in minutes) an agent can be inactive (no mouse or keyboard activity) before Agent Desktop ends their session. The default value for this option is 0, which disables the inactivity timeout.
  • security.inactivity-alert-dialog-before-timeout
    This option specifies how much advanced warning (in seconds) Agent Desktop will give to an agent who is about to have their session ended due to inactivity. The default setting is 30 seconds. (You must set this option to a value that is less than the value of security.inactivity-timeout.)

The changes for both of these options take effect as soon as the session is started or restarted.

After the timeout occurs, the Agent Desktop login dialog should be blank; however, if the agent has allowed the browser to remember his or her password, then the login dialog will still be populated with the agent's credentials. For security, agents should not allow web browsers to remember their login credentials.

Configuration Notes

  • For each option, you must set the section name to interaction-workspace.
  • You can set these customizations individually, on the Person object for each agent, or globally for each Agent group. Note that the group settings takes precedence over the individual setting.
  • Whenever you add multiple values to an option, separate each value with a comma.


To update an existing option, just click on it in Platform Administrator. The Edit window opens with all existing values filled out, and you can edit as you need to. For example, to add more favorites to your Corporate Favorites quick dial list.


To delete an existing option, you need to select the check box next to the option. This enables the Delete button in the toolbar. Once the button is enabled, you can click to remove the option. Note that there is no prompt — as soon as you click Delete, it's gone.


When adding or changing an option, you always need to close out the change by taking one of these actions:

  • Click Save to accept the changes and return to the object list.
  • Click Apply to accept the changes and remain in the Options tab.
  • Click Cancel to discard the changes.
Any changes made to your Agent or Agent Group configurations will only take effect when a session of Agent Desktop if started or restarted.
This page was last modified on August 10, 2017, at 06:39.


Comment on this article:

blog comments powered by Disqus