Conecte sua loja. Mostre seus produtos.

Produtos e alertas são separados

Use Monetização no SSN para promover produtos públicos e páginas de apoio, receber atividades ou ambos. Este guia cobre Fourthwall, Ko-fi e Buy Me a Coffee. Para NinjaBacker, Throne, Amazon e eBay, veja o guia de monetização.

Conectar alertas · Fourthwall · Ko-fi · Buy Me a Coffee · Importar um produto · OBS e QR codes · Solução de problemas

Conectar alertas de atividade

1. Abrir Monetização → Alertas de Fourthwall, Ko-fi e Buy Me a Coffee e escolha seu provedor.
2. Clique em Configuração do receptor. Ative a opção existente controle remoto da extensão por API e mantenha o SSN ligado.
3. Volte a Monetização e clique em Copiar URL do webhook. Cole esse endereço privado nas configurações de webhook do provedor abaixo.
4. Confira o status do receptor. Receptor conectado significa que o SSN está ouvindo, não que a configuração do provedor foi verificada. A linha do último evento é atualizada quando um evento do provedor interpretado e não duplicado chega a este aplicativo em execução; ela é redefinida ao reiniciar.
5. Use Prévia de alerta de exemplo para conferir a aparência em uma página separada de exemplo. Isso não envia pagamentos, atualiza totais, executa o Event Flow nem verifica a entrega de webhooks.

Estes três endpoints existentes com URL de sessão dependem de manter a URL privada; a configuração atual do SSN não aceita seus segredos de assinatura. Eles são adequados para alertas de transmissão, não como comprovante de pagamento para atender pedidos. Não publique o endereço do webhook nem o use como destino de QR code para o público.

Fourthwall

1. No Fourthwall, abra Configurações → Para desenvolvedores → Webhooks.
2. Crie um webhook e cole a URL do Fourthwall copiada do SSN.
3. Selecione os eventos compatíveis necessários: ORDER_PLACED, GIFT_PURCHASE, DONATION e SUBSCRIPTION_PURCHASED.
4. Salve o webhook e mantenha o SSN em execução.

Pedidos aparecem como compras, presentes de produtos como presentes e novas assinaturas como membros. Para compatibilidade, pedidos comuns do Fourthwall ainda carregam seu valor de doação existente. Pedidos de resgate de cartões-presente não somam novamente o valor pré-pago. Eventos marcados como teste são ignorados.

Documentação de webhooks do Fourthwall · Prévia de compra de exemplo

Ko-fi

1. Abrir Webhooks do Ko-fi.
2. Cole a URL do Ko-fi copiada do SSN em URL do webhook, depois salve/atualize.
3. Mantenha o SSN em execução. Gorjetas públicas, pagamentos de membros, pedidos da loja e encomendas usam a mesma conexão.

Pagamentos privados são excluídos. Pagamentos de membros aparecem como atividade de membros; pedidos da loja e encomendas aparecem como compras sem aumentar os totais de doações. O Ko-fi não fornece notificações de cancelamento de assinatura por este webhook.

Testes: use primeiro a prévia isolada de exemplo do SSN. Pagamentos de exemplo do Ko-fi podem se parecer com pagamentos reais e disparar alertas, totais e ações se enviados ao receptor ativo. Não use o teste do provedor em uma sessão com recompensas pagas ativadas.

Documentação de webhooks do Ko-fi · Prévia de apoio de exemplo

Buy Me a Coffee

1. Abrir Integrações no painel do criador e escolha Novo webhook.
2. Dê um nome e cole a URL do Buy Me a Coffee fornecida pelo SSN como endpoint.
3. Selecione donation.created, extra_purchase.created, commission_order.created, wishlist_payment.created e membership.started conforme necessário.
4. Salve e deixe a entrega ativada. Use o histórico de entrega de eventos do provedor para investigar falhas.

Pedidos de loja e encomendas são compras. Pagamentos de lista de desejos são contribuições para presentes. Inícios de assinatura são anúncios de membros, não cobranças confirmadas separadas. Notas ocultas permanecem ocultas e apoiadores anônimos permanecem anônimos. Testes do painel marcados como live_mode: false são ignorados sem alertas pagos. Reembolsos e atualizações do ciclo de vida não criam pagamentos nem revertem totais existentes.

Documentação de webhooks do Buy Me a Coffee · Prévia de contribuição de exemplo

Importar um produto do Fourthwall

