Webhook များ

Webhook ကို ဖွင့်ခြင်း

ဖောင်ကို ဖွင့်ပြီး ဆက်တင်များ တဘ်သို့ သွားကာ Webhook ကို ဖွင့်ပါ။ တင်သွင်းမှုများ လက်ခံရမည့် လိပ်စာကို ကူးထည့်ပါ။ သင် ရိုက်ရပ်လိုက်ပြီး ခဏအကြာတွင် Fillio က သိမ်းဆည်းကာ မျက်နှာပြင်ပေါ်တွင် အတည်ပြုပေးပါသည်။ ဖောင်တစ်ခုလျှင် လိပ်စာတစ်ခုသာ ရှိပြီး ခလုတ်ကို ပြန်ပိတ်လိုက်ပါက လိပ်စာ ပျက်သွားပါသည်။

လိပ်စာသည် HTTPS ဖြစ်ရပါမည်

Fillio သည် https:// ဖြင့် စတင်သော လိပ်စာများကိုသာ ခေါ်ဆိုပါသည်။ http:// လိပ်စာကို ဆက်တင်အကွက်က လက်ခံသော်လည်း ဘယ်တော့မှ ခေါ်မည် မဟုတ်ပါ။ ထို့ကြောင့် သိမ်းထားပြီးဟု ထင်ရသော webhook သည် တိတ်တဆိတ် ဘာမှ ပို့မည် မဟုတ်ပါ။

သီးသန့်ကွန်ရက်အတွင်းသို့ ညွှန်းသော လိပ်စာများကိုလည်း ငြင်းပယ်ပါသည်: 10.x၊ 127.x၊ 169.254.x၊ 172.16-31.x သို့မဟုတ် 192.168.x ရှိ ဟို့စ်များ၊ IPv6 လိပ်စာများ၊ localhost ဖြစ်သော သို့မဟုတ် .local၊ .internal ဖြင့် အဆုံးသတ်သော အမည်များ ဖြစ်ပါသည်။ သင့်လက်ခံလိပ်စာသည် အများသုံး အင်တာနက်မှ ဆက်သွယ်နိုင်ရပါမည်။

တောင်းဆိုမှု

JSON ကိုယ်ထည်ပါသော POST တစ်ခု ဖြစ်ပါသည်။ ဟက်ဒါ လေးခု အတူပါလာပါသည်။

ပေးလုဒ်

အဖြစ်အပျက်ကို ဖော်ပြသော အခွံတစ်ခုနှင့် တုံ့ပြန်ချက်ကို ဖော်ပြသော data အရာဝတ္ထုတစ်ခု ပါဝင်ပါသည်။

{
  "eventId": "8f2c1d7a-4b09-4e5c-9a13-6d0f8b2e77c4",
  "eventType": "FORM_RESPONSE",
  "createdAt": "2026-08-26T09:14:22.481Z",
  "data": {
    "responseId": "Qh3Rk9wZm1sVtY7cN2xP",
    "formId": "7bTn4Kq2Wx",
    "formName": "Workshop signup",
    "createdAt": "2026-08-26T09:14:22.481Z",
    "fields": [
      {
        "key": "V1StGXR8_Z5jdHi6B-myT",
        "label": "Full name",
        "type": "INPUT_TEXT",
        "value": "Mira Kaya"
      },
      {
        "key": "kM4pQz7LxAe2Rn0BsTvUw",
        "label": "Which session?",
        "type": "MULTIPLE_CHOICE",
        "value": "c9XbNf3JdQ",
        "options": [
          { "id": "c9XbNf3JdQ", "text": "Morning" },
          { "id": "eR2mYt8KpL", "text": "Afternoon" }
        ]
      },
      {
        "key": "zA6cWn1FyH4tXd9QrLbEs",
        "label": "How likely are you to recommend us?",
        "type": "LINEAR_SCALE",
        "value": 9
      }
    ]
  }
}

fields အတွင်း

စာကြောင်းတိုင်းတွင် ပရော်ပါတီ လေးခု ပါဝင်ပြီး ရွေးချယ်စရာများ ပါသော မေးခွန်းတွင် ပဉ္စမတစ်ခု ထပ်မံ ပါဝင်ပါသည်။

ဖြေထားသော မေးခွန်းများသာ ရောက်လာပါသည်

ဖြေဆိုသူ မထိသော မေးခွန်းသည် တန်ဖိုးအလွတ်အဖြစ် ပါလာမည့်အစား စာရင်းထဲတွင် လုံးဝ မပါဝင်ပါ။ အခြေအနေအလိုက် လော်ဂျစ်က ဖျောက်ထားသော မေးခွန်းလည်း ဘယ်တော့မှ မပေါ်ပါ။ နေရာအစဉ် သို့မဟုတ် စာကြောင်းအရေအတွက် အသေအပေါ် အားမကိုးဘဲ အဖြေတစ်ခုစီကို ၎င်း၏ key ဖြင့် ရှာပါ။

ရွေးချယ်မှုအဖြေများသည် အညွှန်းမဟုတ်ဘဲ ID များ ဖြစ်ပါသည်

