Connecter les alertes en 5 étapes
- Ouvrir Monétisation → Alertes Fourthwall, Ko-fi et Buy Me a Coffee et choisissez votre Fournisseur.
- Cliquez sur Paramètre du récepteur et activez contrôle distant de l’extension par API (remote API control of extension).
- Revenez à Monétisation et cliquez sur Copier l’URL du webhook.
- Collez-la dans les paramètres de webhook du fournisseur (étapes ci-dessous).
- Laissez Social Stream Ninja en cours d'exécution.
Est-ce que ça fonctionne ? « Récepteur connecté » signifie uniquement que SSN est à l'écoute. La ligne du dernier événement s'actualise à l'arrivée d'un événement réel (elle est remise à zéro au redémarrage).
Gardez l'URL du webhook privée. C'est la seule protection de ces alertes (aucun secret de signature n'est vérifié). Suffisant pour les alertes, mais pas comme preuve de paiement pour expédier des commandes. Ne publiez jamais cette URL et ne l'utilisez pas dans un code QR.
Aperçu d’alerte d’exemple montre seulement l'apparence. Il ne modifie ni les totaux, ni Event Flow, ni votre webhook.
NinjaBacker, Throne, Amazon et eBay : consultez le guide de monétisation. Shopify : consultez Configurer Shopify.
Fourthwall
- Dans Fourthwall, ouvrez Paramètres → Pour les développeurs → Webhooks.
- Créez un webhook et collez l'URL Fourthwall fournie par SSN.
- Cochez les événements souhaités (voir le tableau).
- Enregistrez et laissez SSN en cours d'exécution.
| Événement Fourthwall | S'affiche comme |
|---|---|
ORDER_PLACED | Un achat. Sa valeur de don reste ajoutée pour conserver la compatibilité avec les anciennes configurations. |
GIFT_PURCHASE | Un cadeau. |
DONATION | Un don. |
SUBSCRIPTION_PURCHASED | Une nouvelle adhésion. |
Les commandes de cartes-cadeaux n'ajoutent pas leur valeur deux fois. Les événements de test sont ignorés.
documentation des webhooks Fourthwall · Aperçu d’un achat d’exemple
Ko-fi
- Ouvrir Webhooks Ko-fi.
- Collez l'URL Ko-fi fournie par SSN dans URL du webhook et enregistrez.
- Laissez SSN en cours d'exécution.
Les pourboires publics, adhésions, commandes de boutique et commissions utilisent ce même lien. Les paiements privés sont exclus. Les commandes et commissions apparaissent comme des achats et n'augmentent pas les totaux de dons. Ko-fi ne signale pas les adhésions résiliées.
Testez avec l'aperçu de SSN. Les paiements de test Ko-fi semblent réels et peuvent déclencher des alertes, des totaux et des actions. Ne les utilisez pas lorsque les récompenses payantes sont actives.
documentation des webhooks Ko-fi · Aperçu de soutien d’exemple
Buy Me a Coffee
- Dans votre tableau de bord créateur, ouvrez Intégrations et choisissez Nouveau webhook.
- Donnez-lui un nom et collez l'URL Buy Me a Coffee fournie par SSN.
- Cochez les événements souhaités (voir le tableau).
- Enregistrez et laissez l'envoi activé. En cas d'échec, consultez l'historique des livraisons à cet endroit.
| Événement | S'affiche comme |
|---|---|
donation.created | Un don. |
extra_purchase.created | Un achat. |
commission_order.created | Un achat. |
wishlist_payment.created | Une contribution à un cadeau. |
membership.started | L'annonce d'une nouvelle adhésion (pas un paiement distinct). |
Les notes masquées et les donateurs anonymes restent masqués. Les tests du tableau de bord (live_mode: false) sont ignorés. Les remboursements ne réduisent pas les totaux.
documentation des webhooks Buy Me a Coffee · Aperçu d’une contribution d’exemple
Importer un produit Fourthwall
- Dans Fourthwall, accédez à Paramètres → Pour les développeurs (Settings → For Developers) et créez un Token Storefront. N'utilisez pas de clé API d'administration.
- Dans SSN, ouvrez Produits et liens de soutien → Configurer les produits et liens → Importer un produit Fourthwall.
- Collez le lien public du produit et le jeton. Cliquez sur Charger les détails du produit.
- Vérifiez le nom, l'image, le prix et le lien. Le lien doit provenir de la même boutique que le jeton.
- Choisissez un objectif : Shop (Boutique), Gift (Cadeau), Support (Soutien) ou Join (Adhésion).
- Cliquez sur Ajouter un produit ou un lien, activez Produits et liens de soutien, puis cliquez sur Enregistrer la configuration.
Ce que fait l'importation
- Elle charge un produit public et disponible à la fois.
- Le jeton détermine la boutique recherchée. Il est utilisé une fois, puis effacé. Il n'est jamais enregistré ni envoyé aux overlays.
- Si les variantes ou les lots ont des prix différents, le prix reste vide.
- Il s'agit d'un instantané. Les prix, les stocks et les images ne se mettent pas à jour : réimportez ou modifiez-les lorsqu'ils changent.
- Vous pouvez enregistrer jusqu'à 20 produits. Ajouter à nouveau le même produit crée une deuxième copie.
Afficher des produits et des codes QR en direct
Vous pouvez aussi ajouter manuellement n'importe quel lien public (Shopify, Tiltify, Patreon, etc.). Cela ne connecte pas les alertes de paiement.
- Sous Overlay OBS pour, choisissez Produits et liens de soutien.
- Ouvrir Options du lien d’incrustation et choisissez une Vue de l'overlay: Vitrine de produits uniquement, Carte de soutien uniquement, Alertes d'activité uniquement, ou Vitrine et alertes.
- Cliquez sur Copier le lien OBS et ajoutez-le à OBS comme Source navigateur. Commencez avec 800 × 600. Utilisez une source par vue.
- Dans Options d'affichage, épinglez le premier produit ou faites-les défiler, puis activez Afficher le code QR.
- Scannez le code QR avec votre téléphone dans la disposition finale d'OBS.
Le code QR ne se scanne pas ? Ne réduisez pas et ne recadrez pas trop l'overlay. Pour partager un lien dans le chat, cliquez sur Copier le lien public.
Alertes, multi-alerts et Event Flow
- La vitrine affiche l'image du produit. La carte de soutien, plus petite, ne l'affiche pas.
- Les alertes d'activité fonctionnent seules et n'affichent jamais le code QR d'un produit sans rapport.
- Multi-alerts et le flux d'activité fonctionnent avec la même session, sans liste de produits. La vue d'activité de Monétisation nécessite l'activation de la liste de produits.
- Dans Event Flow, le déclencheur Donation couvre toujours les lignes contenant
hasDonation. Utilisez Event Type pour les achats ou les cadeaux finalisés. Consultez la correspondance des événements.
Changez de produit en direct ou partagez un lien unique avec les spectateurs : consultez commandes de produits en direct.
Si rien n’apparaît
| Problème | À essayer |
|---|---|
| Le récepteur est désactivé | Activez contrôle distant de l’extension par API (remote API control of extension). Les autres interrupteurs API ont d'autres fonctions. |
| Déconnecté | Gardez SSN ouvert et vérifiez votre connexion internet. Il s'agit de la connexion de SSN, pas de celle du fournisseur. |
| Aucun événement reçu | Vérifiez le fournisseur choisi, l'URL et les paramètres de webhook du fournisseur. |
| Événement ignoré | Les tests, les paiements privés, les événements non pris en charge et les montants invalides sont exclus. |
| Événement reçu, mais aucun overlay | Vérifiez la session, le mot de passe, les filtres, les règles SSN et la visibilité de la source OBS. La plupart des achats ne sont pas des dons. |
| Les alertes s'affichent deux fois | N'envoyez pas le même paiement à la fois par le fournisseur et par un autre service. |
| Échec de l'importation | Vérifiez le lien du produit, le jeton Storefront et que le produit est public et disponible. Vous pouvez toujours le saisir manuellement. |
Il s'agit d'un flux d'alertes en direct, pas d'un registre de commandes. Utilisez le tableau de bord du fournisseur pour les paiements, remboursements et expéditions. Les alertes Tiltify et Patreon ne sont pas encore prises en charge.