Guias

Aprenda a configurar, personalizar e aproveitar ao máximo o Social Stream Ninja

Fontes de chat YouTube, Twitch, TikTok e mais de 100 outras plataformas
Social Stream Ninja A extensão ou o aplicativo para desktop reúne todos os chats em uma única sessão
Dock Modere, destaque e responda
Sobreposição para OBS Chat em destaque e alertas na transmissão

Um ID de sessão conecta tudo: use o mesmo ?session= nas URLs do dock e da sobreposição.

Encontre um guia

Pesquise ou abra uma categoria. Comece pelo OBS se só precisar de chat na tela.

Comece aqui Instale, conecte o chat e adicione sobreposições no OBS
Operação da transmissãoControles do dock, moderação, repasses e participação
Sobreposições e personalização Modelos, opções de estilo, fontes e eventos
Automação e integrações API, comandos, Event Flow, webhooks
IA e síntese de voz Coapresentadores por voz, assistentes de navegador, bots, modelos locais e TTS
Guias de plataformas TikTok, YouTube, Twitch, Kick e sites compatíveis
Solução de problemas e suporte Chat ausente, sobreposições vazias e documentação de suporte detalhada

Nenhum guia correspondente encontrado.

Seções detalhadas do guia Conteúdo completo dos guias passo a passo. Recolha esta seção se quiser apenas o diretório.

Primeiros passos (extensão do navegador)

1. Instalação

Antes de usar o Social Stream Ninja, você precisa instalá-lo. Há várias formas de instalar a extensão do navegador:

  • Instalação manual (recomendada): Para a versão mais atualizada, instale manualmente no modo de desenvolvedor.
  • Chrome Web Store: Instale pela Chrome Web Store para facilitar a configuração.

Para instruções detalhadas de instalação, acesse a Página de download.

2. Configuração básica

Após instalar, siga estas etapas para começar a usar o Social Stream Ninja:

  1. Abra o chat da sua plataforma de transmissão em um navegador (ou use o recurso de chat pop-out, se disponível)
  2. Clique no ícone da extensão Social Stream Ninja na barra de ferramentas do navegador
  3. Clique em "Ativar extensão" para ligá-la (o ícone deve ficar verde)
  4. Abra o "Dashboard Link" (Link do painel) fornecido no popup da extensão
  5. Abra o "Overlay Link" (Link da sobreposição) no OBS como fonte de navegador

Nota: Para uma melhor experiência, mantenha as janelas de chat visíveis (não minimizadas) ao usar a extensão do navegador.

3. Conectar diferentes plataformas

O Social Stream Ninja funciona com mais de 100 plataformas. Veja como conectar às mais populares:

YouTube

  • Abra o chat ao vivo do YouTube
  • Clique no botão "Abrir chat em nova janela" no canto superior direito
  • Verifique se a extensão Social Stream Ninja está ativada (ícone verde)

Twitch

  • Abra o chat da Twitch do seu canal
  • Clique no ícone de engrenagem e selecione "Abrir chat em nova janela"
  • Verifique se a extensão Social Stream Ninja está ativada (ícone verde)

Facebook

  • Abra sua transmissão ao vivo do Facebook (como espectador ou transmissor)
  • Verifique se você está conectado por Wi-Fi ou Ethernet (e não por dados móveis)
  • Verifique se a extensão Social Stream Ninja está ativada (ícone verde)

Discord, Slack, WhatsApp etc.

  • Primeiro, ative essas plataformas nas configurações da extensão (interruptor)
  • Abra as versões web dessas plataformas no navegador
  • Verifique se a extensão Social Stream Ninja está ativada (ícone verde)

Personalização (extensão do navegador)

Parâmetros de URL

Você pode personalizar tanto o painel quanto a sobreposição adicionando parâmetros à URL. Alguns exemplos:

Parâmetros do painel:

&darkmode - Ativa o modo escuro no painel
&scale=2 - Duplica o tamanho/resolução de todos os elementos
&hidesource - Oculta ícones de plataformas (YouTube, Twitch etc.)
&compact - Remove o espaçamento entre nome e mensagem
&inline - Coloca a mensagem ao lado do nome mantendo o espaçamento normal
&autoshow - Destaca automaticamente as mensagens conforme aparecem (cerca de 2 a cada 3 segundos)

