Getting started

From Genesys Documentation
Jump to: navigation, search
This topic is part of the manual Agent Desktop Agent's Guide for version Current of Agent Desktop.

Logging in and getting ready to take call and handle Genesys Digital channels.

Related documentation:

This page uses the following icons to help you determine whether or not a specific section applies to you. You might not be aware of which platform you are using. If you are unsure, contact your supervisor or Genesys software administrator.

Icon Platform
Engage cloud white.png Genesys Engage cloud
Engage on-premises white.png Genesys Engage on-premises
Engage private edition white.png Genesys Engage Private Edition
  • Due to continual changes to Agent Desktop, screen shots in this manual might show interface elements that are not yet available for this product or might not accurately reflect what is displayed in the product when you use it.
  • Some Workspace Agent Desktop features, such as SSO, are available only for Engage Cloud users.
Engage cloud white.png If you access Agent Desktop from the Cloud, you launch it by clicking Agent Desktop in the Genesys Portal.

Logging in to Agent Desktop from the Genesys Engage cloud is a little different to logging in to Workspace Agent Desktop from your organization's cloud. Go to the linked article which describes how to Log in to Genesys Engage cloud and access Agent Desktop.

Log in to Agent Desktop

Engage on-premises white.png If you access Agent Desktop from your organization's on-premises deployment, start Agent Desktop by clicking its icon in Genesys Portal, or open a browser and go to the link for Agent Desktop that your supervisor gave you.

Log in with your username and password. If your contact center uses tenants, click Tenant to reveal the Tenant field. You will be told by your administrator what to enter in the Tenant field. Leave this field blank unless instructed otherwise by your administrator.

A series of screenshots demonstrating the login process for Genesys Engage On-premises users. Enter your username in the first login window and your password in the second window. You might have an optional third window where you enter your Place.

Select the Remember Me check box to save your username and tenant information for the next time you login on same browser. This information will be populated in these fields.

If you select clear cache/cookies in your browser settings, your username and tenant will not be populated the next time you login.
In some environments you might also be required to enter your Place after your password is authenticated (refer to the broken line in the graphic). If you do not know what to enter, contact your supervisor.
  • You enter your password on a different login screen. Don't enter it in the Tenant field.
  • Clicking Change login account takes you back to the main log in screen.
  • Agent Desktop has a security feature that might be set up for your account that logs you out if you stop using Agent Desktop or your computer for a while. Agent Desktop first displays a message to warn you that you are going to be logged out. If Agent Desktop logs you out, just log back in again when you are ready to start using Agent Desktop.

You may login only to a single Agent Desktop session at a time. You must log out of one session before logging into a new session.

Logging Out (Exit) from Agent Desktop

A screenshot of the "Your session has ended" message. Click the login link to start a new session or click the "Change login account" link to login as a different user.

To log out of (Exit) Agent Desktop, you must use the Exit option from the Agent Menu. You won't be able to log out if you have any active calls or Digital interactions.

In some environments, after you exit you might encounter one or more links, one to login again, and one to switch login accounts. Click the appropriate link to begin a new session. If you do not receive these links, just login as usual.

How do I choose my language when I log in?

An animated gif demonstrating how some Engage On-premises users can change the language used by Workspace by accessing the Language menu.

Engage on-premises white.png Your account might be configured to enable you to change the display language of Workspace Agent Desktop.
If it is, after entering your username and password, a third login step is added that lets you choose your preferred language from the Language drop down list. Your administrator determines which languages are available to you in this list. Choose your language, then click Continue.

Single Sign-On environments

Engage cloud white.png You might work in an environment that uses Single Sign-On (SSO) identity authentication. If you do, your login experience will be a little different. After entering your username in the application login screen, you will be taken to your company's authentication provider where you will enter your username and password. After that, you will not have to log in again until your authentication expires which is typically every eight hours.

Using SSO means that once you log in to one application, you will not have to log in to any other applications that are also set up for SSO.

In some SSO environments, you will only have to provide your username to login as you are already authenticated.

Logging out in SSO environments

Engage cloud white.png If your company uses SSO, after you click Exit the Workspace window informs you that your session has ended. You must click the Login link to start a new session.

A screenshot of the "Your session has ended" message. Click the login link to start a new session.

Remote and virtual desktop environments

