🔌 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
Aktif bir X hesabınız ve geliştirici erişiminiz olması gerekir. Geliştirici hesabı başvurusu 5-10 dakika sürer.
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.
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
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ı not edin veya indir. Daha sonra ihtiyaç duyacaksınız.
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]
İ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.
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.
Tüm adımları tamamladıysanız, "Test Bağlantısı" butonuna tıklayarak bağlantıyı test edin.
Facebook API Kurulumu
Facebook sayfanıza otomatik paylaşım yapın
Bir Facebook Sayfasına sahip olmanız ve o sayfanın yöneticisi olmanız gerekir. Kişisel hesap yeterli değildir.
Facebook Developer'a Kaydolun
developers.facebook.com adresine gidin ve Facebook hesabınızla giriş yapın.
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
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
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]
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.
LiveSocial VB'ye Anahtarları Girin
vBulletin Admin Paneli → LiveSocial VB → Ayarlar → Facebook bölümüne giderek anahtarları girin.
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
Instagram hesabınızı "Business" hesabına dönüştürmeniz gerekir. Kişisel hesap yeterli değildir.
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
Facebook Developer'da Instagram Graph API Ekleyin
developers.facebook.com adresinde uygulamanıza "Instagram Graph API" ürününü ekleyin.
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]
LiveSocial VB'ye Anahtarları Girin
vBulletin Admin Paneli → LiveSocial VB → Ayarlar → Instagram bölümüne giderek anahtarları girin.
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
Telegram, diğer platformlardan farklı olarak onay süreci gerektirmez. 5 dakikada kurabilirsiniz.
Telegram'da BotFather ile İletişime Geçin
Telegram uygulamasını açın ve aşağıdaki adımları takip edin:
- Arama kutusuna
@BotFatheryazın - BotFather'ı açın
/newbotkomutunu yazın ve gönderin
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)
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
Bot'u Kanalınıza Admin Olarak Ekleyin
Telegram'da:
- Mesajlaşmaya gidin ve bot'u arayın
- Bot'u açın
/startkomutunu yazın- Kanalınızı açın
- Kanal Ayarları → Yöneticiler → Bot'u ekleyin
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.
LiveSocial VB'ye Anahtarları Girin
vBulletin Admin Paneli → LiveSocial VB → Ayarlar → Telegram bölümüne giderek anahtarları girin.
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
Aktif bir Pinterest hesabınız ve bir pano olması gerekir. Ayrıca geliştirici erişimi için başvuru yapmanız gerekebilir.
Pinterest Developer'a Kaydolun
developers.pinterest.com adresine gidin ve Pinterest hesabınızla giriş yapın.
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
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]
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.
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]
LiveSocial VB'ye Anahtarları Girin
vBulletin Admin Paneli → LiveSocial VB → Ayarlar → Pinterest bölümüne giderek anahtarları girin.
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
Aktif bir YouTube kanalınız olması gerekir. Ayrıca Google Cloud Console'da proje oluşturmanız gerekecektir.
Google Cloud Console'a Giriş Yapın
console.cloud.google.com adresine gidin ve Google hesabınızla oturum açın.
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
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
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
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]
LiveSocial VB'ye Anahtarları Girin
vBulletin Admin Paneli → LiveSocial VB → Ayarlar → YouTube bölümüne giderek anahtarları girin.
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
WhatsApp Business API, diğer platformlardan daha karmaşık bir kurulum gerektirir. Onay süreci 1-2 hafta sürebilir.
Meta Business Account Oluşturun
Meta Business Suite adresine gidin ve hesap oluşturun.
WhatsApp Business Uygulaması Ekleyin
Business Suite'de "Apps" bölümüne giderek WhatsApp Business'ı ekleyin.
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.
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]
LiveSocial VB'ye Anahtarları Girin
vBulletin Admin Paneli → LiveSocial VB → Ayarlar → WhatsApp bölümüne giderek anahtarları girin.
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
Tüm platformlar için API anahtarlarını aldıysanız, şimdi vBulletin'de kuruluma başlayabilirsiniz.
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
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.
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.
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
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.
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!
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.
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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.