Parâmetros da sobreposição:

&showtime=20000 - Oculta automaticamente mensagens selecionadas após 20 segundos
&showsource - Mostra os ícones de plataformas ao lado dos nomes de usuário
&fade - Faz mensagens em destaque aparecerem gradualmente em vez de surgir de repente
&swipe - Faz mensagens em destaque deslizarem da esquerda
¢er - Centraliza mensagens em destaque na tela

Para gerenciar URLs com mais facilidade, experimente nosso Ferramenta de edição de parâmetros de URL.

Personalização com CSS

Há várias maneiras de personalizar a aparência com CSS:

Método 1: CSS da fonte de navegador do OBS

No OBS, você pode adicionar CSS personalizado à fonte de navegador:

  1. Adicione sua sobreposição como Fonte de navegador no OBS
  2. Marque a opção "CSS personalizado"
  3. Digite seu CSS personalizado na caixa de texto
body { background-color: rgba(0, 0, 0, 0); margin: 0px auto; overflow: hidden; }

:root {
    --comment-color: #090;
    --comment-bg-color: #DDD;
    --comment-border-radius: 10px;
    --comment-font-size: 30px;
    --author-border-radius: 10px;
    --author-bg-color: #FF0000;
    --author-avatar-border-color: #FF0000;
    --author-font-size: 32px;
    --author-color: blue;
    --font-family: "Arial", sans-serif;
}

.hl-name {
    padding: 2px 10px !important;
}

Método 2: Configurações do menu da extensão

Adicione CSS diretamente pelo menu da extensão:

  1. Clique no ícone da extensão Social Stream Ninja
  2. Encontre a seção de configurações de CSS/JavaScript
  3. Digite seu CSS ou JavaScript personalizado
  4. O CSS será anexado à URL como dados codificados em base64

Método 3: Usar modelos personalizados

Escolha modelos pré-estilizados que já incluem CSS:

  • Veja nossa Galeria de modelos
  • Selecione um modelo que combine com o estilo da sua transmissão
  • Substitua YOURSESSIONID na URL do modelo pelo seu ID de sessão
  • Adicione a URL do modelo como Fonte de navegador no OBS

Exemplo: https://socialstream.ninja/themes/pretty.html?session=YOURSESSIONID

Cores diferentes para nomes no chat

As cores dos nomes precisam de duas configurações: uma fonte geral de cores em Mensagem - Estilo e a opção de exibição do Dock em Mensagem - Visibilidade.

Abra o guia de cores dos nomes no chat para capturas de tela, escolhas de cores, solução de problemas e exemplos de CSS.

Fontes e estilos hospedados por conta própria

Use suas próprias fontes em dock.html ou featured.html sem depender de fontes do Google ou do sistema.

  • Hospede seus arquivos .woff2/.ttf/.otf e carregue-os com @font-face.
  • Aplique CSS pelo CSS personalizado do OBS ou por parâmetros de URL, como &css=, &b64css=, &font=, ou &googlefont=.
  • Funciona da mesma forma na extensão do Chrome, no aplicativo Electron e nas páginas hospedadas.

Abra o guia de fontes hospedadas por conta própria para hospedagem passo a passo e exemplos de CSS.

Recursos avançados (extensão do navegador)

Texto em fala

O Social Stream Ninja pode ler mensagens do chat em voz alta usando tecnologia de síntese de voz:

Configuração de TTS:

  1. Adicione &speech=en-US à URL de featured.html ou dock.html
  2. Para outros idiomas, use um provedor e uma voz que ofereçam suporte ao idioma. Por exemplo, para português, você pode usar o Piper &pipervoice=pt_BR-faber-medium ou eSpeak &espeakvoice=pt-br, enquanto espanhol pode usar Piper &pipervoice=es_ES-davefx-medium ou eSpeak &espeakvoice=es.
  3. Personalize as configurações de voz com parâmetros, como &pitch=1&volume=1&rate=1

