Webhooks

Tuma kila wasilisho kwenye anwani yako mwenyewe, kama JSON, mara tu linapowasili.

POST moja kwa kila jibu

Hutumwa mara tu jibu linapohifadhiwa, bila kumsubirisha mjibu.

Muundo thabiti wa JSON

Majina ya aina ya umma na vitambulisho vya kudumu vya sehemu, kwa hivyo kubadilisha jina la swali hakuvunji msimbo wako.

Sekunde 10, jaribio moja

Fillio husubiri endpoint yako kwa sekunde kumi na haijaribu tena baadaye.

Kuwasha webhook

Fungua fomu, nenda kwenye kichupo cha Mipangilio na uwashe Webhook. Bandika anwani inayotakiwa kupokea mawasilisho; Fillio huihifadhi muda mfupi baada ya kuacha kuandika na kuithibitisha kwenye skrini. Kila fomu hubeba anwani moja, na kuzima swichi tena huifuta.

Anwani lazima iwe HTTPS

Fillio huita anwani zinazoanza na https:// pekee. Anwani ya http:// hukubaliwa na sehemu ya mipangilio lakini haiitwi kamwe, kwa hivyo webhook inayoonekana imehifadhiwa haitawasilisha chochote, kimya kimya.

Anwani zinazoelekeza ndani ya mtandao wa faragha hukataliwa pia: seva yoyote iliyo kwenye 10.x, 127.x, 169.254.x, 172.16-31.x au 192.168.x, anwani yoyote ya IPv6, na jina lolote ambalo ni localhost au linaloishia kwa .local au .internal. Endpoint yako lazima ifikike kutoka kwenye intaneti ya umma.

Ombi

POST yenye mwili wa JSON. Vichwa vinne husafiri nayo.

Kichwa	Maelezo
Content-Type: application/json	Mwili daima ni JSON.
User-Agent: Fillio Webhooks/1.0	Humtambulisha mwitaji kama Fillio, jambo linalosaidia wakati endpoint moja inasikiliza huduma kadhaa.
X-Fillio-Event: FORM_RESPONSE	Jina la tukio. FORM_RESPONSE ndiyo thamani pekee ambayo Fillio hutuma leo.
X-Fillio-Event-Id	UUID mpya kwa uwasilishaji huu, inayorudiwa kama eventId kwenye mwili.

Payload

Bahasha inayoeleza tukio, na kitu cha data kinachoeleza jibu.

{
  "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
      }
    ]
  }
}

Sifa	Maelezo
eventId	Kitambulisho cha kipekee cha uwasilishaji huu.
eventType	Daima FORM_RESPONSE.
createdAt	Wakati jibu lilipowasilishwa, kama alama ya wakati ya ISO 8601 kwa UTC.
data.responseId	Kitambulisho cha jibu lililohifadhiwa.
data.formId	Kitambulisho cha fomu, kile kile kinachoonekana kwenye kiungo chake cha umma.
data.formName	Kichwa cha fomu kama maandishi tupu, bila muundo wowote.
data.fields	Kipengee kimoja kwa kila swali lililojibiwa.

Ndani ya fields

Kila kipengee hubeba sifa nne, na swali lenye machaguo hubeba ya tano.

Sifa	Maelezo
key	Kitambulisho cha kudumu cha swali. Hunusurika kila mabadiliko ya maneno, kwa hivyo linganisha kwa hiki badala ya lebo.
label	Swali kama lilivyoandikwa kwenye kihariri.
type	Aina ya swali, iliyochukuliwa kutoka kwenye orodha hapa chini.
value	Jibu, katika muundo ambao swali hilo huhifadhi.
options	Kwenye maswali yenye machaguo pekee: kitambulisho na maandishi ya kila chaguo, ili uweze kugeuza jibu kuwa lebo.

Maswali yaliyojibiwa pekee ndiyo huwasili

Swali ambalo mjibu hakuligusa halipo kwenye safu badala ya kutumwa kama thamani tupu, na swali lililofichwa na mantiki ya masharti halionekani kabisa. Tafuta kila jibu kwa key yake badala ya kutegemea nafasi yake au idadi isiyobadilika ya vipengee.

Majibu ya chaguo hubeba vitambulisho, si lebo

