TABLE OF CONTENTS

It is possible to submit an application via WhatsApp interview through our partner PitchYou.

This allows you to get the answers to your questions from the application questionnaire easily via WhatsApp chat. There is also room for individual screening questions tailored to your target group.

Before the actual integration in the applicant management system, the contractual agreement with PitchYou is required. You can find the contact here: Service: WhatsApp application with PitchYou


In order to use this function, you also need a WhatsApp button that the applicant can click on. How to set this up, you can find out here. The "Apply with WhatsApp" button is intended to be displayed on pages generated by d.vinci (e.g. job advertisements on the homepage). Agencies and our partner talentsconnect are also able to integrate this button on the homepage. The buttons is not displayed on job boards (e.g. StepStone).

There are five ways to set up the button.

Button in all publications of an application portal

All job advertisements of this application portal are provided with the WhatsApp button.

Useful for example for all job advertisements on the homepage.


Application Portals

  1. Open the page application portals. Click the name of the application portal where all job ads should get the WhatsApp button.
  2. In Functions, click the edit icon . An input form will open.
  3. At the field application import activate the option protected.
  4. Enter username and password according to the instructions.
  5. Make a note of both values so that you can enter them later in the PitchYou onboarding form.
  6. Enter in the field additional header the code/script (click here to jump to the code) .
  7. Click the button Update.


PitchYou Onboarding Form

You should have received an email from PitchYou with a link to the onboarding form. Click this link.

  1. Follow the instructions in the onboarding form.
  2. In the Dvinci API access data section, enter the username and password of your protected application import:
    the username in the API user input field
    the password in the API password input field
  3. In the onboarding form, click the corresponding Finish button.


Button in selected job advertisement templates

All job postings based on the job ad templates will have the WhatsApp button.

Useful, for example, for all job ads targeting the education group.


Job Advertisement Templates

  1. Open the page job advertisement templates. Call one by one all job ad templates which should get a WhatsApp button.
  2. Click the edit icon in the tab data . An input form will open.
  3. In the field additional header enter the code/script (click here to jump to the code).
  4. Click the button Update.


Application Portals

  1. Open the page application portals. Click the name of the application portal where these job ad templates are used. If there are several application portals, please repeat steps 5 - 8 for each application portal.
  2. In Functions, click the edit icon . An input form opens.
  3. At the field application import activate the option protected.
  4. Enter username and password according to the instructions.
    Important: Enter the same username and password for each application portal.
  5. Make a note of both values so that you can enter them later in the PitchYou onboarding form.
  6. Click the button Update.


PitchYou Onboarding Form

You should have received an email from PitchYou with a link to the onboarding form. Click this link.

  1. Follow the instructions in the onboarding form.
  2. In the Dvinci API access data section, enter the username and password of your protected application import:
    the username in the API user input field
    the password in the API password input field
  3. In the onboarding form, click the corresponding Finish button.


Button in selected job openings

The button can be activated for selected calls for tenders.

Useful for example for tenders that are rather difficult to fill. 


The prerequisite is that one of the two upper variants is already implemented.

Inserting the WhatsApp div in the job advertisement template

  1. Call any job advertisement template that should potentially get the button. 
  2. Click the tab job advertisement. 
  3. Click the edit icon behind Introduction. 
  4. Click the button Source in the HTML editor. 
  5. Paste the following code: 
    <div id="whatsapp" style="display:none" data-value="{JOB_OPENING_FF:WHATSAPP}"></div>
  6. Click the button Update.

Create form field 

You need to create a form field that can be used to control the button in the job posting.

Create a new form field

Configuration

Field: Enable WhatsApp

Element: Advertisement

Type: Yes/No

Can be used in correspondence templates and job openings: Yes

Placeholder name: WHATSAPP

Mandatory field: No

Display in reports: No

Transfer via interface: No

Display help text: Yes

Help text: If "Yes" is selected, the WhatsApp button will be displayed in the job ad.

Button in case of job advertisement generation by an agency

In the case of retrieving publication data via interface and displaying job ads e.g. for the homepage by the agency, the agency must ensure the integration of the WhatsApp button.

A general activation of the button or based on data of the advertisement can be done by means of the data of the interface retrieval.


If only certain job openings are to be provided with the button, this way is to be chosen.


Default settings in d.vinci

Create form field 