Opções gratuitas de TTS local (sem chave de API):

  • Kokoro TTS: IA integrada no navegador, excelente qualidade — &ttsprovider=kokoro
  • Piper TTS: TTS neural rápido e leve — &ttsprovider=piper
  • eSpeak-NG: Alternativa leve para idiomas, incluindo português &espeakvoice=pt-br e espanhol &espeakvoice=es
  • Kitten TTS: Menor uso de recursos, somente CPU — &ttsprovider=kitten
  • Servidor hospedado por conta própria: Execute Kokoro-FastAPI ou openedai-speech localmente via Docker — &ttsprovider=openai&openaiendpoint=http://localhost:8880/v1/audio/speech

Opções premium de TTS na nuvem:

  • Google Cloud TTS: Vozes de qualidade profissional (exige chave de API do Google)
  • ElevenLabs: Vozes ultrarrealistas com treinamento de voz personalizada
  • Speechify: Vozes premium com som natural

Quer manter tudo local e privado? Veja: Guia de síntese de voz local com IA para instruções completas de configuração, incluindo opções de servidor próprio e captura de áudio do OBS.

Coapresentadores de IA, bots de chat e assistentes no navegador

O Social Stream Ninja pode usar IA de várias maneiras. Escolha o fluxo de trabalho antes de escolher um provedor.

  • Coapresentador por voz: converse pelo microfone enquanto perguntas do chat ao vivo entram na mesma sessão do coapresentador.
  • Assistente ChatGPT no navegador: capture ou repasse experimentalmente o chat para uma aba aberta do chatgpt.com sem uma chave de API.
  • Bot principal do chat: responda a espectadores selecionados em uma sobreposição, por TTS ou diretamente nos chats compatíveis.
  • Ferramentas de processamento: moderação, tradução, resumos, busca de conhecimento com RAG e sobreposições criadas por IA.

Escolha uma configuração de IA

Enfileiramento e fixação de mensagens

Organize como as mensagens aparecem na sobreposição:

Enfileiramento de mensagens:

  1. Segure CTRL (ou Cmd no Mac) ao clicar nas mensagens do painel
  2. Clique no botão "Próxima da fila" para exibi-las uma a uma
  3. As mensagens aparecerão na sobreposição na ordem em que foram enfileiradas

Fixação de mensagens:

  1. Segure ALT ao clicar em uma mensagem no painel
  2. A mensagem permanecerá fixada no topo do painel
  3. Para desafixar, segure ALT e clique novamente na mensagem fixada

Captura de eventos da transmissão

Capture eventos além do chat, como novos seguidores, inscrições, raids e doações das plataformas de transmissão.

Como ativar:

  1. Clique no ícone da extensão Social Stream Ninja
  2. Encontre o "Capturar eventos da transmissão" nas configurações
  3. Ative para começar a receber alertas

Nota: Eventos no estilo doação (Super Chats, Bits, gorjetas) são encaminhados automaticamente, independentemente desta opção. A opção é principalmente para alertas de seguidores/inscritos.

Eventos capturados por plataforma:

YouTube

  • Novas adesões e presentes de membros
  • Upgrades de membros e marcos
  • Doações de Super Chat e Super Sticker
  • Contagem de inscritos e espectadores

Twitch

  • Novos inscritos, reinscrições e inscrições de presente
  • Seguidores e contagem de seguidores
  • Bits/Cheers e resgates de Pontos do Canal
  • Raids com contagem de espectadores

TikTok, Kick e outros

  • Seguidores e presentes (TikTok)
  • Inscrições e gorjetas (Kick)
  • Contagem de espectadores na maioria das plataformas

Para uma lista completa dos payloads de eventos e campos de dados, consulte a Referência de eventos documentação.

Barra superior do Hype Train

Mostre o progresso do Hype Train e do Treasure Train da Twitch como uma barra superior no estilo da Twitch no OBS.

  • Copie o link dedicado da Barra superior do Trem do Hype no popup.
  • Teste com o botão Fake Hype Train antes de entrar ao vivo.
  • Use o guia para etapas de configuração, capturas de tela e solução de problemas.

Abra o guia da barra superior do Hype Train

Participantes que falam pela primeira vez

Destaque novos participantes do chat, adicione o emblema opcional de folha ou use um bipe do dock apenas para a primeira mensagem.

  • Mantenha o banco de dados local de mensagens ativado.
  • Ative a detecção de participantes que falam pela primeira vez.
  • Escolha as opções de destaque, distintivo e bipe que combinam com sua sobreposição.

