Bu rehberde: Typeform hesabınızı bir kişisel erişim anahtarıyla (personal access token) bağlarsınız. Hesabınızdaki her forma OrqLabs imzalı bir webhook ekler; biri formu gönderdiğinde iş akışınız yanıtla birlikte başlar. Typeform kutusuyla formları listeler ve geçmiş yanıtları okursunuz.
⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | TYPEFORM |
| Kategori | Formlar |
| Kimlik doğrulama | Kişisel erişim anahtarı (Authorization: Bearer …) |
| Kapsam | Proje bazlı |
| Webhook | Evet – bağlarken her forma otomatik kurulur, imzalıdır (Typeform-Signature) |
| Kutu | Typeform (app.typeform) |
| Tetikleyici | Entegrasyon olayı → TYPEFORM · New form response |
Ne işe yarar?
Tetikleyici – New form response: hesabınızdaki herhangi bir form gönderildiğinde iş akışı başlar. İlk öğe şu alanları taşır:
| Alan | Açıklama |
|---|---|
responseId | Yanıt kimliği (Typeform token) – aynı yanıt iki kez gelirse ikincisi atlanır |
formId, formTitle | Formun kimliği ve başlığı |
submittedAt, landedAt | Gönderim ve formun açıldığı zaman (ISO) |
email, name, phone | Formda e-posta / telefon türünde ya da "Ad", "Name", "Ad Soyad", "E-posta", "Telefon" gibi başlıklı bir soru varsa doldurulur |
answers | { "Soru başlığı": cevap } – çoktan seçmeli sorularda seçilen etiket(ler), dosyada adres |
hidden | Gizli alanlar (ör. utm_source) |
score, variables | Quiz puanı ve değişkenler (varsa) |
raw | Typeform'un gönderdiği yükün kısaltılmış hâli |
Örnek: {{ $json.answers["Şirketinizin büyüklüğü?"] }}, {{ $json.email }}.
Typeform kutusunun işlemleri:
| İşlem | Ne yapar | Etki |
|---|---|---|
| List forms | Hesaptaki formları (kimlik, başlık, bağlantı, son güncelleme) listeler; başlıkta arama yapılabilir. | Okuma |
| Get responses | Bir formun yanıtlarını en yeniden eskiye okur: yalnızca gönderilenler, yalnızca yarım kalanlar veya hepsi; Submitted after ile tarih filtresi. Çıktı tetikleyiciyle aynı alanlara sahiptir. | Okuma |
Her iki işlem de yalnızca okuma yaptığı için editördeki test çalıştırmalarında da çalışır.
Ön koşullar
- Bir Typeform hesabı (ücretsiz plan da webhook destekler).
- Formların sahibi olan hesapla oluşturulmuş bir kişisel erişim anahtarı.
- Hesabınız yanıtları AB veri merkezinde tutuyorsa bağlarken Data center → EU seçin.
Adım adım kurulum
A) Typeform'da kişisel erişim anahtarı
- Typeform'da sağ üstteki profil menüsü → Account → sol menüde Personal tokens.
- Generate a new token → ad:
OrqLabs. - Custom scopes seçin ve şu izinleri işaretleyin:
Accounts: Read,Forms: Read,Responses: Read,Webhooks: Read,Webhooks: Write. - Generate token →
tfp_…ile başlayan anahtarı kopyalayın; yalnızca bir kez gösterilir.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Typeform → Bağla → Proje seçin.
- Personal access token alanına anahtarı yapıştırın; AB hesabıysanız Data center → EU seçin → Bağla.
OrqLabs anahtarı doğrular ve son güncellenen 50 forma orqlabs-<entegrasyon kimliği> etiketli bir webhook ekler. Typeform'da formu açıp Connect → Webhooks sekmesinde bu webhook'u görürsünüz. Her teslimat OrqLabs'ın ürettiği gizli anahtarla imzalanır; imzası tutmayan istekler reddedilir.
C) Tetikleyiciyi kurma
- Yeni iş akışında Entegrasyon olayı tetikleyicisini ekleyin.
- Account: Typeform bağlantınız; Event:
TYPEFORM · New form response. - Yalnızca belirli bir formu dinlemek için Payload filter:
{{ $json.formId === "u6nXL7" }}.
Yeni form eklediniz mi? Bağlandıktan sonra oluşturduğunuz formlarda webhook yoktur. Entegrasyonun ayrıntı panelinde Şimdi senkronize et'e basın; OrqLabs webhook'ları tüm formlara yeniden kurar.
Örnek iş akışları
1) Demo talebi → lead + karşılama e-postası
- Entegrasyon olayı (
TYPEFORM · New form response, filtre: demo formu). - Aday oluştur – e-posta
{{ $json.email }}, ad{{ $json.name }}, telefon{{ $json.phone }}. - Metin üret –
Bu cevaplara göre kısa, kişisel bir karşılama e-postası yaz: {{ $json.answers }}. - E-posta gönder – alıcı
{{ $json.email }}.
2) Anket yanıtlarını puanlama
Entegrasyon olayı → Sınıfla ({{ $json.answers["Bizi nasıl buldunuz?"] }}) → CRM'e yaz (Google Sheets veya Notion'a satır).
3) Haftalık yanıt özeti
Zamanlama (pazartesi) → Typeform → Get responses (Form ID, Submitted after {{ $date(Date.now() - 604800000) }} – 7 gün önce) → Metin üret (özet) → Ekibe bildir.
Limitler
| Konu | Sınır |
|---|---|
| Otomatik webhook | Son güncellenen 50 form; daha eski formlardan olay gelmez (kullanmadığınız formları silin veya Şimdi senkronize et ile listeyi yenileyin) |
| Get responses | İstek başına en fazla 200 yanıt |
| Hız sınırı | Typeform API'si hesap başına saniyede 2 istek; OrqLabs webhook kurarken istekleri yavaşlatır |
| Yarım yanıtlar | Tetikleyici yalnızca gönderilen yanıtlarda çalışır (form_response) |
| Yeniden deneme | Typeform başarısız teslimatları bir süre yeniden dener; aynı yanıt iki kez işlenmez |
Bağlantıyı test etme
Bağlantıyı test et form listesini okur ve hesap adını gösterir. Webhook'lar kurulamadıysa hata entegrasyon kartında "Webhook kaydı başarısız" olarak görünür.
Kimlik bilgilerini yenileme
Typeform'da yeni anahtar üretin → OrqLabs'ta Kimlik bilgileri → Güncelle → yeni anahtar → Kaydet. Webhook'lar formlara bağlı olduğu için çalışmaya devam eder. Eski anahtarı Typeform'da silin. Bağlantıyı OrqLabs'ta silerseniz OrqLabs formlardaki webhook'larını da kaldırır.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
AUTH – 401 "Authentication credentials not found" | Anahtar silindi veya yanlış kopyalandı | Yeni anahtar girin |
FORBIDDEN – 403 | Anahtarda gerekli izin (scope) yok | A adımındaki izinlerle yeni anahtar üretin |
NOT_FOUND – 404 "FORM_NOT_FOUND" | Form ID yanlış veya form başka hesabın | Form bağlantısının sonundaki kimliği kullanın (…/to/u6nXL7) |
| Get responses boş dönüyor (AB hesabı) | Yanıtlar AB veri merkezinde | Data center → EU seçip kaydedin |
| Yeni formdan olay gelmiyor | Form bağlandıktan sonra oluşturuldu | Şimdi senkronize et |
RATE_LIMIT – 429 | Çok sık istek | OrqLabs bekleyip yeniden dener |
Sık sorulan sorular
Gizli alanlar (hidden fields) gelir mi?
Evet, hidden nesnesinde. Typeform bağlantınıza ?utm_source=instagram gibi parametreler ekleyerek kampanya kaynağını iş akışına taşıyabilirsiniz.
Aynı Typeform hesabını iki projede bağlayabilir miyim? Evet. Her bağlantı forma kendi etiketiyle ayrı bir webhook ekler; ikisi birbirini ezmez.