A form field has to be created with which the button can be controlled in the RFx.

Create a new form field

Configuration

Field: Activate WhatsApp

Element: Advertisement

Type: Yes/No

Can be used in correspondence templates and job alerts: Yes

Placeholder name: WHATSAPP

Mandatory field: No

Display in reports: No

Transfer via interface: Yes

Display help text: Yes

Help text: If "Yes" is selected, the WhatsApp button is displayed in the job advertisement.


Application portals

  1. Open the page application portals. Press on the name of the application portal that will be retrieved from the Agenzur.
  2. In Functions, click the edit icon . An input form opens.
  3. At the field application import activate the option protected.
  4. Enter username and password according to your company's password policy.
  5. Make a note of both values so that you can enter them later in the PitchYou onboarding form.
  6. Click the button Update.


PitchYou Onboarding Form

You should have received an email from PitchYou with a link to the onboarding form. Click this link.

  1. Follow the instructions in the onboarding form.
  2. In the Dvinci API access data section, enter the username and password of your protected application import:
    the username in the API user input field
    the password in the API password input field
  3. In the onboarding form, click the corresponding Finish button.


To be done by the agency 

Appearance and placement of the button in the job ad needs to be customized by the agency.

The parameterized URL must be stored behind the Apply with WhatsApp button.

All relevant getParameters are available in the interface from the application portal per publication and must be merged as URL.


https://<KUNDE>.pitchyou.de/go/+ dvinciJobId + ?title=+ dvinciJobTitle + &applicationApplyApiURL= + encodeURIComponent(dvinciApplyApiURL) + &lang= + dvinciLanguage


The finished query might then look like this:

https://testkunde.pitchyou.de/go/4711?title=berufskraftfahrer-mwd-und-transportunternehmer-mwd&applicationApplyApiURL=https%3A%2F%2Ftestkunde.dvinci-hr.com%2Fp%2Fdhp%2Fjobs%2F4711%2FapplyApi&lang=de

Button in case of job advertisement import by talentsconnect

If job publication data is retrieved via an interface and job advertisements are imported to a career site by the provider talentsconnect, PitchYou must ensure that the WhatsApp button is integrated into talentsconnect. If you work with talentsconnect, a secure application import is already activated in your application portal and a username and password are stored. This information must be submitted separately to PitchYou, which will send you an email with a link to their onboarding form.


Default settings in d.vinci

Create form field 

A form field has to be created with which the button can be controlled in the RFx.

Create a new form field

Configuration

Field: Activate WhatsApp

Element: Advertisement

Type: Yes/No

Can be used in correspondence templates and job alerts: Yes

Placeholder name: WHATSAPP

Mandatory field: No

Display in reports: No

Transfer via interface: Yes

Display help text: Yes

Help text: If "Yes" is selected, the WhatsApp button is displayed in the job advertisement.


Application portals

  1. Open the page application portals. Press on the name of the application portal that will be retrieved from the Agenzur.
  2. In Funtions, click the edit icon . An input form opens.
  3. Make a note of contens of the input fields Application Import Username and Application Import Password so that you can enter them later in the PitchYou onboarding form.
  4. Click the button Update.


PitchYou Onboarding Form

You should have received an email from PitchYou with a link to the onboarding form. Click this link.

  1. Follow the instructions in the onboarding form.
  2. In the Dvinci API access data section, enter the username and password of your protected application import:
    the username in the API user input field
    the password in the API password input field
  3. In the onboarding form, click the corresponding Finish button.

Script for the additional header (application portal or job ad template)


<script src="https://static.dvinci-easy.com/files/js-d5-utils/apply-with-whatsapp/apply-with-whatsapp.min.js"></script>
<script>
  dvinciUtils.applyWithWhatsappConfig = {
    env: "CUSTOMER",
    isActiveByFormField: true,
    translations: {
      en: "Bewerben mit WhatsApp",
      en: "Apply with WhatsApp"
    }
  }
</script>

Explanation of the parameters

  • env:
    Is the so-called identifier as used by PitchYou. This is provided to you by PitchYou as part of the onboarding process and usually corresponds to your subdomain.
  • isActiveByFormField:
    If you want to display the button in selected tenders, the value must be as follows: true.
    For all other options it is optional. The value is false.
  • translations:
    Allows you to control the naming of the button in German (DE) and English (EN).