Abra o guia de participantes que falam pela primeira vez

Editor do Event Flow

O editor do Event Flow é um poderoso sistema de automação baseado em nós para criar fluxos personalizados. É a camada de "automação avançada" que permite programar sua própria lógica de roteamento.

O que você pode fazer:

  • Repassar chat entre plataformas com filtros inteligentes (por exemplo, espelhar a Twitch no Discord, mas bloquear comandos)
  • Criar comandos personalizados com portas lógicas AND/OR/NOT
  • Acione sobreposições e áudio com base em eventos ou palavras-chave específicos
  • Controlar OBS cenas e fontes automaticamente
  • Criar rifas e sorteios com gerenciamento de fila

Primeiros passos:

  1. Abra o editor do Event Flow pelo menu principal do painel
  2. Crie um novo fluxo e adicione nós de origem (ex.: "Mensagem do Twitch")
  3. Conecte nós de lógica para filtrar mensagens (Contém palavra-chave, Função do usuário etc.)
  4. Adicione nós de ação para responder (Enviar chat, Reproduzir áudio, Exibir sobreposição)
  5. Teste com o simulador integrado antes de entrar ao vivo

Sobreposição Flow Actions:

Para que áudio, sobreposições de mídia e ações do OBS funcionem, adicione a página Flow Actions como fonte de navegador no OBS:

  1. No popup, encontre a seção "Flow Actions" e copie a URL
  2. Adicione como Fonte de navegador no OBS (1920×1080 recomendado)
  3. Mantenha a sobreposição aberta (pode ficar oculta, mas não a feche)

Importante: As ações atuais Repassar chat ignoram automaticamente ecos reconhecidos. Use um Filtro de ecos (Reflection Filter) para controlar se os ecos capturados aparecem no Dock e nas sobreposições. Consulte o passo a passo do repasse de chat para configuração. Para documentação detalhada, consulte o Guia do Event Flow. Para sons ou mídias de recompensas do Kick, use o Guia de pontos do canal / recompensas do Kick.

Controle por MIDI e atalhos

Controle o Social Stream Ninja diretamente pelo Stream Deck, controladores MIDI ou atalhos de teclado.

Configuração de MIDI:

  1. Conecte seu dispositivo MIDI (Stream Deck, controlador MIDI etc.)
  2. Abra o popup do Social Stream Ninja
  3. Encontre a seção de configurações de MIDI
  4. Selecione seu dispositivo MIDI no menu suspenso
  5. Associe notas MIDI a ações específicas

Ações disponíveis:

  • Acione sobreposições e mídias personalizadas
  • Envie mensagens de chat predefinidas
  • Troque cenas do OBS
  • Reproduza clipes de áudio ou TTS
  • Execute gatilhos do Event Flow

Dica: MIDI é ideal para controlar a transmissão sem usar as mãos. Use um pedal para acionar alertas ou um botão giratório para ajustar o volume.

Comandos de bot e respostas automáticas

Crie comandos interativos de bot e respostas automatizadas para o chat.

Comandos integrados:

  • !joke - Envia uma piada nerd aleatória no estilo tiozão
  • !hi - Cumprimenta espectadores automaticamente
  • !cycle - Permite que espectadores mudem cenas do OBS (com permissão)

Configuração da resposta automática:

  1. Abra o popup da extensão e encontre a seção Bot/Auto-Response
  2. Ative os comandos que deseja usar
  3. Mantenha a janela de chat visível (não minimizada) para que as respostas funcionem
  4. Verifique se você está conectado à plataforma com permissão para publicar

Criar comandos personalizados:

Para comandos mais complexos, use o editor do Event Flow:

  1. Crie um novo fluxo com uma origem de Mensagem
  2. Adicione um nó "Contém palavra-chave" para detectar seu comando (ex.: "!social")
  3. Conecte uma ação "Enviar chat" com sua resposta
  4. Opcionalmente, adicione filtros de função de usuário para comandos exclusivos de moderadores

