Social Media Integration Funktioniert Nicht

Häufige Social Media Probleme

M4T3 unterstützt Benachrichtigungen von mehreren Plattformen: Twitch, YouTube, Instagram, Twitter, Reddit und RSS-Feeds. Wenn diese Integrationen aufhören zu funktionieren, liegt es meist an Konfigurationsproblemen, API-Beschränkungen oder Service-spezifischen Problemen.

Aktuelle Updates: M4T3 hat 2025 Best Practices implementiert, einschließlich Circuit Breaker, Rate Limiting mit exponentiellem Backoff und verbesserter Zuverlässigkeit auf allen sozialen Plattformen.

Unterstützte Plattformen

Streaming-Plattformen

• Twitch - Live-Stream-Benachrichtigungen wenn Streamer live gehen (800/min Rate Limit)
• YouTube - Neue Video-Upload-Benachrichtigungen von Kanälen (50/Stunde Rate Limit)

Soziale Netzwerke

• Instagram - Neue Post-Benachrichtigungen von Konten (30/min Rate Limit mit Validierung)
• Twitter - Neue Tweet-Benachrichtigungen von Konten (15/15min Rate Limit)
• Reddit - Neue Posts von Subreddits (60/min Rate Limit)

Benutzerdefinierte Inhalte

• RSS-Feeds - Benutzerdefinierte RSS/Atom-Feed-Benachrichtigungen (120/min Rate Limit)

Social Media Integration Einrichten

Methode 1: Web-Dashboard Verwenden

