Employee Survey Integration

Modified on Mon, 4 Aug at 12:55 PM

All you need to know about our Employee Survey integration

How to set up the integration

You need to generate a token in Employee Survey for authentication purposes. This can be found under Account -> API Access.
- Only users granted the role "Administrator" in Employee Survey are capable of generating API tokens.
Copy the API Key
In Simployer One navigate to Settings -> Integrations and enter the copied API Key and click “integrate”
When successful response is given the connection is set.

How to sync users from Simployer One to Employee Survey

As an Owner go to Engagement - Surveys - Export
When clicking Synchronize the current state of employees will be synced to Employee Survey
Repeat this step every time you make a change related to employees and organizations in Simployer One

Employee data export

The following data is exported to Employee Survey

All users that are in the active state in Simployer One

Employee Survey	Simployer One	Comment/example
externalId	EmployeeId	6128e769ee5cac02018203f27
firstName	firstName *(mandatory)*	John
lastName	lastName *(mandatory)*	Doe
email	Work email *(mandatory)*	john.doe@company.co
phone	Work Phone (needs to be correctly formatted, or left blank)	+461234567
timezone	Time Zone for user
role	Role	Owners = Administrator , All others = User
accessInfo : memberOf	The employees current connected "groups". And groups are defined as Organization Office Department Team(s) Employment type	Organization Eastern Office New York Department Sales Team(s) BDR, SDR Employment type Permanent employment

Group data export

In Employee Survey reports are available for groups and teams that have been offered to participate in a pulse and surpass the anonymity requirements set for an account.

Therefore when employees are exported from Simployer we make sure that the groups in Employee Survey is the same as the groups/entities they belong to in Simployer One.

Simployer One entity	Name in Employee Survey	Description in Employee Survey
Organizations	Name of the organization	Users belonging to the [Name] Organization in Simployer One
Offices	Name of the Offices	Users belonging to the [Name] Office in Simployer One
Departments	Name of the departments	Users belonging to the [Name] Department in Simployer One
Teams	Name of the Teams	Users belonging to the [Name] Team in Simployer One
Employment types	Name of the employment types	Users belonging to the [Name] Employment types in Simployer One

Attributes data export

You can export the following custom attributes from Simployer One to Employee Survey that is connected to the exported users.

Attribute	Data in Simployer One	Comment
City	Personal - City	Optional
Country	Personal - Country	Optional
Gender	Personal - Legal Gender	*Needs to be created as a custom attribute with the label Gender and options must be Male, Female, Non-binary or Not-specified
Birthdate	Birthdate	Required if active
Employment date	Employee hire date, first employment date	Required if active

To be able to export attributes you must first add the attributes in Employee Survey .

Go to Account – User management and add wanted attributes:

NOTE: If you allow Gender to be not specified on your employees you need to create a custom attribute in Employee Survey with the following options Male, Female, Non-binary, Not-specified. See image below

When you have added the attributes in Employee Survey you can sync data from Simployer to Employee Survey (note that all employees must have attribute data in their Simployer profile for the sync to be successful).

How to access Employee Survey

1. As an Owner go to Engagement - Surveys - Overview

2. When clicking View Surveys you will get directed in to Employee Survey

3. Go to Log in - Employee Survey

4. First time you log in you have to create an account:
- Add your email address

- Choose password

- Confirm password

5. Now you are ready to log in!

FAQ

Frequently asked questions

Q : What happens when an employee is offboarded in Simployer One?

A : The next time the employees are exported to Employee Survey and the offboarded date has passed. The employee will be removed from Employee Survey . Already answered surveys will be saved.

Q : I am getting an error message saying "validateThatPhoneNumberIsCorrect", what does that mean?

A : This means that one of the employees within your company has a faulty phone number and you need to correct it. You can do this through an employee report and have the work phone as one of the fields for searching.

Q : I am getting an error message saying "validateNoPhoneDuplicates", what does that mean?

A : This means that one of the employees within your company has a work phone number that is already registered to a user in Employee Survey and you probably need to correct it. You can do this through an employee report and have the work phone as one of the fields for searching.

Q : I am getting an error message saying "validateDuplicateMailInAnotherCompany", what does that mean?

A : This means that one of the employees within your company has a work email that already exists on a user in Employee Survey.

Q : I am getting an error message saying "apiTokenValidation", what does that mean?

A : This means that the api token from Employee Survey that was entered when activating the integration is not currently valid.

Q : I am getting an error message saying "validateExternalProperties", what does that mean?

A : This means that Employee Survey expects external properties to be sent (they are activated in Employee Survey). Or that Simployer is sending external properties that are not activated in Employee Survey (but activated in Simployer One).

In the below example Simployer is trying to send external name "not specified" for the attribute Gender but that attribute or its allowed data is not configured in Employee Survey.