Bu rehberde: Dropbox hesabınızı OrqLabs'a bağlarsınız. İş akışları raporları ve üretilen içerikleri Dropbox'a kaydeder, herkese açık paylaşım linki üretir ve bir klasördeki dosyaları listeler.
⏱ 5 dakika (platformun Dropbox uygulaması hazırsa)
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | DROPBOX |
| Kategori | Veri ve dosyalar |
| Kimlik doğrulama | İzin ekranı (Dropbox OAuth 2, çevrimdışı erişim – yenileme anahtarı) |
| Kapsam | Proje bazlı |
| Webhook | Hayır |
| Kutu | Dropbox (app.dropbox) |
Ne işe yarar?
| İşlem | Ne yapar | Etki |
|---|---|---|
| Upload file | Text content alanındaki metni (rapor, açıklama, JSON) UTF-8 dosya olarak veya Or file URL adresindeki dosyayı indirip (en fazla 150 MB) verilen yola kaydeder. Yol / ile bitiyorsa dosya adı URL'den alınır (/Klipler/ → /Klipler/klip.mp4). Overwrite kapalıyken aynı adlı dosya korunur, yeni dosya ad (1).md olarak kaydedilir. | Değişiklik |
| Create shared link | Dosya veya klasör için herkese açık paylaşım linki oluşturur; link zaten varsa onu döndürür. Çıktıda ayrıca doğrudan indirme adresi downloadUrl (dl=1) bulunur. | Değişiklik |
| List folder | Klasördeki dosya ve klasörleri listeler (isteğe bağlı alt klasörlerle); her kayıt ayrı öğe olur: type, name, path, size, serverModified. | Okuma |
Yollar Dropbox yollarıdır: /OrqLabs/raporlar/{{ $today }}.md. Editördeki test çalıştırmalarında yükleme ve link oluşturma çalıştırılmaz; kutu ne yapacağını çıktıya yazar.
Örnek akış – haftalık raporu arşivle: Zamanlayıcı → GA4 raporu / Strateji ajanı → Dropbox · Upload file (path: /OrqLabs/raporlar/{{ $today }}.md, content: {{ $json.report }}) → Dropbox · Create shared link (path: {{ $json.path }}) → Mesaj gönder (Slack'e {{ $json.url }}).
Ön koşullar
- Bir Dropbox hesabı (Basic dahil her plan).
- Platform tarafında Dropbox uygulaması (
DROPBOX_CLIENT_ID,DROPBOX_CLIENT_SECRET).
Adım adım kurulum
- Entegrasyonlar → Dropbox → Bağla → Proje seçin.
- Dropbox ile devam et → Dropbox hesabınıza giriş yapın → İzin ver.
- Kartta hesap adınız görünür. Bağlantıyı test et hesabı yeniden okur.
Platform yöneticisi: uygulama kaydı
- Dropbox App Console → Create app → Scoped access → erişim türü Full Dropbox (veya yalnızca kendi klasörü için App folder; o zaman yollar uygulama klasörüne göredir).
- Permissions sekmesinde şu kapsamları işaretleyip Submit:
account_info.read,files.metadata.read,files.content.read,files.content.write,sharing.read,sharing.write. - Settings → OAuth 2 → Redirect URIs:
https://api.orqlabs.com/api/v1/integrations/oauth/dropbox/callbackekleyin. - App key →
DROPBOX_CLIENT_ID, App secret →DROPBOX_CLIENT_SECRET(API ortam değişkenleri), API'yi yeniden başlatın. - Uygulama "Development" durumundayken en fazla 500 kullanıcı bağlanabilir; daha fazlası için Apply for production başvurusu yapın.
Kapsam sonradan eklenirse mevcut bağlantılar yeni izni almaz: kullanıcıların Yeniden yetkilendir demesi gerekir.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
FORBIDDEN – missing_scope/… | Kapsam App Console'da açık değil veya bağlantı eskiden kalma | Kapsamı açın, entegrasyonu yeniden yetkilendirin |
NOT_FOUND – path/not_found | Yol yanlış (App folder uygulamasında köke göre) | Yolu / ile başlatın, List folder ile kontrol edin |
FORBIDDEN – insufficient_space | Dropbox kotası dolu | Yer açın veya planı yükseltin |
AUTH – expired_access_token | Erişim izni iptal edildi | Yeniden yetkilendir |
INVALID – 150 MB | Dosya tek istekte yüklenemeyecek kadar büyük | Daha küçük dosya kullanın |