Sorteios, bilhetes e prêmios em pontos

Faça um sorteio gratuito em 5 etapas

No popup, abra Opções de sorteio. Deixe o ID como default e a palavra-chave como !enter. Mantenha o preço do bilhete e o prêmio em pontos em 0.
Escolha Cartão do ganhador, Roleta de nomes, ou Roleta da comunidade. Veja a prévia e copie o link para o OBS como Fonte de navegador.
Clique em Abrir participações. Os espectadores digitam a palavra-chave no chat para participar.
Clique em Fechar participações, depois Sortear ganhador. (O sorteio fecha as inscrições se você esquecer.)
Clique em Nova rodada para outro sorteio. Os vencedores anteriores permanecem no histórico.

Mantenha o Social Stream Ninja em execução. Ele executa o sorteio. Você nunca precisa clicar dentro da fonte do OBS.

A antiga roleta da comunidade independente continua funcionando se você deixar &managed fora do link. Pontos e controles remotos precisam do link gerenciado.

Venda bilhetes por pontos SSN

Ative Sistema de pontos de fidelidade no painel. (São pontos SSN, não pontos do canal da Twitch.)
Em Opções do sorteio, abra Bilhetes e prêmios em pontos. Defina Pontos por bilhete e Máximo de bilhetes por espectador.
Clique em Abrir participações. Para um sorteio chamado friday, um espectador compra 5 bilhetes com !ticket friday 5.
Veja quem entrou em Gerenciar sorteios e histórico.

Quando isto acontece…	Os pontos…
Um espectador compra bilhetes	Ficam reservados. Não podem ser gastos em outra coisa.
O espectador não tem pontos suficientes	Não são cobrados. Nenhum bilhete é emitido.
Você sorteia um vencedor	São gastos.
Você clica em Cancelar e reembolsar	São devolvidos a todos.
Você remove um espectador antes do sorteio	São devolvidos a esse espectador.

As regras ficam bloqueadas após a primeira inscrição. Para alterá-las, cancele e reembolse, depois inicie uma nova rodada. Nova rodada não descarta uma rodada paga. Fechar e reabrir apenas pausa.

Distribuir pontos

Antes de abrir as inscrições, defina Prêmio em pontos por ganhador e Número de prêmios.
Abra as inscrições normalmente.
Sorteie um vencedor por vez. O prêmio é adicionado ao saldo de pontos de cada vencedor.

Os pontos do prêmio são pontos novos, não saem das vendas de bilhetes. O máximo que você pode distribuir é prêmio × número de prêmios.

Um sorteio concluído não pode ser desfeito. Para corrigir um erro, ajuste manualmente os pontos desse espectador. Reconectar a tela nunca paga duas vezes.

Jogos com recompensas em pontos

Caça ao número (Number Hunt)

Defina o tipo como Caça ao número (controlada pelo host), Pontos por bilhete 0, e Número de prêmios 1. Adicione um prêmio em pontos se quiser.
O Social Stream escolhe um número secreto de 1 a 100.
Os jogadores adivinham com !guess friday 50 (use o ID do seu sorteio).

Palpites errados reduzem o intervalo para todos. A primeira resposta certa ganha. Um palpite por espectador a cada 5 segundos.

Mostre com a tela do sorteio ou games/numberhunt.html?session=YOUR_SESSION&managed&giveaway=friday. Os jogos comuns não concedem pontos SSN.

Pote de cara ou coroa

Defina o tipo como Pote de cara ou coroa, Pontos por bilhete 1, Número de prêmios 1, e Prêmio em pontos por ganhador 0.
Os espectadores apostam com !ticket friday 3 heads ou !ticket friday 3 tails.
Feche as inscrições e sorteie. É um lançamento com chance de 50/50, independentemente das apostas.

Os vencedores recebem a aposta de volta mais uma parte das apostas perdedoras, proporcional ao valor apostado. Sem taxa e sem pontos novos. Exemplo: vencedores apostam 2 e 1, perdedores apostam 5; o pote de 8 pontos paga 5 e 3.

É preciso ter um jogador em cada lado, ou o sorteio é recusado. Cancele antes de sortear para reembolsar todos.

Como os pontos restantes são divididos

Os pontos restantes vão primeiro para as maiores partes fracionárias. Empates favorecem quem entrou primeiro.

Faça vários sorteios ao mesmo tempo

Dê a cada um um identificador curto em ID do sorteio (letras, números, -, _) e adicione &giveaway=ID ao link do OBS.
Os comandos de bilhetes e palpites incluem o nome do sorteio, como !ticket friday 5.
Dê a cada sorteio gratuito sua própria palavra-chave. Uma palavra compartilhada não inscreve nos dois.
Todos os bilhetes saem do mesmo saldo de pontos do espectador.

O painel configura novas rodadas. Para ver as regras reais de uma rodada em andamento, confira o gerenciador. Editar um link do OBS só muda a aparência.

A tela do OBS