Requisitos: Respostas automáticas funcionam melhor em navegadores baseados em Chromium. Janelas de chat precisam permanecer visíveis, e você deve ter permissão para publicar na plataforma.

Webhooks e integrações

Conecte plataformas externas de doações para exibir gorjetas e compras na sobreposição da transmissão.

Pré-requisitos:

  1. Anote seu ID de sessão no popup da extensão
  2. Mantenha o Social Stream Ninja ativado
  3. Em Global settings and tools → Mechanics, ative controle remoto da extensão por API
  4. Use seus links normais gerados para dock e sobreposição; não adicione &server, &server2, ou &server3 para webhooks de doação
  5. Recarregue o dock uma vez se ele já estava aberto
Só é necessário ativar uma opção de API: o controle remoto por API permite que o script em segundo plano normalize webhooks de doação e os entregue como mensagens normais. As outras opções de transporte da API podem permanecer desativadas.

A doação normalizada é compartilhada com chat, alertas, Event Flow e o Tip Jar/Goal Meter.

Controle remoto por API ativado, enquanto as outras opções de transporte da API permanecem desativadas

Plataformas compatíveis:

Plataforma URL do webhook Tipo de evento
Stripe https://io.socialstream.ninja/{sessionID}/stripe checkout.session.completed
Ko-Fi https://io.socialstream.ninja/{sessionID}/kofi Gorjetas públicas, assinaturas, pedidos da loja e encomendas
Buy Me A Coffee https://io.socialstream.ninja/{sessionID}/bmac Gorjetas, assinaturas, pedidos da loja, encomendas e financiamento de listas de desejos
Fourthwall https://io.socialstream.ninja/{sessionID}/fourthwall Pedidos, presentes, doações e novas assinaturas

Configuração do Stripe:

  1. Crie um Stripe Payment Link
  2. Importante: Adicione campos personalizados ao link de pagamento:
    • Nome de exibição ou Nome de usuário (obrigatório) - sem este campo, as doações serão rejeitadas
    • Mensagem (opcional) - permite que doadores deixem uma mensagem
  3. Vá para Webhooks do Stripe e crie um novo endpoint
  4. Defina a URL como: https://io.socialstream.ninja/YOUR_SESSION_ID/stripe
  5. Selecione o evento: checkout.session.completed
  6. Não é necessário verificar assinaturas (mantenha seu ID de sessão privado)

Testes: Use o modo de teste do Stripe com o cartão 4242 4242 4242 4242, qualquer validade futura, qualquer CVC.

Configuração de loja de criador

Use: guia ilustrado de configuração para Fourthwall, Ko-fi e Buy Me a Coffee, incluindo status do receptor, prévias isoladas e importação de produtos.

Nota de segurança: Mantenha seu ID de sessão privado. Qualquer pessoa com esse ID pode enviar eventos falsos de doação para sua sobreposição.

Exportação do chat por webhook:

Você também pode exportar dados do chat para serviços externos:

  • Configure uma URL de webhook de saída nas configurações
  • Mensagens de chat são enviadas como requisições POST com payload JSON
  • Use isso para registrar chats, acionar automações externas ou sincronizar com outras ferramentas

Solução de problemas (extensão do navegador)

Soluções para problemas comuns da extensão do navegador

Problema com janela minimizada

O chat para em segundo plano/minimizado

Mensagens de chat param de aparecer quando as janelas do navegador estão em segundo plano ou minimizadas. Isso acontece porque navegadores limitam abas em segundo plano para economizar recursos.

Desative a limitação do navegador
  • Chrome/Edge/Brave:
    1. Abrir chrome://flags/#enable-throttle-display-none-and-visibility-hidden-cross-origin-iframes
    2. Defina como "Disabled" (Desativado)
    3. Desative também chrome://flags/#calculate-native-win-occlusion
    4. Reinicie o navegador
  • Desativar limitação de desempenho:
    1. Vá para chrome://settings/performance
    2. Desative "Throttle Javascript timers in background"
Alternativas
  • Mantenha as janelas visíveis: Organize as janelas para que não fiquem minimizadas; até uma pequena parte visível pode evitar limitação.
  • Use áreas de trabalho virtuais: No Windows, use Win+Tab para criar duas áreas de trabalho virtuais, com as janelas de chat em uma e o OBS na outra.
  • Experimente o aplicativo independente: O aplicativo para desktop do Social Stream Ninja evita muitos problemas de limitação de atividade do navegador.
