Tigris Website API

Met de Tigris Website API is het mogelijk om uw eigen website te integreren met uw Tigris
omgeving. Hierdoor is het mogelijk om vanuit het systeem vacatures op je website te plaatsen en sollicitaties automatisch binnen te laten komen in Tigris. 

Let op: 

Api versie

Gebruik zoveel mogelijk de nieuwste api versie. Deze kun je in Salesforce vinden op de volgende manieren: https://www.youtube.com/watch?v=jCsK64zIxbc

Je kunt dit versienummer ophogen in de url waartoe je de request/post doet. Bijvoorbeeld: https://<jouwdomein>.my.salesforce.com/services/data/v50.0/sobjects/tigris__vacancy__c/<recordid>

SSL certificaat

Daarnaast dient de website te beschikken over een geldig ssl certificaat dat door Salesforce wordt geaccepteerd. Uitleg hierover vindt je hier:  https://help.salesforce.com/articleView?id=000326722&type=1&mode=1

Stap 1: Verbinding opzetten met Tigris/Salesforce

Creëer een connected app in Salesforce (dit wordt gedaan door een Tigris consultant). Dit zorgt ervoor dat er een secret key en een public key gegenereerd wordt.

Om dit goed in te kunnen stellen heeft Tigris de onderstaande zaken nodig:

1. Domein waar de vacatures heen gepost worden/waar de sollicitaties vandaan komen

2. Callback URL (voor authenticatie)

3. Streaming URL (voor het posten van de XML met de vacatures)

Als deze gegevens zijn aangeleverd door de webbouwer, wordt er door Tigris een connected app gemaakt. Vervolgens worden de consumer key en consumer secret door Tigris aangeleverd zodat de webbouwer hiermee de beveiligde verbinding kan opzetten.

Zie onderstaande Salesforce artikelen voor meer informatie:

- https://help.salesforce.com/articleView?id=remoteaccess_oauth_endpoints.htm&type=5

- https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_defining_remote_access_applications.htm

Let op: Met de consumer key en consumer secret is het mogelijk om de verbinding op te zetten en een bearer token op te halen. Deze token verloopt ook weer. Aan de kant van de website dient dus gecontroleerd te worden of de bearer token nog geldig is. Zo niet dan dient hij opnieuw aangevraagd te worden voordat je een api call kunt doen. Maak nooit gebruik van alleen de Salesforce gebruikersnaam en wachtwoord zelf. Deze kunnen namelijk veranderen waardoor de verbinding daarna niet meer mogelijk is.

Stap 2: Ontvangen van de vacatures

Tigris stuurt de gegevens door wanneer er een vacature is gemaakt, gewijzigd of verwijderd.
Jullie kunnen een URL opgeven waar Tigris de XML naar toe mag sturen.

Een voorbeeld van de XML die verzonden wordt (afhankelijk van welke velden nodig zijn):

<?xml version="1.0" encoding="UTF-8"?><Data><OrganizationId>00D1t000000Dq5kEAC</OrganizationId><Notifications><Notification><ActionType>update</ActionType><sObject><Id>a151t000000hCHfAAM</Id><Name>Productieplanner</Name><CreatedDate>2018-09-04 08:42:57</CreatedDate><Tigris__Geplaatst__c>true</Tigris__Geplaatst__c><Tigris__Vacaturenummer__c>V-00000027</Tigris__Vacaturenummer__c><Tigris__Owner_name__c>Pieter de Werker</Tigris__Owner_name__c><Tigris__Company_name__c>Test Bedrijf</Tigris__Company_name__c><Tigris__Introductie__c>Voor een bedrijf actief in de levensmiddelenindustrie zoeken wij ter versterking van het huidige team een gemotiveerde productieplanner.</Tigris__Introductie__c><Tigris__Vacature_omschrijving__c><p><span style="color: rgb(112, 110, 107); background-color: rgb(255, 255, 255);">Als productieplanner ben je verantwoordelijk voor het functioneren van de interne productieprocessen. Je maakt per productielijn een dagplanning en bewaakt de voortgang in overleg met de diverse afdelingen. Je zorgt ook voor een optimale personele bezetting waarbij zowel eigen mensen als inleenkrachten worden ingezet.</span></p></Tigris__Vacature_omschrijving__c><Tigris__Gevraagd_wordt__c><p><b>Wij vragen:</b></p><ul><li>Ervaring in een soortgelijke functie binnen de foodindustrie;</li><li>Enthousiasme, stressbestendigheid en accuratesse;</li><li>Affiniteit met voedsel- en kwaliteitssytemen;</li><li>Een flexibele instelling qua werktijden.</li></ul></Tigris__Gevraagd_wordt__c><Tigris__Geboden_wordt__c><p><b>Wij bieden:</b></p><ul><li>Een veelzijdige job met afwisseling en uitdaging;</li><li>Een prima salaris en goede secundaire arbeidsvoorwaarden;</li><li>Kans op een vast dienstverband bij gebleken geschiktheid.</li></ul><p><b style="background-color: transparent;">Interesse?</b></p><p>Ben je enthousiast geworden over deze vacature? Wacht dan niet langer en maak gebruik van ons sollicitatieformulier. Wij nemen dan zo <a href="mailto:test@test.nl" target="_blank">test@test.nl</a>.</p></Tigris__Geboden_wordt__c><Tigris__Bedrijfsomschrijving__c><p><b>Wie zijn wij:</b></p><p>Flexbureau is een regionaal detachering- en uitzendbureau. We houden van korte lijnen, persoonlijk contact en hechten veel waarde aan betrouwbaarheid. We kennen onze klanten en vakkrachten en zij kennen ons. Ben je benieuwd naar wat we voor jou kunnen betekenen? Neem dan contact met ons op voor een vrijblijvende kennismaking.</p></Tigris__Bedrijfsomschrijving__c><Tigris__Uren_per_week__c>40</Tigris__Uren_per_week__c><Tigris__Soort_dienstverband__c>Vast</Tigris__Soort_dienstverband__c><Tigris__Salaris_van__c>1750.00</Tigris__Salaris_van__c><Tigris__Salaris_tot__c>2250.00</Tigris__Salaris_tot__c><Tigris__Functiegroep__c>Inkoop/Logistiek/Transport</Tigris__Functiegroep__c><Tigris__Salaris_per__c>Maand</Tigris__Salaris_per__c><Tigris__Postcode__c>2952AD</Tigris__Postcode__c><Tigris__Plaats__c>Alblasserdam</Tigris__Plaats__c><Tigris__Opleidingsniveau__c>MBO</Tigris__Opleidingsniveau__c><Tigris__Land__c>Nederland</Tigris__Land__c><Tigris__Huisnummer__c></Tigris__Huisnummer__c><Tigris__Branche__c>Logistiek</Tigris__Branche__c><Tigris__Bedrijfstak__c>Maak een keuze</Tigris__Bedrijfstak__c><Tigris__Office__c>Gorinchem</Tigris__Office__c><Tigris__Interne_vacature__c>true</Tigris__Interne_vacature__c></sObject></Notification></Notifications></Data>"

