Conecta tu tienda. Muestra tus productos.

Los productos y las alertas son independientes

Usa Monetización en SSN para promocionar productos y páginas de apoyo públicos, recibir actividad o ambas cosas. Esta guía cubre Fourthwall, Ko-fi y Buy Me a Coffee. Para NinjaBacker, Throne, Amazon y eBay, consulta la guía de monetización.

Conectar alertas · Fourthwall · Ko-fi · Buy Me a Coffee · Importar un producto · OBS y códigos QR · Solución de problemas

Conectar alertas de actividad

1. Abrir Monetización → Alertas de Fourthwall, Ko-fi y Buy Me a Coffee y elige tu proveedor.
2. Haz clic en Ajuste del receptor. Habilita la opción existente de control remoto de la extensión mediante API (remote API control of extension) , y luego mantén SSN activado.
3. Vuelve a Monetización y haz clic en Copiar URL del webhook. Pega esta dirección privada en los ajustes de webhook de tu proveedor que se indican abajo.
4. Comprueba el estado del receptor. Receptor conectado significa que SSN está escuchando, no que se haya verificado la configuración del proveedor. La línea del último evento se actualiza cuando un evento del proveedor interpretado y no duplicado llega a esta aplicación en ejecución; se reinicia al volver a abrirla.
5. Usa Vista previa de alerta de ejemplo para comprobar la apariencia en una página de ejemplo aparte. Esto no envía un pago, actualiza los totales, ejecuta Event Flow ni verifica la entrega del webhook.

Estos tres puntos de recepción existentes con URL de sesión dependen de que la URL sea privada; la configuración actual de SSN no acepta sus secretos de firma. Son adecuados para alertas de transmisión, no como prueba de pago para preparar pedidos. No publiques la dirección del webhook ni la uses como destino del QR para espectadores.

Fourthwall

1. En Fourthwall, abre Ajustes → Para desarrolladores → Webhooks.
2. Crea un webhook y pega la URL de Fourthwall copiada de SSN.
3. Selecciona los eventos compatibles que necesites: ORDER_PLACED, GIFT_PURCHASE, DONATION y SUBSCRIPTION_PURCHASED.
4. Guarda el webhook y mantén SSN en funcionamiento.

Los pedidos aparecen como compras, los productos regalados como regalos y las nuevas suscripciones como membresías. Por compatibilidad, los pedidos normales de Fourthwall conservan su valor de donación existente. Los pedidos que canjean tarjetas de regalo no vuelven a sumar el valor pagado por adelantado. Los eventos marcados como prueba se omiten.

documentación de webhooks de Fourthwall · Vista previa de una compra de ejemplo

Ko-fi

1. Abrir Webhooks de Ko-fi.
2. Pega la URL de Ko-fi copiada de SSN en URL del webhook, y luego guárdalo o actualízalo.
3. Mantén SSN en funcionamiento. Las propinas públicas, pagos de membresía, pedidos de tienda y encargos usan la misma conexión.

Se excluyen los pagos privados. Los pagos de membresía aparecen como actividad de membresía; los pedidos de tienda y encargos aparecen como compras sin sumar a los totales de donaciones. Ko-fi no proporciona avisos de cancelación de membresía mediante este webhook.

Pruebas: usa primero la vista previa de ejemplo aislada de SSN. Los pagos de ejemplo de Ko-fi pueden parecer pagos reales y activar alertas, totales y acciones si se envían al receptor activo. No uses la prueba del proveedor en una sesión con recompensas de pago habilitadas.

documentación de webhooks de Ko-fi · Vista previa de apoyo de ejemplo

Buy Me a Coffee

1. Abrir Integraciones en el panel del creador y elige Nuevo webhook.
2. Dale un nombre y pega la URL de Buy Me a Coffee de SSN como dirección de destino.
3. Selecciona donation.created, extra_purchase.created, commission_order.created, wishlist_payment.created y membership.started según lo necesites.
4. Guarda y deja habilitada la entrega. Usa el historial de entrega de eventos del proveedor para investigar los fallos.

Los pedidos de tienda y encargos son compras. Los pagos de listas de deseos son aportaciones para regalos. Los inicios de membresía son anuncios de membresía, no cobros confirmados independientes. Las notas ocultas permanecen ocultas y los colaboradores anónimos siguen siendo anónimos. Las pruebas del panel marcadas como live_mode: false se omiten sin alertas de pago. Los reembolsos y las actualizaciones del ciclo de vida no crean pagos ni revierten los totales existentes.

documentación de webhooks de Buy Me a Coffee · Vista previa de una contribución de ejemplo

Importar un producto de Fourthwall

