Transept'i webhook tetikleyicileriyle otomatikleştirin

Oluşturucuda kayıtlı bir iş akışını açın ve en üstteki tetikleyici kartına —üzerinde Bunu manuel olarak çalıştırırsınız yazan karta— bakın. Bu bir geçiş anahtarıdır. Manuel varsayılan ayardır: Çalıştır düğmesine kendiniz basarsınız. Webhook ise iş akışına dış bir sistemin POST isteği gönderebileceği özel bir URL tanımlar; böylece süreç kendiliğinden başlar. Tetikleyici kaydedilmiş bir iş akışına bağlıdır, bu yüzden önce iş akışını kaydedin — Webhook seçeneği kaydedilmemiş taslaklarda devre dışı kalır.

Kartı Webhook konumuna getirin, tetikleyicinin neyi çalıştıracağını (aşağıda) belirleyin ve kaydedin. Transept bu iş akışına özel gizli bir URL oluşturur ve bunu bir kez gösterir; bu yüzden URL'yi o an kopyalayın, çünkü sistemde yalnızca bir hash saklanır ve tam URL bir daha asla görüntülenemez. Gizli anahtar, bir başlık (header) yerine URL'nin içinde yer alır; çünkü en basit göndericiler başlık ayarı yapamaz. Bu nedenle URL'ye bir şifre gibi davranın; ona sahip olan herkes süreci başlatabilir.

Kartı daha sonra tekrar açtığınızda, tam URL yerine maskelenmiş bir ön ek (whk_live_…) ve bir Yenile (Rotate) işlemi görürsünüz. Yenileme işlemi, onay verdiğiniz anda yepyeni bir URL oluşturur ve eskisini geçersiz kılar; sızdırılan bir bağlantıyı bu şekilde devre dışı bırakabilirsiniz. Ayrıca tetikleyiciyi silmeden kapatabilir veya tamamen kaldırabilirsiniz. Kartta, tetikleyicinin en son ne zaman çalıştığı da gösterilir.

URL tetiklendiğinde iş akışının neleri etkileyeceğini iki ayar belirler:

• Hedef — belirlediğiniz sabit bir doküman (her tetikleme o dokümanı ve dil grubunu etkiler) veya gelen veri paketinde belirtilen Notion sayfası (Transept bunu dokümanınızla eşleştirir ve sayfayı ilk kez gördüğünde içe aktarır).
• Diller — tüm dil versiyonları (varsayılan; çalışma, hedefin her diline bir grup çalışması olarak yayılır) veya sadece tek bir doküman.
• Sadece güncellenen içerik — varsayılan olarak açıktır; çünkü otomatik bir çalışma, her tetiklemede tüm dokümanı yeniden çevirmek yerine sadece son seferden beri değişen kısımları işlemelidir. Bkz. Sadece 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ı tetiklemeye neden olan sayfa üzerinde yürütür. Bu yöntemi kullanmadan önce bilmeniz gereken iki önemli nokta var.

İlk olarak, Notion otomasyonları sadece gövde metni düzenlendiğinde değil, bir özellik değişikliği (veya yeni bir sayfa) olduğunda tetiklenir; bu nedenle bir sayfanın metnini düzenlemek tek başına bir tetikleme oluşturmayabilir. En güvenilir yöntem, otomasyonun bir Durum (Status) özelliğini izlemesidir: Bu özelliği değiştirdiğinizde (örneğin Çeviriye hazır konumuna getirdiğinizde), bu değişiklik gerekli sinyali gönderir.

İkinci olarak, bir Notion webhook'u yalnızca sayfanın adını bildirir —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ına erişim izni verilmiş olmalıdır. Her iki adım da (Notion'ı bağlamak ve ardından veritabanını entegrasyonla paylaşmak), API ile Transept'i Otomatikleştirin rehberinin “Notion tetikleyicileri: Transept'e erişim izni verin” bölümünde ayrıntılarıyla anlatılmıştır. Bu adımlardan herhangi birini atlarsanız, her tetikleme bir erişim hatasıyla geri çevrilir.

HTTP POST isteği gönderebilen her şey tetikleyiciyi çalıştırabilir — bir Zapier veya n8n adımı, bir CI işi ya da bir derleme sonundaki curl komutu gibi. Sabit doküman hedefi için gövde (body) önemli değildir, bu yüzden boş bir POST isteği yeterlidir; sadece Notion sayfası hedefi, hangi sayfanın değiştiğini belirlemek için gövdeyi okur. Authorization başlığına (header) gerek yoktur; gizli anahtar URL'nin tamamıdır.

Varsayılan olarak bir tetikleme, iş akışını tüm dil versiyonları genelinde çalıştırır ve —Sadece güncellenen içerik özelliği açıkken— yalnızca son çalışmadan bu yana kaynak metni değişen blokları yeniden çevirir; böylece küçük bir düzenleme tüm dokümanı değil, yalnızca birkaç bloğu harcar. Bu yöntemle başlatılan çalışmalar, tıpkı uygulama içi editördeki gibi kelime bazlı ücretlendirilir; bakiyeniz çalışmayı karşılamaya yetmiyorsa hiçbir işlem başlatılmaz ve herhangi bir ücret yansıtılmaz.

İncelemenizi bekleyecek şekilde ayarlanan bir adım yine de beklemeye alınır: Tetikleme işlemi o eşiğe kadar çeviriyi yapar ve orada durur; ilgili dil, onaylamanız için editörün İncelemeye Hazır panelinde belirir — otomasyon, inceleme aşamalarınızı atlamaz. Bir Notion sayfası hedefi okunamadığında ise (genellikle veritabanı entegrasyonla paylaşılmadığı için), tetikleyici kartı son başarısızlığı zaman damgalı bir “Notion sayfası okunamadı” notu olarak öne çıkarır; böylece tetiklemenin neden sonuçsuz kaldığını görebilirsiniz.

Evet. Tetikleyicinin hedefini “istek gövdesi içeriktir” olarak ayarlayın; URL'ye POST ettiğiniz her şey dokümana dönüşür: ham Markdown, HTML veya düz metin (uygun Content-Type bilgisini gönderin) ya da {"content": "…", "content_type": "markdown"} şeklinde bir JSON. Her tetikleyici için, her gönderimin yeni bir doküman mı oluşturacağını yoksa sabit bir dokümanı mı güncelleyeceğini seçin; güncelleme işlemi içeriği yeniden hizalar, böylece sadece değişen bloklar yeniden çevrilir. E-posta platformları, Zapier/n8n adımları veya script'ler; şablonları ya da makaleleri manuel yükleme gerektirmeden doğrudan çeviri iş akışına bu şekilde aktarır. Tekrar eden gönderimler 24 saat boyunca tekilleştirilir; tam kontrol sağlamak için JSON içeriğine bir external_id (kendi mesaj kimliğiniz) ekleyin. İstek gövdesi 10 MB'a kadar olabilir.