La Integración de Redes Sociales No Funciona

Problemas Comunes de Redes Sociales

M4T3 soporta notificaciones de múltiples plataformas: Twitch, YouTube, Instagram, Twitter, Reddit, y feeds RSS. Cuando estas integraciones dejan de funcionar, usualmente se debe a problemas de configuración, limitaciones de API, o problemas específicos del servicio.

Actualizaciones Recientes: M4T3 ha implementado mejores prácticas de 2025 incluyendo interruptores de circuito, limitación de velocidad con backoff exponencial, y confiabilidad mejorada en todas las plataformas sociales.

Plataformas Soportadas

Plataformas de Streaming

• Twitch - Notificaciones de transmisión en vivo cuando los streamers se ponen en línea (800/min límite de velocidad)
• YouTube - Notificaciones de nuevos videos subidos desde canales (50/hora límite de velocidad)

Redes Sociales

• Instagram - Notificaciones de nuevas publicaciones desde cuentas (30/min límite de velocidad con validación)
• Twitter - Notificaciones de nuevos tweets desde cuentas (15/15min límite de velocidad)
• Reddit - Nuevas publicaciones de subreddits (60/min límite de velocidad)

Contenido Personalizado

• Feeds RSS - Notificaciones de feeds RSS/Atom personalizados (120/min límite de velocidad)

Configurar Integración de Redes Sociales

Método 1: Usando el Panel Web

