1. Before you start
- Rekruti sets up your recruiting agent with a job form channel, and the email channel it answers applicants with.
- Open your jobs: only job openings with the status Opened, on the Recruitment page of Rekruti, are listed in the form. See the recruiting guide.
- Put the form on one of the websites of your widgets: on another site, the form says that applications are not open.
2. Installation
Add an empty element where the form should appear, and the following script tag just before the closing
</body> tag of the page.
<div id="nc-job-form"></div>
<script src="https://cdn.rekruti.com/jobform.v1.1.js"
data-backend-url="https://relay.rekruti.com/jobform"
data-client-key="YOUR-CLIENT-KEY"
data-agent-key="YOUR-JOB-FORM-CHANNEL-KEY"
data-language="en"
data-container="#nc-job-form"></script>
Rekruti gives you this code with both keys filled in: data-client-key is the key of your
Rekruti account, and data-agent-key the key of your agent’s job form channel — not that of
its chatbot or voicebot, as each channel has its own.
3. Configuration parameters
Set on the script tag.
| Attribute | Required | Description | Default |
|---|---|---|---|
data-backend-url | Yes | Address of the Rekruti relay: https://relay.rekruti.com/jobform | |
data-client-key | Yes | The key of your Rekruti account | |
data-agent-key | Yes | The key of your agent’s job form channel | |
data-language | en or fr: the labels of the form, and the language of the answer | en | |
data-title | Title above the form | ||
data-container | CSS selector of the element to draw the form in | Before the script | |
data-accent-color | Colour of the button | #0c70a1 | |
data-accent-text-color | Colour of the text of the button | #FFFFFF | |
data-debug | true to show, under a failure, why it failed: while you set the form up | false |
4. How it works
- The form lists your opened jobs, and Spontaneous application last.
- The applicant gives a name and an email, picks a job and attaches up to 3 files, 10 MB in all: PDF, Word (.doc, .docx), OpenDocument (.odt), RTF, text, JPEG or PNG. A résumé, a cover letter or a certificate, for example.
- The application is sent to Rekruti at once, and the applicant is thanked right away.
- Your agent reads the files and adds the applicant to the job picked. A spontaneous application goes to the opened job that matches it best.
- Your agent answers by email, usually within minutes.
The applicant then appears on the job opening in Rekruti, with their documents and their evaluation: see the recruiting guide.
5. Styling with CSS
For more than the button colours, style the form from your own stylesheet. Start your selectors with
body to win, rather than using !important.
body .ncj-primary { padding: 12px 28px; }
| Selector | What it is |
|---|---|
.ncj | The form |
.ncj-title | The title |
.ncj-field | A label and its field |
.ncj-hint | The note under the files |
.ncj-primary | The Apply button |
.ncj-status | The messages under the button |
6. Testing and troubleshooting
- Test before you install — ask Rekruti to send a test application with you: the applicant is added to the job, and the agent’s answer arrives by email.
- “Applications are not open at the moment” — the agent’s job form channel is not set up, or the page is not on one of the websites of your widgets.
- Only “Spontaneous application” in the list — no job has the status Opened. Applicants can still apply.
- Files refused — more than 3 files, more than 10 MB in all, or a type not listed above.
- “Invalid configuration” — a key is missing or malformed. Paste the code exactly as Rekruti gave it to you.
- No answer by email — check your spam folder, then ask Rekruti to check the agent’s email channel.
Need help with your job form? Write to us, or book a demo if you are not a Rekruti client yet.
All guides