Bu rehberde: Tally hesabınızı bir API anahtarıyla bağlarsınız. OrqLabs hesabınızdaki formlara imzalı webhook'lar ekler; biri formu doldurduğunda iş akışınız cevaplarla birlikte başlar. Tally kutusuyla formları listeler ve gönderimleri okursunuz.
⏱ 5 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | TALLY |
| Kategori | Formlar |
| Kimlik doğrulama | API anahtarı (Authorization: Bearer …) |
| Kapsam | Proje bazlı |
| Webhook | Evet – bağlarken her forma otomatik kurulur, imzalıdır (Tally-Signature) |
| Kutu | Tally (app.tally) |
| Tetikleyici | Entegrasyon olayı → TALLY · New form response |
Ne işe yarar?
Tetikleyici – New form response: bir Tally formu gönderildiğinde iş akışı başlar. İlk öğe:
| Alan | Açıklama |
|---|---|
responseId, submissionId, respondentId | Yanıt, gönderim ve kişi kimlikleri – aynı yanıt iki kez gelirse ikincisi atlanır |
formId, formTitle | Formun kimliği ve adı |
submittedAt | Gönderim zamanı (ISO) |
email, name, phone | E-posta / telefon alanı ya da "Ad Soyad", "Full name", "E-posta", "Telefon" gibi başlıklı bir soru varsa doldurulur |
answers | { "Soru başlığı": cevap } – seçimlerde seçenek metinleri, dosya yüklemede dosya adresleri |
hidden, calculated | Gizli alanlar (ör. utm_source) ve hesaplanan alanlar |
raw | Tally'nin gönderdiği yükün kısaltılmış hâli |
Tally kutusunun işlemleri:
| İşlem | Ne yapar | Etki |
|---|---|---|
| List forms | Formları (kimlik, ad, durum, gönderim sayısı, tally.so/r/… bağlantısı) listeler. | Okuma |
| Get submissions | Bir formun gönderimlerini okur: tamamlananlar, yarım kalanlar veya hepsi; Submitted after ile tarih filtresi. Cevaplar soru başlığıyla gelir. | Okuma |
Ön koşullar
- Bir Tally hesabı (ücretsiz planda da API ve webhook vardır).
- Formların bulunduğu çalışma alanına erişimi olan bir API anahtarı.
Adım adım kurulum
A) Tally'de API anahtarı
- Tally → sol alttaki hesap menüsü → Settings → API keys.
- Create API key → ad:
OrqLabs→ anahtarı kopyalayın.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Tally → Bağla → Proje seçin.
- API key alanına anahtarı yapıştırın → Bağla. Webhook signing secret alanını boş bırakın (yalnızca elle kurulum içindir, aşağıya bakın).
OrqLabs anahtarı doğrular ve son güncellenen 50 forma (boş taslaklar hariç) bir webhook ekler. Formu Tally'de açıp Integrations → Webhooks bölümünde OrqLabs adresini görürsünüz. Her teslimat OrqLabs'ın ürettiği gizli anahtarla imzalanır.
C) Tetikleyiciyi kurma
- Entegrasyon olayı tetikleyicisini ekleyin → Account: Tally bağlantınız → Event:
TALLY · New form response. - Tek bir form için Payload filter:
{{ $json.formId === "wMq9vX" }}.
Yeni form eklediniz mi? Ayrıntı panelinde Şimdi senkronize et'e basın; OrqLabs webhook'ları yeniden kurar.
Elle webhook (isteğe bağlı)
Belirli bir formu kendiniz bağlamak isterseniz: Tally'de form → Integrations → Webhooks → Connect → OrqLabs entegrasyon kartında gösterilen webhook adresini yapıştırın. Signing secret alanına uzun, rastgele bir değer girin ve aynı değeri OrqLabs'ta Kimlik bilgileri → Webhook signing secret alanına yazın. Bu zorunludur: imzasız ya da yanlış imzalı istekler her zaman reddedilir.
Örnek iş akışları
1) Başvuru formu → aday + ekip bildirimi
Entegrasyon olayı (TALLY · New form response) → Aday oluştur (e-posta {{ $json.email }}, ad {{ $json.name }}, telefon {{ $json.phone }}) → Ekibe bildir (Yeni başvuru: {{ $json.name }} – {{ $json.answers["Bütçeniz?"] }}).
2) Cevaba göre otomatik yanıt
Entegrasyon olayı → Eğer ({{ $json.answers["Hizmet"] }} "SEO" içeriyor) → Metin üret (kişisel teklif özeti) → E-posta gönder.
3) Etkinlik kaydı → Ghost üyesi
Entegrasyon olayı → Ghost → Add member (Email {{ $json.email }}, Labels webinar).
Limitler
| Konu | Sınır |
|---|---|
| Otomatik webhook | Son güncellenen 50 form (boş taslaklar hariç) |
| Get submissions | İstek başına en fazla 500 gönderim |
| Hız sınırı | Tally API'si dakikada yaklaşık 100 istek |
| Onay kutuları | Her seçenek için ayrıca gelen doğru/yanlış alanlar atlanır; seçilenler ana soruda liste olarak gelir |
Bağlantıyı test etme
Bağlantıyı test et hesap adınızı ve planınızı gösterir. Webhook kurulamadıysa hata entegrasyon kartında görünür.
Kimlik bilgilerini yenileme
Tally'de yeni API anahtarı üretin → OrqLabs'ta Kimlik bilgileri → Güncelle → Kaydet → eski anahtarı Tally'de silin. Kurulu webhook'lar çalışmaya devam eder. Bağlantıyı OrqLabs'ta silerseniz OrqLabs'ın kurduğu webhook'lar da Tally'den kaldırılır.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
AUTH – 401 | Anahtar silindi veya yanlış | Yeni anahtar girin |
NOT_FOUND – 404 | Form ID yanlış | Form bağlantısındaki kimliği kullanın (tally.so/r/wMq9vX) |
| Elle kurulan webhook 401 alıyor | Signing secret OrqLabs'takiyle aynı değil | İki taraftaki değeri eşitleyin |
| 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
Yarım kalan (partial) gönderimler tetikler mi?
Hayır. Tetikleyici Tally'nin FORM_RESPONSE olayıyla, yani form gönderildiğinde çalışır. Yarım kalanları Get submissions → Partial only ile okuyabilirsiniz.
Gizli alanları nasıl kullanırım?
Tally form bağlantısına ?utm_source=instagram gibi parametre ekleyin ve formda aynı adla gizli alan tanımlayın; değer hidden nesnesinde gelir.