ဒရော့ပ်ဒေါင်း သို့မဟုတ် တစ်ခုရွေးချယ်မှု အဖြေသည် ရွေးလိုက်သော ရွေးချယ်စရာ၏ ID ဖြစ်ပြီး အမှန်ခြစ်ကွက်၊ အများရွေးချယ်မှု သို့မဟုတ် အစီအစဉ်သတ်မှတ်ခြင်း အဖြေသည် ရွေးချယ်စရာ ID များ၏ စာရင်းတစ်ခု ဖြစ်ပါသည်။ ၎င်းတို့ကို တူညီသောစာကြောင်းရှိ options စာရင်းနှင့် တိုက်ဆိုင်ကြည့်ပါ။ အစီအစဉ်သတ်မှတ်ခြင်း အဖြေသည် ဖြေဆိုသူ စီထားသည့် အစဉ်အတိုင်း ရှိနေပါသည်။

အခြား ရွေးချယ်စရာ

ဖြေဆိုသူက အခြား အကွက်ထဲ ရေးသွင်းလိုက်ပါက တန်ဖိုးသည် ရွေးချယ်စရာ ID မဟုတ်ဘဲ __OTHER__: နောက်တွင် ၎င်းတို့ရိုက်ထားသော စာသား ဖြစ်ပါသည်။ အဖြေကို ဖတ်ရန် ထိုရှေ့ဆက်ကို ဖြုတ်လိုက်ပါ။

"value": "__OTHER__:Heard about it from a friend"

ဖိုင်များနှင့် လက်မှတ်များ

ဖိုင်တင်ခြင်း အဖြေသည် Fillio ၏ သိုလှောင်မှုအတွင်းရှိ ဖိုင်သို့ ဒေါင်းလုဒ်လင့်ခ် ဖြစ်ပါသည်။ လက်မှတ် အဖြေမှာ base64 PNG data URL ဖြစ်ပြီး တိုက်ရိုက် သိမ်းခြင်း သို့မဟုတ် ပြသခြင်း ပြုလုပ်နိုင်ပါသည်။

အကွက် အမျိုးအစားများ

အမျိုးအစားသည် တည်ငြိမ်သော အများသုံးအမည်ဖြစ်သဖြင့် Fillio အတွင်းပိုင်း ပြောင်းလဲမှုသည် သင့်ချိတ်ဆက်မှုအထိ ဘယ်တော့မှ ရောက်မလာပါ။ Fillio ဖော်ပြ၍ မရသည့် အရာမှန်သမျှသည် INPUT_TEXT အဖြစ် ရောက်လာပါသည်။

သင့်လက်ခံလိပ်စာက မတုံ့ပြန်ပါက

Fillio သည် 10 စက္ကန့် စောင့်ပါသည်။ အချိန်ကုန်ခြင်း၊ ချိတ်ဆက်မှု အမှားအယွင်း သို့မဟုတ် 2xx အပြင်ဘက် အခြေအနေကုဒ်တိုင်းသည် ပို့ဆောင်မှု မအောင်မြင်ခြင်း ဖြစ်ပြီး ထိုနေရာတွင်ပင် အဆုံးသတ်ပါသည်။ ထပ်မံ ကြိုးစားခြင်း မရှိသလို ပြန်ပို့ရန် တန်းစီစာရင်းလည်း မရှိပါ။

တုံ့ပြန်ချက်ကိုယ်တိုင်မှာမူ ဘယ်တော့မှ မထိခိုက်ပါ။ တောင်းဆိုမှု မပို့မီကတည်းက သိမ်းထားပြီး သင့်လက်ခံလိပ်စာ မည်သို့ဖြစ်စေ သင့်ဒက်ရှ်ဘုတ်တွင် ကျန်ရှိနေပါသည်။ ထို့ကြောင့် ပို့ဆောင်မှုတစ်ခု ပျောက်သွားလျှင်ပင် ဒက်ရှ်ဘုတ်သည် ပြည့်စုံသော မှတ်တမ်းအဖြစ် ရှိနေပါသည်။

လက်မှတ်ထိုးမှု မရှိပါ

Fillio သည် တောင်းဆိုမှုကို လက်မှတ်မထိုးသလို မျှဝေထားသော လျှို့ဝှက်ကုဒ်လည်း မပို့ပါ။ ထို့ကြောင့် ကိုယ်ထည်တစ်ခုတည်းက ဘယ်ကလာသည်ကို သက်သေမပြနိုင်ပါ။ သင့်လက်ခံလိပ်စာက သေချာနေဖို့ လိုအပ်ပါက သင်သာ သိသော လိပ်စာတစ်ခု (ရှည်လျားပြီး မှန်းဆ၍မရသော လမ်းကြောင်း သို့မဟုတ် query string) ကို ပေးထားပြီး အခြားနေရာမှ ရောက်လာသည့် အရာမှန်သမျှကို မယုံကြည်ရဟု သတ်မှတ်ပါ။

ပို့ဆောင်မှုတိုင်းတွင် ကိုယ်ပိုင် အဖြစ်အပျက် ID ပါဝင်ပြီး X-Fillio-Event-Id ဟက်ဒါနှင့် ကိုယ်ထည် နှစ်ခုစလုံးတွင် ပါဝင်ပါသည်။ ကိုင်တွယ်ပြီးသား ID များကို မှတ်ထားခြင်းသည် သင့်လက်ခံလိပ်စာကို နှစ်ကြိမ် ခေါ်လျှင်လည်း ဘေးကင်းစေရန် အလွယ်ဆုံး နည်းလမ်း ဖြစ်ပါသည်။