1. Gehen Sie zu Ihrem M4T3-Dashboard (https://m4t3.com/dashboard)
2. Wählen Sie Ihren Server
3. Navigieren Sie zu Gilden-Einstellungen > Social Media
4. Wählen Sie die Plattform, die Sie konfigurieren möchten
5. Geben Sie die erforderlichen Informationen ein:
   • Twitch: Benutzername oder Kanalname (Login-Name verwenden, nicht Anzeigename)
   • YouTube: Kanal-ID (UC...), Benutzername oder Handle (@benutzername)
   • Instagram: Benutzername (nur öffentliche Konten, auf Genauigkeit validiert)
   • Twitter: Benutzername (ohne @)
   • Reddit: Subreddit-Name (ohne r/)
   • RSS: Feed-URL (muss gültiges XML sein)
6. Wählen Sie den Discord-Kanal für Benachrichtigungen
7. Passen Sie die Benachrichtigungsnachricht an (optional)
8. Klicken Sie auf "Konfiguration Speichern"
9. Testen Sie die Integration

Methode 2: Bot-Befehle Verwenden

1. Verwenden Sie den Befehl /setup social setup in Discord
2. Wählen Sie die Plattform, die Sie konfigurieren möchten
3. Folgen Sie den interaktiven Eingabeaufforderungen:
   • Benutzername/Kanal-Informationen eingeben
   • Benachrichtigungskanal auswählen
   • Benutzerdefinierte Nachricht festlegen (optional)
4. Konfiguration speichern
5. Integration testen

Häufige Probleme und Lösungen

Keine Benachrichtigungen Erscheinen

Konfiguration Überprüfen

1. Benutzernamen/IDs überprüfen: Exakte Schreibweise und Format sicherstellen
2. Kanal-Berechtigungen testen: Bot benötigt Nachrichten-Senden-Berechtigung
3. Benachrichtigungskanal prüfen: Überprüfen, ob Kanal noch existiert
4. Dashboard-Einstellungen überprüfen: Bestätigen, dass Integration aktiviert ist
5. Auf Synchronisation warten: Änderungen können bis zu 5 Minuten dauern

Plattform-Spezifische Probleme

Twitch-Probleme (Kürzlich Behoben):

• Benutzername vs Anzeigename: KRITISCH - Den tatsächlichen Twitch Login-Benutzernamen (user_login) verwenden, nicht Anzeigename (user_name). Dies war ein großer Bug, der kürzlich behoben wurde.
• Groß-/Kleinschreibung: Kleinbuchstaben für beste Ergebnisse verwenden
• Stream-Verzögerungen: Benachrichtigungen erscheinen 1-2 Minuten nach Live-Gang
• API Rate Limits: 800 Anfragen pro Minute mit Circuit Breaker Schutz
• Doppelte Benachrichtigungen: Behoben - nur noch Shard 0 verarbeitet Benachrichtigungen

YouTube-Probleme (Kürzlich Behoben):

• Kanal-ID-Format: Moderne Kanäle verwenden Kanal-IDs beginnend mit "UC"
• Handle-Auflösung: @benutzername Handles werden jetzt korrekt über Search API aufgelöst
• Legacy-Benutzernamen: Alte YouTube-Benutzernamen funktionieren selten, Kanal-ID verwenden
• Upload-Verzögerungen: YouTube API hat 5-15 Minuten Verzögerungen für neue Videos
• Private/nicht gelistete Videos: Nur öffentliche Videos lösen Benachrichtigungen aus
• Kanal-Erkennung: Erkennt jetzt korrekt Kanal-Identifikator-Typ (UC vs @ vs Legacy)

Instagram-Probleme (Kürzlich Behoben):

• Benutzername-Validierung: NEU - M4T3 validiert jetzt, dass zurückgegebene Posts mit konfiguriertem Benutzernamen übereinstimmen
• Konto-Privatsphäre: Nur öffentliche Konten können überwacht werden
• Falsche Benachrichtigungen: Problem behoben, wo falsche Benutzerposts gesendet wurden
• RSS-Feed-Validierung: Validiert jetzt, dass RSS-Elemente mit konfiguriertem Benutzernamen übereinstimmen
• Inhaltsbeschränkungen: Einige Post-Typen lösen möglicherweise keine Benachrichtigungen aus
• Rate Limiting: 30 Anfragen pro Minute mit exponentiellem Backoff

Doppelte Benachrichtigungen (Behoben)

Kürzliche Behebung: M4T3 führt Social Integration jetzt nur auf Shard 0 aus, was doppelte Benachrichtigungen eliminiert, die auftraten, wenn mehrere Shards denselben Inhalt verarbeiteten.

1. Mehrere Konfigurationen prüfen: Sicherstellen, dass dasselbe Konto nicht mehrfach konfiguriert ist
2. Benachrichtigungskanäle verifizieren: Sicherstellen, dass verschiedene Konfigurationen verschiedene Kanäle verwenden
3. Webhook-Einstellungen überprüfen: Mehrere Webhooks können Duplikate verursachen
4. Shard-Verarbeitung: Jetzt automatisch gehandhabt (nur Shard 0)

Verzögerte Benachrichtigungen

1. Erwartete Verzögerungen: Die meisten Plattformen haben 2-15 Minuten Verzögerungen
2. API Rate Limits: Circuit Breaker verhindern Kaskadenfehler
3. Cache-Aktualisierung: M4T3 prüft alle 5-15 Minuten auf Updates
4. Plattform-Status: Prüfen, ob die soziale Plattform Probleme hat
5. Circuit Breaker: Kann temporär Prüfungen pausieren bei zu vielen Fehlern

Erweiterte Fehlerbehebung

Neue Zuverlässigkeits-Features

• Circuit Breaker: Verhindern Kaskadenfehler mit GESCHLOSSEN/OFFEN/HALB_OFFEN Zuständen
• Rate Limiting: Exponentieller Backoff verhindert API-Erschöpfung
• Einheitliche Metriken: Umfassendes Monitoring via /admin dashboard Befehl
• Deduplizierung: Zyklusbasiertes Caching verhindert doppelte API-Aufrufe

Einzelne Plattformen Testen

1. Test-Befehle verwenden: /setup social list um spezifische Integrationen zu verifizieren
2. API-Antworten prüfen: Nach Fehlermeldungen in Bot-Logs suchen
3. API-Schlüssel verifizieren: M4T3 verwaltet API-Zugang automatisch
4. Rate Limits überwachen: Circuit Breaker handhaben Rate-Limit-Management
5. Metriken prüfen: Dashboard verwenden um Erfolg/Fehler-Raten zu sehen

Konfigurations-Validierung

1. Benutzernamen doppelt prüfen: Kopieren-Einfügen um Tippfehler zu vermeiden
2. Plattform-URLs verifizieren: Sicherstellen, dass Konto/Kanal existiert und öffentlich ist
3. Benachrichtigungskanal testen: Test-Nachricht senden um Berechtigungen zu verifizieren
4. Bot-Rollen überprüfen: Sicherstellen, dass M4T3 notwendige Discord-Berechtigungen hat
5. Auf Verbreitung warten: 5 Minuten für Änderungen zur Synchronisation erlauben

Wann Support Kontaktieren

• Benachrichtigungen hörten für alle Plattformen nach aktuellen Updates auf
• Circuit Breaker bleibt für längere Zeiträume OFFEN
• Fehlermeldungen bestehen nach Konfigurationsfixes
• Plattform-spezifische Probleme betreffen mehrere Server
• Verdächtige API- oder Service-Ausfälle

Best Practices

Konfigurations-Management

• Exakte Benutzernamen verwenden: Besonders wichtig für Instagram und Twitch
• Regelmäßige Tests: Periodisch verifizieren, dass Integrationen funktionieren
• Änderungen überwachen: Auf Plattform-Benutzername/URL-Änderungen achten
• Einstellungen sichern: Konfigurationen dokumentieren
• Validierung prüfen: Sicherstellen, dass Benutzernamen korrekt validiert sind

Benachrichtigungs-Optimierung

• Dedizierte Kanäle: Separate Kanäle für verschiedene Plattformen verwenden
• Benutzerdefinierte Nachrichten: Benachrichtigungen für Community personalisieren
• Rollen-Erwähnungen: Rollen-Pings für wichtige Benachrichtigungen verwenden
• Embed-Anpassung: Embed-Farben und -Formatierung konfigurieren
• Rate-Limit-Bewusstsein: Plattform-Limits nicht überschreiten

Performance-Überlegungen

• Integrationen begrenzen: Circuit Breaker verwalten Last automatisch
• Konfigurationen staffeln: Eingebautes Rate Limiting handhabt Timing
• Metriken überwachen: M4T3 Dashboard für detaillierte Statistiken prüfen
• Regelmäßige Wartung: Ungenutzte Integrationen überprüfen und aufräumen
• Zuverlässigkeits-Monitoring: Circuit Breaker Status im Dashboard beobachten