Webhook'lar

Webhook'u açmak

Formunuzu açın, Ayarlar sekmesine gidin ve Webhook seçeneğini etkinleştirin. Yanıtları alacak adresi yapıştırdığınızda Fillio, yazmayı bıraktıktan kısa bir süre sonra adresi kaydeder ve bunu ekranda doğrular. Her form tek bir adres taşır; anahtarı yeniden kapattığınızda bu adres silinir.

Adresin HTTPS olması gerekir

Fillio yalnızca https:// ile başlayan adresleri çağırır. http:// ile başlayan bir adres ayarlar alanı tarafından kabul edilir, ancak hiçbir zaman çağrılmaz; bu nedenle kayıtlı görünen bir webhook sessizce hiçbir şey iletmez.

Özel bir ağın içini gösteren adresler de reddedilir: 10.x, 127.x, 169.254.x, 172.16-31.x veya 192.168.x aralığındaki her sunucu, her IPv6 adresi ve localhost olan ya da .local veya .internal ile biten her ad bu kapsamdadır. Uç noktanızın genel internet üzerinden erişilebilir olması gerekir.

İstek

Gövdesi JSON olan bir POST isteği gönderilir. İstekle birlikte dört başlık iletilir.

Gönderilen veri

Olayı tanımlayan bir dış katman ve yanıtı tanımlayan bir data nesnesinden oluşur.

{
  "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 dizisinin içeriği

Her kayıt dört özellik taşır; seçenekleri olan sorular ise beşinci bir özellik daha taşır.

Yalnızca yanıtlanan sorular gelir

Katılımcının hiç dokunmadığı bir soru, boş bir değerle gönderilmek yerine dizide hiç yer almaz; koşullu mantıkla gizlenen bir soru ise hiçbir zaman görünmez. Bu nedenle her yanıtı sırasına veya sabit bir kayıt sayısına güvenerek değil, key değeri üzerinden bulunuz.

Seçim yanıtları etiket değil kimlik taşır

Açılır liste veya tekli seçim yanıtı, seçilen seçeneğin kimliğidir; onay kutusu, çoklu seçim ve sıralama yanıtları ise seçenek kimliklerinden oluşan bir dizidir. Bu kimlikleri aynı kayıttaki options listesiyle eşleştirerek çözünüz. Sıralama yanıtı, katılımcının belirlediği sırayı korur.

Diğer seçeneği

Katılımcı Diğer kutusuna bir şey yazdığında değer bir seçenek kimliği olmaz; __OTHER__: ifadesinin ardından yazdığı metin gelir. Yanıtı okumak için bu ön eki kaldırınız.

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

Dosyalar ve imzalar

Dosya yükleme yanıtı, dosyanın Fillio deposundaki indirme bağlantısıdır. İmza yanıtı ise base64 kodlu bir PNG veri adresidir; bu adresi doğrudan kaydedebilir veya görüntüleyebilirsiniz.

Alan türleri

Tür adı, herkese açık ve sabit bir addır; Fillio'nun içinde yapılan bir değişiklik entegrasyonunuza yansımaz. Fillio'nun eşleştiremediği her alan INPUT_TEXT olarak gelir.

Uç noktanız yanıt vermezse

Fillio on saniye bekler. Zaman aşımı, bağlantı hatası veya 2xx aralığının dışındaki herhangi bir durum kodu başarısız bir gönderim sayılır ve iş orada biter: yeniden deneme yapılmaz, yeniden oynatılabilecek bir kuyruk tutulmaz.

Yanıtın kendisi bundan hiçbir şekilde etkilenmez. Yanıt, istek gönderilmeden önce kaydedilir ve uç noktanız ne yaparsa yapsın kontrol panelinizde kalır; bu nedenle bir gönderim kaybolsa bile eksiksiz kayıt kontrol panelinizdedir.

İstek imzalanmaz

Fillio isteği imzalamaz ve paylaşılan bir gizli anahtar göndermez; bu nedenle gövde tek başına isteğin nereden geldiğini kanıtlamaz. Uç noktanızın bundan emin olması gerekiyorsa yalnızca sizin bildiğiniz bir adres kullanın; tahmin edilemeyecek kadar uzun bir yol veya sorgu dizesi belirleyin ve başka bir yerden gelen her isteği güvenilmez sayın.

Her gönderim, hem X-Fillio-Event-Id başlığında hem de gövdede kendi olay kimliğini taşır. Daha önce işlediğiniz kimlikleri kaydetmek, uç noktanızı iki kez çağrılmaya karşı güvenli kılmanın en basit yoludur.