1. En la sección de Fourthwall Ajustes → Para desarrolladores (Settings → For Developers), crea un Token de Storefront. Usa el token de Storefront para acceder al catálogo público, no una clave administrativa de API.
2. En SSN, abre Productos y enlaces de apoyo → Configurar productos y enlaces → Importar un producto de Fourthwall.
3. Pega la URL pública del producto y el token, y luego haz clic en Cargar detalles del producto.
4. Revisa el nombre, la imagen, el precio y la URL pública cargados. Confirma que la URL pertenezca a la misma tienda que el token, incluido cualquier dominio personalizado. El token determina qué catálogo de tienda se consulta.
5. Elige Comprar, Regalar, Apoyar o Unirse para describir lo que harán los espectadores. Haz clic en Añadir producto o enlace, habilita Productos y enlaces de apoyo y luego Guardar configuración.

Esto importa un producto público disponible cada vez mediante la API Storefront de Fourthwall. El token se usa para esa solicitud, se borra después y no se guarda ni se envía a las superposiciones. Los precios de variantes diferentes y de lotes se dejan vacíos para no dar a entender que el total de compra es fijo. La importación es una instantánea: los precios, existencias e imágenes no se actualizan automáticamente. Vuelve a importar o edita cuando cambien. El catálogo admite hasta 20 entradas; añadir de nuevo crea otra entrada.

Crear un token de Storefront · Campos de producto de Fourthwall

Mostrar productos, enlaces públicos y códigos QR

También puedes introducir manualmente un enlace público de producto o apoyo de cualquier sitio, incluidos Shopify, Tiltify o Patreon. Añade una URL de imagen y un precio opcional, elige su finalidad, habilita el catálogo y guarda. Añadir un enlace no conecta un flujo de pagos.

1. Elige Productos y enlaces de apoyo en Enlace de superposición para.
2. Abrir Opciones del enlace de superposición. Elige Escaparate de productos, Tarjeta de apoyo, Alertas de actividad o la vista combinada.
3. Haz clic en Copiar enlace de OBS (Copy OBS link) y pégalo en una fuente de navegador de OBS. Empieza con 800 × 600. Para separar las capas promocionales y de actividad, crea una fuente para cada vista.
4. Usa Opciones de visualización para fijar el primer producto o rotar las entradas. Habilita los códigos QR para que los espectadores puedan escanear el destino público. Usa Copiar enlace público junto a una entrada para compartir tú mismo en el chat su dirección clicable.

El escaparate incluye la imagen del producto si se proporciona; la tarjeta de apoyo más pequeña la oculta. Las alertas de actividad funcionan de forma independiente y no adjuntan el QR de un producto en rotación que no esté relacionado. Mantén legible el enlace público y prueba el QR desde un teléfono mientras ves el diseño final en OBS. Cambiar la escala del enlace de OBS o recortar demasiado puede dificultar el escaneo.

Para multi-alerts o el feed de actividad, usa sus enlaces de superposición existentes con la misma sesión de SSN. No necesitas habilitar el catálogo de productos para estas superposiciones de actividad existentes. La vista genérica de actividad de Monetización requiere que el catálogo esté habilitado. En Event Flow, Donación sigue siendo el disparador para las filas con hasDonation; usa Tipo de evento para compras o regalos completados. Consulta la correspondencia de eventos.

Si no aparece nada

• Receptor desactivado: habilita el control remoto de la extensión mediante API. Los demás interruptores de API tienen otros usos.
• Desconectado: mantén SSN activado y comprueba el acceso a la red. Este estado indica la conexión del receptor compartido, no el estado de entrega del panel del proveedor.
• No se ha recibido ningún evento: revisa el proveedor seleccionado, la URL privada y los ajustes de entrega del proveedor. Que funcione la vista previa local solo comprueba la apariencia.
• Evento omitido: se excluyen las pruebas marcadas, los pagos privados, los tipos de evento no compatibles y los importes inválidos. No se muestran datos del comprador en el estado.
• Evento recibido, pero sin superposición: revisa la sesión/contraseña, los filtros de fuentes, las categorías de eventos, las reglas de SSN y la visibilidad en OBS. Las compras no son suscripciones; la mayoría de las compras no son donaciones.
• Duplicados: evita introducir el mismo pago tanto a través del proveedor directo como de un agregador. La deduplicación de reintentos usa los ID de entrega del proveedor.
• Error de importación: revisa el identificador del producto y el token de Storefront, y comprueba que el producto sea público y esté disponible. Sigue siendo posible introducirlo manualmente.

Esto es actividad de transmisión en vivo, no un registro de pedidos. Usa el panel del proveedor para confirmar pagos, gestionar reembolsos y preparar pedidos. Shopify ahora tiene su propia configuración de importación de productos y pedidos pagados con firma. La actividad de campañas de Tiltify y las membresías de pago de Patreon siguen siendo integraciones futuras.