Vacature online plaatsen/offline halen

Tigris__Offline__c = Wanneer deze op “true” staat is de vacature offline gehaald.
Tigris__Geplaatst__c = Wanneer deze op “true” staat is de vacature online gezet.

Wanneer ze beide op true staan dan dient de vacature offline te zijn.

Stap 3: Vacature gegevens terug sturen naar Tigris

Nadat de vacature zichtbaar is op de website is het nodig om het externe ID (Post ID) en URL
van de vacature terug te sturen naar Tigris. Dit is benodigd voor het matchen van sollicitaties in Tigris en de URL wordt gebruikt voor mulitposting naar andere vacaturesites. Hiervoor wordt een patch methode gebruikt.

URL die gebruikt wordt om te updaten: https://<jouwdomein>.my.salesforce.com/services/data/v50.0/sobjects/tigris__vacancy__c/<recordid>

Het vacaturenummer van de vacature is zichtbaar geworden op de website.

Voorbeeld json:

{
"Tigris__Vacature_url__c": "www.tigris.nl/hello",
"Tigris__Extern_vacature_ID__c": "12345"
}

Wanneer je een compleet nieuwe vacature wil sturen is dit mogelijk met de volgende URL: https://<jouwdomein>.my.salesforce.com/services/data/v50.0/sobjects/Tigris__Vacancy__c

Alle velden die in de eerder genoemde voorbeeld XML zichtbaar zijn, zijn te vullen. Mocht het nodig zijn dan is het mogelijk om aan de Tigris kant extra velden aan te maken.

Stap 4: Sollicitaties doorsturen naar Tigris

Wanneer er op een vacature gesolliciteerd wordt dient dit naar Tigris gestuurd te worden.
Hiervoor wordt een post methode gebruikt.

URL die gebruikt wordt om de sollicitatie naartoe te sturen: https://<jouwdomein>.my.salesforce.com/services/data/v20.0/sobjects/Tigris__sollicitatie__c

Voorbeeld json:

{ "Tigris__Voornaam_kandidaat__c": "MaxwellHo",
"Tigris__Achternaam_kandidaat__c": "Lambert",
"Tigris__Mobiel_nummer__c": "+1 (867) 429-2788",
"Tigris__Email__c": "test@tigris.nl",
"Tigris__Extern_vacature_ID__c" : "extern id van de vacature",
"Tigris__UTM_url__c ": "url inclusief utm”,
}

Na insert wordt er een succesbericht teruggestuurd, met daarin het ID van het sollicitatierecord (applicationID).

Voorbeeld succesbericht

{
"id": "a0V1n00000DjC1dEAF",
"success": true,
"errors": []
}

Dit ID kan dan gebruikt worden om de bijlage te relateren aan het sollicitatierecord.

Bijlage URL: https://<jouwdomein>.my.salesforce.com/services/data/v50.0/sobjects/Attachment/

Voorbeeld bijlage toevoegen

{
'ParentId': applicationID,
'Name': 'test_cv.txt',
'body': body
}

Belangrijk: Bij de naam van het CV dient als suffix _cv aan toegevoegd te worden. Zo weet het systeem dat het om een CV gaat en deze ook geparset mag worden door Textkernel.

Stap 5: Open sollicitaties

Een open sollicitatie werkt met dezelfde methode als stap 4. Echter is deze sollicitatie niet
op een vacature, dus is er geen extern vacature ID bekend. Hierdoor is het benodigd om een
extra waarde mee te geven. Dit is de vestiging. Het is mogelijk om in het open sollicitatie
formulier een keuzelijst met vestigingen toe te voegen en de geselecteerde waarde door de
kandidaat mee te sturen naar Tigris.

Voeg deze tag toe aan de json:

"Tigris__Office_from_website__c": "Alblasserdam",

Opties:

• Het is mogelijk om extra waarde mee te geven of naar het Tigris platform toe te
  sturen. Wanneer dit gewenst is, neem contact op met een Tigris consultant.
• Het is mogelijk om ter controle alle vacatures eens per dag op te halen. Je kunt hier
  een query voor bouwen. Een voorbeeld hiervan:
  https://<jouwdomein>.my.salesforce.com/services/data/v50.0/query/?q=SELECT+name,
  Tigris__geplaatst__c+from+Tigris__Vacancy__c+where+Tigris__geplaatst__c=true