TABLE OF CONTENTS

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

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. 

There are four 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.

  1. Open the page application portals. Press on the name of the application portal where all job ads should get the WhatsApp button.
  2. Press 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 your company's password policy.
  5. Send username and password via email to PitchYou.
  6. Enter in the field additional header the code/script (click here to jump to the code) .
  7. Press the button Update.

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.

  1. Open the page job advertisement templates. Call one by one all job ad templates which should get a WhatsApp button.
  2. Press 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. Press the button Update.
  5. Open the page application portals. Press 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. 
  6. At the field application import activate the option protected.
  7. Enter username and password according to your company's password policy.
    Important: Enter the same username and password for each application portal. 
  8. Send username and password via email to PitchYou.
  9. Press the button Update.

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. Press on the tab job advertisement. 
  3. Press the edit icon behind Introduction. 
  4. Press 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. Press 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.


WhatsApp 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. Press 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. Send username and password via email to PitchYou.
  6. Press the button Update.


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

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 customer name as used by PitchYou. This must be requested there beforehand.
  • 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).