Customer Experience

The user interface for customers on assessment partner integrations is standardized across partners to help create familiarity and set the expectations amongst end users. However, we also want you to be able to easily integrate your service into SmartRecruiters, therefore we provide some options for you and your team to choose from.

The following section shows examples of the customer experience and user interfaces when using an assessment partner’s integration on SmartRecruiters platform.

Apps & Integrations Management

The admin users of customers can manage all the integrations, active and non-active, in the SmartRecruiters App & Integration Management module. The admin user experience is standardized in this module for the customers. For each partner’s integration, on the interface, the end user see:


SmartRecruiters App & Integration Center


SmartRecruiters Partner Integration page demo

  1. Your logo
  2. Short description of the service provided by the integration
  3. Full description of the service provided by the integration
  4. Status of the integration
  5. Data access scope of the integration
  6. Usage of those data in the integration

Authorization and Authentication

After the admin user authorized your service to access their data in SmartRecruiters, you service have the option to authenticate the customer:

  • Via a pop-up widget, which hosts your page, developed and provided by you
  • Via a redirect to your page

The dimension of your page on the pop-up widget should be the following:

  • Width: 600 px
  • Height: 45% of screen height

Scroll bar will be available to the widget if the dimension of your page exceeded the above specification.

After the customer authenticates, you may want to present SmartRecruiters scope of access to your customer if your service requires the customer to grant permission to SmartRecruiters service.

Custom Fields Mapping

If you have specified fields using the /configurations endpoint, the admin user will see an additional ‘Configuration’ on the bottom left of your integration page.


By clicking the ‘Configuration’ button, the admin user can map SmartRecruiters custom job fields or or fields to the fields your service have specified. These mapped SmartRecruiters custom field values will be passed back to your services during the /packages call to help your service provide a concise and accurate assessment package list to the end users.

Package Selection and Ordering

When the integration is enabled, there are two ways the customer can order assessment from your services:

  1. User orders assessment, manually, for an individual candidate on a specific job
  2. Admin user configures assessment in a step of a hiring process, the assessment order triggers automatically when a candidate reaches the hiring step

When the user orders or configures the assessment, a list of assessment packages is presented to the user. On that list, the user sees:


SmartRecruiters Candidate Profile select assessment package demo


SmartRecruiters Hiring Process configure assessment package demo

  1. Your logo
  2. Name of each assessment packages
  3. Description of each assessment packages

On the manual order flow, the user needs to confirm the package order to proceed.

Package Status

After SmartRecruiters placed the assessment order, the status of that order is displayed to the user within each individual candidates’ profiles. On the section, the user can see:

  1. Name of the package
  2. Name of individual assessment
  3. Corresponding package or assessment status

SmartRecruiters Assessment Status and Result demo

Assessment Results

Once your service returns the assessment results to SmartRecruiters, the results are displayed to the user in the form of attachment; or in the form of URL that directs the user to your platform to view the results.

  1. Link to the detailed assessment result/report (paper clip icon)