You might work in an environment that uses Virtual Desktop Infrastructure (VDI, sometimes called VMware) to run Workspace. This means that when you start Workspace, it is displayed on your screen, but it is not actually running on your workstation, it is running on a remote machine.

In VDI environments, your administrator installed the Genesys Softphone on your workstation before you logged in, or, you were instructed to install it by clicking on an installation hyperlink in an email or other document.

When you start your workstation, the Genesys Softphone automatically launches and the Genesys Softphone icon is displayed in your system tray. Until you log in to Workspace, this icon is in the waiting state: The Genesys Softphone waiting for Login icon.. After you launch Workspace and the Genesys Softphone is connected, the Genesys Softphone icon is in the active state: The Genesys Softphone Connected icon..

Browser specific notifications and issues

Some browsers require specific actions to ensure that you receive notifications from Workspace Agent Desktop and the Genesys system. For detailed information about allowing notifications for your browser, review the documentation specific to the browser and version that you are using. The following are some guidelines:

  • Chrome: When you login , you might receive a browser notification asking whether to allow or deny notifications from the Workspace Agent Desktop URL. Click Allow.
  • Firefox up to v71: When you login , you might receive a browser notification asking whether to show notifications from the Workspace Agent Desktop URL. Click Show for this session or Always show.
  • Firefox v72 and higher: When you login, you might have to click the Notifications icon in the address bar to display the dialog that enables you to allow notifications. You are not prompted to do this by the browser.
  • Edge: When you login, you might receive a browser notification at the bottom of window asking whether to show notifications from the Workspace Agent Desktop URL. Click Yes.

Log in, log out, log on, log off, and exit, what's the difference?

You log in and log out of the Workspace Agent Desktop application. Logging in means launching the application in your browser and identifying yourself to the system so that you become authorized to receive interactions and use the various features that are enabled for you.

A thumbnail version of the Engage On-premises login process.

Typically, you log in to Workspace Agent Desktop at the beginning of your shift and log out (Exit) at the end of your shift. To log out of Workspace, you must use the Exit option from the Agent Menu. You won't be able to log out if you have any active calls or interactions.

You log on to and log off of channels in Workspace Agent Desktop. Channels include voice, email, chat, and so on. Channels are the media that you use to interact with contacts. When you log in to Workspace Agent Desktop, you are usually logged on to all the channels assigned to you, and when you log out (exit) of Workspace Agent Desktop, you are logged off from all the assigned channels. In some environments, you might be logged off from one or more channels when you log in because the channel is out of service or your administrator has set up your account to be logged on to specific channels only.

Use the My Channels tab to log on or log off one or more channels. Logging off of all your channels does not log you out of Workspace Agent Desktop. You must still exit the application to log out.

You can log on or log off all your assigned channels by using the Global Status menu.

How do I change my password?

Engage on-premises white.png It is a good idea to change your password regularly for security purposes. Your account might be set up to enable you to change your password yourself. If this feature is available to you, the Change password option will be displayed in the Agent menu.

A screenshot of the Agent Menu showing the Change Password option being selected.

When you select this option, the Change Password dialog box is displayed. Perform the following steps to change your password:

  1. Verify your username. This field is not editable.
  2. Enter your current password.
  3. Enter your new password. Your company will have specific password rules. If your new password does not follow those rules, you will receive warning messages.
  4. Re-enter your new password to ensure that you did not make any mistakes in the New Password field.
  5. Click Change Password. If you did not make any errors, your new password will replace your old password. The next time you log in, make sure you use your new password.
    A screenshot of the Change Password dialog box.

Handling a system disconnection

A series of screenshots demonstrating the possible sequence of message window that are displayed during a system disconnection. Follow the instructions in these message windows if you experience a disconnection.

Workspace is designed to handle system disconnections. If the server that directs interactions to you becomes disabled or disconnected for some reason Workspace automatically tries to connect you to a back up server so that you can keep serving your customers with minimal interruption. If a connection loss occurs you are informed right away by the Connection Lost message. Workspace immediately tries to reconnect you.

If Workspace cannot reconnect you, you must log in to the back up server when the Re-establish Connection log in window is displayed. Log in just like you do when you first log in at the start of your shift.

If you have pop-ups blocked in your browser, you might receive a message asking you to enable pop-ups to display the log in window. You might be able to click the Open button in the Re-establish Connection window to open the log in window.