Problema da barra de depuração

Barra azul aparece / respostas automáticas não funcionam

Uma barra azul de depuração aparece ou respostas automatizadas não funcionam ao tentar usar comandos de bot ou respostas automáticas.

Confira a visibilidade da janela de chat
  • Ao usar YouTube ou Twitch, verifique se a janela de chat pop-out está aberta e visível
  • Em algumas plataformas, talvez seja necessário manter a janela principal aberta junto com o pop-out
Compatibilidade de navegadores
  • Respostas automáticas funcionam melhor em navegadores baseados em Chromium (Chrome, Edge, Brave)
  • O Firefox tem suporte limitado aos recursos da extensão

Perguntas frequentes

O Social Stream Ninja oferece suporte a mais de 100 plataformas, incluindo YouTube, Twitch, Facebook, Instagram, TikTok, Discord, Zoom, Google Meet, X (Twitter), WhatsApp, Telegram e muitas outras. Para a lista completa, consulte a Plataformas compatíveis página.
O aplicativo independente é recomendado para a maioria dos usuários porque:
  • Evita problemas de limitação do navegador
  • Fornece atualizações automáticas
  • Oferece recursos de fixação de janela e transparência
  • Oferece melhor desempenho e estabilidade
A extensão do navegador é melhor se você:
  • Precisa usar em vários computadores
  • Prefere não instalar software adicional
  • Quer as atualizações mais recentes imediatamente (instalação manual)
Não! Uma das maiores vantagens do Social Stream Ninja é que ele não exige chaves de API nem credenciais de login para a maioria das plataformas. Ele captura os dados do chat diretamente da janela do navegador ou da interface do aplicativo. No entanto, você precisa estar conectado a cada plataforma para visualizar o chat normalmente.
Para a extensão do navegador: Para atualizar a extensão instalada manualmente, baixe a versão mais recente, substitua os arquivos antigos pelos novos e recarregue a extensão ou reinicie o navegador. Não desinstale a extensão se quiser manter suas configurações. Se estiver usando a versão da Chrome Web Store, ela será atualizada automaticamente, mas com menos frequência. Para o aplicativo independente: O aplicativo será atualizado automaticamente ao ser reiniciado. Você também pode verificar atualizações manualmente pelo menu do aplicativo.
Sim! O Social Stream Ninja oferece chat bidirecional na maioria das plataformas. Quando você está conectado a uma plataforma e tem as permissões adequadas, pode enviar mensagens pelo painel ou por comandos de API, e elas aparecerão em todos os chats conectados simultaneamente.
Com certeza! O Social Stream Ninja foi feito para funcionar perfeitamente com o OBS Studio e outros programas de transmissão. Basta adicionar a URL da sobreposição como Fonte de navegador no programa de transmissão. Você pode personalizar a aparência com CSS diretamente no OBS ou por parâmetros de URL.
Sim, o Social Stream Ninja é totalmente gratuito e de código aberto sob a licença GPLv3.0. Não há assinaturas, taxas ocultas nem limitações de recursos. O projeto é mantido por Steve Seguin com contribuições da comunidade.
Mantemos uma lista canônica de todos os payloads de eventos (seguidores, membros, raids, contagem de espectadores, doações e mais) na Referência de eventos. Também explica quais fontes exigem a opção “Capturar eventos da transmissão”, permissões de login ou escopos adicionais para receber dados.
Todas as URLs de sobreposição, APIs do dock, comandos WebSocket e pontos de integração de automação estão documentados na Comandos e API página. É o melhor ponto de partida quando você quer programar comportamentos personalizados ou integrar o Social Stream Ninja a outras ferramentas.
O Social Stream Ninja tem uma comunidade ativa no Discord onde você pode obter ajuda diretamente do desenvolvedor e de outros usuários. Entre em discord.socialstream.ninja. Você também pode relatar problemas no Repositório no GitHub.

Ainda precisa de ajuda?

Entre no nosso servidor da comunidade no Discord, onde o desenvolvedor e outros usuários podem ajudar a resolver problemas.