Overzicht van webhooks

Wat zijn webhooks?

Een webhook is een bericht dat automatisch tussen applicaties wordt verstuurd wanneer een specifiek event plaatsvindt. Het is een ideale manier om applicaties te koppelen en workflows te automatiseren. In Role.so kun je kandidaatgegevens, zowel van geïnteresseerde als afgewezen kandidaten, naadloos naar elk platform sturen dat webhooks ondersteunt, waaronder Make, Zapier en meer.

Gebruikssituaties en voorbeelden

Je kunt je workflow voor elke situatie automatiseren en aanpassen:

• contactgegevens van geïnteresseerde kandidaten naar een Google-spreadsheet sturen
• automatisch een sms sturen naar een kandidaat die interesse in een functie heeft getoond
• een melding in Slack sturen wanneer een kandidaat interesse toont of een functie afwijst
• kandidaatgegevens opslaan in het applicant-tracking-systeem van je keuze

Events

Bij het maken van een webhook kun je uit twee eventtypen kiezen: Interested en Declined. Deze events komen rechtstreeks overeen met de twee formulieren in elk kandidatenpakket. Nadat een formulier is verzonden, sturen we een bericht naar alle actieve webhooks die bij het eventtype passen.

Gegevens

Afhankelijk van het eventtype (interested of declined) sturen we een vaste datastructuur. Je kunt deze gegevens gebruiken om automatiseringen in je applicaties te maken en je workflow uit te breiden.

Gegevens bij interesse

Als er geen antwoorden op aangepaste vragen worden ingediend, wordt de eigenschap custom_answers volledig weggelaten uit de payload in plaats van op null te worden ingesteld. Andere niet-gebruikte of uitgeschakelde scalaire velden krijgen de waarde null, terwijl attachments altijd een array is en [] bevat als er geen bestanden worden geüpload. Als in het interesseformulier van je kandidatenpakket alleen de velden name en email zijn ingeschakeld, versturen we bijvoorbeeld de volgende gegevens:

Gegevens bij afwijzing

De gegevens bij afwijzing hebben een vergelijkbare structuur:

Als je aangepaste afwijzingsredenen op je formulier hebt ingesteld, sturen we deze gegevens in plaats daarvan. Als je aangepaste redenen bijvoorbeeld zijn ingesteld op Reden 1 en Reden 2, versturen we de volgende gegevens:

Veelgestelde vragen

V: Is deze functie beschikbaar in het abonnement Starter?

A: De toegang hangt af van de functies die bij je huidige abonnement zijn inbegrepen. Als je account de webhookfunctie bevat, kun je deze functie gebruiken; anders toont het dashboard de beschikbare upgradeopties.

V: Hoeveel webhooks kan ik maken?

A: Je kunt momenteel maximaal 4 webhooks maken.

V: Worden events en meldingen realtime verstuurd?

A: In de meeste gevallen wel. Het kan echter 1 tot 5 minuten duren voordat de gegevens naar je applicatie worden verstuurd.

V: Kan ik testevents versturen?

A: Ja, je kunt testmeldingen versturen om je workflow eenvoudig in te stellen zonder de statistieken van je kandidatenpakketten te beïnvloeden. Lees het helpartikel Een testevent versturen voor meer informatie.

V: Hoe worden fouten afgehandeld?

A: Herstelbare fouten, zoals netwerkfouten, time-outs, HTTP 5xx-antwoorden en bepaalde tijdelijke 4xx-antwoorden, krijgen in totaal maximaal 8 afleverpogingen: de eerste poging plus maximaal 7 nieuwe pogingen. Permanente fouten, zoals ongeldige payloads, door het beveiligingsbeleid geblokkeerde endpoints en andere 4xx-antwoorden, stoppen na de eerste poging. Een webhook kan al na één afleverfout als mislukt worden gemarkeerd en een definitief mislukte aflevering kan handmatig opnieuw worden geprobeerd. Lees het helpartikel Webhooks controleren voor meer informatie.

V: Wat gebeurt er als een webhook na verloop van tijd blijft falen? Word ik hiervan op de hoogte gebracht?

A: Niet rechtstreeks. We markeren de webhook als mislukt en voegen een badge Mislukt aan de webhook toe. Aanhoudende bezorgfouten schakelen de webhook niet automatisch uit. Controleer het endpoint en schakel de webhook indien nodig handmatig uit vanaf de webhooks-pagina. Lees het helpartikel Webhooks controleren voor meer informatie.