1. Ve a tu Panel M4T3 (https://m4t3.com/dashboard)
2. Selecciona tu servidor
3. Navega a Configuraciones de Gremio > Redes Sociales
4. Elige la plataforma que quieres configurar
5. Ingresa la información requerida:
   • Twitch: Nombre de usuario o nombre del canal (usa nombre de login, no nombre de visualización)
   • YouTube: ID del canal (UC...), nombre de usuario, o handle (@usuario)
   • Instagram: Nombre de usuario (solo cuentas públicas, validado para precisión)
   • Twitter: Nombre de usuario (sin @)
   • Reddit: Nombre del subreddit (sin r/)
   • RSS: URL del feed (debe ser XML válido)
6. Selecciona el canal de Discord para notificaciones
7. Personaliza el mensaje de notificación (opcional)
8. Haz clic en "Guardar Configuración"
9. Prueba la integración

Método 2: Usando Comandos del Bot

1. Usa el comando /setup social setup en Discord
2. Selecciona la plataforma que quieres configurar
3. Sigue las indicaciones interactivas para:
   • Ingresar información de usuario/canal
   • Elegir canal de notificaciones
   • Configurar mensaje personalizado (opcional)
4. Guardar la configuración
5. Probar la integración

Problemas Comunes y Soluciones

No Aparecen Notificaciones

Revisar Configuración

1. Verificar nombres de usuario/IDs: Asegurar ortografía y formato exactos
2. Probar permisos del canal: El bot necesita permiso de Enviar Mensajes
3. Revisar canal de notificaciones: Verificar que el canal aún existe
4. Revisar configuraciones del panel: Confirmar que la integración está habilitada
5. Esperar sincronización: Los cambios pueden tardar hasta 5 minutos en propagarse

Problemas Específicos de Plataforma

Problemas de Twitch (Recientemente Corregidos):

• Nombre de usuario vs Nombre de visualización: CRÍTICO - Usar el nombre de usuario de login real de Twitch (user_login), no el nombre de visualización (user_name). Este fue un bug mayor recientemente corregido.
• Sensibilidad a mayúsculas: Usar minúsculas para mejores resultados
• Retrasos de transmisión: Las notificaciones aparecen 1-2 minutos después de ir en vivo
• Límites de velocidad API: 800 solicitudes por minuto con protección de interruptor de circuito
• Notificaciones duplicadas: Corregido - ahora solo el shard 0 procesa notificaciones

Problemas de YouTube (Recientemente Corregidos):

• Formato de ID del canal: Los canales modernos usan IDs de Canal que comienzan con "UC"
• Resolución de handle: Los handles @usuario ahora se resuelven correctamente vía API de búsqueda
• Nombres de usuario legados: Los nombres de usuario antiguos de YouTube rara vez funcionan, usar ID de Canal en su lugar
• Retrasos de subida: La API de YouTube tiene retrasos de 5-15 minutos para videos nuevos
• Videos privados/no listados: Solo los videos públicos activan notificaciones
• Detección de canal: Ahora detecta correctamente el tipo de identificador de canal (UC vs @ vs legado)

Problemas de Instagram (Recientemente Corregidos):

• Validación de nombre de usuario: NUEVO - M4T3 ahora valida que las publicaciones devueltas coincidan con el nombre de usuario configurado
• Privacidad de cuenta: Solo las cuentas públicas pueden ser monitoreadas
• Notificaciones falsas: Problema corregido donde se enviaban publicaciones de usuarios incorrectos
• Validación de feed RSS: Ahora valida que los elementos RSS coincidan con el nombre de usuario configurado
• Restricciones de contenido: Algunos tipos de publicaciones pueden no activar notificaciones
• Limitación de velocidad: 30 solicitudes por minuto con backoff exponencial

Notificaciones Duplicadas (Corregido)

Corrección Reciente: M4T3 ahora ejecuta la integración social solo en el shard 0, eliminando notificaciones duplicadas que ocurrían cuando múltiples shards procesaban el mismo contenido.

1. Revisar configuraciones múltiples: Asegurar que la misma cuenta no esté configurada múltiples veces
2. Verificar canales de notificación: Asegurar que diferentes configuraciones usen diferentes canales
3. Revisar configuraciones de webhook: Múltiples webhooks pueden causar duplicados
4. Procesamiento de shard: Ahora manejado automáticamente (solo shard 0)

Notificaciones Retrasadas

1. Retrasos esperados: La mayoría de plataformas tienen retrasos de 2-15 minutos
2. Límites de velocidad API: Los interruptores de circuito previenen fallas en cascada
3. Actualización de caché: M4T3 verifica actualizaciones cada 5-15 minutos
4. Estado de plataforma: Verificar si la plataforma social está experimentando problemas
5. Interruptor de circuito: Puede pausar temporalmente las verificaciones si ocurren demasiadas fallas

Solución de Problemas Avanzada

Nuevas Características de Confiabilidad

• Interruptores de Circuito: Previenen fallas en cascada con estados CERRADO/ABIERTO/MEDIO_ABIERTO
• Limitación de Velocidad: El backoff exponencial previene el agotamiento de API
• Métricas Unificadas: Monitoreo completo vía comando /admin dashboard
• Deduplicación: El caché basado en ciclos previene llamadas API duplicadas

Probar Plataformas Individuales

1. Usar comandos de prueba: /setup social list para verificar integraciones específicas
2. Revisar respuestas API: Buscar mensajes de error en logs del bot
3. Verificar claves API: M4T3 maneja automáticamente el acceso API
4. Monitorear límites de velocidad: Los interruptores de circuito manejan la gestión de límites de velocidad
5. Revisar métricas: Usar el panel para ver tasas de éxito/falla

Validación de Configuración

1. Verificar dos veces nombres de usuario: Copiar y pegar para evitar errores tipográficos
2. Verificar URLs de plataforma: Asegurar que la cuenta/canal existe y es público
3. Probar canal de notificación: Enviar mensaje de prueba para verificar permisos
4. Revisar roles del bot: Asegurar que M4T3 tiene permisos Discord necesarios
5. Esperar propagación: Permitir 5 minutos para que los cambios se sincronicen

Cuándo Contactar Soporte

• Las notificaciones dejaron de funcionar para todas las plataformas después de actualizaciones recientes
• El interruptor de circuito permanece ABIERTO por períodos extendidos
• Los mensajes de error persisten después de correcciones de configuración
• Problemas específicos de plataforma que afectan múltiples servidores
• Sospecha de interrupciones de API o servicio

Mejores Prácticas

Gestión de Configuración

• Usar nombres de usuario exactos: Especialmente importante para Instagram y Twitch
• Pruebas regulares: Verificar periódicamente que las integraciones funcionen
• Monitorear cambios: Observar cambios de nombre de usuario/URL de plataforma
• Respaldar configuraciones: Documentar tus configuraciones
• Verificar validación: Asegurar que los nombres de usuario estén correctamente validados

Optimización de Notificaciones

• Canales dedicados: Usar canales separados para diferentes plataformas
• Mensajes personalizados: Personalizar notificaciones para tu comunidad
• Menciones de rol: Usar pings de rol para notificaciones importantes
• Personalización de embed: Configurar colores y formato de embed
• Conciencia de límites de velocidad: No exceder límites de plataforma

Consideraciones de Rendimiento

• Limitar integraciones: Los interruptores de circuito manejan la carga automáticamente
• Escalonar configuraciones: La limitación de velocidad incorporada maneja el tiempo
• Monitorear métricas: Verificar el panel M4T3 para estadísticas detalladas
• Mantenimiento regular: Revisar y limpiar integraciones no utilizadas
• Monitoreo de confiabilidad: Observar el estado del interruptor de circuito en el panel