1. No Fourthwall, em Configurações → Para desenvolvedores, crie um Token Storefront. Use o token Storefront para acesso ao catálogo público, não uma chave de API administrativa.
2. No SSN, abra Produtos e links de apoio → Configurar produtos e links → Importar um produto do Fourthwall.
3. Cole a URL pública do produto e o token e clique em Carregar detalhes do produto.
4. Confira nome, imagem, preço e URL pública carregados. Confirme que a URL pertence à mesma loja do token, incluindo qualquer domínio personalizado. O token determina qual catálogo de loja é consultado.
5. Escolha Loja, Presente, Apoio ou Participar para descrever o que os espectadores farão. Clique em Adicionar produto ou link, ative Produtos e links de apoio, depois Salvar configuração.

Isso importa um produto público disponível por vez pela Storefront API do Fourthwall. O token é usado nessa requisição, limpo depois e não é salvo nem enviado às sobreposições. Preços diferentes de variantes e pacotes ficam vazios para não sugerir um total fixo no checkout. A importação é um registro pontual: preços, estoque e imagens não são atualizados automaticamente. Importe novamente ou edite quando mudarem. O catálogo comporta até 20 entradas; adicionar novamente cria outra entrada.

Crie um token Storefront · Campos de produto do Fourthwall

Mostrar produtos, links públicos e QR codes

Você também pode inserir manualmente um link público de produto ou apoio de qualquer site, incluindo Shopify, Tiltify ou Patreon. Adicione uma URL de imagem e um preço opcional, escolha a finalidade, ative o catálogo e salve. Adicionar um link não conecta um feed de pagamentos.

1. Escolha Produtos e links de apoio em Link da sobreposição para.
2. Abrir Opções do link da sobreposição. Escolha Vitrine de produtos, Cartão de apoio, Alertas de atividade ou a visualização combinada.
3. Clique em Copiar link do OBS e cole em uma Fonte de navegador do OBS. Comece com 800 × 600. Para camadas separadas de promoção e atividade, crie uma fonte para cada visualização.
4. Use Opções de exibição para fixar o primeiro produto ou alternar as entradas. Ative QR codes para os espectadores escanearem o destino público. Use Copiar link público ao lado de uma entrada para compartilhar você mesmo o endereço clicável no chat.

A vitrine inclui a imagem do produto quando fornecida; o cartão de apoio menor a oculta. Alertas de atividade funcionam independentemente e não usam o QR code de um produto sem relação que esteja na rotação. Mantenha o link público legível e teste o QR pelo celular na visualização final do OBS. Alterar a escala do link do OBS ou recortar demais pode dificultar a leitura.

Para Multi Alerts ou o feed de atividades, use os links existentes das sobreposições com a mesma sessão do SSN. Você não precisa ativar o catálogo de produtos para essas sobreposições de atividade existentes. A visualização genérica de atividade de Monetização exige o catálogo ativado. No Event Flow, Doação continua sendo o gatilho para linhas com hasDonation; use Tipo de evento para compras ou conclusão de presentes. Veja o mapeamento de eventos.

Se nada aparecer

• Receptor desligado: ative o controle remoto da extensão por API. Outras opções de API têm usos diferentes.
• Desconectado: mantenha o SSN ligado e confira o acesso à rede. Este status é da conexão compartilhada do receptor, não o status de entrega do painel do provedor.
• Nenhum evento recebido: confira o provedor selecionado, a URL privada e as configurações de entrega do provedor. O sucesso da prévia local verifica apenas a aparência.
• Evento ignorado: testes identificados, pagamentos privados, tipos de evento incompatíveis ou valores inválidos são excluídos. Nenhum detalhe do comprador é exibido no status.
• Evento recebido, mas sem sobreposição: confira sessão/senha, filtros de fonte, categorias de eventos, regras do SSN e visibilidade no OBS. Compras não são inscrições; a maioria das compras não é doação.
• Duplicatas: evite enviar o mesmo pagamento tanto pelo provedor direto quanto por um agregador. A deduplicação de novas tentativas usa os IDs de entrega do provedor.
• A importação falhou: confira o slug do produto e o token Storefront e se o produto é público e está disponível. A entrada manual continua disponível.

Isto é atividade de transmissão ao vivo, não um registro de pedidos. Use o painel do provedor para confirmar pagamentos, fazer reembolsos e atender pedidos. O Shopify agora tem sua própria configuração de importação de produtos e pedidos pagos assinados. Atividades de campanhas do Tiltify e membros pagos do Patreon continuam sendo integrações futuras.