L'Intégration des Médias Sociaux ne Fonctionne Pas

Problèmes Courants des Médias Sociaux

M4T3 prend en charge les notifications de plusieurs plateformes : Twitch, YouTube, Instagram, Twitter, Reddit, et flux RSS. Lorsque ces intégrations cessent de fonctionner, c'est généralement dû à des problèmes de configuration, des limitations d'API, ou des problèmes spécifiques au service.

Mises à Jour Récentes: M4T3 a implémenté les meilleures pratiques 2025 incluant les disjoncteurs, la limitation de débit avec backoff exponentiel, et une fiabilité améliorée sur toutes les plateformes sociales.

Plateformes Prises en Charge

Plateformes de Streaming

• Twitch - Notifications de stream en direct quand les streameurs sont en ligne (800/min limite de débit)
• YouTube - Notifications de nouvelles vidéos téléchargées depuis les chaînes (50/heure limite de débit)

Réseaux Sociaux

• Instagram - Notifications de nouveaux posts depuis les comptes (30/min limite de débit avec validation)
• Twitter - Notifications de nouveaux tweets depuis les comptes (15/15min limite de débit)
• Reddit - Nouveaux posts depuis les subreddits (60/min limite de débit)

Contenu Personnalisé

• Flux RSS - Notifications de flux RSS/Atom personnalisés (120/min limite de débit)

Configuration de l'Intégration des Médias Sociaux

Méthode 1: Utiliser le Tableau de Bord Web

1. Allez à votre Tableau de Bord M4T3 (https://m4t3.com/dashboard)
2. Sélectionnez votre serveur
3. Naviguez vers Paramètres de Guilde > Médias Sociaux
4. Choisissez la plateforme à configurer
5. Entrez les informations requises:
   • Twitch: Nom d'utilisateur ou nom de chaîne (utilisez le nom de connexion, pas le nom d'affichage)
   • YouTube: ID de chaîne (UC...), nom d'utilisateur, ou handle (@nom)
   • Instagram: Nom d'utilisateur (comptes publics seulement, validé pour la précision)
   • Twitter: Nom d'utilisateur (sans @)
   • Reddit: Nom du subreddit (sans r/)
   • RSS: URL du flux (doit être XML valide)
6. Sélectionnez le canal Discord pour les notifications
7. Personnalisez le message de notification (optionnel)
8. Cliquez sur "Sauvegarder la Configuration"
9. Testez l'intégration

Méthode 2: Utiliser les Commandes du Bot

1. Utilisez la commande /setup social setup dans Discord
2. Sélectionnez la plateforme à configurer
3. Suivez les invites interactives pour :
   • Entrer les informations de nom d'utilisateur/canal
   • Choisir le canal de notification
   • Définir un message personnalisé (optionnel)
4. Sauvegarder la configuration
5. Tester l'intégration

Problèmes Courants et Solutions

Aucune Notification N'Apparaît

Vérifier la Configuration

1. Vérifier les noms d'utilisateur/IDs: Assurer l'orthographe et le format exacts
2. Tester les permissions du canal: Le bot a besoin de la permission Envoyer des Messages
3. Vérifier le canal de notification: Vérifier que le canal existe toujours
4. Examiner les paramètres du tableau de bord: Confirmer que l'intégration est activée
5. Attendre la synchronisation: Les changements peuvent prendre jusqu'à 5 minutes pour se propager

Problèmes Spécifiques aux Plateformes

Problèmes Twitch (Récemment Corrigés):

• Nom d'utilisateur vs Nom d'affichage: CRITIQUE - Utiliser le vrai nom d'utilisateur de connexion Twitch (user_login), pas le nom d'affichage (user_name). C'était un bug majeur récemment corrigé.
• Sensibilité à la casse: Utiliser des minuscules pour de meilleurs résultats
• Délais de stream: Les notifications apparaissent 1-2 minutes après le passage en direct
• Limites de débit API: 800 requêtes par minute avec protection par disjoncteur
• Notifications en double: Corrigé - maintenant seul le shard 0 traite les notifications

Problèmes YouTube (Récemment Corrigés):

• Format ID de chaîne: Les chaînes modernes utilisent des IDs de chaîne commençant par "UC"
• Résolution de handle: Les handles @nom d'utilisateur sont maintenant correctement résolus via l'API de recherche
• Noms d'utilisateur hérités: Les anciens noms d'utilisateur YouTube fonctionnent rarement, utilisez l'ID de chaîne
• Délais de téléchargement: L'API YouTube a des délais de 5-15 minutes pour les nouvelles vidéos
• Vidéos privées/non listées: Seules les vidéos publiques déclenchent des notifications
• Détection de chaîne: Détecte maintenant correctement le type d'identifiant de chaîne (UC vs @ vs hérité)

Problèmes Instagram (Récemment Corrigés):

