Bu rehberde: Threads hesabınızı bağlarsınız. Threads, Meta'nın ayrı bir uygulama kimliği üreten özel bir kullanım senaryosudur. Yayın sınırlarını (500 karakter, 1 konu etiketi) öğrenirsiniz.
⏱ 15 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | THREADS |
| Kategori | Sosyal medya |
| Kimlik doğrulama | İzin ekranı (Threads API) |
| Kapsam | Proje bazlı |
| Webhook | Hayır |
| Yetenekler | Gönderi yayınlama, metrik okuma |
| Kullanan kutular | Yayınla, Zamanla, Metrik al |
| Kullanan ajanlar | Content Creator, Social Publisher |
Ne işe yarar?
Threads hesabınıza metin ve görsel/video gönderileri yayınlar; görüntüleme, beğeni, yanıt ve repost sayılarını okur. Yorum yönetimi bu sürümde yoktur.
Ön koşullar
- Bir Threads hesabı (Instagram hesabınıza bağlıdır).
- Meta for Developers'ta Threads API kullanım senaryolu bir uygulama.
- Platform yöneticisinin
THREADS_APP_IDveTHREADS_APP_SECRETtanımlamış olması. Threads, Meta uygulamasının genel App ID'sinden ayrı bir kimlik üretir.
Adım adım kurulum
A) Meta for Developers (platform yöneticisi)
- developers.facebook.com → My Apps → Create App → ① kullanım senaryosu Access the Threads API → ad ve iletişim e-postası → ② Create app.
- Use cases → Access the Threads API → Customize.
- Settings sekmesinde ① Threads App ID ve ② Threads App Secret değerlerini kopyalayın; yönetici bunları
THREADS_APP_IDveTHREADS_APP_SECRETolarak tanımlar.
- ① Redirect Callback URLs:
https://api.orqlabs.com/api/v1/integrations/oauth/threads/callback. ② Uninstall Callback URL ve Delete Callback URL: 200 dönen herhangi bir adres; OrqLabs geri dönüş adresini kabul eder. ③ Save.
- ① Permissions:
threads_basic,threads_content_publish,threads_manage_insightsişaretli olsun. - ② App roles → Roles → Add people → Threads Tester → Threads kullanıcı adınızı ekleyin. Threads uygulamasında Ayarlar → Hesap → Web sitesi izinleri → Davetler bölümünden daveti kabul edin.
- ③ App settings → Basic: gizlilik politikası ve hizmet şartları adresleri (App Review için).
B) OrqLabs'ta bağlama
- Entegrasyonlar → Threads → Bağla.
- ① Proje seçin; ② Bağla.
- Threads yetkilendirme ekranında giriş yapın ve izinleri onaylayın.
- OrqLabs kısa ömürlü izni (1 saat) uzun ömürlüye (60 gün) çevirir ve süresi yaklaşırken otomatik yeniler.
- Bağlantıyı test et: kullanıcı adı ve profil bilgisi görünmelidir.
İzinler ve kapsamlar
| Kapsam | Neden gerekli |
|---|---|
threads_basic | Profil ve gönderi listesi |
threads_content_publish | Metin/görsel/video gönderi oluşturma |
threads_manage_insights | Gönderi ve hesap içgörüleri |
Uygulama incelemesi
- Development modda yalnızca Threads Tester hesapları bağlanır; kendi markanız için yeterli olabilir.
- Başka kullanıcıların hesapları için üç izne App Review ve Business verification gerekir.
- Uygulama Live moda alınmadan test kullanıcısı dışında kimse bağlanamaz.
Limitler
| Konu | Sınır |
|---|---|
| Yayın kotası | 24 saatte 250 API gönderisi; yanıt için ayrı 1.000 |
| Metin | 500 karakter |
| Konu etiketi | Gönderi başına 1 |
| Görsel | JPEG/PNG, 8 MB |
| Video | MP4/MOV, 5 dk, 1 GB |
| Carousel | 2-20 medya |
| İzin | Uzun ömürlü 60 gün; otomatik yenilenir |
| Yayın süreci | 2 adım: kap oluştur → bekle → yayınla; OrqLabs yönetir |
Bağlantıyı test etme
② Bağlantıyı test et profil bilgisini okur ve iznin kalan süresini gösterir. Test modunda Yayınla kutusu karakter ve konu etiketi doğrulaması yapar.
Kimlik bilgilerini yenileme
- Uzun ömürlü izin 60 günde bir otomatik yenilenir. Yenileme başarısız olursa (izin kaldırıldıysa) kart "Yeniden yetkilendirme gerekli" olur.
- Threads uygulamasında Web sitesi izinleri bölümünden OrqLabs'ı kaldırırsanız izin anında geçersizleşir.
- Threads App Secret sıfırlanırsa tüm izinler düşer.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
| "Invalid platform app" / "redirect_uri mismatch" | Threads App ID veya adres yanlış | Redirect Callback URLs ve .env değerlerini kontrol edin |
| "You are not a tester of this app" | Test kullanıcısı değil | Threads Tester ekleyin, daveti kabul edin |
AUTH – kod 190 | İzin yenilenmedi | Yeniden yetkilendir |
INVALID – "Media not found" | Adres erişilemez veya biçim | Herkese açık JPEG/MP4 |
| Metin 500 karakteri aşıyor | Uzun içerik | Göreve "Threads için 500 karakter" ekleyin |
RATE_LIMIT – "Publishing limit reached" | 250/24 saat | Bekleyin |
| Kap "ERROR" | Video işleme başarısız | Kodek/oranı kontrol edin |
| İçgörü boş | Gönderi çok yeni | Birkaç saat sonra dolar |
Sık sorulan sorular
Instagram bağlantım yeterli mi? Hayır. Threads ayrı bir izin ve ayrı bir uygulama kimliği ister.
Yorumlara yanıt verir mi? Bu sürümde hayır.
Uzun metinleri böler mi? Hayır. 500 karakteri aşan metin hata verir; Content Creator'a sınırı belirtin.