Kurulum Rehberi

X (Twitter) Uygulamanızı Oluşturup Bağlayın

X API artık ücretli ve uygulama başına kotalıdır. Bu yüzden her çalışma alanı KENDİ X uygulamasını getirir (BYO) — böylece maliyet ve kota size ait olur. Bu rehber, kendi X uygulamanızı oluşturup SocialToWeb’e adım adım bağlamayı anlatır.

Yaklaşık 10–15 dakikaBir X (Twitter) hesabı

Maliyet sizin uygulamanıza aittir

X “kullandıkça öde” (kredi) modeliyle çalışır. Kendi uygulamanızı kullandığınız için ücretler sizin X kredinizden düşer: bir tweet ≈ $0.015 (link içerirse $0.20), DM/mention okuma birkaç sent. Kredinizi console.x.com’dan yüklersiniz.

X Developer hesabı açın

developer.x.com adresine gidin ve X hesabınızla giriş yapın. Developer hesabınız yoksa kısa bir kayıt/başvuru adımını tamamlayın.

developer.x.com

Proje ve uygulama oluşturun

Developer Portal → “Projects & Apps” bölümünden yeni bir uygulama (App) oluşturun. Uygulamaya ayırt edici bir ad verin, örneğin “Firma Adı – SocialToWeb”.

Apps in Pay Per Use — uygulama listesi ve “Create App”

Kimlik doğrulama ayarları

Uygulama → Settings → “User authentication settings” → Set up / Edit. Şu ayarları yapın:

App permissions: “Read and write and Direct message” seçin. (DM ve yorum yönetimi için ŞARTTIR; yalnızca “Read and write” seçerseniz DM çalışmaz.)
Type of App: “Web App, Automated App or Bot” (Confidential client).
Callback URI: SocialToWeb’in size verdiği callback adresini BİREBİR yapıştırın: https://app.socialtoweb.com/api/auth/x/callback
Website URL: firma sitenizi girin (örn. https://socialtoweb.com).

Callback adresi BİREBİR eşleşmelidir; aksi halde bağlama sırasında “redirect_uri mismatch” hatası alırsınız.

App permissions = “Read and write and Direct message” ve Type of App = Web App

App info — Callback URI ve Website URL alanları doldurulmuş

Anahtarları alın (Keys & Tokens)

Uygulama → “Keys & Tokens” sekmesinden aşağıdaki değerleri kopyalayın. Secret’lar genelde YALNIZCA BİR KEZ gösterilir; kaybederseniz “Regenerate” ile yenileyebilirsiniz.

X Console’daki yeri	SocialToWeb alanı	Ne için
OAuth 2.0 → Client ID	Client ID	Bağlama (zorunlu)
OAuth 2.0 → Client Secret	Client Secret	Bağlama (zorunlu)
App-Only → Bearer Token	Bearer Token	Webhook (gerçek zamanlı)
OAuth 1.0 → API Key Secret	API Key Secret	Webhook imza/CRC

“API Key Secret” (Consumer Secret), OAuth 2.0 “Client Secret”’ten FARKLI bir değerdir. Webhook kullanmayacaksanız Bearer Token ve API Key Secret opsiyoneldir.

OAuth 2.0 Keys — Client ID + Client Secret

OAuth 1.0 Keys — Consumer Key / API Key Secret

Kredi yükleyin

X “kullandıkça öde” modelinde olduğu için, yayın/DM çalışmadan önce kredi yüklemeniz gerekir. console.x.com → Billing / Credits → “Buy Credits”.

console.x.com

Kredi yoksa yayın sırasında “does not have any credits to fulfill this request” hatası alırsınız.

Developer Console — Credits / kredi bakiyesi ve “Purchase credits”

SocialToWeb’e bağlayın

SocialToWeb → Kanallar → “Kanal Bağla” → X.
“X Uygulamanızı Bağlayın” ekranında Client ID, Client Secret (webhook isterseniz Bearer Token + API Key Secret) girin → “Kaydet ve Devam Et”.
Açılan X penceresinde uygulamanızı “Authorize app” ile yetkilendirin.
Hesabınız kanal listenize eklenir. Artık İçerik Yöneticisi’nden yayın yapabilirsiniz. 🎉

Daha sonra bilgileri düzenlemek için Kanallar’daki X kartının köşesindeki ⚙ (dişli) simgesini kullanabilirsiniz.

SocialToWeb “X Uygulamanızı Bağlayın” formu

(Opsiyonel) Gerçek zamanlı webhook

DM ve mention’ların manuel “Senkronla” gerekmeden anlık gelmesini istiyorsanız webhook’u etkinleştirin: Kanallar → X satırı → ⚡ (şimşek) simgesi.

Ön koşullar:

X uygulama izni: “Read and write and Direct message”.
Bearer Token ve API Key Secret SocialToWeb’e girilmiş olmalı.

⚡’a basınca webhook X uygulamanıza otomatik kaydedilir ve hesabınız abone edilir. Sonrasında DM/mention anlık düşer.

Kanallar’daki X satırında ⚡ webhook simgesi

Sorun giderme

Sık karşılaşılan hatalar

redirect_uri mismatch

Callback adresi birebir eşleşmiyor. 3. adımdaki Callback URI’yi SocialToWeb’deki adresle aynı yapın.

invalid scope

Uygulama izni “Read and write and Direct message” değil. İzni güncelleyip kanalı yeniden bağlayın.

does not have any credits

X kredisi yok. 5. adımdan kredi yükleyin.

Webhook / Bearer Token gerekli

Webhook için Bearer Token ve API Key Secret zorunludur. 4. adımdan alıp forma girin.

DM gelmiyor

Sizi takip etmeyen birinden gelen DM, X’te “Mesaj İstekleri”ne düşebilir ve API’de görünmeyebilir. X uygulamasından isteği kabul edin.

Hazır mısınız?

Anahtarlarınızı aldıysanız, X kanalınızı şimdi bağlayın.

Ücretsiz Başla Tüm Entegrasyonlar