Integração de Mídia Social Não Funciona

Problemas Comuns de Mídia Social

O M4T3 suporta notificações de várias plataformas: Twitch, YouTube, Instagram, Twitter, Reddit, e feeds RSS. Quando essas integrações param de funcionar, geralmente é devido a problemas de configuração, limitações de API, ou problemas específicos do serviço.

Atualizações Recentes: M4T3 implementou melhores práticas de 2025 incluindo circuit breakers, rate limiting com backoff exponencial, e confiabilidade melhorada em todas as plataformas sociais.

Plataformas Suportadas

Plataformas de Streaming

• Twitch - Notificações de transmissão ao vivo quando streamers ficam online (800/min rate limit)
• YouTube - Notificações de novos uploads de vídeo dos canais (50/hora rate limit)

Redes Sociais

• Instagram - Notificações de novos posts das contas (30/min rate limit com validação)
• Twitter - Notificações de novos tweets das contas (15/15min rate limit)
• Reddit - Novos posts de subreddits (60/min rate limit)

Conteúdo Personalizado

• Feeds RSS - Notificações de feeds RSS/Atom personalizados (120/min rate limit)

Configurando Integração de Mídia Social

Método 1: Usando o Painel Web

1. Vá para o seu Painel M4T3 (https://m4t3.com/dashboard)
2. Selecione o seu servidor
3. Navegue para Configurações da Guilda > Mídia Social
4. Escolha a plataforma que deseja configurar
5. Digite as informações necessárias:
   • Twitch: Nome de usuário ou nome do canal (use nome de login, não nome de exibição)
   • YouTube: ID do canal (UC...), nome de usuário, ou handle (@usuário)
   • Instagram: Nome de usuário (apenas contas públicas, validado para precisão)
   • Twitter: Nome de usuário (sem @)
   • Reddit: Nome do subreddit (sem r/)
   • RSS: URL do feed (deve ser XML válido)
6. Selecione o canal do Discord para notificações
7. Personalize a mensagem de notificação (opcional)
8. Clique em "Salvar Configuração"
9. Teste a integração

Método 2: Usando Comandos do Bot

1. Use o comando /setup social setup no Discord
2. Selecione a plataforma que deseja configurar
3. Siga as instruções interativas para:
   • Digite informações de nome de usuário/canal
   • Escolha o canal de notificação
   • Configure mensagem personalizada (opcional)
4. Salve a configuração
5. Teste a integração

Problemas Comuns e Soluções

Nenhuma Notificação Aparecendo

Verificar Configuração

1. Verificar nomes de usuário/IDs: Garantir ortografia e formato exatos
2. Testar permissões do canal: Bot precisa da permissão Enviar Mensagens
3. Verificar canal de notificação: Verificar se o canal ainda existe
4. Revisar configurações do painel: Confirmar se a integração está habilitada
5. Aguardar sincronização: Mudanças podem levar até 5 minutos para propagar

Problemas Específicos da Plataforma

Problemas do Twitch (Recentemente Corrigidos):

• Nome de usuário vs Nome de exibição: CRÍTICO - Use o nome de usuário de login real do Twitch (user_login), não o nome de exibição (user_name). Este foi um bug maior recentemente corrigido.
• Sensibilidade de maiúsculas: Use minúsculas para melhores resultados
• Delays de transmissão: Notificações aparecem 1-2 minutos após ficar online
• Rate limits da API: 800 requisições por minuto com proteção circuit breaker
• Notificações duplicadas: Corrigido - agora apenas shard 0 processa notificações

Problemas do YouTube (Recentemente Corrigidos):

• Formato de ID do canal: Canais modernos usam IDs de Canal começando com "UC"
• Resolução de handle: Handles @usuário agora são resolvidos corretamente via API de busca
• Nomes de usuário legados: Nomes de usuário antigos do YouTube raramente funcionam, use ID do Canal
• Delays de upload: API do YouTube tem delays de 5-15 minutos para novos vídeos
• Vídeos privados/não listados: Apenas vídeos públicos ativam notificações
• Detecção de canal: Agora detecta corretamente o tipo de identificador do canal (UC vs @ vs legado)

Problemas do Instagram (Recentemente Corrigidos):

• Validação de nome de usuário: NOVO - M4T3 agora valida que posts retornados coincidem com o nome de usuário configurado
• Privacidade da conta: Apenas contas públicas podem ser monitoradas
• Notificações falsas: Problema corrigido onde posts de usuários errados eram enviados
• Validação de feed RSS: Agora valida que itens RSS coincidem com nome de usuário configurado
• Restrições de conteúdo: Alguns tipos de post podem não ativar notificações
• Rate limiting: 30 requisições por minuto com backoff exponencial

Notificações Duplicadas (Corrigido)

Correção Recente: M4T3 agora executa integração social apenas no shard 0, eliminando notificações duplicadas que ocorriam quando múltiplos shards processavam o mesmo conteúdo.

1. Verificar configurações múltiplas: Garantir que a mesma conta não está configurada várias vezes
2. Verificar canais de notificação: Garantir que configurações diferentes usam canais diferentes
3. Revisar configurações de webhook: Múltiplos webhooks podem causar duplicatas
4. Processamento de shard: Agora tratado automaticamente (apenas shard 0)

Notificações Atrasadas

1. Delays esperados: A maioria das plataformas tem delays de 2-15 minutos
2. Rate limits da API: Circuit breakers previnem falhas em cascata
3. Atualização de cache: M4T3 verifica atualizações a cada 5-15 minutos
4. Status da plataforma: Verificar se a plataforma social está com problemas
5. Circuit breaker: Pode pausar verificações temporariamente se muitas falhas ocorrerem

Solução de Problemas Avançada

Novos Recursos de Confiabilidade

• Circuit Breakers: Previnem falhas em cascata com estados FECHADO/ABERTO/MEIO_ABERTO
• Rate Limiting: Backoff exponencial previne esgotamento de API
• Métricas Unificadas: Monitoramento abrangente via comando /admin dashboard
• Deduplicação: Cache baseado em ciclos previne chamadas duplicadas de API

Testando Plataformas Individuais

1. Usar comandos de teste: /setup social list para verificar integrações específicas
2. Verificar respostas da API: Procurar mensagens de erro nos logs do bot
3. Verificar chaves da API: M4T3 gerencia acesso à API automaticamente
4. Monitorar rate limits: Circuit breakers lidam com gerenciamento de rate limit
5. Verificar métricas: Usar painel para ver taxas de sucesso/falha

Validação de Configuração

1. Verificar duas vezes nomes de usuário: Copiar e colar para evitar erros de digitação
2. Verificar URLs da plataforma: Garantir que conta/canal existe e é público
3. Testar canal de notificação: Enviar mensagem de teste para verificar permissões
4. Revisar roles do bot: Garantir que M4T3 tem permissões Discord necessárias
5. Aguardar propagação: Permitir 5 minutos para mudanças sincronizarem

Quando Contatar Suporte

• Notificações pararam de funcionar para todas as plataformas após atualizações recentes
• Circuit breaker permanece ABERTO por períodos estendidos
• Mensagens de erro persistem após correções de configuração
• Problemas específicos de plataforma afetando múltiplos servidores
• Suspeita de interrupções de API ou serviço

Melhores Práticas

Gerenciamento de Configuração

• Usar nomes de usuário exatos: Especialmente importante para Instagram e Twitch
• Testes regulares: Verificar periodicamente se integrações funcionam
• Monitorar mudanças: Observar mudanças de nome de usuário/URL da plataforma
• Backup de configurações: Documentar suas configurações
• Verificar validação: Garantir que nomes de usuário estão validados corretamente

Otimização de Notificações

• Canais dedicados: Usar canais separados para plataformas diferentes
• Mensagens personalizadas: Personalizar notificações para sua comunidade
• Menções de role: Usar pings de role para notificações importantes
• Personalização de embed: Configurar cores e formatação de embed
• Consciência de rate limit: Não exceder limites da plataforma

Considerações de Performance

• Limitar integrações: Circuit breakers gerenciam carga automaticamente
• Escalonar configurações: Rate limiting integrado lida com timing
• Monitorar métricas: Verificar painel M4T3 para estatísticas detalhadas
• Manutenção regular: Revisar e limpar integrações não utilizadas
• Monitoramento de confiabilidade: Observar status do circuit breaker no painel