Sosyal Medya Entegrasyonu Çalışmıyor

Yaygın Sosyal Medya Sorunları

M4T3 birden fazla platformdan bildirim destekler: Twitch, YouTube, Instagram, Twitter, Reddit ve RSS beslemeleri. Bu entegrasyonlar çalışmayı durdurunca, genellikle yapılandırma sorunları, API kısıtlamaları veya hizmet özel sorunlarından kaynaklanır.

Son Güncellemeler: M4T3, devre kesici, üstel geri çekilme ile hız sınırlama ve tüm sosyal platformlarda geliştirilmiş güvenilirlik dahil olmak üzere 2025 en iyi uygulamalarını uyguladı.

Desteklenen Platformlar

Yayın Platformları

• Twitch - Yayıncılar canlı yayına geçtiğinde canlı yayın bildirimleri (800/dk hız sınırı)
• YouTube - Kanallardan yeni video yükleme bildirimleri (50/saat hız sınırı)

Sosyal Ağlar

• Instagram - Hesaplardan yeni gönderi bildirimleri (30/dk hız sınırı, doğrulama ile)
• Twitter - Hesaplardan yeni tweet bildirimleri (15/15dk hız sınırı)
• Reddit - Subreddit'lerden yeni gönderiler (60/dk hız sınırı)

Özel İçerik

• RSS Beslemeleri - Özel RSS/Atom besleme bildirimleri (120/dk hız sınırı)

Sosyal Medya Entegrasyonu Kurulumu

Yöntem 1: Web Panelini Kullanma

