🔌 API Kurulum Rehberi

Sosyal medya platformlarınızı LiveSocial VB'ye bağlamak çok kolay. Adım adım talimatları takip edin.

𝕏

Twitter/X API Kurulumu

X'te (eski adıyla Twitter) otomatik paylaşım için API anahtarlarını alın

💡
Başlamadan Önce

Aktif bir X hesabınız ve geliştirici erişiminiz olması gerekir. Geliştirici hesabı başvurusu 5-10 dakika sürer.

1

Developer Portal'a Giriş Yapın

developer.twitter.com/portal adresine gidin ve X hesabınızla oturum açın.

⚠️

Eğer geliştirici hesabınız yoksa, "Sign up for free" butonuna tıklayarak başvuru yapın.

2

Yeni Uygulama Oluşturun

Dashboard'da sol tarafta "Projects & Apps" bölümüne gidin.

  • "Create App" butonuna tıklayın
  • Uygulama adı girin (örn: "LiveSocial VB")
  • Uygulama açıklaması yazın
  • "Next" butonuna tıklayın
3

API Keys Alın

Uygulamanız oluşturulduktan sonra, otomatik olarak API Keys sayfasına yönlendirileceksiniz.

API Key (Consumer Key): [Buraya API Key'iniz yazılacak] API Key Secret (Consumer Secret): [Buraya API Key Secret'ınız yazılacak] Bearer Token: [Buraya Bearer Token'ınız yazılacak]
✅
Bu Anahtarları Kaydedin

Bu anahtarları not edin veya indir. Daha sonra ihtiyaç duyacaksınız.

4

Access Tokens Oluşturun

Aynı sayfada aşağıya inin ve "Generate" butonuna tıklayarak Access Token ve Access Token Secret'ı oluşturun.

Access Token: [Buraya Access Token'ınız yazılacak] Access Token Secret: [Buraya Access Token Secret'ınız yazılacak]
5

İzinleri Ayarlayın

Uygulamanızın "Settings" sekmesine gidin ve aşağıdaki ayarları yapın:

  • App Permissions: "Read and Write" seçin
  • Authentication Settings: "3-legged OAuth" etkinleştirin
  • Callback URLs: Eklenti tarafından sağlanan URL'i girin
💡

Callback URL'sini eklenti ayarlarında bulabilirsiniz.

6

LiveSocial VB'ye Anahtarları Girin

vBulletin Admin Paneli → LiveSocial VB → Ayarlar → Twitter/X bölümüne giderek yukarıda aldığınız tüm anahtarları girin.

  • API Key
  • API Key Secret
  • Bearer Token
  • Access Token
  • Access Token Secret
  • ✅
    Tamamlandı!

    Tüm adımları tamamladıysanız, "Test Bağlantısı" butonuna tıklayarak bağlantıyı test edin.

    f

    Facebook API Kurulumu

    Facebook sayfanıza otomatik paylaşım yapın

    💡
    Başlamadan Önce

    Bir Facebook Sayfasına sahip olmanız ve o sayfanın yöneticisi olmanız gerekir. Kişisel hesap yeterli değildir.

    1

    Facebook Developer'a Kaydolun

    developers.facebook.com adresine gidin ve Facebook hesabınızla giriş yapın.

    2

    Uygulama Oluşturun

    Dashboard'da "My Apps" → "Create App" butonuna tıklayın.

    • App Type: "Business" seçin
    • App Name: "LiveSocial VB" yazın
    • App Purpose: Uygun bir seçenek belirleyin
    • "Create App" butonuna tıklayın
    3

    Facebook Login Ürünü Ekleyin

    Uygulamanızda "Facebook Login" ürününü ekleyin.

    • Dashboard'da "Add Product" butonuna tıklayın
    • "Facebook Login" arayın ve "Set Up" butonuna tıklayın
    • Platform olarak "Web" seçin
    4

    App ID ve App Secret Alın

    Uygulamanızın "Settings" → "Basic" bölümünde App ID ve App Secret'ı bulabilirsiniz.

    App ID: [Buraya App ID'niz yazılacak] App Secret: [Buraya App Secret'ınız yazılacak]
    5

    Page Access Token Alın

    Facebook sayfanız için erişim tokenı alın.

    • Facebook Developer Dashboard'da "Tools" → "Graph API Explorer" açın
    • Açılır menüden uygulamanızı seçin
    • Arama kutusuna "me/accounts" yazın ve "Get" butonuna tıklayın
    • Sayfanızı bulun ve "access_token" değerini kopyalayın
    ⚠️

    Page Access Token'ı güvenli bir yerde saklayın. Kimseyle paylaşmayın.

    6

    LiveSocial VB'ye Anahtarları Girin

    vBulletin Admin Paneli → LiveSocial VB → Ayarlar → Facebook bölümüne giderek anahtarları girin.

  • App ID
  • App Secret
  • Page ID
  • Page Access Token
  • ⚠️
    Onay Süreci

    Facebook, uygulamanızın yayın erişimine sahip olması için onay yapması gerekebilir. Bu 1-7 gün sürebilir.

    📷

    Instagram API Kurulumu

    Instagram Business hesabınıza otomatik paylaşım yapın

    💡
    Başlamadan Önce

    Instagram hesabınızı "Business" hesabına dönüştürmeniz gerekir. Kişisel hesap yeterli değildir.

    1

    Instagram Hesabını Business'a Dönüştürün

    Instagram uygulamasında:

    • Profil sayfanıza gidin
    • Ayarlar → Hesap Türünü Değiştir
    • "Business" seçeneğini seçin
    • Talimatları takip edin
    2

    Facebook Developer'da Instagram Graph API Ekleyin

    developers.facebook.com adresinde uygulamanıza "Instagram Graph API" ürününü ekleyin.

    3

    Instagram Business Account ID Alın

    Facebook Developer Dashboard'da Graph API Explorer kullanarak:

    • Arama kutusuna "me/instagram_business_account" yazın
    • "Get" butonuna tıklayın
    • Dönen sonuçta "id" değerini kopyalayın
    Instagram Business Account ID: [Buraya Account ID'niz yazılacak] Access Token: [Buraya Access Token'ınız yazılacak]
    4

    LiveSocial VB'ye Anahtarları Girin

    vBulletin Admin Paneli → LiveSocial VB → Ayarlar → Instagram bölümüne giderek anahtarları girin.

  • Instagram Business Account ID
  • Access Token
  • ⚠️
    Sınırlamalar

    Instagram Graph API şu anda Carousel, Image ve Video gönderilerini destekler. Reel ve Stories şu anda desteklenmiyor.

    ✈️

    Telegram Bot Kurulumu

    Telegram kanalınıza otomatik mesaj gönderin

    ✅
    En Kolay Platform!

    Telegram, diğer platformlardan farklı olarak onay süreci gerektirmez. 5 dakikada kurabilirsiniz.

    1

    Telegram'da BotFather ile İletişime Geçin

    Telegram uygulamasını açın ve aşağıdaki adımları takip edin:

    • Arama kutusuna @BotFather yazın
    • BotFather'ı açın
    • /newbot komutunu yazın ve gönderin
    2

    Bot Adı ve Kullanıcı Adı Belirleyin

    BotFather'ın sorduğu sorulara cevap verin:

    • "Botunuzun adı ne olsun?": Örn: "Forum Haberleri Bot"
    • "Kullanıcı adı ne olsun?": Örn: "forum_haberleri_bot" (mutlaka "_bot" ile bitmeli)
    3

    Bot Token'ı Kopyalayın

    BotFather size bir mesaj gönderecek. Bu mesajda Bot Token bulunur. Kopyalayın ve güvenli bir yerde saklayın.

    Bot Token: 123456789:ABCDefGHIjklMNOpqrsTUVwxyz
    4

    Bot'u Kanalınıza Admin Olarak Ekleyin

    Telegram'da:

    • Mesajlaşmaya gidin ve bot'u arayın
    • Bot'u açın
    • /start komutunu yazın
    • Kanalınızı açın
    • Kanal Ayarları → Yöneticiler → Bot'u ekleyin
    5

    Kanal ID'sini Bulun

    Bot'u kanalınıza ekledikten sonra:

    • Bot'a bir mesaj gönderin (örn: "test")
    • Tarayıcınızda şu URL'ye gidin:
    https://api.telegram.org/botTOKEN/getUpdates TOKEN yerine yukarıda aldığınız Bot Token'ı yazın. Dönen sonuçta "chat" → "id" değerini kopyalayın.
    6

    LiveSocial VB'ye Anahtarları Girin

    vBulletin Admin Paneli → LiveSocial VB → Ayarlar → Telegram bölümüne giderek anahtarları girin.

  • Bot Token
  • Kanal ID
  • ✅
    Tamamlandı!

    Tüm adımları tamamladıysanız, "Test Bağlantısı" butonuna tıklayarak test edin. Kanalınızda bir test mesajı alacaksınız.

    📌

    Pinterest API Kurulumu

    Pinterest panosunuza otomatik pin ekleyin

    💡
    Başlamadan Önce

    Aktif bir Pinterest hesabınız ve bir pano olması gerekir. Ayrıca geliştirici erişimi için başvuru yapmanız gerekebilir.

    1

    Pinterest Developer'a Kaydolun

    developers.pinterest.com adresine gidin ve Pinterest hesabınızla giriş yapın.

    2

    Uygulama Oluşturun

    Dashboard'da "My Apps" bölümüne gidin.

    • "Create App" butonuna tıklayın
    • Uygulama adı girin (örn: "LiveSocial VB")
    • Uygulama açıklaması yazın
    • "Create" butonuna tıklayın
    3

    App ID ve App Secret Alın

    Uygulamanızın ayarlarından App ID ve App Secret'ı kopyalayın.

    App ID: [Buraya App ID'niz yazılacak] App Secret: [Buraya App Secret'ınız yazılacak]
    4

    Redirect URI Ayarlayın

    Uygulamanızın ayarlarında "Redirect URIs" bölümüne eklenti tarafından sağlanan URL'i girin.

    💡

    Redirect URI'sini eklenti ayarlarında bulabilirsiniz.

    5

    Access Token Alın

    Pinterest Developer Dashboard'da "Access Token" bölümüne gidin ve token oluşturun.

    Access Token: [Buraya Access Token'ınız yazılacak]
    6

    LiveSocial VB'ye Anahtarları Girin

    vBulletin Admin Paneli → LiveSocial VB → Ayarlar → Pinterest bölümüne giderek anahtarları girin.

  • App ID
  • App Secret
  • Access Token
  • ⚠️
    Onay Süreci

    Pinterest, uygulamanızın onaylanması için başvuru yapmanızı isteyebilir. Başvuru formunu doldurarak onay isteyin.

    ▶️

    YouTube API Kurulumu

    YouTube kanalınıza otomatik video gönderin

    💡
    Başlamadan Önce

    Aktif bir YouTube kanalınız olması gerekir. Ayrıca Google Cloud Console'da proje oluşturmanız gerekecektir.

    1

    Google Cloud Console'a Giriş Yapın

    console.cloud.google.com adresine gidin ve Google hesabınızla oturum açın.

    2

    Yeni Proje Oluşturun

    Üst kısımda "Select a Project" açılır menüsüne tıklayın.

    • "New Project" butonuna tıklayın
    • Proje adı girin (örn: "LiveSocial VB")
    • "Create" butonuna tıklayın
    3

    YouTube Data API v3'ü Etkinleştirin

    Sol menüden "APIs & Services" → "Library" bölümüne gidin.

    • Arama kutusuna "YouTube Data API v3" yazın
    • Sonucu tıklayın
    • "Enable" butonuna tıklayın
    4

    OAuth 2.0 Credentials Oluşturun

    Sol menüden "APIs & Services" → "Credentials" bölümüne gidin.

    • "Create Credentials" butonuna tıklayın
    • "OAuth 2.0 Client ID" seçin
    • Uygulama türü olarak "Web application" seçin
    • Redirect URI'sini girin (eklenti tarafından sağlanır)
    • "Create" butonuna tıklayın
    5

    Client ID ve Client Secret Alın

    Oluşturulan credentials'ı tıklayarak Client ID ve Client Secret'ı kopyalayın.

    Client ID: [Buraya Client ID'niz yazılacak] Client Secret: [Buraya Client Secret'ınız yazılacak]
    6

    LiveSocial VB'ye Anahtarları Girin

    vBulletin Admin Paneli → LiveSocial VB → Ayarlar → YouTube bölümüne giderek anahtarları girin.

  • Client ID
  • Client Secret
  • ⚠️
    API Quota

    YouTube API, günde 10.000 quota kullanabilir. Aşırı kullanım durumunda sınırlandırılabilirsiniz.

    💬

    WhatsApp Business API Kurulumu

    WhatsApp Business hesabınıza otomatik mesaj gönderin

    ⚠️
    Önemli Bilgi

    WhatsApp Business API, diğer platformlardan daha karmaşık bir kurulum gerektirir. Onay süreci 1-2 hafta sürebilir.

    1

    Meta Business Account Oluşturun

    Meta Business Suite adresine gidin ve hesap oluşturun.

    2

    WhatsApp Business Uygulaması Ekleyin

    Business Suite'de "Apps" bölümüne giderek WhatsApp Business'ı ekleyin.

    3

    Telefon Numarası Doğrulayın

    WhatsApp Business hesabınız için bir telefon numarası doğrulayın. Bu numara mesaj göndermek için kullanılacaktır.

    💡

    Telefon numarası doğrulanırken SMS veya sesli arama yöntemi kullanabilirsiniz.

    4

    API Credentials Alın

    WhatsApp Business API ayarlarından aşağıdaki bilgileri kopyalayın:

    Phone Number ID: [Buraya Phone Number ID'niz yazılacak] Business Account ID: [Buraya Business Account ID'niz yazılacak] Access Token: [Buraya Access Token'ınız yazılacak]
    5

    LiveSocial VB'ye Anahtarları Girin

    vBulletin Admin Paneli → LiveSocial VB → Ayarlar → WhatsApp bölümüne giderek anahtarları girin.

  • Phone Number ID
  • Business Account ID
  • Access Token
  • ⚠️
    Onay Süreci

    WhatsApp, uygulamanızın onaylanması için başvuru yapmanızı isteyebilir. Bu süreç 1-2 hafta sürebilir.

    ⚙️

    vBulletin'de Kurulum

    Tüm API anahtarlarını vBulletin'de yapılandırın

    ✅
    Hazır mısınız?

    Tüm platformlar için API anahtarlarını aldıysanız, şimdi vBulletin'de kuruluma başlayabilirsiniz.

    1

    Eklentiyi İndirin ve Yükleyin

    Panel → İndir bölümünden LiveSocial VB eklentisini indirin.

    • ZIP dosyasını indirin
    • vBulletin sunucunuza FTP ile yükleyin
    • vBulletin Admin Paneli → Eklentiler → Eklenti Yöneticisi'nde yükleyin
    2

    Lisans Anahtarını Girin

    vBulletin Admin Paneli → LiveSocial VB → Lisans bölümüne gidin.

    • Satın alma e-postanızdan aldığınız lisans anahtarını girin
    • "Doğrula" butonuna tıklayın
    💡

    Lisans anahtarını bulamıyorsanız, destek ile iletişime geçin.

    3

    Platform Ayarlarını Yapılandırın

    vBulletin Admin Paneli → LiveSocial VB → Ayarlar bölümüne gidin.

    Her platform için:

    • Platform sekmesini açın
    • Yukarıda aldığınız API anahtarlarını girin
    • "Test Bağlantısı" butonuna tıklayarak bağlantıyı test edin
    • Başarılı mesajı aldıktan sonra "Kaydet" butonuna tıklayın
    ⚠️

    API anahtarlarını doğru girin. Yanlış anahtarlar paylaşımların başarısız olmasına neden olur.

    4

    Paylaşım Ayarlarını Yapılandırın

    vBulletin Admin Paneli → LiveSocial VB → Paylaşım Ayarları bölümüne gidin.

    • Hangi forumlardan paylaşılacak? Seçin (tüm forumlar veya belirli forumlar)
    • Hangi platformlara paylaşılacak? Seçin
    • Otomatik paylaşım etkinleştirilsin mi? Evet seçin
    • "Kaydet" butonuna tıklayın
    5

    Mesaj Şablonlarını Özelleştirin

    vBulletin Admin Paneli → LiveSocial VB → Şablonlar bölümüne gidin.

    Her platform için mesaj şablonu oluşturun:

    Kullanılabilir Değişkenler: {baslik} - Konunun başlığı {ozet} - Konunun özeti (ilk 200 karakter) {yazar} - Konuyu oluşturan kullanıcı adı {link} - Konunun tam linki {forum} - Konunun bulunduğu forum adı {tarih} - Konunun oluşturulma tarihi Örnek Şablon: 🆕 Yeni Konu: {baslik} 👤 Yazar: {yazar} 📝 {ozet}... 🔗 Oku: {link}
    💡

    Her platform için farklı şablonlar oluşturabilirsiniz. Örneğin, Twitter için daha kısa, Facebook için daha detaylı şablonlar.

    6

    Test Konusu Oluşturun

    Kurulumun başarılı olup olmadığını test etmek için:

    • Forumunuzda test kategorisinde yeni bir konu oluşturun
    • Sosyal medya hesaplarınızı kontrol edin
    • Konunun paylaşılıp paylaşılmadığını kontrol edin
    ✅

    Konunuz sosyal medyaya paylaşıldıysa, kurulum başarılı demektir!

    7

    Logları Kontrol Edin

    vBulletin Admin Paneli → LiveSocial VB → Loglar bölümüne gidin.

    • Gönderim geçmişini görüntüleyin
    • Başarılı ve başarısız gönderileri kontrol edin
    • Hata mesajlarını okuyun
    💡

    Sorun yaşıyorsanız, logları kontrol ederek sorunun kaynağını bulabilirsiniz.

    ✅
    Tamamlandı!

    Tüm adımları tamamladıysanız, LiveSocial VB artık forumunuzdaki yeni konuları otomatik olarak sosyal medyaya paylaşacaktır.

    Kurulum Tamamlandı mı?

    Tüm adımları tamamladıysanız, şimdi eklentiyi indirip vBulletin'e kurabilirsiniz.

    🧪

    Sorun Giderme

    Kurulum sırasında sorun yaşıyorsanız, bu bölümü okuyun

    Sık Karşılaşılan Sorunlar ve Çözümleri

    ❌ "API anahtarı geçersiz" hatası

    Bu hata, API anahtarının yanlış kopyalanması veya süresi dolması durumunda oluşur.

    ✓
    Çözüm:
    • API anahtarını yeniden kopyalayın ve yapıştırın
    • Boşluk veya fazladan karakter olmadığından emin olun
    • Gerekirse API anahtarını yeniden oluşturun
    • "Test Bağlantısı" butonuna tıklayarak tekrar test edin
    ❌ Konular sosyal medyaya paylaşılmıyor

    Bu hata, paylaşım ayarlarının doğru yapılandırılmaması durumunda oluşur.

    ✓
    Çözüm:
    • Paylaşım Ayarları'nda "Otomatik paylaşım" etkinleştirildiğini kontrol edin
    • Konunun bulunduğu forumun paylaşım listesinde olduğunu kontrol edin
    • Platform sekmesinin etkinleştirildiğini kontrol edin
    • Loglar bölümünde hata mesajını kontrol edin
    ❌ Görsel yüklenmedi

    Bazı platformlar görsel boyutu veya formatı konusunda sınırlamalar vardır.

    ✓
    Çözüm:
    • Görsel boyutunun platform gereksinimlerine uygun olduğunu kontrol edin
    • Görsel formatının desteklenen türde olduğunu kontrol edin (JPG, PNG)
    • Görsel dosya boyutunun çok büyük olmadığını kontrol edin
    • Sunucunun görsel yükleme izinlerine sahip olduğunu kontrol edin
    ❌ Telegram mesajı gelmedi

    Telegram kurulumunda en sık karşılaşılan sorun, kanal ID'sinin yanlış olmasıdır.

    ✓
    Çözüm:
    • Bot'un kanalda admin olarak eklendiğini kontrol edin
    • Kanal ID'sinin doğru olduğunu kontrol edin (negatif sayı olmalı)
    • Bot Token'ın doğru olduğunu kontrol edin
    • Kanalın gizli kanal olmadığını kontrol edin
    ❌ "Karakter sınırı aşıldı" hatası

    Her platform farklı karakter sınırlamalarına sahiptir.

    ✓
    Çözüm:
    • Mesaj şablonunu kısaltın
    • Özet uzunluğunu azaltın
    • Gereksiz bilgileri kaldırın
    • Platform karakter limitlerini kontrol edin
    ❌ Eklenti yüklenmedi

    vBulletin eklenti yüklemesi başarısız olabilir.

    ✓
    Çözüm:
    • ZIP dosyasının bozuk olmadığını kontrol edin
    • vBulletin sürümünün uyumlu olduğunu kontrol edin
    • Sunucu izinlerini kontrol edin (755 veya 777)
    • PHP bellek limitini artırmayı deneyin
    • Destek ile iletişime geçin
    ❓

    Sık Sorulan Sorular

    Kurulum hakkında merak ettiğiniz sorular

    S: Tüm platformları aynı anda kullanabilir miyim?

    C: Evet! LiveSocial VB, tüm platformları aynı anda destekler. Hangi platformları kullanmak istediğinizi seçebilirsiniz.

    S: API anahtarlarım güvenli mi?

    C: Evet, API anahtarları şifreli olarak veritabanında saklanır. Kimse tarafından görülemez.

    S: Paylaşımları iptal edebilir miyim?

    C: Evet, eklenti ayarlarından otomatik paylaşımı devre dışı bırakabilirsiniz. Daha önce paylaşılan konuları sosyal medyadan silmeniz gerekir.

    S: Belirli forumlardan paylaşım yapmayabilir miyim?

    C: Evet, Paylaşım Ayarları'nda hangi forumlardan paylaşım yapılacağını seçebilirsiniz.

    S: Paylaşım başarısız olursa ne olur?

    C: Başarısız paylaşımlar loglar bölümünde kaydedilir. Sorunu çözdükten sonra manuel olarak yeniden paylaşabilirsiniz.

    S: Kurulum sırasında sorun yaşarsam ne yapmalıyım?

    C: Destek bölümünden bize ulaşabilirsiniz. Ekibimiz size yardımcı olmaktan mutlu olacaktır.