X (Twitter)

Çift mod. OAuth 2.0 (passport, @superfaceai/passport-twitter-oauth2) veya cookie connect (POST /api/v1/auth/twitter/unofficial) — giriş yapmış bir tarayıcının auth_token ve ct0 cookie'lerini gönder, Sosyabot bunları api.twitter.com/1.1/account/settings.json üzerinde doğrular.

Kimlik bir bakışta

Alan	Değer
Kimlik modeli	OAuth 2.0
Gerekli ENV	TWITTER_CLIENT_ID, TWITTER_CLIENT_SECRET
Callback URL	${BASE_URL}/api/v1/auth/twitter/callback
Scope'lar / izinler	tweet.read, tweet.write, users.read, follows.read
Otomatik token yenileme	Hayır — süresi dolduğunda manuel reconnect

ENV detayları

Boot'ta her iki anahtar da opsiyoneldir — yönetim paneli bunları çalışma zamanında Yönetim → OAuth Kimlik Bilgileri altından override edebilir. Cookie connect hiçbirine ihtiyaç duymaz.

Nasıl bağlanılır

1. Bağlantılar → X (Twitter) → Bağlan'ı aç.
2. OAuth seç (twitter.com'a yönlendirilirsin) veya tarayıcı cookie'lerini yapıştır (cookie connect formu).
3. Sosyabot hesabı saklar ve bağlantılar listesine geri dönersin.

Token yenileme

X otomatik yenileme süpürmesinde değildir. Cookie kimlik bilgileri her gönderide yeniden doğrulanır; OAuth token'ları X politikasına göre süresi dolar ve dolduğunda manuel reconnect gerekir.

Notlar

• Cookie modu v2 API'yi atlar ve public X bearer token ile eski v1.1 endpoint'lerini kullanır. Kontrol ettiğin kişisel handle'lar için kullan; cookie'leri paylaşma.
• Saklanan Account kayıdındaki login_type OAuth için 1, cookie için 2'dir. Her ikisi de can_post: 1 flag'ini taşır.
• X uygulaman sandbox/audit kademesindeyse ve sınırlı yayın yapabiliyorsa, cookie connect geçici çözümdür.

Sorun giderme

Kanal needs_reconnect gösteriyorsa, access token X (Twitter) 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.

İlgili

Bağlantılar Genel Bakış

Editör

OAuth Callback URL'leri