Een webhook maken en aan een trigger hangen

Een webhook definiëren en hem vanuit een trigger aanroepen. Twee stukken, en de voorwaarden op de trigger zijn het deel om voorzichtig mee te zijn.

Een webhook definiëren en hem vanuit een trigger aanroepen. Twee stukken, en de voorwaarden op de trigger zijn het deel om voorzichtig mee te zijn.

De webhook maken

1. Open het Beheercentrum, dan Apps en integraties, dan Webhooks.
2. Voeg een webhook toe en noem hem naar wat hij meldt en aan wie.
3. Zet het adres van het eindpunt en de aanvraagmethode.
4. Zet de authenticatie die het andere systeem verwacht.
5. Test hem vanaf het inrichtingsscherm.
6. Sla op.

Hem aanroepen vanuit een trigger

1. Maak of bewerk een trigger.
2. Zet de voorwaarden smal. Zie hieronder.
3. Voeg de actie toe die de webhook aanroept.
4. Bouw de inhoud van het bericht, met plaatsaanduidingen voor de ticketgegevens.
5. Test op één ticket voordat je hem aanzet.

Maak de voorwaarden smal

Een webhook maakt werk in een systeem dat jij niet beheert. Voorwaarden die net iets te ruim staan betekenen daar honderden ongewenste records, en dat opruimen is andermans middag.

Begin met een testtag als voorwaarde, bewijs dat het werkt, en verbreed daarna bewust.

De inhoud van het bericht

Stuur wat het andere systeem nodig heeft en verder niets. Een inhoud met het hele ticket inclusief alle opmerkingen stuurt klantgesprekken naar een ander systeem, en dat is net zozeer een vraag over gegevens als een technische.

Authenticatie

Wat het andere systeem ook eist, je richt het in op de webhook en niet in de trigger. Zo staan de inloggegevens op één plek en buiten je bedrijfsregels.

Zie ook

• Een webhook testen en storingen vinden
• Acties in een trigger
• Een trigger testen zonder klanten lastig te vallen