Où ça se passe
Tout se branche depuis le menu API Externe, la page Connexions. Elle est coupée en deux : Plateformes de stream en haut, Dons & boutique en dessous.
Tu peux en connecter plusieurs en même temps : les events de toutes tes plateformes alimentent le même timer. Chacune garde son propre barème dans Paramètres du Temps.
Twitch
Rien à faire : Twitch est branché dès ta connexion au site. Tes subs, subs offerts, ré-abonnements, bits, power-ups, raids et le début et la fin de tes lives remontent automatiquement.
Deux cas demandent quand même une reconnexion, en te déconnectant puis en te reconnectant avec Twitch :
- Les follows ne comptent pas et un avertissement apparaît dans Paramètres du Temps : l'autorisation de les lire est plus récente que ta dernière connexion.
- Tu as retiré l'autorisation de Marathon-Timer depuis ton compte Twitch.
YouTube
Clique sur Connecter dans la carte YouTube, puis choisis le compte Google de ta chaîne. Les Super Chats et les adhésions ajoutent alors du temps pendant tes lives.
Le bouton Déconnecter révoque aussi notre accès dans ton compte Google : plus rien n'est lu chez toi.
Kick
Clique sur Connecter dans la carte Kick et autorise l'application. Les abonnements, abonnements offerts et ré-abonnements Kick remontent ensuite comme ceux de Twitch, avec leur propre barème.
Streamlabs, TipeeeStream et StreamElements
Ces trois-là se branchent avec une clé à copier depuis leur site, dans la carte Dons & boutique :
- Streamlabs : le Socket API Token, dans les paramètres de compte, section API.
- TipeeeStream : ta clé d'API, dans la section développeur.
- StreamElements : le token JWT de ta chaîne, derrière l'affichage des secrets.
Une fois enregistrée, la clé n'est plus jamais réaffichée en entier : tu vois un masque. Pour en changer, colle simplement la nouvelle ; pour la retirer, vide le champ et enregistre.
Si le même don remonte par deux services à la fois, par exemple Tipeee et Streamlabs, il n'est compté qu'une seule fois.
Devise
La Devise locale, dans la même carte, sert à afficher tes dons et à les compter dans tes goals. Elle ne convertit rien : un don de 10 compte comme 10, quelle que soit la monnaie d'origine.
Ko-fi
Ko-fi n'a pas de bouton de connexion : il t'envoie ses events par une URL personnelle.
- Dans la carte Ko-fi, clique sur 📋 Copier pour récupérer ton URL.
- Sur Ko-fi, ouvre More → API → Webhooks et colle-la comme Webhook URL.
- Recopie le Verification token de cette page dans le champ prévu sur Marathon-Timer, puis enregistre.
Le token est facultatif mais recommandé : il garantit que seuls les envois de Ko-fi sont acceptés. Les dons, les abonnements, les commandes de boutique et les commissions ajoutent du temps.
Colle l'URL exactement telle qu'elle est copiée. Une adresse retapée à la main, sans le www, se fait rediriger et Ko-fi reçoit une erreur.
NineStore et autres boutiques
La carte NineStore te donne une URL de vente à coller dans ton tableau de bord de ventes : chaque vente ajoute alors du temps, sur la base du montant taxes comprises.
L'URL accepte une vente seule ou un lot de plusieurs ventes, ce qui permet de la brancher sur n'importe quel outil capable d'envoyer un montant et un nom d'acheteur.
TikTok
La carte TikTok ne demande que ton pseudo public. Les cadeaux, comptés en diamants, ajoutent du temps tant que la passerelle fonctionne. C'est une intégration non officielle, qui peut cesser de fonctionner sans prévenir.
Vérifier que ça marche
- Sur la plateforme concernée, provoque un petit event : un don d'un euro à toi-même, un sub offert, un Super Chat.
- Sur ton Tableau de bord, regarde l'activité récente : l'event doit y apparaître.
- S'il apparaît sans ajouter de temps, c'est ton barème qui est à
0pour cet event, pas la connexion.