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 ya da 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: alan adını sabitlemeyin. /admin/api-integration/threads admin sayfasında gösterilen tam Callback URL'yi (bu kurulum için canlı) kopyalayın. Kalıp:

  <BASE_URL>/api/v1/auth/threads/callback

  <BASE_URL> backend URL'iniz; /api/v1 ayarlı API_PREFIX'tir. Bkz. OAuth Callback URL'leri.

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.

İlgili

OAuth Kimlik Bilgileri genel

Threads kullanıcı bağlantı

Facebook kurulumu