Threads API Kurulumu
Threads (Meta) entegrasyonu için admin walkthrough. Son-kullanıcı akışı: Bağlantılar → Threads.
Genel bakış
| Form alanı | Options anahtarı |
|---|---|
| App ID | threads_app-id |
| App Secret | threads_app-secret |
| Status | threads_integration_status |
ENV fallback: THREADS_APP_ID + THREADS_APP_SECRET.
Threads kendi Meta app'ini kullanır
Threads bir Meta ürünü olmasına rağmen Threads ürünü etkin ayrı bir Meta app gerektirir — daha önce yapılandırdığın Facebook/Instagram app'ini yeniden kullanamazsın. OAuth akışı farklıdır (Threads, Facebook Graph API'sini değil Threads Graph API'sini kullanır).
developers.facebook.com adım adım
1. Threads için yeni Meta app oluştur
https://developers.facebook.com → My Apps → Create App → app type Business → adlandır (örn. "Sosyabot Threads").
2. Threads ürününü ekle
App dashboard'unda Add Product'a tıkla ve Threads'i seç. Sorulduğunda Threads API şartlarını kabul et.
3. Threads → Use Cases yapılandır
Threads → Use Cases'i aç. Yapılandır:
- Use case: Access the Threads API.
- Threads → Settings → Redirect Callback URLs:
https://app.sosyabot.com/api/v1/auth/threads/callback
4. Gerekli izinler
threads_basic, threads_content_publish. Her ikisi de Development modunda davetli tester'lara otomatik verilir; production yayını Threads use case'in Meta App Review'ünü gerektirir.
5. App ID + App Secret'ı al
Yeni app'in Settings → Basic'i. App ID'yi kopyala ve App Secret'ı reveal/kopyala.
Sosyabot admin paneline yapıştırma
/admin/api-integration/threads. Yapıştır, Enable, Save, Test credentials.
Hata: Threads integration disabled: app id/secret not configured.
Doğrulama
/app/channels → Connect → Threads → OAuth → onayla. /app/publishing'den kısa metin-only bir thread yayınla.
Sorun giderme
| Belirti | Sebep | Çözüm |
|---|---|---|
Threads integration disabled: app id/secret not configured | Admin + ENV boş | 1-5. adımlar. |
Threads access not enabled for this app | Threads ürünü eklenmedi | 2. adımı tamamla. |
| Uzun ömürlü token 60 gün sonra expire | Varsayılan Threads token TTL | Sosyabot tokenRefresh.queue.ts worker'ı süre dolmadan 7 gün önce otomatik yeniler — worker'ın çalıştığını doğrula (./service.sh logs worker). |
Yükseltme sonrası Invalid OAuth access token | App Secret rotate edildi | Etkilenen kullanıcıları reconnect et. |
ENV fallback
THREADS_APP_ID=<app id'in>
THREADS_APP_SECRET=<app secret'in>.env düzenledikten sonra ./service.sh restart api.