Webhooks

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 එකකි. ශීර්ෂක හතරක් එය සමඟ පැමිණේ.

Payload එක

සිදුවීම විස්තර කරන ලියුම් කවරයක් සහ ප්‍රතිචාරය විස්තර කරන 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 අරාවකි. ඒවා එකම ඇතුළත් කිරීමේ ඇති විකල්ප ලැයිස්තුවට එරෙහිව විසඳන්න. ශ්‍රේණිගත කිරීමේ පිළිතුරක් පිළිතුරු දෙන්නා අයිතම තැබූ අනුපිළිවෙල තබා ගනී.

වෙනත් විකල්පය

පිළිතුරු දෙන්නෙකු වෙනත් කොටුවට ලියන විට, අගය විකල්ප ID එකක් නොව __OTHER__: යන පෙළත් ඉන් පසුව ඔවුන් ටයිප් කළ දෙයත් වේ. පිළිතුර කියවීමට එම උපසර්ගය ඉවත් කරන්න.

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

ගොනු සහ අත්සන්

ගොනු උඩුගත කිරීමේ පිළිතුරක් යනු Fillio හි ගබඩාවේ ඇති ගොනුව වෙත බාගැනීමේ සබැඳියකි. අත්සන් පිළිතුරක් යනු base64 PNG data URL එකකි; එය ඔබට කෙලින්ම සුරැකීමට හෝ පෙන්වීමට හැකිය.

ක්ෂේත්‍ර වර්ග

වර්ගය ස්ථාවර ප්‍රසිද්ධ නාමයක් වන නිසා, Fillio තුළ සිදුවන වෙනසක් ඔබේ ඒකාබද්ධ කිරීමට කිසිදා ළඟා නොවේ. Fillio හට සිතියම්ගත කළ නොහැකි ඕනෑම දෙයක් INPUT_TEXT ලෙස පැමිණේ.

ඔබේ අන්ත ලක්ෂ්‍යය පිළිතුරු නොදුනහොත්

Fillio තත්පර දහයක් රැඳී සිටී. කාලය ඉකුත් වීමක්, සම්බන්ධතා දෝෂයක් හෝ 2xx පරාසයෙන් පිටත ඕනෑම තත්ත්වයක් අසාර්ථක බෙදාහැරීමක් ලෙස ගැනේ, එතැනින් එය අවසන්ය: නැවත උත්සාහයක් හෝ නැවත ධාවනය කළ හැකි පෝලිමක් නොමැත.

ප්‍රතිචාරයට කිසිදා බලපෑමක් නොවේ. ඉල්ලීම කිරීමට පෙර එය ගබඩා වන අතර ඔබේ අන්ත ලක්ෂ්‍යය කුමක් කළත් ඔබේ ඩෑෂ්බෝඩ්හි පවතී, එබැවින් බෙදාහැරීමක් නැති වුවත් ඩෑෂ්බෝඩ් සම්පූර්ණ වාර්තාව ලෙස පවතී.

අත්සනක් නොමැත

Fillio ඉල්ලීමට අත්සන් නොකරන අතර හවුල් රහසක් ද නොයවයි, එබැවින් බඳ පමණක් එය පැමිණි තැන ඔප්පු නොකරයි. ඔබේ අන්ත ලක්ෂ්‍යයට නිශ්චිත විය යුතු නම්, ඔබ පමණක් දන්නා ලිපිනයක් එයට දෙන්න: දිගු, අනුමාන කළ නොහැකි මාවතක් හෝ විමසුම් පෙළක්. වෙනත් තැනකින් පැමිණෙන ඕනෑම දෙයක් විශ්වාස නොකරන්න.

සෑම බෙදාහැරීමක්ම X-Fillio-Event-Id ශීර්ෂකයේ සහ බඳ තුළ යන දෙකෙහිම එහිම සිදුවීම් ID එකක් දරයි. ඔබ දැනටමත් හසුරුවා ඇති ඒවා සටහන් කර තබා ගැනීම ඔබේ අන්ත ලක්ෂ්‍යය දෙවරක් ඇමතීමට ආරක්ෂිත කරන සරලම ක්‍රමයයි.