In the event that the back up server is not available, the Host Not Available message is displayed. Click Refresh to refresh your browser and log in to your company's system as soon as the server become available again.

What if the system is down when I log in?

For agents who are voice-only, if the system is down when you try to log in you will receive the Connection Lost message right away. If Workspace is unable to connect immediately to the back up server, the Connection Failed window is displayed requesting that you log in again. You might have to keep trying until Workspace is able to connect to the server or the back up server.

Browser notifications

If the system becomes disconnected while your browser is minimized, blocked by another application, or if the Workspace Agent Desktop tab is not the active tab, Agent Desktop sends you browser notifications to alert you to make the Workspace Agent Desktop browser or tab active so that you can view the disconnection message and follow the instructions to reconnect.

To ensure that your browser is set up to enable you to see browser notifications, refer to this FAQ: Browser specific notifications and issues.

Change your status to Ready

A pair of screenshots demonstrating the two ways one can change ready status. The first is from the Channel Status in the My Channels tab. The second is from the Global Status Menu.

To receive calls, you must be in a Ready status (indicated by a green check mark beside your name).

If you need to change your status, click the Global Status menu and select Ready, or go to My Channels and toggle the voice channel or one or more of your Genesys Digital channels to Ready.

Watch the video for a short demonstration of changing your status. Note: This video show Agent Desktop in an environment that has many different media channels available, such voice, chat, and email. Don't worry if not all these channels are available in your environment.

In some environments, agent status is set to Ready when the agent logs in. This means that interactions are directed to these agents upon login.

Table of status icons

Here is a table showing the status icons that you might encounter while using Workspace Agent Desktop.

Agent Desktop icon Agent Desktop status
The State unknown icon. State unknown
The Logged out icon. Logged out
The Ready or Ready with Action Code icon. Ready/Ready with Action Code
The Partially Ready icon. Partially Ready
The Not Ready or Not Ready with Action Code icon. Not Ready/Not Ready with Action Code
The After Call Work (ACW) icon. (Not Ready) After Call Work
The Do Not Disturb icon. Do Not Disturb (DND)
The Out of Service icon. Out of Service

What happens if not all channels are available when I log in?

A screenshot of the Workspace window showing the message that displays when channels are out of service.

Sometimes when you log in, one or more of the channels that you are assigned might not be available.

You will know that one or more channels are not available because you will receive a warning message at the bottom of the Workspace window.

When this happens, you can still log in, but when you examine your My Channels tab, you'll notice that one or more channels have the Out Of Service status. When a channel is out of service, you cannot log on or off on that channel and you cannot set your status.

When the channel becomes available again, a message will be displayed at the bottom of the Workspace window. You can use the My Channels tab to change your status on that channel.

Setting your status to Not Ready with a Reason

A screen shot of the My Channels tab demonstrating selecting a Not Ready with a Reason status from the Voice channel Status column in the My Channels tab.

Sometimes you need to set your status on one or more channels to Not Ready so that you do not receive new interaction on that channel. You can choose to set the status to Not Ready or Not Ready with a reason. Your administrator sets up the Not Ready Reasons that are available to you from the Status drop-down menus.
If you manually set your status to Not Ready while you are handling a phone call or a Digital channel such as chat or email, the system starts recording your time in that state rather than the time spent handling the call. Some contact centers have the Pending state enabled so that the Not Ready state does not take effect until after you end your phone call or Digital interaction, or after you send your email or place it in a workbin.

Handle an inbound call

A screenshot of the Workspace window with an active Voice call.

Make sure your phone device is connected and ready.

When a call arrives, you'll get a screen pop-up. You might also hear a sound to alert you that a call has arrived.

Click Accept to connect the call. If you Reject the call, or ignore the pop-up, it goes to the next available agent.

Watch the video for a short demonstration of how to handle a voice call. Note: some of the features shown in this video might not be available in your contact center.

Detailed call handling information can be found here.

To get you started, here are some common call handling features:

  • Click Hold (The Hold button.) to place your caller on hold.
  • Click Resume (The Resume button.) to retrieve a call that is on hold.
  • Click Transfer (The Transfer button.) to transfer a call to someone else in your organization.
  • Click End (The End button.) to hang up a call.
  • Click Done (The Done button.) to complete a call (Mark Done).

