Transept'i webhook tetikleyicileriyle otomatikleştirin

Oluşturucuda kayıtlı bir iş akışını açın ve en üstteki tetikleyici kartına bakın; hani üzerinde Manuel olarak çalıştırırsınız yazan kart. Bu bir anahtardır. Varsayılan ayar Manuel'dir: Çalıştır düğmesine kendiniz basarsınız. Webhook, iş akışına harici bir sistemin POST isteği gönderdiği özel bir URL tanımlar, böylece çalışma işlemi kendiliğinden başlar. Tetikleyici kayıtlı bir iş akışına aittir, bu nedenle önce iş akışını kaydedin; kaydedilmemiş taslaklarda Webhook seçeneği devre dışı kalır.

Kartı Webhook konumuna getirin, tetiklemenin neleri etkileyeceğini (aşağıda) ayarlayın ve kaydedin. Transept bu Workflow için gizli bir URL oluşturur ve bunu bir kez gösterir; o anda kopyalayın, çünkü sadece bir hash saklanır ve tam URL bir daha asla gösterilemez. Gizli anahtar, bir başlık yerine URL'nin içinde yer alır; çünkü en basit göndericiler bile başlık ayarlayamayabilir. Bu nedenle URL'ye bir şifre gibi davranın; ona sahip olan herkes çalışmayı başlatabilir.

Kartı daha sonra tekrar açtığınızda, tam URL yerine maskelenmiş bir önek (whk_live_…) ve bir Yenile eylemi görürsünüz. Yenileme işlemi, onayladığınız anda yeni bir URL oluşturur ve eskisini geçersiz kılar; sızdırılan bir bağlantıyı bu şekilde devreden çıkarabilirsiniz. Ayrıca tetikleyiciyi silmeden kapalı konuma getirebilir veya tamamen kaldırabilirsiniz. Kart, en son ne zaman tetiklendiğini gösterir.

URL tetiklendiğinde Workflow'un neleri etkileyeceğini iki ayar belirler:

• Hedef — belirttiğiniz sabit bir belge (her tetikleme o belgeye ve dil grubuna yönlendirilir) veya gelen veri paketinde (payload) adı geçen Notion sayfası (Transept bunu belgenizle eşleştirir ve sayfayı ilk gördüğünde içe aktarır).
• Diller — tüm dil sürümleri (varsayılan; çalışma, hedefin her diline bir grup çalışması olarak yayılır) veya yalnızca tek bir belge.
• Yalnızca güncellenen içerik — varsayılan olarak açıktır; çünkü otomatik bir çalışma, her tetiklemede tüm belgeyi yeniden çevirmek yerine sadece son seferden bu yana değişenleri tekrar işlemelidir. Bkz. Yalnızca değişenleri çalıştır.

Bir Notion veritabanı otomasyonu, Webhook gönder eylemiyle tetikleyiciyi çağırabilir: Eylemi tetikleyici URL'sine yönlendirdiğinizde, otomasyon her çalıştığında Transept, iş akışını tetiklemeyi başlatan sayfa üzerinde yürütür. Bu yöntemi kullanmaya başlamadan önce bilmeniz gereken iki nokta var.

Birincisi, Notion otomasyonları yalnızca içerik düzenlendiğinde değil, bir özellik değişikliği (veya yeni bir sayfa) olduğunda tetiklenir; yani bir sayfanın metnini düzenlemek tek başına bir tetikleme başlatmayabilir. Güvenilir yöntem, otomasyonun izlediği bir Durum özelliğidir: Bu özelliği değiştirdiğinizde (örneğin Çeviriye hazır yaptığınızda), bu değişiklik sinyal işlevi görür.

İkincisi, bir Notion webhook'u yalnızca sayfayı belirtir, sayfa içeriğini asla taşımaz; bu nedenle Transept sayfayı sizin Notion bağlantınız üzerinden okur. Bu bağlantıya da Notion içindeki veritabanı için erişim izni verilmiş olmalıdır. Her iki adım da (Notion'ı bağlamak ve ardından veritabanını entegrasyonla paylaşmak), Transept'i API ile otomatikleştirin sayfasındaki “Notion tetikleyicileri: Transept'e erişim verin” bölümünde açıklanmıştır. Bu adımlardan birini atlarsanız, her tetikleme denemesi erişim hatasıyla geri çevrilir.

HTTP POST gönderebilen her şey tetikleyiciyi çalıştırabilir — bir Zapier veya n8n adımı, bir CI görevi veya bir derleme sonundaki curl komutu gibi. Sabit belge hedefi için gövde önemli değildir, bu nedenle boş bir POST yeterlidir; yalnızca Notion sayfası hedefi, hangi sayfanın değiştiğini anlamak için gövdeyi okur. Authorization başlığına gerek yoktur — gizli anahtar URL'nin kendisidir.

Varsayılan olarak, bir tetikleme Workflow'u tüm dil sürümlerinde çalıştırır ve — Yalnızca güncellenen içerik özelliği açıkken — yalnızca son çalışmadan bu yana kaynağı değişen blokları yeniden çevirir; böylece küçük bir düzenleme tüm belgenin değil, sadece birkaç bloğun maliyetine yol açar. Bu şekilde başlatılan çalışmalar, kelimeleri tıpkı uygulama içi düzenleyicideki gibi ücretlendirir ve bakiye çalışmayı karşılamaya yetmezse hiçbir işlem yapılmaz ve ücret alınmaz.

İncelemenizi bekle şeklinde ayarlanan bir adım yine de duraklatılır: Tetikleme o aşamaya kadar çeviri yapar ve orada bekler; dil ise onaylamanız için düzenleyicinin İncelemeye hazır panelinde görünür — otomasyon inceleme aşamalarınızı atlamaz. Ayrıca, bir Notion sayfası hedefi okunamadığında (genellikle veritabanı entegrasyonla paylaşılmadığı için), tetikleyici kartı son hatayı zaman damgalı bir “Notion sayfası okunamadı” notu olarak gösterir; böylece tetiklemenin neden sonuçsuz kaldığını görebilirsiniz.