API Integration Support to 3rd party systems

Seamless Integration for Enhanced Workflow

Our API and integration capabilities enable you to connect TypingTest Pro with your HR management software, applicant tracking systems, and other essential tools. Say goodbye to manual data entry and hello to automated efficiency.

Efficiently Redirect Test Takers to a Third-Party Web Page Based on Test Results

Would you like to guide test takers to a different web page after they complete your typing test, depending on whether they pass or fail? You're in luck! Our system allows you to effortlessly set up automatic redirections.

Redirecting After Test Completion:

Should your test configuration permit multiple attempts, the redirection will only happen once the test taker selects the "EXIT" button. Let's delve into the simple steps to make this work:

Step 1: Sign In and Access Test Settings:

Log into your account as an Administrator and locate the specific test you wish to modify. Proceed to the "Test Settings" section.

Step 2: Activate Exit Pass or Exit Fail Link:

Activate either the "Exit Pass Link" or "Exit Fail Link" slider, or both, depending on whether you want to redirect successful or unsuccessful test takers.

Step 3: Configure Redirection URLs:

Under the "Exit Pass Link" setting, input the URL that you want test takers to be directed to after they pass the test (e.g., http://www.yourserver.com/congratulations.html). Similarly, in the "Exit Fail Link" setting, set the URL for test takers who don't meet the passing criteria (e.g., http://www.yourserver.com/sorry.html).

Upon test completion, our server will automatically execute the redirection, appending relevant test taker information as URLEncoded GET parameters if delivery is enabled from integration settings.

How to Enable Exit Link URL Parameter Delivery:

If you'd like to have control over whether URL parameters are delivered, you can enable or disable this feature within the ACCOUNT TAB / INTEGRATION SETTINGS.

Understanding the Redirection Process:

Step 1: Automatic Redirection:

As soon as the test taker finishes the typing test, an automatic redirection process is initiated.

There will be 10 second delay before an automatic redirection occurs.  If the test settings allow more than 1 Attempts, the redirection still occurs immediately, while test taker can arrive back to try again.

Step 2: Redirection to Third-Party Page:

The redirection will take them to a third-party web page of your choice, where they can view or save their results. There will be 10 second delay before an automatic redirection occurs.  If the test settings allow more than 1 Attempts, the redirection occurs when the test taker clicks EXIT button.

Capturing Test Taker Information:

The following URL parameters are sent to the target page if enabled from Integration Settings:

```

https://www.typingtestpro.com/pro/exitlink.html?nwpm=11.1&gwpm=11.1&err=10&acc=100&firstname=first&lastname=last&status=pass&date=2023-05-02&email=[e-mail]

```

Most web frameworks will automatically decode this data, enabling you to use simple JavaScript code or server-side languages such as PHP's `$_GET["netspeed"]`.

Advanced Result Integration:

Step 1: Set Up Account and Access Integration Settings:

As an Administrator, access your account settings and navigate to the "Integration settings" section.

Step 2: Enable Result Link:

Enable the "RESULT LINK" setting and provide the URL (e.g., http://www.myserver.com/resultsaver.php) that should be called to process the results.

Upon test completion, our server will automatically call the Result Link URL, transmitting information as URLEncoded GET parameters.

If the test settings allow more than 1 Attempts, the delivery occurs each time when the test is done.

For example:

```

https://www.myserver.com/resultsaver.php?firstname=mrs&lastname=tester&email=something%40typingmaster.com&custom1=111&custom2=222&title=Standard+Typing+Test&text=Fishing+in+Finland&date=8%2F31%2F2009+8%3A45+AM&duration=01%3A00&status=Passed&keystrokesg=332keystrokesn=322&gross=66&units=wpm&errors=2&accuracy=96&netspeed=64

```

Just like before, server-side languages can effortlessly decode the passed data.

Seamless Integration for Optimal User Experience:

With these functionalities, enhancing the post-test experience of your users becomes a breeze. Whether it's immediate redirections or comprehensive result integration, our system empowers you to create a seamless user journey.

 

Automatic Login

Prepare to streamline the login process for test takers with our upcoming automatic login feature.

This innovation allows seamless access for users, eliminating the need for any manual data entry. No extra setup is required; you can effortlessly integrate this feature in your system. Employ the provided automatic login URL in various ways, such as using it as an iframe's src parameter or presenting it as a simple clickable link:

https://app.typingtestpro.com/test?id=eexxxjmx9xr9&email=[e-mail]&firstname=john&lastname=doe&customfield1=111&customfield2=222

The testId parameter denotes the specific test to be initiated for the user. Depending on your account's Plan, it's possible to configure multiple tests.

Upon first use, the link creates a new user profile automatically, incorporating the additional information into their data.

For further personalization and data management, leverage the customfield1 and customfield2 parameters. These can include special user information, like a user ID, which will later be passed to the Integration URL after the test. This enables storage in a database and can even serve as an authentication mechanism to enhance result security. For instance, generating a one-time secure hash at the beginning of the test and adding it as the customfield2 can validate result authenticity by comparing it to data from the Integration URL.

EASY INTEGRATION WITH ZAPIER STARTER OR PRO

Advanced Zapier

We're excited to tell you that our biggest clients are using ZAPIER to incorporate typing tests and assess results seamlessly into their recruitment systems. Please get in touch with us for comprehensive details.

Zapier Action:

• Start Test - deliver user data to the test with automatic login

Zapier Triggers:

• Candidate Passed: Triggers when a candidate successfully completes a typing test.
• Candidate Failed: Triggers when a candidate does not meet the criteria in a typing test.