Bu rehberde: Jotform hesabınızı bir API anahtarıyla bağlarsınız. OrqLabs her aktif formunuza bir webhook ekler; biri formu gönderdiğinde iş akışınız cevaplarla birlikte başlar. Jotform kutusuyla formları listeler ve geçmiş gönderimleri okursunuz.
⏱ 5 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | JOTFORM |
| Kategori | Formlar |
| Kimlik doğrulama | API anahtarı (APIKEY başlığı) + veri bölgesi (Global / EU / HIPAA) |
| Kapsam | Proje bazlı |
| Webhook | Evet – bağlarken her forma otomatik kurulur; adres gizli bir anahtar (?t=…) içerir |
| Kutu | Jotform (app.jotform) |
| Tetikleyici | Entegrasyon olayı → JOTFORM · New form submission |
Ne işe yarar?
Tetikleyici – New form submission: bir Jotform formu gönderildiğinde iş akışı başlar. İlk öğe:
| Alan | Açıklama |
|---|---|
submissionId | Gönderim kimliği – aynı gönderim iki kez gelirse ikincisi atlanır |
formId, formTitle | Formun kimliği ve başlığı |
submittedAt | Gönderim zamanı (ISO) |
email, name, phone | E-posta, ad-soyad ve telefon alanlarından doldurulur |
answers | { "Soru metni": cevap } – formda gördüğünüz etiketlerle |
fields | Aynı cevaplar Jotform alan adlarıyla (fullName, email, phoneNumber …); ad, adres, tarih gibi parçalı alanlar tek metne çevrilir |
ip | Gönderenin IP adresi |
raw | Jotform'un gönderdiği yükün kısaltılmış hâli (rawRequest çözülmüş) |
Jotform kutusunun işlemleri:
| İşlem | Ne yapar | Etki |
|---|---|---|
| List forms | Silinmemiş formları (kimlik, başlık, durum, gönderim sayısı, bağlantı) listeler. | Okuma |
| Get submissions | Bir formun gönderimlerini okur; Submitted after (2026-01-01 09:00:00, hesabınızın saat diliminde) ile filtre. Cevaplar soru metniyle gelir. | Okuma |
Ön koşullar
- Bir Jotform hesabı (ücretsiz planda da webhook vardır; API günlük istek sınırı plana göre değişir).
- Hesabınızın veri bölgesi: hesap eu.jotform.com üzerindeyse EU, HIPAA hesabıysa HIPAA seçin.
Adım adım kurulum
A) Jotform'da API anahtarı
- Jotform → sağ üstte profil → Settings → sol menüde API.
- Create New Key → izin: Full Access (webhook eklemek için okuma yetkisi yetmez).
- Anahtarı kopyalayın.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Jotform → Bağla → Proje seçin.
- API key alanına anahtarı yapıştırın, Data region seçin → Bağla.
OrqLabs anahtarı doğrular ve aktif (enabled) formlarınızdan son güncellenen 50 tanesine bir webhook ekler. Jotform webhook'ları imza taşımadığı için OrqLabs adresin sonuna yalnızca bu bağlantıya özel, tahmin edilemez bir anahtar ekler (…?t=…); anahtarı tutmayan istekler reddedilir. Bu adresi başkalarıyla paylaşmayın. Formu Jotform'da açıp Settings → Integrations → WebHooks bölümünde görebilirsiniz.
C) Tetikleyiciyi kurma
- Entegrasyon olayı tetikleyicisini ekleyin → Account: Jotform bağlantınız → Event:
JOTFORM · New form submission. - Tek bir form için Payload filter:
{{ $json.formId === "241234567890123" }}.
Yeni form eklediniz mi? Ayrıntı panelinde Şimdi senkronize et'e basın; OrqLabs webhook'ları yeniden kurar.
Örnek iş akışları
1) Randevu talebi → aday + ekip bildirimi
Entegrasyon olayı (JOTFORM · New form submission) → Aday oluştur (e-posta {{ $json.email }}, ad {{ $json.name }}, telefon {{ $json.phone }}) → Ekibe bildir ({{ $json.formTitle }}: {{ $json.answers["Tercih edilen tarih"] }}).
2) Teklif formu → yapay zekâ özeti → CRM
Entegrasyon olayı → Metin üret (Bu talebi 3 maddede özetle ve öncelik ver: {{ $json.answers }}) → CRM'e yaz.
3) Günlük gönderim raporu
Zamanlama (her gün 18:00) → Jotform → Get submissions (Submitted after {{ $date(Date.now() - 86400000, "YYYY-MM-DD HH:mm:ss") }}) → Metin üret → Ekibe bildir.
Limitler
| Konu | Sınır |
|---|---|
| Otomatik webhook | Son güncellenen 50 aktif form |
| Get submissions | İstek başına en fazla 1.000 gönderim |
| API günlük sınırı | Jotform planınıza göre (ücretsiz planda günde 1.000 istek) – webhook kurulumu form başına 1 istek harcar |
answers etiketleri | Jotform'un gönderdiği "Etiket:Değer" özetinden okunur; cevap metninde ", Başka bir etiket:" geçerse bölünebilir. Kesin değerler için fields kullanın |
| Dosya yükleme | Dosyalar Jotform'da kalır; cevapta dosya adresi gelir |
Bağlantıyı test etme
Bağlantıyı test et kullanıcı adınızı ve hesap türünüzü gösterir. Yanlış bölge seçildiyse AUTH hatası alırsınız.
Kimlik bilgilerini yenileme
Jotform'da yeni anahtar üretin → OrqLabs'ta Kimlik bilgileri → Güncelle → Kaydet. Webhook'lar anahtardan bağımsızdır, çalışmaya devam eder. Bağlantıyı OrqLabs'ta silerseniz OrqLabs'ın eklediği webhook'lar formlardan kaldırılır.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
AUTH – 401 "You're not authorized" | Anahtar yanlış veya hesap başka bölgede | Anahtarı ve Data region'ı kontrol edin |
FORBIDDEN – webhook eklenemiyor | Anahtar Read Access | Full Access anahtar üretin |
RATE_LIMIT | Günlük API sınırı doldu | Ertesi gün tekrar deneyin veya planı yükseltin |
| Yeni formdan olay gelmiyor | Form bağlandıktan sonra oluşturuldu veya devre dışı | Formu etkinleştirip Şimdi senkronize et |
| Webhook 401 alıyor | Adres elle kopyalandı ve ?t= kısmı eksik | Şimdi senkronize et ile yeniden kurun |
Sık sorulan sorular
Neden webhook adresinde bir anahtar var? Jotform webhook'ları imzalamaz. Gelen isteğin gerçekten sizin formunuzdan geldiğini, adresteki gizli anahtarla doğrularız.
Ödeme formları çalışır mı?
Evet; ödeme alanları cevaplarda Jotform'un gönderdiği hâliyle (answers ve fields) yer alır.