Outbound Webhook များ

Webhook များက တစ်စုံတစ်ရာဖြစ်ပေါ်သည်နှင့် FreeMaint မှ သင်ထိန်းချုပ်သော URL သို့ POST ပို့စေသည်။ ထို့ကြောင့် အခြားစနစ်တစ်ခု (ERP၊ ငွေတောင်းခံ၊ ကုန်လက်ကျန်၊ စာရင်းကိုင်၊ စကားပြောချန်နယ်) သည် မည်သူမျှ ပြန်ရိုက်ထည့်စရာမလိုဘဲ ကိုက်ညီနေသည်။ /company-settings/webhooks မှ ပြင်ဆင်ပါ။ Starter တွင် တစ်ရက် ၁၀၀ ပို့ဆောင်မှု ကန့်သတ်ထားပြီး Business နှင့်အထက်တွင် အကန့်အသတ်မရှိပါ။ ပြည့်စုံသော payload အညွှန်းအတွက် API နှင့် GraphQL > Webhook ကို ကြည့်ပါ။

ရရှိနိုင်သော ဖြစ်ရပ်များ

• work_order.created — အလုပ်အမိန့်တစ်ခု ဖန်တီးပြီး
• work_order.completed — အလုပ်အမိန့်တစ်ခု «ပြီးစီးပြီး» သို့ ပြောင်းပြီး
• work_order.status_changed — အလုပ်အမိန့်တစ်ခု မည်သည့်အခြေအနေသို့မဆို ပြောင်းသွားပြီ။ work_order.completed လည်း ဆက်လက် ထွက်ပေါ်သည်
• request.created — ထိန်းသိမ်းရေး တောင်းဆိုမှုတစ်ခု တင်သွင်းပြီး
• request.status_changed — တောင်းဆိုမှုတစ်ခု အတည်ပြု၊ ငြင်းပယ် သို့မဟုတ် ပယ်ဖျက်ခံရ
• part.low_stock — အပိုပစ္စည်းတစ်ခု ပြန်လည်မှာယူမည့်အဆင့် သို့မဟုတ် ၎င်းအောက်သို့ ကျဆင်း
• part.out_of_stock — အပိုပစ္စည်းတစ်ခု သုညသို့ ကျဆင်း
• part.low_stock_summary — တစ်ရက်တစ်ကြိမ်၊ ပြန်လည်မှာယူမည့်အဆင့် သို့မဟုတ် ၎င်းအောက်ရှိ အပိုပစ္စည်းများ — တစ်ခါမျှ မလှုပ်ရှားခဲ့သည်များ အပါအဝင်
• part.out_of_stock_summary — တစ်ရက်တစ်ကြိမ်၊ သုညတွင် ရှိနေသော အပိုပစ္စည်းများ
• part.consumed — အလုပ်အမိန့်တွင် သုံးစွဲ သို့မဟုတ် ၎င်းမှ ပြန်အပ်
• compliance.chain_divergence — စာရင်းစစ် hash ကွင်းဆက် ပြတ်တောက် (Enterprise)
• asset.downtime_started — စက်ရပ်နားမှုတစ်ခု ဖွင့်လိုက်ပြီ
• asset.downtime_ended — စက်ရပ်နားမှုတစ်ခု ပိတ်လိုက်ပြီ
• report.daily_summary — ထိုနေ့၏ ပြီးစီးခဲ့သော အလုပ်များ၊ သင်ရွေးချယ်ထားသည့် အချိန်တွင် တစ်ရက်တစ်ကြိမ်
• purchase_order.created — ဝယ်ယူမှုအမိန့်တစ်ခု ဖန်တီးပြီး
• purchase_order.status_changed — ဝယ်ယူမှုအမိန့်တစ်ခု အခြားအခြေအနေသို့ ပြောင်းသွားပြီ (အတည်ပြု၊ မှာယူပြီး၊ ပယ်ဖျက်…)
• purchase_order.received — ဝယ်ယူမှုအမိန့်တစ်ခုအတွက် ပို့ဆောင်မှုကို လက်ခံရရှိပြီ — တစ်စိတ်တစ်ပိုင်း ပို့ဆောင်မှုများ အပါအဝင်

ပို့ဆောင်မှု သဘောသဘာဝ

