Webhooks - Shifton Help

Webhooks компанияңызда белгілі оқиғалар болған кезде сыртқы жүйелеріңізге нақты уақыттағы хабарламаларды жіберуге мүмкіндік береді.

Бұл не?

Әзірлеуші бетіндегі Webhooks қойындысы Shifton-нан автоматты хабарламаларды қабылдайтын webhook соңғы нүктелерін жасауға мүмкіндік береді. Аккаунтыңызда оқиғалар болған кезде — ауысым жасалды, қызметкер кіру уақытын белгіледі немесе кесте жарияланды — Shifton деректер жүктемесін көрсетілген URL-ге жібереді. Бұл жүйелеріңіздің жаңартулар үшін Shifton-ды үнемі тексеруін болдырмайды, интеграцияларды жылдамырақ және тиімдірек етеді.

Алғышарттар

Талап	Мәліметтер
Рөл	Owner немесе
Соңғы нүкте	Webhook жүктемелерін қабылдайтын серверіңіздегі жалпы қатынасты URL
Білім	HTTP сұраулары мен webhooks-қа негізгі түсінік (немесе әзірлеушіге қатынас)

Қадамдық нұсқаулар

Webhooks қойындысына кіру

Сол жақ бүйірлік тақтадан Интеграциялар батырмасын басыңыз.

Әзірлеуші

бетіне өтіңіз.

Вебхуктар

қойындысын басыңыз.

Егер webhook жасалмаған болса, жұмбақ суреті бар бос күй пайда болады.

Жаңа webhook жасау

«Жаңа webhook»

батырмасын басыңыз.

Webhook конфигурациясын толтырыңыз:

Өріс	Сипаттама
URL	Shifton оқиға деректерін жіберетін соңғы нүктенің URL-і
Оқиғалар	Осы webhook-ты іске қосуы керек Shifton оқиғаларын таңдаңыз
Белсенді	Webhook-ты қосу немесе өшіру ауыстырғышы

Webhook-ты сақтаңыз.

Shifton таңдалған оқиғалар болған сайын URL-ге HTTP POST сұрауларын жіберуге кіріседі.

Бар webhookтарды басқару

Webhooks қойындысында жасалған барлық webhookтардың тізімін көресіз.

Конфигурациясын өңдеу үшін webhook-ты басыңыз.

URL-ді өзгерте, оқиғаны таңдауды жаңарта немесе белсенді күйді ауыстыра аласыз.

Webhook-ты жою үшін жою опциясын пайдаланыңыз.

Webhook-ты тексеру

Webhook-ты жасағаннан кейін Shifton-да тиісті оқиғаны іске қосыңыз (мысалы, сынақ ауысымын жасаңыз).

Webhook жүктемесі алынғанын растау үшін соңғы нүктенің сервер журналдарын тексеріңіз.

Жүктеме келмеген болса, URL дұрыс және жалпы қатынасты екенін тексеріңіз.

Қатынас рұқсаттары

Рөл	Webhookтарды қарау	Webhookтарды жасау/өңдеу	Webhookтарды жою
Owner	Иә	Иә	Иә
	Иә	Иә	Иә
Manager	Жоқ	Жоқ	Жоқ
Қызметкер	Жоқ	Жоқ	Жоқ

Жиі қойылатын сұрақтар

С: Shifton webhook жүктемелері үшін қандай пішім пайдаланады?
Ж: Webhookтар JSON денесі бар HTTP POST сұраулары ретінде жіберіледі. Әрбір оқиға түрінің дәл жүктеме құрылымы үшін API құжаттамасын қараңыз.

С: Бір оқиға үшін бірнеше webhook орнатуға бола ма?
Ж: Иә, бір оқиғаны тыңдайтын бірнеше webhook жасауға болады, олардың әрқайсысы әртүрлі URL-ге нұсқайды.

С: Webhook іске қосылғанда сервер өшіп тұрса не болады?
Ж: Соңғы нүкте қолжетімсіз болса, webhook жеткізілуі сәтсіз болуы мүмкін. Қайталау саясаты мен сәтсіздікті өңдеу туралы мәліметтер үшін API құжаттамасын тексеріңіз.

С: Webhookтарды белгілі қызметкерлер немесе жобалар үшін ғана іске қосуға сүзе аламын ба?
Ж: Webhook оқиғасын таңдау әдетте оқиға-түрі деңгейінде болады. Белгілі қызметкерлер немесе жобалар үшін кіріс деректерді сервер жағынан сүзу қажет болады.

С: Webhook соңғы нүктесін қалай қорғауға болады?
Ж: Кіріс сұраулардың шынымен Shifton-нан келгенін тексеру үшін құпия токен немесе қол тану верификациясын пайдалануды қарастырыңыз. Қауіпсіздік ұсыныстары үшін API құжаттамасын қараңыз.

Мүмкін мәселелер мен шешімдер

Мәселе	Мүмкін себеп	Шешім
Webhook іске қосылмайды	Webhook белсенді емес күйде	Webhook-ты өңдеп, Белсенді ауыстырғышының қосылғанын тексеріңіз
Соңғы нүкте қателер қайтарады	URL дұрыс емес немесе сервер өшіп тұр	URL дұрыс екенін және серверіңіздің жұмыс істеп, жалпы қатынасты екенін тексеріңіз
Жүктеме алынбады	Брандмауэр кіріс сұрауларды бұғаттауда	Shifton-нан кіріс POST сұрауларына рұқсат беру үшін сервер брандмауэр параметрлерін тексеріңіз
Webhook іске қосылды, бірақ деректер толық емес	Қате оқиға түрі таңдалды	Webhook-ты өңдеп, дұрыс оқиғалардың таңдалғанын тексеріңіз
Бар webhookтар болса да бос күй көрсетіледі	Бет жаңартылмаған	Соңғы деректерді жүктеу үшін Webhooks қойындысын жаңартыңыз
«Жаңа webhook» батырмасы көрінбейді	Жеткіліксіз рұқсаттар	Owner немесе рөліңіз бар екенін тексеріңіз