Webhook alındığında

Lütfen unutmayın: tüm tetikleyici yapılandırması AI Chat’te yapılabilir. İş akışının ne yapmasını istediğinizi AI’a söyleyin; gerisini o halleder.

Bu tetikleyici benzersiz bir URL oluşturur. Harici bir sistem bu URL’ye HTTP POST isteği gönderdiğinde iş akışı çalışır.

AI ile oluşturma

Tablonuzun sağ kenar çubuğunda AI Chat’i açın ve ne istediğinizi açıklayın. AI her şeyi halleder: doğru tetikleyiciyi seçer, ilgili alanları eşler ve tüm eylemleri otomatik olarak yapılandırır. Hedefinizi bir kez açıklayın; iş akışınız elle yapılandırma gerektirmeden hazır olur. Örnek: “Bir Stripe ödeme webhook’u aldığımda sipariş kaydı oluştur.”

Yapılandırma

Ayar	Zorunlu	Açıklama
Yetkilendirme	Hayır	Yok (herkese açık; URL’yi bilen herkes tetikleyebilir) veya Taşıyıcı Belirteci (istek üstbilgisinde otomatik oluşturulan belirteç gerekir)
Yanıt	Hayır	Varsayılan (Teable kendi alındı bildirimini döndürür) veya Özel (durum koduna, içerik türüne ve gövdeye siz karar verirsiniz)

Nasıl yapılandırılır?

Otomasyonunuzu açıp yeni bir tetikleyici ekleyin.
Webhook alındığında seçeneğini belirleyin.
Tetikleyici hemen benzersiz bir webhook URL’si oluşturur. Harici sistemde kullanmak üzere bu URL’yi kopyalayın.
(İsteğe bağlı ancak önerilir) Taşıyıcı Belirteci yetkilendirmesini etkinleştirmek için Belirteç Oluştur’a tıklayın. Böylece gelen isteklerin Authorization üstbilgisinde bulunması gereken bir belirteç oluşturulur.
Otomasyonu kaydedip etkinleştirin.
Harici sisteminizi webhook URL’sine POST isteği gönderecek şekilde yapılandırın. Yetkilendirmeyi etkinleştirdiyseniz belirteci üstbilgiye ekleyin.
Bir test isteği gönderin (aşağıdaki örneklere bakın). Verilerin doğru alındığını doğrulamak için otomasyonun çalıştırma geçmişini denetleyin.
Eylem adımlarınızı ekleyin. Webhook’un JSON gövdesindeki değerlere başvurmak için herhangi bir eylem alanında + simgesine tıklayın.

Sonraki adımlarda kullanılabilen veriler

Gelen POST isteğinin tüm JSON gövdesi değişken olarak kullanılabilir. Örneğin şunu gönderirseniz:

{
  "order_id": "12345",
  "customer": "Ayşe",
  "amount": 99.95
}

Eylemlerinizde + simgesine tıklayıp tetikleyicinin çıktı alanlarına giderek order_id, customer ve amount değerlerine ayrı ayrı başvurabilirsiniz. Teable, JSON’u otomatik olarak ayrıştırır ve üst düzey her anahtar için adlandırılmış bir değişken oluşturur. İç içe nesnelere de erişilebilir.

Yanıtı özelleştirme

Teable varsayılan olarak gelen her isteğe kendi alındı bildirimiyle yanıt verir. Bazı platformlar bunu kabul etmez: bir yoklama göndererek abonelik URL’sini doğrular ve uç noktanızın istekteki bir alanı aynen geri döndürmesini ister. Slack bu yöntemi kullandığından olayları ancak webhook el sıkışmasına yanıt verdikten sonra otomasyona ulaşabilir. Tetikleyici panelinde Yanıt ayarını Varsayılan yerine Özel yapın:

Alan	Açıklama
Durum kodu	200 ile 299 arasında herhangi bir kod. Varsayılan 200’dür.
İçerik türü	JSON veya ham metin. Varsayılan JSON’dur.
Yanıt gövdesi	Döndürülecek metin. Gelen istekteki değerleri eklemek için `{{body.<path>}}` kullanın.

Özel seçildiğinde gövde, çoğu çağıranın ihtiyaç duyduğu el sıkışması yanıtıyla önceden doldurulur:

{"challenge":"{{body.challenge}}"}

{{ }} içindeki yollar, tetikleyicinin çıktı değişkeni olarak sunduğu yollarla aynıdır; bu nedenle daha önce bir test çalıştırmasında gördüğünüz yükteki yolu doğrudan kopyalayabilirsiniz. {{body.event.type}} gibi iç içe değerler de çalışır. JSON gövdesinde isteğin içermediği bir yol null olarak oluşturulur; böylece yanıt geçerli JSON olarak kalır.

Slack Authorization üstbilgisi gönderemez; bu nedenle bağlarken Yetkilendirme ayarını Yok olarak bırakın. İkisi de aynı anda açıksa tetikleyici paneli bir uyarı gösterir.

Teable’ın kendi alındı bildirimine dönmek için Yanıt ayarını istediğiniz zaman yeniden Varsayılan yapın. Bu ayarı hiç değiştirmeyen otomasyonlar etkilenmez.

Webhook’unuzu test etme

Test etmenin en kolay yolu komut satırından curl kullanmaktır. Veritabanı ve iş akışı kimliklerini içerdiğinden URL’yi elle yazmak yerine tetikleyici panelindeki gerçek URL’yi kopyalayın. Yetkilendirme olmadan:

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -d '{"test": true, "message": "curl tarafından merhaba"}'