1. M4T3 Panelinize gidin (https://m4t3.com/dashboard)
2. Sunucunuzu seçin
3. Lonca Ayarları > Sosyal Medya'ya gidin
4. Yapılandırmak istediğiniz platformu seçin
5. Gerekli bilgileri girin:
   • Twitch: Kullanıcı adı veya kanal adı (giriş adını kullanın, görünen ad değil)
   • YouTube: Kanal kimliği (UC...), kullanıcı adı veya tanıtıcı (@kullanıcıadı)
   • Instagram: Kullanıcı adı (sadece genel hesaplar, doğruluk için onaylanmış)
   • Twitter: Kullanıcı adı (@ olmadan)
   • Reddit: Subreddit adı (r/ olmadan)
   • RSS: Besleme URL'si (geçerli XML olmalı)
6. Bildirimler için Discord kanalını seçin
7. Bildirim mesajını özelleştirin (isteğe bağlı)
8. "Yapılandırmayı Kaydet" düğmesine tıklayın
9. Entegrasyonu test edin

Yöntem 2: Bot Komutlarını Kullanma

1. Discord'da /setup social setup komutunu kullanın
2. Yapılandırmak istediğiniz platformu seçin
3. Etkileşimli istemleri takip edin:
   • Kullanıcı adı/kanal bilgilerini girin
   • Bildirim kanalını seçin
   • Özel mesaj ayarlayın (isteğe bağlı)
4. Yapılandırmayı kaydedin
5. Entegrasyonu test edin

Yaygın Sorunlar ve Çözümler

Bildirim Görünmüyor

Yapılandırmayı Kontrol Edin

1. Kullanıcı adı/kimliklerini doğrulayın: Tam yazım ve format sağlayın
2. Kanal izinlerini test edin: Botun Mesaj Gönderme izni gerekir
3. Bildirim kanalını kontrol edin: Kanalın hala var olduğunu doğrulayın
4. Panel ayarlarını gözden geçirin: Entegrasyonun etkin olduğunu onaylayın
5. Senkronizasyonu bekleyin: Değişikliklerin yayılması 5 dakika kadar sürebilir

Platform Özel Sorunları

Twitch Sorunları (Yakın Zamanda Düzeltildi):

• Kullanıcı adı vs Görünen ad: KRİTİK - Gerçek Twitch giriş kullanıcı adını (user_login) kullanın, görünen adı (user_name) değil. Bu yakın zamanda düzeltilen büyük bir hataydi.
• Büyük/küçük harf duyarlılığı: En iyi sonuçlar için küçük harf kullanın
• Yayın gecikmeleri: Bildirimler canlı yayına geçtikten 1-2 dakika sonra görünür
• API hız sınırları: Devre kesici koruması ile dakikada 800 istek
• Çift bildirimler: Düzeltildi - şimdi sadece shard 0 bildirimleri işler

YouTube Sorunları (Yakın Zamanda Düzeltildi):

• Kanal kimliği formatı: Modern kanallar "UC" ile başlayan Kanal Kimliklerini kullanır
• Tanıtıcı çözünürlüğü: @kullanıcıadı tanıtıcıları artık arama API'si aracılığıyla doğru şekilde çözülüyor
• Eski kullanıcı adları: Eski YouTube kullanıcı adları nadiren çalışır, Kanal Kimliği kullanın
• Yükleme gecikmeleri: YouTube API yeni videolar için 5-15 dakika gecikme yaşar
• Özel/listelenmemiş videolar: Sadece genel videolar bildirimleri tetikler
• Kanal algılama: Artık kanal tanımlayıcı türünü doğru algılar (UC vs @ vs eski)

Instagram Sorunları (Yakın Zamanda Düzeltildi):

• Kullanıcı adı doğrulaması: YENİ - M4T3 artık döndürülen gönderilerin yapılandırılan kullanıcı adıyla eşleştiğini doğrular
• Hesap gizliliği: Sadece genel hesaplar izlenebilir
• Yanlış bildirimler: Yanlış kullanıcı gönderilerinin gönderildiği sorun düzeltildi
• RSS besleme doğrulaması: Artık RSS öğelerinin yapılandırılan kullanıcı adıyla eşleştiğini doğrular
• İçerik kısıtlamaları: Bazı gönderi türleri bildirim tetiklemeyebilir
• Hız sınırlaması: Üstel geri çekilme ile dakikada 30 istek

Çift Bildirimler (Düzeltildi)

Son Düzeltme: M4T3 artık sosyal entegrasyonu sadece shard 0'da çalıştırıyor, birden fazla shard'ın aynı içeriği işlemesi durumunda oluşan çift bildirimleri ortadan kaldırıyor.

1. Çoklu yapılandırmaları kontrol edin: Aynı hesabın birden fazla kez yapılandırılmadığından emin olun
2. Bildirim kanallarını doğrulayın: Farklı yapılandırmaların farklı kanallar kullandığından emin olun
3. Webhook ayarlarını gözden geçirin: Birden fazla webhook çift oluşturabilir
4. Shard işleme: Artık otomatik olarak yönetiliyor (sadece shard 0)

Gecikmeli Bildirimler

1. Beklenen gecikmeler: Çoğu platformun 2-15 dakika gecikmeleri vardır
2. API hız sınırları: Devre kesiciler kademeli hataları önler
3. Önbellek yenileme: M4T3 her 5-15 dakikada bir güncellemeleri kontrol eder
4. Platform durumu: Sosyal platformun sorun yaşayıp yaşamadığını kontrol edin
5. Devre kesici: Çok fazla hata oluşursa kontrolleri geçici olarak durdurabilir

Gelişmiş Sorun Giderme

Yeni Güvenilirlik Özellikleri

• Devre Kesiciler: KAPALI/AÇIK/YARI_AÇIK durumlarla kademeli hataları önler
• Hız Sınırlaması: Üstel geri çekilme API tükenmesini önler
• Birleşik Metrikler: /admin dashboard komutu aracılığıyla kapsamlı izleme
• Tekrar Giderme: Döngü tabanlı önbellekleme çift API çağrılarını önler

Tekil Platformları Test Etme

1. Test komutlarını kullanın: Belirli entegrasyonları doğrulamak için /setup social list
2. API yanıtlarını kontrol edin: Bot günlüklerinde hata mesajları arayın
3. API anahtarlarını doğrulayın: M4T3 API erişimini otomatik yönetir
4. Hız sınırlarını izleyin: Devre kesiciler hız sınırı yönetimini ele alır
5. Metrikleri kontrol edin: Başarı/hata oranlarını görmek için panoyu kullanın

Yapılandırma Doğrulaması

1. Kullanıcı adlarını çift kontrol edin: Yazım hatalarını önlemek için kopyala-yapıştır
2. Platform URL'lerini doğrulayın: Hesap/kanalın var olduğunu ve genel olduğunu sağlayın
3. Bildirim kanalını test edin: İzinleri doğrulamak için test mesajı gönderin
4. Bot rollerini gözden geçirin: M4T3'ün gerekli Discord izinlerine sahip olduğundan emin olun
5. Yayılmayı bekleyin: Değişikliklerin senkronize olması için 5 dakika verin

Ne Zaman Destek ile İletişime Geçilir

• Son güncellemelerden sonra tüm platformlar için bildirimler çalışmayı durdurdu
• Devre kesici uzun süreler AÇIK kalıyor
• Yapılandırma düzeltmelerinden sonra hata mesajları devam ediyor
• Birden fazla sunucuyu etkileyen platform özel sorunlar
• Şüpheli API veya hizmet kesintileri

En İyi Uygulamalar

Yapılandırma Yönetimi

• Kesin kullanıcı adları kullanın: Instagram ve Twitch için özellikle önemli
• Düzenli testler: Entegrasyonların çalıştığını periyodik olarak doğrulayın
• Değişiklikleri izleyin: Platform kullanıcı adı/URL değişikliklerini takip edin
• Ayarları yedekleyin: Yapılandırmalarınızı belgeleyin
• Doğrulamayı kontrol edin: Kullanıcı adlarının doğru doğrulandığından emin olun

Bildirim Optimizasyonu

• Özel kanallar: Farklı platformlar için ayrı kanallar kullanın
• Özel mesajlar: Topluluğunuz için bildirimleri kişiselleştirin
• Rol bahsetmeleri: Önemli bildirimler için rol pinglerini kullanın
• Embed özelleştirmesi: Embed renklerini ve biçimlendirmesini yapılandırın
• Hız sınırı farkındalığı: Platform sınırlarını aşmayın

Performans Değerlendirmeleri

• Entegrasyonları sınırlayın: Devre kesiciler yükü otomatik yönetir
• Yapılandırmaları kademeli yapın: Dahili hız sınırlaması zamanlamayı ele alır
• Metrikleri izleyin: Ayrıntılı istatistikler için M4T3 panosunu kontrol edin
• Düzenli bakım: Kullanılmayan entegrasyonları gözden geçirin ve temizleyin
• Güvenilirlik izleme: Panodaki devre kesici durumunu izleyin