Conecte os alertas em 5 etapas
- Abrir Monetização → Alertas de Fourthwall, Ko-fi e Buy Me a Coffee e escolha seu Provedor.
- Clique em Configuração do receptor e ative controle remoto da extensão por API.
- Volte a Monetização e clique em Copiar URL do webhook.
- Cole nas configurações de webhook do provedor (etapas abaixo).
- Mantenha o Social Stream Ninja em execução.
Está funcionando? “Receptor conectado” significa apenas que o SSN está escutando. A linha do último evento é atualizada quando chega um evento real (ela é zerada ao reiniciar).
Mantenha a URL do webhook privada. É a única proteção desses alertas (nenhum segredo de assinatura é verificado). Serve para alertas, mas não como comprovante de pagamento para enviar pedidos. Nunca publique essa URL nem a use em um código QR.
Prévia de alerta de exemplo mostra apenas a aparência. Não altera os totais, o Event Flow nem o webhook.
NinjaBacker, Throne, Amazon e eBay: consulte o guia de monetização. Shopify: consulte Configurar o Shopify.
Fourthwall
- No Fourthwall, abra Configurações → Para desenvolvedores → Webhooks.
- Crie um webhook e cole a URL do Fourthwall fornecida pelo SSN.
- Marque os eventos desejados (veja a tabela).
- Salve e mantenha o SSN em execução.
| Evento do Fourthwall | Aparece como |
|---|---|
ORDER_PLACED | Uma compra. Seu valor de doação continua sendo somado para manter a compatibilidade com configurações antigas. |
GIFT_PURCHASE | Um presente. |
DONATION | Uma doação. |
SUBSCRIPTION_PURCHASED | Uma nova assinatura. |
Os pedidos de cartões-presente não somam o valor duas vezes. Os eventos de teste são ignorados.
Documentação de webhooks do Fourthwall · Prévia de compra de exemplo
Ko-fi
- Abrir Webhooks do Ko-fi.
- Cole a URL do Ko-fi fornecida pelo SSN em URL do webhook e salve.
- Mantenha o SSN em execução.
Gorjetas públicas, assinaturas, pedidos da loja e encomendas usam este mesmo link. Pagamentos privados são excluídos. Pedidos e encomendas aparecem como compras e não somam aos totais de doações. O Ko-fi não informa assinaturas canceladas.
Teste com a prévia do SSN. Os pagamentos de teste do Ko-fi parecem reais e podem acionar alertas, totais e ações. Não os use enquanto recompensas pagas estiverem ativas.
Documentação de webhooks do Ko-fi · Prévia de apoio de exemplo
Buy Me a Coffee
- No painel de criador, abra Integrações e escolha Novo webhook.
- Dê um nome e cole a URL do Buy Me a Coffee fornecida pelo SSN.
- Marque os eventos desejados (veja a tabela).
- Salve e deixe o envio ativado. Se algo falhar, confira o histórico de entregas nesse painel.
| Evento | Aparece como |
|---|---|
donation.created | Uma doação. |
extra_purchase.created | Uma compra. |
commission_order.created | Uma compra. |
wishlist_payment.created | Uma contribuição para um presente. |
membership.started | Um anúncio de nova assinatura (não uma cobrança separada). |
As notas ocultas e os apoiadores anônimos continuam ocultos. Os testes do painel (live_mode: false) são ignorados. Os reembolsos não reduzem os totais.
Documentação de webhooks do Buy Me a Coffee · Prévia de contribuição de exemplo
Importar um produto do Fourthwall
- No Fourthwall, vá a Configurações → Para desenvolvedores e crie um Token Storefront. Não use uma chave de API de administrador.
- No SSN, abra Produtos e links de apoio → Configurar produtos e links → Importar um produto do Fourthwall.
- Cole o link público do produto e o token. Clique em Carregar detalhes do produto.
- Confira o nome, a imagem, o preço e o link. O link deve ser da mesma loja que o token.
- Escolha uma finalidade: Shop (Loja), Gift (Presente), Support (Apoio) ou Join (Participar).
- Clique em Adicionar produto ou link, ative Produtos e links de apoio, e clique em Salvar configuração.
O que a importação faz
- Carrega um produto público e disponível por vez.
- O token determina em qual loja pesquisar. Ele é usado uma vez e depois apagado. Nunca é salvo nem enviado às sobreposições.
- Se as variantes ou os pacotes tiverem preços diferentes, o preço fica em branco.
- É uma cópia daquele momento. Preços, estoque e imagens não são atualizados; importe novamente ou edite quando mudarem.
- Você pode salvar até 20 produtos. Adicionar o mesmo novamente cria uma segunda cópia.
Mostre produtos e códigos QR na transmissão
Você também pode adicionar manualmente qualquer link público (Shopify, Tiltify, Patreon etc.). Isso não conecta os alertas de pagamento.
- Em Sobreposição do OBS para, escolha Produtos e links de apoio.
- Abrir Opções do link da sobreposição e escolha uma Visualização da sobreposição: Somente vitrine de produtos, Somente cartão de apoio, Somente alertas de atividade ou Vitrine e alertas.
- Clique em Copiar link do OBS e adicione ao OBS como Fonte de navegador. Comece com 800 × 600. Use uma fonte por visualização.
- Em Opções de exibição, fixe o primeiro produto ou alterne entre eles e ative Mostrar código QR.
- Leia o código QR com o celular no layout final do OBS.
O código QR não é lido? Não reduza nem recorte demais a sobreposição. Para compartilhar um link no chat, clique em Copiar link público.
Alertas, multi-alerts e Event Flow
- A vitrine mostra a imagem do produto. O cartão de apoio menor não mostra.
- Os alertas de atividade funcionam sozinhos e nunca mostram o código QR de um produto sem relação com o evento.
- Multi-alerts e o feed de atividade funcionam na mesma sessão, sem precisar de uma lista de produtos. A visualização de atividade de Monetização exige que a lista de produtos esteja ativada.
- No Event Flow, o gatilho Donation continua incluindo as linhas com
hasDonation. Use Event Type para compras ou presentes concluídos. Consulte o mapeamento de eventos.
Troque de produto ao vivo ou compartilhe um único link com os espectadores: consulte controles de produtos ao vivo.
Se nada aparecer
| Problema | Tente isto |
|---|---|
| O receptor está desligado | Ative controle remoto da extensão por API. As outras opções de API têm funções diferentes. |
| Desconectado | Mantenha o SSN ligado e confira sua conexão à internet. Esta é a conexão do SSN, não a do provedor. |
| Nenhum evento recebido | Confira o provedor selecionado, a URL e as configurações de webhook do provedor. |
| Evento ignorado | Testes, pagamentos privados, eventos não compatíveis e valores inválidos são excluídos. |
| O evento chegou, mas a sobreposição não aparece | Confira a sessão, a senha, os filtros, as regras do SSN e se a fonte do OBS está visível. A maioria das compras não é doação. |
| Os alertas aparecem duas vezes | Não envie o mesmo pagamento pelo provedor e por outro serviço. |
| Falha na importação | Confira o link do produto e o token Storefront e se o produto é público e está disponível. Você sempre pode inseri-lo manualmente. |
Este é um feed de alertas ao vivo, não um registro de pedidos. Use o painel do provedor para pagamentos, reembolsos e envios. Alertas do Tiltify e Patreon ainda não são compatíveis.