Webhooks - Shifton Help

Webhooks laat Shifton toe om intydse kennisgewings na eksterne stelsels te stuur wanneer gebeurtenisse in jou maatskappy plaasvind.

Stap-vir-stap instruksies

Toegang tot die Webhooks-oortjie

Klik op die linkerkantbalk op Integrasies.

Gaan na die Ontwikkelaar-bladsy → oortjie Webhooks.

Skep ‘n nuwe webhook

Klik «Nuwe webhook».

Vul die konfigurasie in:

Veld	Beskrywing
URL	Eindpunt vir die ontvangs van gebeurtenisdata
Gebeure	Shifton-gebeurtenisse wat die webhook aktiveer
Aktief	Skakelaar om te aktiveer/deaktiveer

Stoor. Shifton sal HTTP POST-versoeke na die aangeduide URL stuur.

Bestuur webhooks

Klik op ‘n webhook om die URL te wysig, gebeurtenisse op te dateer of die aktiwiteitstatus te verander.

Toets ‘n webhook

Veroorsaak die ooreenstemmende gebeurtenis in Shifton (bv. skep ‘n toetsskof).

Kontroleer jou bedienerlogboeke — die data behoort te arriveer.

Verwante artikels

Gereelde vrae

V: In watter Skepaat stuur skofon data?
HTTP POST met ‘n liggaam in JSON-formaat. Sien die API-dokumentasie vir die datastruktuur per gebeurtenistipe.

V: Kan ek verskeie webhooks vir een gebeurtenis skep?
Ja, met verskillende URL’s.

V: Wat as die bediener onbeskikbaar is wanneer die webhook afvuur?
Aflewering kan misluk. Besonderhede oor die herprobeerbeleids is in die API-dokumentasie.

V: Die webhook vuur nie af nie — hoekom?
Maak seker dat die Aktief-skakelaar geaktiveer is en die URL publiek toeganklik is.

V: Hoe kontroleer ek of die webhook data ontvang?
Skep ‘n toetsgebeurtenis in Shifton (bv. voeg ‘n skof by) en kontroleer jou bedienerlogboeke vir ‘n inkomende POST-versoek.

V: Kan ek webhook-verifikasie instel?
Ja. Voeg ‘n geheime sleutel of token by die webhook se URL of kopstukke. Besonderhede is in die API-dokumentasie.

V: Hoe lyk die webhook-versoekliggaam?
‘n JSON-objek met gebeurtenisdata. Die struktuur hang af van die gebeurtenistipe — sien die API-dokumentasie vir voorbeelde.

V: Kan een webhook verskeie gebeurtenisse Maandagitor?
Ja. Kies verskeie gebeurtenisse wanneer jy die webhook skep — een URL sal kennisgewings vir alle gekose gebeurtenisse ontvang.

V: Wat is die “herprobeerbeleids” vir webhooks?
As die bediener ‘n fout (nie 200) teruggee, kan Shifton die versoek herhaal. Besonderhede hang af van die platformkonfigurasie.

V: Is daar ‘n limiet op die aantal webhooks?
Geen beperkings is in die dokumentasie aangedui nie, maar dit word aanbeveel om slegs die nodiges te skep.

V: Moet ek HTTPS vir die webhook-URL gebruik?
Dit word aanbeveel. HTTP-adresse mag werk, maar HTTPS verseker veilige data-oordrag.

V: Kan ek webhook-kennisgewings ontvang by elke roosterverandering?
Ja. Voeg gebeurtenisse soos “Verskuiwing geskep” of “schedule updated” by wanneer jy die webhook opstel.

V: Wie het toegang om webhooks te skep?
Slegs Owner. Bestuurders en werknemers sien nie die Developer-afdeling nie.

V: Kan ek ‘n webhook deaktiveer sonder om dit te verwyder?
Ja. Deaktiveer die Aktief-skakelaar in die webhook-instellings — dit sal ophou afvuur maar die konfigurasie behou.

V: Word webhook-afvurings in skofon gelogboek?
Gedetailleerde webhook-afleweringslogboeke word nie in die koppelvlak verskaf nie. Monitering is aan die kant van jou bediener.

V: Kan ek die webhook per projek of rooster filter?
Nee. Die webhook vuur af vir alle gebeurtenisse van die gekose tipe regoor die maatskappy. Filtrering is aan die kant van die ontvangende bediener.

V: Wat gebeur met webhooks wanneer die maatskappy verwyder word?
Alle webhooks word saam met die maatskappy verwyder.