Taşıyıcı Belirteci yetkilendirmesiyle:

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{"order_id": "12345", "status": "paid"}'

Daha karmaşık veri gönderme:

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{
    "event": "invoice.paid",
    "data": {
      "invoice_id": "INV-001",
      "amount": 250.00,
      "currency": "USD",
      "customer_email": "alice@example.com"
    }
  }'

Test isteğini gönderdikten sonra verilerin alınıp doğru ayrıştırıldığını doğrulamak için otomasyonun çalıştırma geçmişini denetleyin.

Hız sınırları

Kapsam	Sınır
Veritabanı başına	Saniyede 50 istek
İş akışı başına	Saniyede 2 istek

Hız sınırını aşan istekler HTTP 429 yanıtı alır. Harici sisteminiz kısa süreli istek yoğunlukları gönderiyorsa üstel geri çekilmeli yeniden deneme mantığı uygulamayı değerlendirin.

Güvenlikle ilgili en iyi uygulamalar

Üretim webhook’larında her zaman Taşıyıcı Belirteci yetkilendirmesi kullanın. Herkese açık bir webhook URL’si, URL’yi bulan herkes tarafından tetiklenebilir.
Webhook URL’nizi gizli tutun. Parola gibi değerlendirin. Herkese açık depolara göndermeyin veya açık kanallarda paylaşmayın.
Belirtecin ele geçirildiğinden şüpheleniyorsanız belirteci yeniden oluşturun. Tetikleyici panelinden istediğiniz zaman yeni bir belirteç oluşturabilirsiniz.
İş akışınızdaki verileri doğrulayın. Gelen verilerin düzgün biçimlendirildiğini varsaymayın. İşlemeden önce zorunlu alanların bulunduğunu doğrulamak için filtreler veya komut dosyası adımları kullanın.
Çalıştırma geçmişini izleyin. Beklenmeyen veya yetkisiz istekleri fark etmek için otomasyonunuzun çalıştırma günlüklerini düzenli olarak denetleyin.

Ne zaman kullanılır?

Stripe veya PayPal’dan ödeme olayları alın. invoice.paid olaylarını Teable otomasyonunuza gönderecek bir Stripe webhook’u yapılandırarak sipariş kayıtlarını otomatik oluşturun veya güncelleyin.
Web sitenizden form gönderimlerini kabul edin. Doğrudan Teable’da kayıt oluşturmak için web sitenizin iletişim veya kayıt formunu webhook URL’sine yönlendirin.
IoT cihazlarından veri alın. HTTP isteği gönderebilen sensörler veya cihazlar, izleme ve uyarılar için Teable’a veri aktarabilir.
CI/CD işlem hatlarını bağlayın. Bir derleme başarılı veya başarısız olduğunda iş akışlarını tetikleyin; kayıt oluşturun, bildirim gönderin veya proje durumunu güncelleyin.
Herhangi bir SaaS aracından olay alın. Birçok araç (GitHub, Jira, Shopify, Twilio vb.) webhook bildirimlerini destekler. Araçlar arası iş akışlarını otomatikleştirmek için bunları Teable webhook’unuza yönlendirin.

İpuçları

Webhook yalnızca POST isteklerini kabul eder. GET, PUT ve diğer yöntemler otomasyonu tetiklemez.
Her zaman Content-Type: application/json üstbilgisi gönderin. Gövde geçerli JSON değilse tetikleyici verileri doğru ayrıştıramayabilir.
Taşıyıcı kimlik doğrulaması için özel üstbilgileri desteklemeyen bir sistemden veri göndermeniz gerekiyorsa herkese açık modu kullanabilir ancak JSON gövdesine iş akışınızın bir filtre veya komut dosyasıyla doğrulayacağı gizli anahtar ekleyebilirsiniz.
Hata ayıklama için harici sisteminizin gerçekten ne gönderdiğini Teable’a yönlendirmeden önce incelemek üzere webhook.site gibi hizmetleri kullanabilirsiniz.

İlgili konular

HTTP isteği eylemi — giden karşılığıdır: iş akışınızdan harici API’leri çağırın
Komut dosyası çalıştır — gelişmiş webhook yükü işleme için
Döngü (toplu) eylemi — webhook yüklerindeki dizileri işleyin

Yapay Zekâ

Alan

Otomasyon

Veritabanı

Yetki Matrisi

SSO

Karşılaştırma

Webhook alındığında

AI ile oluşturma

Yapılandırma

Nasıl yapılandırılır?

Sonraki adımlarda kullanılabilen veriler

Yanıtı özelleştirme

Webhook’unuzu test etme

Hız sınırları

Güvenlikle ilgili en iyi uygulamalar

Ne zaman kullanılır?

İpuçları

İlgili konular

​AI ile oluşturma

​Yapılandırma

​Nasıl yapılandırılır?

​Sonraki adımlarda kullanılabilen veriler

​Yanıtı özelleştirme

​Webhook’unuzu test etme

​Hız sınırları

​Güvenlikle ilgili en iyi uygulamalar

​Ne zaman kullanılır?

​İpuçları

​İlgili konular

AI ile oluşturma

Yapılandırma

Nasıl yapılandırılır?

Sonraki adımlarda kullanılabilen veriler

Yanıtı özelleştirme

Webhook’unuzu test etme

Hız sınırları

Güvenlikle ilgili en iyi uygulamalar

Ne zaman kullanılır?

İpuçları

İlgili konular