Bulk upload of people data
You can use a .csv file to bulk upload people and their details to your organization. Download and use the sample CSV file for structuring your file.
Genesys recommends that you export the .csv file from a spreadsheet instead of composing .csv using a plain text editor. When the spreadsheet saves a .csv file, it automatically inserts required quotes and commas. This process is less error prone than formatting records manually.
Notes:
- The validation process does not catch spelling errors or extra spaces. These issues can cause duplicate role creation. As a best practice, ensure you format and proofread your
.csvfile before you import it. - The
.csvfile requiresnameandemail. All other data is optional. - The skills category is valid only for skills, not languages.
- The data in the
.csvfile must be in the following order:
name,email,phone_work,extension,title,department,email_manager,location_work,roles_divisions,queues,division,skills,hire_date
- Queue names are comma-separated; however an actual queue name cannot contain a comma.
- Spell roles exactly as they appear in the Roles/Permissions page.
- If the
.csvfile includes empty “extension”, “title” or “department” columns, the blank fields override existing fields in Genesys Cloud. - If the
.csvfile includes empty “phone_work”, “email_manager”, “location_work”, “roles_divisions”, “queues”, “division”, or “skills” columns, the blank fields do not override existing fields in Genesys Cloud. - During the import process, Genesys Cloud automatically adds new locations in the
.csvfile to the organization. - When you update existing users with a
.csvimport, Genesys Cloud adds roles and queues but does not replace or remove them. - To upload skills with proficiency via the
.csv, add the skill and proficiency, separated by a colon. Separate multiple skills by a comma. For example,Skill1:5,Skill2:3,Skill3:1and so on. - If you include new skills in the
.csvfile, Genesys Cloud replaces existing skills with the new ones.
For example:
"Gene Hamilton","gene.hamilton@company.com","919-555-1234","3324","Sales associate","Sales","sue.ellen.templar@company.com","Durham, NC","admin,Communicate User","Inside Sales","Home","Replacement Parts" "Lisa Greenjeans","lisa.greenjeans@company.com","317-555-6789","268","Contact Agent","Technical Support","dex.cooper@company.com","Indianapolis, IN","Genesys Cloud User","Customer Support","East Coast","Warranty"
Import a .csv file with double-byte characters
If the .csv file contains double-byte characters for languages like Japanese or Chinese, save the file in Unicode or UTF-8 format. For more information, see Create a .csv file in Unicode or UTF-8 format.
Bulk import people into your organization
- Click Admin. Under People and Permissions, click People and click Bulk Import.
- Click Menu > User Management > Users.
- Click the icon next to Add Person and select Bulk Import.
- Click Select File and choose the
.csvfile with your people data.Note: If you use Active Directory within your organization, click to set up a connector and sync your people automatically. For more information, see Configure Azure Active Directory for Genesys Cloud SCIM (Identity Management). - Under Import Preview, review the data.
- To update the existing individual data, select Update Existing People.
- To send invites automatically after adding people, select Send Invitation Notification.
- To view the warning, click the Information icon in the warning message and view the reasons.
- Click Next Step.
- Review the import preview and click Create Individuals.
- When the import completes, click Close.
For more information, see About people and permissions.
[NEXT] Was this article helpful?
Get user feedback about articles.