• JSON ကိုယ်ထည်ဖြင့် POST — { event, timestamp, data }
• X-FreeMaint-Signature ခေါင်းစီး — t=<unix စက္ကန့်>,v1=<hex>။ v1 သည် သင့် webhook လျှို့ဝှက်ချက်ကို သော့အဖြစ်သုံး၍ «<t>.<ကုန်ကြမ်းကိုယ်ထည်>» ၏ HMAC-SHA256 ဖြစ်သည်။ တောင်းဆိုမှုတိုင်းတွင် ကုန်ကြမ်းကိုယ်ထည်နှင့် တိုက်ဆိုင်စစ်ဆေးပါ
• X-FreeMaint-Event နှင့် X-FreeMaint-Delivery-Id ကိုပါ ပူးတွဲပို့သည်
• ကွန်ရက်အမှားများနှင့် 5xx ကို ထပ်ကိန်းနောက်ဆုတ်နည်းဖြင့် ၃ ကြိမ်အထိ ပြန်ကြိုးစားသည် (ခန့်မှန်း ၂ စက္ကန့်၊ ၄ စက္ကန့်၊ ၈ စက္ကန့်)။ 4xx မှာ အပြီးအပိုင်ငြင်းပယ်မှုဖြစ်၍ ပြန်မကြိုးစားပါ
• ကြိုးစားမှုတိုင်းကို webhook အောက်တွင် အခြေအနေ၊ တုံ့ပြန်မှုကုဒ်နှင့် ကြိုးစားမှုအရေအတွက်နှင့်အတူ မှတ်တမ်းတင်ထားပြီး၊ ပြီးဆုံးသွားသော ပို့ဆောင်မှုမှန်သမျှကို ထိုနေရာမှ ပြန်ပို့နိုင်သည်
• ရွေးချယ်နိုင်သော ဓာတ်ပုံများ — "ဓာတ်ပုံများ ထည့်သွင်းရန်" ဖွင့်ထားပါက "work_order" နှင့် "request" ဖြစ်ရပ်များ၏ "photos" အကွက်တွင် ပုံလင့်ခ် 4 ခုအထိ ပါဝင်ပြီး လင့်ခ်ရှိသူ မည်သူမဆို 7 ရက်ကြာ ဖွင့်နိုင်ပါသည် — သင်ထိန်းချုပ်ထားသော လက်ခံရေး URL အတွက်သာ ဖွင့်ပါ

ပြင်ဆင်ခြင်း

1. /company-settings/webhooks ကို ဖွင့်ပါ — ကုမ္ပဏီဆက်တင် ခွင့်ပြုချက် သို့မဟုတ် "ပေါင်းစပ်မှုများကို စီမံရန်" ခွင့်ပြုချက် လိုအပ်သည်။
2. «Webhook ထည့်ရန်» ကို နှိပ်ပါ — အမည်၊ https:// URL ပေးပြီး လိုချင်သော ဖြစ်ရပ်များကို အမှတ်ခြစ်ပါ။
3. လက်မှတ်လျှို့ဝှက်ချက်ကို ကူးယူပါ — ဖန်တီးချိန်တွင် တစ်ကြိမ်သာ ပြသသည်။ နောက်ပိုင်းတွင် «လျှို့ဝှက်ချက် လှည့်ရန်» ဖြင့် အသစ်ထုတ်နိုင်ပြီး၊ အဟောင်းမှာ အကျုံးမဝင်တော့ပါ။
4. ပို့ဆောင်မှုများကို စောင့်ကြည့်ပါ — ဖြစ်ရပ်များ ရောက်ရှိမှုကို အတည်ပြုရန်နှင့် မအောင်မြင်သည်များကို ပြန်ပို့ရန် webhook ၏ ပို့ဆောင်မှုမှတ်တမ်းကို ဖွင့်ပါ။

အစီအစဉ်အလိုက် ကန့်သတ်ချက်

• Starter — ကုမ္ပဏီတစ်ခုလျှင် တစ်ရက် ပို့ဆောင်မှု ၁၀၀ (ရေတွက်မှုကို 00:00 UTC တွင် ပြန်သုညပြု)
• Business — အကန့်အသတ်မရှိ
• Enterprise — အကန့်အသတ်မရှိ
• ရေတွက်မှုသည် ကြိုးစားမှုအလိုက် — ဖြစ်ရပ်တူပေါ်ရှိ webhook သုံးခုသည် ယူနစ်သုံးခု သုံးစွဲသည်