After the call is complete, you might enter an After Call Work state, during which you can complete any tasks related to the call. For example, you could add a note or select a disposition code.

What kinds of customer interactions can I receive?

Depending on your assignment, you might receive interactions through the Voice or Digital channels, such as Chat or Email channels, directly from customers or by way of a consultation, conference, or transfer.

For a list of channels that Workspace Agent Desktop supports, refer to Channels and the Channels tab.

Some contact centers are set up to always direct interactions from the same customers to the same agents. If your assignment is set up this way, then you will be able to assist certain customers whenever they call.

How do I accept an incoming interaction?

New calls, chats, emails, workitems, and other interaction types arrive at your workstation in a pop-up interaction notification. In most cases you can decide whether to accept or reject the interaction by clicking Accept or Reject, or, if you take no action at all, it will eventually time out and go to the next available agent.

A screenshot of the Interaction Notification pop up.

Your account might be configured for auto-answer which means you can't choose to reject an interaction. When the interaction is directed to you, it opens automatically on your desktop.

However, some accounts that are configured for auto-answer might have a timer on the Accept button. This gives you the opportunity to review the Case Information in the interaction notification before the interaction is auto-answered. You can click Accept before the timer counts down if you are ready to accept the interaction. You might also encounter a Reject button on a timed auto-accept interaction that permits you to reject the interaction before it is auto-accepted.

A pair of screenshots demonstrating the Interaction Notification pop up without and with the Reject button. Both have the Accept button displaying a countdown until auto-accept.

Many browsers, such as Google Chrome, Mozilla Firefox, and Microsoft Edge, also display notices to you about interactions and other events. You can manage these notifications through the settings in the browser. Refer to the help for the browser you are using if you want to control browser notifications.

Why do I have unclosed interactions?

The Unclosed Interactions notification, requiring the agent to view the interactions.

In very rare situations, you might see the Unclosed interactions notification. This notification is displayed when you login and you have multiple interactions that were not marked Done from your previous session. You must close the unclosed interactions before you start working on new interactions. Click View interactions.

When the notification closes, the first unclosed interaction displays in the interaction view. The Done (The Done button.) button is available to close the interaction. Next to the Done button is a plus sign followed by a number. This is the number of unclosed interactions for you to review and close.

GAPI 900 Number Of Unclosed Interactions.png

As you close the unclosed interactions, this number will go down until you have no more interactions to review and close.

How do I set a disposition code?

A screenshot of the Disposition tab in a Voice interaction view. You can click a disposition from the list or enter the name of one in the Quick Search field.

You can assign one disposition code to an ongoing or terminated interaction to characterize the outcome of the interaction.

The Disposition Code view is a tab in the Interaction view. It contains a list of choices that you can click to specify the outcome of the interaction. A search field is available to search among the disposition codes.

The Disposition Codes are organized within grouping folders, which cannot be selected as dispositions. These grouping folders do not correspond to business attributes, as they are only textual information.

Select a disposition for the interaction. Once a disposition is selected, the disposition list is hidden and the selected disposition appears in a textbox located at the top of the listing. You can't edit a disposition but you can select a new one.

The complete path to the disposition is available as a tooltip of the disposition name.

Depending on your system configuration:

  • You might have to set a disposition code before you click Mark Done.
  • You might be able to click Mark Done without a disposition code.
  • The Disposition Code view might not be displayed.

How do I add a note to an interaction?

A screenshot of the Interaction view Note tab.

The note is a feature that enables you to enter comments about the current interaction or about a selected interaction. You can view the note in most channels as well as the Contact History view.

You must click Save to store your note.

How do I work with case information?

A screenshot of the Case Information area of a Voice interaction view.

The case information view (also called attached data) provides information about an interaction — for example, an account number or type of service.

Some case information might be displayed as the title of the web page, an anchor, or a link. If the link is active, it is displayed as blue text.

To make changes, select the field you want to edit or delete. Fields that you can edit display a pencil icon when you roll your mouse pointer over them.

You can add more fields with The Case Information area Add button..

Where can I find answers to common contact questions or problems?

First, try the standard responses, your own contact history, and any customized knowledge repositories your contact center uses. If none of those options works, you can start a consultation with one of your team members.

What next?

Top 5 topics