Webhooks - Shifton Help

Ang mga Webhook ay nagbibigay-daan sa Shifton na magpadala ng mga real-time na abiso sa mga panlabas na sistema kapag may nangyaring kaganapan sa inyong kompanya.

Mga Sunud-sunod na Tagubilin

Pag-access sa Tab na Webhooks

Sa kaliwang sidebar, pindutin ang Integrasyon.

Pumunta sa pahina ng Developer → tab na Webhooks.

Paglikha ng Bagong Webhook

Pindutin ang “Bagong webhook”.

Punan ang configuration:

Field	Paglalarawan
URL	Endpoint para sa pagtanggap ng datos ng kaganapan
Mga Kaganapan	Mga kaganapan ng Shifton na nag-a-activate ng webhook
Aktibo	Toggle ng pag-enable/pag-disable

I-save. Magpapadala ang Shifton ng mga HTTP POST request sa tinukoy na URL.

Pamamahala ng mga Webhook

Pindutin ang webhook para sa pag-edit ng URL, pag-update ng mga kaganapan o pagbabago ng status ng aktibidad.

Pag-test ng Webhook

Mag-trigger ng kaukulang kaganapan sa Shifton (halimbawa, gumawa ng test na shift).

Suriin ang mga log ng server — dapat na natanggap ang datos.

Mga Kaugnay na Artikulo

Mga Madalas Itanong

T: Sa anong Bumuoat nagpapadala ng datos ang iskedyulon?
HTTP POST na may body sa JSON format. Ang istruktura ng datos para sa bawat uri ng kaganapan ay makikita sa dokumentasyon ng API.

T: Maaari bang gumawa ng ilang webhook para sa isang kaganapan?
Oo, na may iba’t ibang URL.

T: Ano kung hindi Magagamit ang server kapag nag-trigger ang webhook?
Maaaring mabigo ang paghahatid. Ang mga detalye tungkol sa retry policy ay nasa dokumentasyon ng API.

T: Hindi gumagana ang webhook — bakit?
Tiyaking naka-on ang toggle na Aktibo at ang URL ay publicly accessible.

T: Paano masusuri na nakakatanggap ng datos ang webhook?
Gumawa ng test na kaganapan sa Shifton (halimbawa, magdagdag ng shift) at suriin ang mga log ng inyong server para sa papasok na POST request.

T: Maaari ko bang i-configure ang authentication ng webhook?
Oo. Magdagdag ng Lihim na susi o token sa URL o mga header ng webhook. Ang mga detalye ay nasa dokumentasyon ng API.

T: Ano ang hitsura ng body ng webhook Kahilingan?
JSON object na may datos ng kaganapan. Ang istruktura ay depende sa uri ng kaganapan — tingnan ang dokumentasyon ng API para sa mga halimbawa.

T: Maaari bang mag-track ang isang webhook ng ilang kaganapan?
Oo. Sa paglikha ng webhook, pumili ng ilang kaganapan — ang isang URL ay makakatanggap ng mga abiso para sa lahat ng napili.

T: Ano ang “retry policy” para sa webhook?
Kung ang server ay nagbabalik ng error (hindi 200), maaaring ulitin ng Shifton ang request. Ang mga detalye ay depende sa configuration ng platform.

T: May limitasyon ba sa bilang ng mga webhook?
Walang tinukoy na limitasyon sa dokumentasyon, ngunit inirerekomendang gumawa lamang ng mga kinakailangan.

T: Kailangan bang gumamit ng HTTPS para sa URL ng webhook?
Inirerekomenda. Ang mga HTTP address ay maaaring gumana, ngunit tinitiyak ng HTTPS ang ligtas na paghahatid ng datos.

T: Maaari bang makatanggap ng mga webhook Abiso sa bawat pagbabago ng iskedyul?
Oo. Idagdag ang mga kaganapan tulad ng “Lumikha ng shift” o “schedule updated” sa pag-configure ng webhook.

T: Sino ang may access sa paglikha ng mga webhook?
Tanging ang Owner lamang. Hindi nakikita ng mga manager at empleyado ang seksyon ng Developer.

T: Maaari bang i-Huwag paganahin ang webhook nang hindi ito tinatanggal?
Oo. I-off ang toggle na Aktibo sa mga setting ng webhook — hihinto ito sa pag-trigger ngunit mananatili ang configuration.

T: Nilo-log ba ang mga pag-trigger ng webhook sa iskedyulon?
Hindi ibinibigay ang mga detalyadong delivery log sa interface. Ang pag-track ay nasa panig ng inyong server.

T: Maaari bang i-filter ang webhook ayon sa proyekto o iskedyul?
Hindi. Ang webhook ay nag-trigger sa lahat ng kaganapan ng napiling uri sa buong kompanya. Ang pag-filter ay nasa panig ng tumatanggap na server.

T: Ano ang nangyayari sa mga webhook kapag tinanggal ang kompanya?
Lahat ng webhook ay natatanggal kasama ng kompanya.