Threads
Threads Graph API üzerinden OAuth 2.0. İki aşamalı takas: kısa ömürlü token → th_exchange_token grant ile uzun ömürlü token. Sosyabot { accessToken, userId, expiresAt } saklar.
Kimlik bir bakışta
| Alan | Değer |
|---|---|
| Kimlik modeli | OAuth 2.0 |
| Gerekli ENV | THREADS_APP_ID, THREADS_APP_SECRET |
| Callback URL | ${BASE_URL}/api/v1/auth/threads/callback |
| Scope'lar / izinler | threads_basic, threads_content_publish |
| Otomatik token yenileme | Evet — süresi dolmadan 7 gün önce |
Nasıl bağlanılır
- Bağlantılar → Threads → Bağlan'ı aç.
- Threads'e (Meta) giriş yap ve scope'ları onayla.
- Sosyabot iki aşamalı token takasını tamamlar ve uzun ömürlü token'ı saklar.
Token yenileme
Otomatik yenilenir. tokenRefresh.queue.ts worker'ı Threads hesaplarını tarar ve expiresAt'i 7 gün içinde olan herhangi bir token'ı POST /v1.0/refresh_access_token?grant_type=th_refresh_token çağırarak yeniler.
Notlar
- Varsayılan token TTL'i 60 gündür; otomatik yenileme worker çalıştığı sürece seni süresiz olarak oturumda tutar.
- Meta uygulaması yalnızca Graph API ile değil, Threads ürünüyle de yapılandırılmış olmalıdır.
- Eski bağlantılarda
expiresAteksikse, workerupdatedAt'ten 60 gün varsayar ve devam eder.
Sorun giderme
Kanal needs_reconnect gösteriyorsa, access token Threads tarafından reddedilmiştir. Yaygın sebepler:
- Kullanıcı Sosyabot'un yetkilendirmesini platform üzerinden iptal etmiştir.
- Platform token'ı geçersiz kılmıştır (şifre değişikliği, güvenlik olayı).
- OAuth uygulama kimlik bilgileriniz değişmiştir ve mevcut token'lar artık eşleşmiyordur.
Yukarıdaki bağlantı akışını yeniden çalıştır. Çalışma alanı genelinde checklist için Sorun Giderme'ye bak.