Jump to: navigation, search

Agent accounts

On the Users tab, you can manage agent accounts, including adding new accounts, importing agent accounts from an external file, and exporting agents.

  • To perform most tasks on user accounts, your account must have Administrator privileges. If you are unable to perform certain actions using the Agent Setup interface, check that your account privileges are correct.
  • To add administrator accounts to your contact center, you can either import the administrator accounts or use Platform Administration.

After you log in to the Agent Setup interface, the first screen that you will see is the Users tab. If your contact center already has agents assigned to it, you see a list of configured agents. In a fresh installation, you might see an empty list. Regardless, as part of your regular maintenance on your contact center, you need to add agents.

How do I add a single agent?

Click the Add User link. You can select a template from the Template drop-down list box if you have configured one or more templates. A template automatically selects some of the options on the Add User screen.

Complete all the required (*) fields on the screen. If you make an error, a message is displayed to tell you the correct format for a field. Most fields are self-explanatory, such as the name and email fields.

This video demonstrates how to add a single agent.

Use the following table for advice on how to fill in the fields:

Option Description
Folder From the drop-down list box, select the business group to which you want to assign the user.
First Name Type the first name of the user.
Last Name Type the last name of the user.
Username Type the username for the user.
Login Code Optional. Type a login code for the user. An example of a login code is the user's employee ID.
The Login Code option is hidden by default, therefore, it might not be displayed on your screen. If you require the Login Code option, contact Genesys Professional Services to request that they enable the Agent Login Code option.
Email Optional. Type the user's email address.
Reset Password When selected, this option specifies that when the next time the user logs in, he or she will be prompted to change the password. This option only applies to agent user accounts.
Password Type a default password for the user.
Password confirm Type the password again.
Employee ID Optional. Type the user's employee ID.
External ID Optional. Type the user's external ID.
Capacity Rule Optional. Choose an existing Capacity Rule from the drop down.
State enabled Enables or disables the user account.
Multimedia Agent Specifies that this agent is only enabled for multimedia (non-voice).
Supervisor Select this option if this agent has a supervisory role.
Phone Number(s) In addition to the default phone number, you can assign additional phone numbers to the agent. The agent has the opportunity to select the number when they log in to accept calls.

For example, if you type hjackson in the Username field, when you type a phone number in the Number field of the first row, the Place Name field displays hjackson. If you type a number in the second row, the associated Place Name field displays hjackson2 and the place name in the first row changes to hjackson1. If your contact center has a requirement to specify unique place names for different business groups or regions, you can overwrite the default place name.

Place Name The value that you type in the Username field automatically populates the Place Name column. If you don't want to use the username as a place name, clear the Use check box.
Use The Use option specifies that the username is to be used for the associated phone number. This option is selected by default. When you clear the Use check box, the phone number is used as a place name.
Wrap Up Time You can configure wrap up time for an agent. Wrap up time is the amount of time the agent is allotted to complete after-call tasks, such as typing notes or selecting a disposition. The wrap-up time is measured in seconds. To disable wrap up time, type 0.
Agent Voice Mail Type the voice mail box extension number for the agent to use.
Softphone Select this check box if this user will use a softphone.
SIP Phone Type When you enable Softphone, you must select a softphone type.
Skills Select the skills that you want to assign to the agent, assign a skill level, and click Add. With many skills to choose from, you can filter the list of skills by using the search box.
Caller IDs Click Caller ID and add at least one identifier to be displayed on a receiver's call display. If you add more than one, the agent has the option to choose which caller ID they want to display. You can also enable the agent to use an anonymous caller ID.
Agent Groups Assign this agent to an agent group, which is a logical grouping of agents that provide particular sets of contact center services. For more information about agent groups, see Managing Agent Groups.
Annex Assign this agent to an access group, which is a logical grouping of agents that are provided specific access permissions.
Favorites Personal Favorites is a list of Agents, Agent Groups or external contacts that group members frequently dial. This list provides a click-to-call list of these numbers on Agent Desktop. Personal favorites are configured the same way as Global Favorites. See Global Favorites.
Switches Select the switches where DNs and Agent Logins should be provisioned.
External URLs Integrate internal and external websites into your agent's main view. See External URLs.
Filter For each agent group, you can control what information that group can see from other agent groups in the Team Communicator, Favorites, and Statistics. After you select an agent group on the Agent Groups window, select the Filter option on the menu bar. In the list of agents groups, you can choose to restrict or exclude agent groups by selecting the appropriate check boxes. You can also manage filters on the Desktop Options page. For more information, see Desktop Options.
Desktop Options Assign channels and other options to the agent by clicking Desktop Options and then selecting from the listed options. You can select more than one option. For a detailed look at what options you can configure for an agent, see the Desktop Options.
CRM Adapter CRM Adapter: Use the CRM Adapter tab to configure the Gplus Adapter option settings for the agent group. For information, see CRM Adapter settings.
Recording Hierarchy The recording hierarchy for an agent specifies the access control applied to recordings of calls handled by that agent. Select the Recording Hierarchy check box, and then type the hierarchy string. See Access control for Recording users for more information about Recording agent hierarchy, access groups, and partitioning.

Editing agents


You can edit a single agent or a group of agents. When you edit a single agent, you can edit any of the agent's details. For a group edit, the two options available for you to edit are Annex and Skills.

