Installation guide

Installing the Rekruti job form on your careers page

The Rekruti job form goes on your careers page with a few lines of HTML. Applicants pick one of your opened jobs, or apply spontaneously, and send their résumé. Your AI recruiting agent adds them to the job and answers them by email within minutes.

1. Before you start

  1. Rekruti sets up your recruiting agent with a job form channel, and the email channel it answers applicants with.
  2. 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.
  3. 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.

AttributeRequiredDescriptionDefault
data-backend-urlYesAddress of the Rekruti relay: https://relay.rekruti.com/jobform
data-client-keyYesThe key of your Rekruti account
data-agent-keyYesThe key of your agent’s job form channel
data-languageen or fr: the labels of the form, and the language of the answeren
data-titleTitle above the form
data-containerCSS selector of the element to draw the form inBefore the script
data-accent-colorColour of the button#0c70a1
data-accent-text-colorColour of the text of the button#FFFFFF
data-debugtrue to show, under a failure, why it failed: while you set the form upfalse

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; }
SelectorWhat it is
.ncjThe form
.ncj-titleThe title
.ncj-fieldA label and its field
.ncj-hintThe note under the files
.ncj-primaryThe Apply button
.ncj-statusThe 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