• Validation du nom d'utilisateur: NOUVEAU - M4T3 valide maintenant que les posts retournés correspondent au nom d'utilisateur configuré
• Confidentialité du compte: Seuls les comptes publics peuvent être surveillés
• Fausses notifications: Problème corrigé où des posts de mauvais utilisateurs étaient envoyés
• Validation du flux RSS: Valide maintenant que les éléments RSS correspondent au nom d'utilisateur configuré
• Restrictions de contenu: Certains types de posts peuvent ne pas déclencher de notifications
• Limitation de débit: 30 requêtes par minute avec backoff exponentiel

Notifications en Double (Corrigé)

Correction Récente: M4T3 exécute maintenant l'intégration sociale uniquement sur le shard 0, éliminant les notifications en double qui se produisaient quand plusieurs shards traitaient le même contenu.

1. Vérifier les configurations multiples: S'assurer que le même compte n'est pas configuré plusieurs fois
2. Vérifier les canaux de notification: S'assurer que différentes configurations utilisent différents canaux
3. Réviser les paramètres de webhook: Plusieurs webhooks peuvent causer des doublons
4. Traitement par shard: Maintenant géré automatiquement (shard 0 uniquement)

Notifications Retardées

1. Délais attendus: La plupart des plateformes ont des délais de 2-15 minutes
2. Limites de débit API: Les disjoncteurs préviennent les échecs en cascade
3. Actualisation du cache: M4T3 vérifie les mises à jour toutes les 5-15 minutes
4. Statut de la plateforme: Vérifier si la plateforme sociale rencontre des problèmes
5. Disjoncteur: Peut temporairement suspendre les vérifications si trop d'échecs se produisent

Dépannage Avancé

Nouvelles Fonctionnalités de Fiabilité

• Disjoncteurs: Préviennent les échecs en cascade avec les états FERMÉ/OUVERT/SEMI-OUVERT
• Limitation de Débit: Le backoff exponentiel prévient l'épuisement API
• Métriques Unifiées: Surveillance complète via la commande /admin dashboard
• Déduplication: La mise en cache basée sur les cycles prévient les appels API en double

Tester les Plateformes Individuelles

1. Utiliser les commandes de test: /setup social list pour vérifier des intégrations spécifiques
2. Vérifier les réponses API: Rechercher les messages d'erreur dans les logs du bot
3. Vérifier les clés API: M4T3 gère automatiquement l'accès API
4. Surveiller les limites de débit: Les disjoncteurs gèrent la gestion des limites de débit
5. Vérifier les métriques: Utiliser le tableau de bord pour voir les taux de succès/échec

Validation de Configuration

1. Vérifier deux fois les noms d'utilisateur: Copier-coller pour éviter les fautes de frappe
2. Vérifier les URLs de plateforme: S'assurer que le compte/chaîne existe et est public
3. Tester le canal de notification: Envoyer un message de test pour vérifier les permissions
4. Réviser les rôles du bot: S'assurer que M4T3 a les permissions Discord nécessaires
5. Attendre la propagation: Permettre 5 minutes pour que les changements se synchronisent

Quand Contacter le Support

• Les notifications ont cessé de fonctionner pour toutes les plateformes après les mises à jour récentes
• Le disjoncteur reste OUVERT pendant de longues périodes
• Les messages d'erreur persistent après les corrections de configuration
• Problèmes spécifiques à la plateforme affectant plusieurs serveurs
• Pannes API ou de service suspectées

Meilleures Pratiques

Gestion de Configuration

• Utiliser des noms d'utilisateur exacts: Particulièrement important pour Instagram et Twitch
• Tests réguliers: Vérifier périodiquement que les intégrations fonctionnent
• Surveiller les changements: Surveiller les changements de nom d'utilisateur/URL de plateforme
• Sauvegarder les paramètres: Documenter vos configurations
• Vérifier la validation: S'assurer que les noms d'utilisateur sont correctement validés

Optimisation des Notifications

• Canaux dédiés: Utiliser des canaux séparés pour différentes plateformes
• Messages personnalisés: Personnaliser les notifications pour votre communauté
• Mentions de rôle: Utiliser les pings de rôle pour les notifications importantes
• Personnalisation d'embed: Configurer les couleurs et le formatage d'embed
• Conscience des limites de débit: Ne pas dépasser les limites de plateforme

Considérations de Performance

• Limiter les intégrations: Les disjoncteurs gèrent automatiquement la charge
• Échelonner les configurations: La limitation de débit intégrée gère le timing
• Surveiller les métriques: Vérifier le tableau de bord M4T3 pour des statistiques détaillées
• Maintenance régulière: Réviser et nettoyer les intégrations inutilisées
• Surveillance de fiabilité: Surveiller le statut du disjoncteur dans le tableau de bord