When you edit one agent, click the agent's name in the Name column. In the Manage User window, you can make your updates.

To edit multiple users at once, select the agents that you want to edit, click Edit Users, and then make your changes in the Edit Users window. When you edit multiple users, consider the following:

  • You can add Annex options or modify existing options. You can only delete Annex options that are identical for all selected agents.
  • Only values that are common for the selected users are shown for Skills and Annex. For example, if:
    • Agent 1 has Russian skill level of 10 and English skill level of 5
    • Agent 2 has Russian skill level of 10 and English skill level of 7
You will see the Russian skill level of 10 and English skill level is blank on the Edit Users screen under Skills.

This video gives you a demonstration on how to update multiple agents.

Importing agent accounts

When you need to add a large number of agent accounts, you can use the Bulk Import tab in Agent Setup. By importing a large number of agent accounts at one time, you won't need to add the accounts one at a time and you can apply a template to configure options, such as DN, place, person, and login options, to all accounts.

How do I import a file that contains agent accounts?

Before you can import agent accounts , you must have a .CSV file that has all the required data.

The values from the imported file overwrite corresponding values that are specified in the template. For example, the value for the Skill parameter in the imported file takes precedence over the value for the Skill parameter that is specified in the template.

When you are ready to import the file, click Choose File, select the file from your local device, and then click Import. If you want, you can validate the file to ensure that it is structured correctly.

About CSV files

The .CSV file must be a text file in a comma-separated format. In the source file each line represents a single user or agent.

When you import a .CSV file, each parameter value is updated according to the following rules:

  • If value is present, the new value replaces the previous value.
  • If an empty value is encountered, no change is made.
  • If the value includes /d , the attribute is unassigned and deleted. If the value includes /r , the attribute is unassigned only.
  • If no corresponding record is found, an error message is logged and the updated continues to process.
[+] Show .CSV file parameters
[+] Show an example
When performing a bulk import, the Password field is not included in the imported file. A default password is associated to each user account in the imported file. The format of the default password is: <username>@<company-name>.com-<Month>-<year>, where <Month> is the three-digit abbreviation for the month. For example, hjackson@demo.com-Feb-2017. The Reset Password option is automatically enabled when adding or importing new users, therefore, all users are prompted to reset their password the next time that they log in.

How do I stop an import?


When you stop an import, a window is displayed in which you can confirm that you really want to stop the import. After you click Stop, agents records that were imported before you clicked Link= are retained and the import process does not proceed.

Exporting agent accounts

There may be circumstances where you need to create a backup file of all your agent accounts or you might want to export agent accounts to update them using another application and then import them back in. When you export agent records, a spreadsheet document is downloaded to your local computer.


On the Users page, you can export all users or a subset of users.

  • Export All: Click the down arrow on the User Actions menu and select Export All.
  • Export Selected: To select a subset of users, select the users and then select Export Selected from the User Actions menu. You can select the users by:
    • Click the check boxes next to the users you want to export.
    • Filter the list of users by using the search boxes at the top of the Users list and then click Select All or individually select the users you want to export.

How do I select the fields that I want to export?


On the Export Users window, you can give your exported file a custom name. This makes it easier for you to locate on your local system after you export. You can either accept the default selections or customize the list. If you want to export all fields, select the check box at the top of the list, next to the Field label.

  • If you are exporting your user accounts as a means to modify the records and then import them back in, select the Import Action field. If you don't select this field, the .CSV file will not import correctly.
  • If you are including Skills in your export, the skill level must be zero or greater for it to be listed in the export files.

Where did my export go?


When the progress bar at the top of the Export Users window reaches 100 per cent, the document is completely downloaded to your local computer. How you access your downloaded files varies by operating system. In general, you can open your Downloads folder, and look for the .csv file that corresponds to the file name you specified.

You can then double-click the file to open it and view the exported data.

If you use Microsoft Excel, the program automatically truncates all leading zeros from numbers in CSV files when you open the file by double-clicking on its name. You need to change at least the columns where the leading zeros occur to text format. For more information on how to resolve this issue, see this FAQ.

Locating agent accounts

What you see in the Agent Setup interface is determined by your permission settings.


If you see a red check box next to an agent account, this means that the agent's account is not valid due to some missing information. Hover your mouse over the check box to see what information is missing. For example, if a voice agent does not have a configured default Place Name field and your contact center is not configured to prompt the agent to enter place when he or she logs in, the agent's account is considered invalid until you update the agent account to supply the missing information. You can filter the list of agents to view only Valid or only Not Valid agents by selecting the appropriate option from the State drop-down list box.

Note the following options that you can use to locate specific agents on the list:

  • Search by Name/Username: Use this field to type an agent name or username, or part of an agent's name, to filter the list to display only agents that match your search words.
  • Agent Groups: Use this field to type the name of an agent group. All agents that are assigned the specified agent group will be listed.
  • Roles: Use this drop-down list box to filter the list to display only agents that are assigned a specific role.
  • Skills: Use this drop-down list box to filter the list to display only agents that are assigned a specific skill.
  • State: Use this drop-down list box to filter the list to display either All, Enabled, Disabled, Valid or Not Valid agents.
  • Page navigation: To scroll through the list pages, use the back and next arrow next to the page number at the bottom of the page.

This page was last modified on September 26, 2019, at 14:38.


Comment on this article:

blog comments powered by Disqus