Use 1280 × 720 como fonte de navegador. O fundo é transparente, a menos que você escolha Painel temático.
A roleta mostra até 120 nomes, mas o vencedor é escolhido entre todos os bilhetes.
Após reconectar, o resultado salvo é mostrado. A configuração de movimento reduzido pula a animação.
O Social Stream não consegue saber se a cena do OBS está ao vivo.

Mantenha estes dados privados: links de controle, IDs de sessão e arquivos de backup.

Event Flow

Adicione o Sorteio / Bilhetes como ação (abaixo das ações de pontos).
Escolha a ação: Entrar no sorteio gratuito, Comprar bilhetes, Conceder bilhetes grátis, Fechar inscrições, Sortear vencedor, Cancelar e reembolsar ou Consultar estado.
Escolha o ID do sorteio e a quantidade de bilhetes. Para um pote, escolha cara ou coroa.

Comprar bilhetes já gasta os pontos. Não coloque uma ação Gastar pontos antes dela.

Age em nome do espectador que enviou a mensagem. Coloque um gatilho ou filtro confiável antes das concessões e dos controles do host.

Mais detalhes do Event Flow

Se falhar, as ações dependentes param. A mensagem do chat continua aparecendo.
O resultado fica em meta.giveawayControlResult.
O painel de testes apenas simula. Para testes reais, use outro host ou perfil.
O saldo é verificado na execução, então a mensagem de inscrição não pode gerar o último ponto que falta.
A proteção contra repetições é mais forte em fontes com IDs próprios de mensagens.
Eventos agendados sem espectador não podem comprar bilhetes.

Stream Deck e API

O plugin do Stream Deck inclui: Abrir sorteio, Fechar sorteio, Realizar sorteio, Cancelar e reembolsar, Nova rodada do sorteio, e Estado do sorteio.

Usam o sorteio default . Para outro, coloque {"giveawayId":"friday"} no campo de valor. Abrir sorteio também aceita um objeto config .
Uma tecla confirma que o Social Stream respondeu, não que o OBS esteja exibindo. Se o tempo limite acabar, confira o estado antes de sortear novamente.

Comprar bilhetes pela API

{"protocol":2,"action":"buygiveawaytickets","get":"callback-1","value":{"giveawayId":"friday","roundId":"ROUND_ID","operationId":"purchase-123","count":5,"actor":{"chatname":"Avery","type":"youtube","userid":"SOURCE_USER_ID"}}}

operationId identifica a compra; get identifica a resposta.
Mantenha o mesmo ID de operação ao tentar novamente. Use um novo para uma nova compra.

O acesso à API do host pode gastar os pontos de qualquer espectador. Nunca o exponha em um formulário público.

Histórico e backups

Gerenciar sorteios e histórico mostra rodadas, inscritos e vencedores. Você pode usar Exportar histórico de vencedores (JSON) ou salvar um backup completo de pontos e sorteios. Nada é enviado.

Após reiniciar, as rodadas abertas voltam fechadas, com os bilhetes ainda reservados. Reabra, sorteie ou cancele e reembolse.

Restaurar um backup

Só funciona em um host novo sem pontos nem sorteios.

Mantenha o host antigo desligado. Abra o SSN em um perfil de navegador novo e abra o gerenciador de sorteios.
Em Recuperar em um host novo, escolha seu backup completo. Espere a mensagem e anote o ID de sessão informado.
Na seção do popup Opções de sessão, digite esse ID de sessão.
De volta ao gerenciador, escolha o ID do sorteio e clique em Atualizar. Confira as regras, os inscritos e os vencedores. As rodadas voltam fechadas.
Reabra, sorteie ou use Cancelar e reembolsar. Depois salve um novo backup.

Nunca execute o host antigo e o restaurado ao mesmo tempo. Um backup não contém o que aconteceu depois que foi salvo nem as configurações do painel.

Mais sobre onde os dados ficam

Os pontos ficam neste perfil do navegador ou aplicativo e não são sincronizados com outros. As rodadas são mantidas por sessão.
Limpar os dados do navegador pode apagá-los, então mantenha backups fora desse perfil.
Importações apenas de saldos não restauram bilhetes reservados. Redefinir pontos fica bloqueado enquanto houver bilhetes reservados e não apaga o histórico dos sorteios.
Compras de figurinhas não confirmadas são liberadas após o tempo limite.
Não há backup na nuvem nem saque em dinheiro. O backup no servidor pode chegar mais tarde.

Resolver problemas

Problema	Tente isto
Um espectador não consegue participar	Confira o ID, a palavra-chave, a opção só para membros, se as inscrições estão abertas e se a plataforma está sendo capturada. Mensagens de bots, privadas, antigas, reproduzidas e de teste nunca contam.
A conta de um espectador parece incorreta	Uma mudança de nome pode confundir os saldos. Confira no host. As plataformas nunca são mescladas.
Os botões não respondem	Confira se o host SSN correto está em execução com os controles do host ativados. Atualize antes de tentar novamente.
Não é possível redefinir ou importar pontos	Primeiro conclua ou cancele as compras de bilhetes reservados. Para um backup com bilhetes reservados, use a recuperação completa.
`!spend` informa recompensa desconhecida	Precisa de uma recompensa configurada com um preço.