Produtos ao vivo e links para o público

1. Adicione um produto ou link de apoio

Abra Monetização > Produtos e links de apoio > Configurar produtos e links. Cole um link HTTPS público e escolha Carregar detalhes do link. A importação rápida aceita páginas públicas do Gumroad, itch.io, Ko-fi, Buy Me a Coffee e Fourthwall. Domínios personalizados, redirecionamentos, páginas privadas e páginas sem metadados públicos podem exigir entrada manual. As opções existentes de importação por API do Shopify e Fourthwall continuam disponíveis.

Confira título, imagem, preço, moeda e finalidade. A importação rápida deixa o preço vazio intencionalmente. Escolha Adicionar produto ou link, ative Produtos e links de apoio, depois Salvar configuração. Não é necessária uma conta de comerciante para cartões manuais.

Loja, Presente, Apoio e Participar descrevem a finalidade do link. Não alteram a classificação dos eventos de pagamento posteriores. Os cartões são registros salvos; o checkout é a referência para estoque e preços.

2. Controle o que aparece

Adicione a URL existente da sobreposição Produtos e links de apoio ao OBS. Use Vitrine ou Cartão de apoio para promoções, ou Ambos para incluir alertas de atividade.

• Mostrar agora em uma linha salva fixa esse produto e substitui a programação periódica de cartões.
• Próximo produto fixa o próximo produto salvo.
• Ocultar produtos oculta cartões promocionais. Os alertas de compras e presentes continuam.
• Retomar programação restaura as configurações salvas de primeiro produto ou rotação.

Defina os segundos de Mostrar/ocultar antes de usar um controle. Zero dura até ser alterado; 1–3600 restaura a programação salva após esse número de segundos. Substituições ao vivo são redefinidas quando o SSN reinicia. Linhas não salvas são marcadas e seus botões Mostrar agora ficam desativados até Salvar configuração. O status identifica o produto selecionado e mostra os segundos restantes; não afirma que o OBS esteja ao vivo nem que essa fonte esteja visível. Os controles identificam um produto pela URL salva exata, portanto movê-lo na lista não quebra uma automação.

3. Publique um link para o público

Abra Opções de exibição > Página pública para o público e escolha Publicar links salvos. Isso publica explicitamente todos os links de produtos/apoio salvos, incluindo títulos, imagens, preços e finalidades. Compartilhe Copiar link do público com seus espectadores. Os QR codes dos produtos agora usam essa página estável, para que o espectador ainda encontre um produto depois que a sobreposição alternar.

Alterações salvas e controles ao vivo atualizam a mesma URL. A página pública verifica atualizações a cada 15 segundos e identifica o produto em destaque. Ela mantém os outros links acessíveis quando os cartões promocionais estão ocultos. O último catálogo publicado permanece acessível enquanto o SSN está offline; o horário salvo é exibido, e destaque significa a última seleção ou rotação salva, não uma comprovação de que o criador esteja ao vivo.

Retirar publicação remove a página; os QR codes dos produtos voltam aos links individuais. Páginas públicas abertas são limpas na próxima verificação bem-sucedida. URLs já compartilhadas deixam de carregar até você publicar novamente. Publicar novamente pelo mesmo dispositivo restaura a mesma URL. Preserve o perfil do dispositivo SSN: sua chave privada de publicação é necessária para atualizar ou remover a página.

Se a API estiver indisponível, os controles locais continuam funcionando. Atualizações que falham deixam a última página publicada visível e são tentadas novamente enquanto o SSN estiver aberto. O popup informa a falha. A publicação exige que o serviço opcional de loja pública esteja implantado; nenhuma conta de loja ou pagamento é envolvida.

Event Flow e controles remotos

No Event Flow, adicione a ação Produtos e apoio no grupo de ações de sobreposição. Selecione Mostrar, Próximo, Ocultar ou Retomar; opcionalmente, defina a URL exata do produto salvo e os segundos. Use um gatilho existente apropriado, como seu próprio comando de moderador, em vez de permitir que toda mensagem de chat altere os produtos.

No plugin do Stream Deck, adicione teclas Comando predefinido a partir de Produtos e apoio: Mostrar produto, Próximo produto, Ocultar produtos e Retomar produtos. Mostrar inclui um seletor de produto salvo; escolha Atualizar produtos e estado para carregar a lista. Uma seleção salva indisponível permanece visível em vez de mudar silenciosamente. Você ainda pode colar a URL pública do produto ou deixá-la vazia para o produto atual/primeiro. Próximo e Ocultar aceitam segundos opcionais. As teclas aguardam o SSN confirmar a alteração local, independentemente das atualizações da página pública. Adicione a tecla opcional Estado do produto para mostrar seleção/ocultação/programação, atualizadas a cada cinco segundos enquanto a tecla está visível. O inspetor e o SSN mostram o nome completo do produto; a pequena tecla de estado abrevia nomes longos. Use a conexão P2P ou WebSocket existente.

A API remota existente de sessão autenticada aceita o mesmo controle:

{"action":"commerceControl","command":"show","url":"https://example.com/product","seconds":30}

Os comandos são show, next, hide e resume. Omita a URL para mostrar o produto atual/primeiro. Os controles do anfitrião precisam estar ativados. Nunca compartilhe uma URL privada de sessão/controle com os espectadores; use o link publicado para o público.

Estas ações transmitem apenas o estado existente monetization_update de exibição. Elas não criam doações, compras, publicações no chat nem gatilhos de pagamento do Event Flow. O comportamento existente de hasDonation continua igual.

Saiba quando um controle terminou

A ação Produtos e apoio aguarda a resposta do SSN antes de continuar o fluxo. Em payloads de eventos comuns, meta.commerceControlResult contém success e o resultado commerce de controle ou um estado error. Uma falha interrompe as ações seguintes nessa cadeia; a compra ou gorjeta original continua disponível para outros fluxos e sobreposições. O estado confirma a seleção, o estado oculto ou a programação do SSN; a visibilidade no OBS é independente.

Se nenhuma resposta chegar em oito segundos, a ação informa tempo esgotado. O controle ainda pode ter sido aplicado: confira o estado no popup ou dock antes de tentar Próximo novamente. Clientes remotos externos devem usar o protocolo existente de solicitação/resposta e verificar o resultado retornado, em vez de tratar o envio do comando como sucesso.

Outros efeitos têm seu próprio retorno. Imprimir etiqueta térmica informa meta.thermalPrintResult; o envio bem-sucedido de um trabalho não confirma a impressão em papel. Uma ação Webhook síncrona pode retornar o status HTTP e a resposta e pode bloquear em caso de falha. Esses são resultados de ações, não novos eventos de pagamento. Veja a referência de eventos para o contrato de resultado dos controles.