Jibu la orodha kunjuzi au chaguo nyingi ni kitambulisho cha chaguo lililoteuliwa, na jibu la visanduku vya kuteua, uteuzi wa vingi au upangaji ni safu ya vitambulisho vya machaguo. Vilinganishe na orodha ya options iliyo kwenye kipengee kile kile. Jibu la upangaji huhifadhi mpangilio ambao mjibu aliweka vitu.

Chaguo la Nyingine

Mjibu anapoandika kwenye kisanduku cha Nyingine, thamani si kitambulisho cha chaguo bali ni maandishi __OTHER__: yakifuatiwa na alichoandika. Ondoa kiambishi hicho ili kusoma jibu.

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

Mafaili na sahihi

Jibu la kupakia faili ni kiungo cha kupakua faili lililo kwenye hifadhi ya Fillio. Jibu la sahihi ni data URL ya PNG ya base64, ambayo unaweza kuihifadhi au kuionyesha moja kwa moja.

Aina za sehemu

Aina ni jina la umma lisilobadilika, kwa hivyo mabadiliko yanayotokea ndani ya Fillio hayafiki kamwe kwenye muunganisho wako. Chochote ambacho Fillio haiwezi kukioanisha huwasili kama INPUT_TEXT.

Aina	Swali	Thamani
INPUT_TEXT	Jibu Fupi	Maandishi
TEXTAREA	Jibu Refu	Maandishi
INPUT_EMAIL	Barua Pepe	Maandishi
INPUT_PHONE_NUMBER	Nambari ya Simu	Maandishi
INPUT_NUMBER	Nambari	Namba kama maandishi, hasa kama ilivyoandikwa
INPUT_LINK	Kiungo	Maandishi
INPUT_DATE	Tarehe	Tarehe, kwa mtindo wa YYYY-MM-DD
INPUT_TIME	Wakati	Saa, kwa mtindo wa HH:MM wa saa 24
DROPDOWN	Menyu ya Kushuka	Kitambulisho kimoja cha chaguo
MULTIPLE_CHOICE	Redio	Kitambulisho kimoja cha chaguo
CHECKBOXES	Kisanduku cha Kuteua	Safu ya vitambulisho vya machaguo
MULTI_SELECT	Uchaguzi Mwingi	Safu ya vitambulisho vya machaguo
RATING	Ukadiriaji wa Nyota	Namba
LINEAR_SCALE	Mizani ya Mstari	Namba
RANKING	Upangaji	Safu ya vitambulisho vya machaguo, kwa mpangilio wa mjibu
FILE_UPLOAD	Kupakia Faili	Kiungo cha kupakua
SIGNATURE	Saini	Data URL ya PNG ya base64

Ikiwa endpoint yako haijibu

Fillio husubiri sekunde kumi. Muda kuisha, hitilafu ya muunganisho au hali yoyote nje ya kundi la 2xx huhesabika kama uwasilishaji ulioshindwa, na hapo ndipo mwisho wake: hakuna jaribio la pili wala foleni ya kurudia.

Jibu lenyewe haliathiriwi kamwe. Huhifadhiwa kabla ya ombi kutumwa na hubaki kwenye dashibodi yako haijalishi endpoint yako inafanya nini, kwa hivyo dashibodi hubaki kumbukumbu kamili hata kama uwasilishaji mmoja ukipotea.

Hakuna sahihi

Fillio haitii sahihi kwenye ombi wala haitumi siri ya pamoja, kwa hivyo mwili peke yake hauthibitishi ulikotoka. Ikiwa endpoint yako lazima iwe na uhakika, ipe anwani unayoijua wewe pekee: njia au kigezo kirefu kisichokisika. Chukulia chochote kinachowasili mahali pengine kama kisichoaminika.

Kila uwasilishaji hubeba kitambulisho chake cha tukio, kwenye kichwa cha X-Fillio-Event-Id na kwenye mwili. Kurekodi vile ambavyo tayari umevishughulikia ndiyo njia rahisi zaidi ya kufanya endpoint yako iwe salama hata ikiitwa mara mbili.

Kidokezo

Elekeza webhook kwenye endpoint yoyote ya kukagua maombi kisha uwasilishe fomu yako mwenyewe mara moja. Utaona payload halisi ambayo fomu yako huzalisha, ikiwa na vitambulisho vyako vya sehemu. Hiyo ndiyo njia ya haraka zaidi ya kuandika uoanishaji upande wako.