Webhooks

  • Laatst geupdate op 15 mei 2023 om 13:51

Opmerking: Kunt u dit niet vinden in uw Cloud? Deze functie is beschikbaar met het Plus Plan van TimeMoto Cloud. Als u het meeste uit uw TimeMoto account wilt halen, zorg er dan voor dat u uw plan upgradet naar uw behoeften!

Wilt u meer uit de TimeMoto Cloud ervaring halen? Hoewel ons systeem al op zichzelf werkt met verschillende modules zoals onze TimeMoto klokken en een browser en mobiele applicatie, kunt u nog meer doen! Bekijk hoe u webhooks kunt gebruiken om TimeMoto met uw eigen systemen te laten communiceren om dit de beste optie te maken die precies aan uw behoeften voldoet.

Vind de ontwikkelaarsopties door helemaal naar beneden te scrollen vanaf elke plek in uw cloud en de link [Ontwikkelaarsopties] in de voettekst te selecteren.

Ontwikkelaarsopties

De ontwikkelaarsopties zijn verdeeld in twee segmenten. [Ontwikkelaarsopties] en [Webhooks]. In de Ontwikkelaarsopties kunt u instellen op welke globale versie uw webhooks zullen terugvallen. 

Webhooks

Klik op [Webhooks] om toegang te krijgen tot uw specifieke webhook-instellingen.

Hier ziet u een lijst van uw reeds toegevoegde webhooks met daarin:

  • de naam van de webhooks
  • de URL van de webhook
  • de versie van het communicatieprotocol dat de webhook gebruikt
  • de Ingeschakelde status van de webhook
  • het foutpercentage van de webhook (mislukte pogingen).

Hoe werkt een webhook?

Een webhook is een manier om een software te informeren over de gebeurtenissen van een andere software. 

Stelt u zich een baliemedewerker voor die zijn collega moet laten weten of een bepaalde klant in het gebouw is aangekomen. Zodra de baliemedewerker de betreffende klant ziet, pakt hij de telefoon en belt zijn collega om hem te informeren. 

Zo werkt een webhook. Om dit te vertalen naar de software wereld: Je stelt een gebeurtenis in die de webhook moet triggeren (zoals, in dit voorbeeld, de receptie). Zodra de gebeurtenis heeft plaatsgevonden (de klant die aankomt), sturen de webhooks de informatie naar een URL (het telefoonnummer van de collega) om de details door te geven.

Webhooks toevoegen

Zorg ervoor dat u de sectie webhook hebt geselecteerd. Om een nieuwe webhook aan te maken, klikt u rechtsboven op de knop [Webhook toevoegen]. Vul in het volgende formulier alle noodzakelijke gegevens in:

  • Geef de webhook een Naam. Een naam identificeert een webhook en maakt het gemakkelijker te vinden in uw lijst.
  • De Status bepaalt of de webhook momenteel actief of inactief is.
  • Voeg de URL van het webhook adres in. Denk eraan dat dit HTTPS moet zijn.
  • Optioneel kunt u de webhook aan een specifieke versie van het communicatieprotocol koppelen of leeg laten. Als u dit leeg laat, zal de webhook de globale versie gebruiken die is gedefinieerd in uw ontwikkelaarsopties of, als deze ook leeg blijkt te zijn, de laatste stabiele vooraf ingestelde versie.
  • Selecteer de gebeurtenissen die de webhook moeten triggeren. U kunt meerdere gebeurtenissen selecteren, zoals aanwezigheid of gebruikersgegevens die worden ingevoegd, bijgewerkt of verwijderd.

Zodra u klaar bent, klikt u op [Opslaan] om de webhook aan uw lijst toe te voegen.

Zodra u de webhook heeft aangemaakt, kunt u erop klikken om meer details te zien.

Geheim

Nee, we hebben het niet over de verborgen geheimen van een bedrijf. Een Secret is een token dat moet garanderen dat uw URL alleen legitieme gegevens van TimeMoto Cloud's webhooks ontvangt. Een soort zegel van goedkeuring.

Pogingen

Als u er zeker van wilt zijn dat de webhook werkt zoals bedoeld, kunt u hier een lijst zien van alle uitvoerpogingen gedocumenteerd met status, type gebeurtenis, gebeurtenis-ID en de exacte tijdstempel van de uitvoer. Bij een mislukte poging ziet u ook wanneer het systeem de uitvoer opnieuw gaat proberen.

Als u niet wilt wachten op een werkelijke gebeurtenis, kunt u ook klikken op [Send test webhook] om een testpoging te starten. Deze zal als zodanig worden gecategoriseerd.


Heeft u nog vragen?
Op zoek naar antwoorden maar niet zeker waar te beginnen? Bekijk onze verklarende woordenlijst! Het is een geweldige bron om u te helpen de informatie te vinden die u nodig hebt. Als u meer hulp nodig hebt, neem dan contact met ons op via het contactformulier.

Was dit artikel behulpzaam?