Benodigde licentie
| Abonnement | Elk abonnement |
| Toegang | Admin |
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
- Open het Beheercentrum, dan Apps en integraties > Webhooks > Webhooks.
- Klik op Create webhook en kies hoe hij wordt aangeroepen: Zendesk events of Trigger or Automation. Dat is de eerste vraag en achteraf niet zomaar te wijzigen, dus lees hem goed.
- Geef hem een Name en Description, genoemd naar wat hij meldt en aan wie.
- Zet de Endpoint URL, de Request method en de Request format: JSON, XML of form-encoded.
- Zet de Authentication die het andere systeem verwacht: geen, een API-sleutel, basisauthenticatie of een bearertoken. Met Add header dek je af wat het verder nog vraagt.
- Klik op Test webhook en daarna op Create webhook.
Een webhook op Trigger or Automation hangt nog nergens aan. Dat doe je daarna vanuit de trigger, en dat is de volgende paragraaf.
Hem aanroepen vanuit een trigger
- Maak of bewerk een trigger.
- Zet de voorwaarden smal. Zie hieronder.
- Voeg de actie toe die de webhook aanroept.
- Bouw de inhoud van het bericht, met plaatsaanduidingen voor de ticketgegevens.
- 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.
Twee getallen om in gedachten te houden terwijl je de inhoud bouwt. De payload mag niet boven de 16.000 tekens komen, dus een bericht met een lange opmerking erin kan stranden op een ticket waar je niet mee hebt getest. En een mislukte aanroep wordt automatisch tot drie keer opnieuw geprobeerd, wat betekent dat het andere systeem dezelfde gebeurtenis meer dan eens kan ontvangen en daartegen moet kunnen.
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.
Een webhook die terugbelt naar je eigen Zendesk is een apart geval
Sommige webhooks wijzen naar je eigen account in plaats van naar een ander systeem, om een ticket bij te werken waar de trigger niet bij kan. Die werden meestal met een API-token geauthenticeerd, en die route sluit: vanaf 27 oktober 2026 kan er geen nieuw token meer worden aangemaakt en op 30 april 2027 stopt elk bestaand token.
Voor de meeste van deze gevallen doet Action Builder hetzelfde werk zonder enige inloggegevens, en dat is de eenvoudiger stap. Zendesk heeft gezegd OAuth voor webhooks toe te voegen vóór de deadline in april, maar er is geen datum genoemd, dus reken er niet op. Moet die van jou toch met een token blijven terugbellen, laat het ons weten; dan kijken we er ruim voor de datum naar in plaats van erop.
Opmerkingen
0 opmerkingen
Artikel is gesloten voor opmerkingen.