Box Etkinlik Güncellemelerini Otomatik Al ve İşle

Genel Bakış

Bu iş akışı, Box bulut depolama hizmetinizdeki belirli etkinlikleri (örneğin, yeni dosya yüklemeleri, klasör değişiklikleri, dosya silmeleri) otomatik olarak izlemek ve bu etkinlikler hakkında gerçek zamanlı güncellemeler almak için tasarlanmıştır. Box Trigger düğümünü kullanarak, Box API'sinden gelen webhook bildirimlerini dinler ve bu veriyi n8n'de daha fazla işlem için kullanılabilir hale getirir.

Gereksinimler

• n8n Hesabı/Kurulumu: Çalışan bir n8n kurulumuna (bulut veya kendi sunucunuzda) sahip olmanız gerekir.
• Box Hesabı: Box'ta bir hesabınız olmalı ve bu hesapta izlemek istediğiniz etkinliklerin gerçekleştiği klasörlere veya dosyalara erişiminiz bulunmalıdır.
• Box API Kimlik Bilgileri: n8n'in Box hesabınıza bağlanabilmesi için Box OAuth 2.0 kimlik bilgilerine ihtiyacınız olacaktır. Bu genellikle Box geliştirici konsolundan alınır.

Kurulum Adımları

1. n8n İş Akışını İçe Aktarın: Bu iş akışını n8n arayüzünüze içe aktarın. (Bu talimatlar, mevcut bir JSON dosyasını içe aktardığınızı varsayar.)
2. Box Trigger Düğümünü Yapılandırın:
   • İş akışındaki 'Box Trigger' düğümüne tıklayın.
   • 'Credentials' (Kimlik Bilgileri) bölümünde 'New Credential' (Yeni Kimlik Bilgisi) seçeneğini seçin.
   • Açılan pencerede 'Box OAuth2 API' seçeneğini seçin.
   • 'Grant Type' (Yetkilendirme Türü) olarak 'Authorization Code' (Yetkilendirme Kodu) seçeneğini bırakın.
   • 'Connect with Box' (Box ile Bağlan) düğmesine tıklayın. Bu sizi Box'ın yetkilendirme sayfasına yönlendirecektir. Box hesabınıza giriş yapın ve n8n'e gerekli izinleri verin.
   • Başarılı bir bağlantıdan sonra, n8n'e geri yönlendirileceksiniz ve kimlik bilgileriniz otomatik olarak kaydedilecektir.
   • 'Events' (Etkinlikler) bölümünde, izlemek istediğiniz Box etkinliklerini seçin (örneğin, 'File Uploaded', 'Folder Created', 'File Deleted'). Birden fazla etkinlik seçebilirsiniz.
   • 'Resource' (Kaynak) bölümünde, izlemek istediğiniz kaynağın türünü seçin (örneğin, 'File', 'Folder'). Belirli bir klasörü izlemek istiyorsanız, 'Folder' seçeneğini seçip ilgili klasörün ID'sini girmeniz gerekebilir.
3. Diğer Düğümleri Yapılandırın (Opsiyonel):
   • Box Trigger düğümünden sonra gelen diğer düğümler (örneğin, Slack, Google Sheets, Email) için gerekli kimlik bilgilerini ve ayarları yapın. Bu düğümler, Box'tan gelen veriyi işlemek ve ilgili eylemleri gerçekleştirmek için kullanılacaktır.
4. İş Akışını Aktive Edin: İş akışının sağ üst köşesindeki 'Active' (Aktif) düğmesini açarak iş akışını etkinleştirin. Artık Box'ta seçtiğiniz etkinlikler gerçekleştiğinde n8n otomatik olarak tetiklenecektir.

Kullanım Senaryoları

• Senaryo 1: Yeni Yüklenen Dosyalar İçin Slack Bildirimi: Bir ekip klasörüne yeni bir dosya yüklendiğinde, Box Trigger bunu algılar ve bir Slack düğümü aracılığıyla ilgili kanala dosya adı, yükleyen kişi ve dosya bağlantısı içeren bir bildirim gönderir.
• Senaryo 2: Box Etkinliklerini Google Sheets'e Kaydetme: Box'ta gerçekleşen tüm dosya oluşturma ve silme etkinliklerini otomatik olarak bir Google Sheets tablosuna tarih, etkinlik türü, dosya/klasör adı ve kullanıcı bilgileriyle birlikte kaydeder. Bu, denetim ve raporlama amaçları için faydalıdır.

İpuçları ve Öneriler

• Webhook URL'sini Kontrol Edin: Box Trigger düğümünü ilk kez etkinleştirdiğinizde, n8n otomatik olarak Box'ta bir webhook oluşturur. Herhangi bir sorun yaşarsanız, Box geliştirici konsolundan webhook'un doğru şekilde oluşturulup oluşturulmadığını kontrol edebilirsiniz.
• Test Etkinlikleri Oluşturun: İş akışını etkinleştirdikten sonra, Box'ta küçük bir test dosyası yükleyerek veya bir klasör oluşturarak iş akışının doğru çalışıp çalışmadığını test edin.
• Hata Yönetimi Ekleme: Daha karmaşık iş akışlarında, olası hataları yakalamak ve işlemek için 'Error Trigger' ve 'IF' düğümleri gibi hata yönetimi mekanizmaları eklemeyi düşünebilirsiniz.
• Veri Filtreleme: Yalnızca belirli türdeki dosyalar veya belirli klasörlerdeki etkinlikler için işlem yapmak istiyorsanız, Box Trigger'dan sonra 'IF' veya 'Filter' düğümlerini kullanarak gelen veriyi filtreleyebilirsiniz.