Controllare il relay IRL tramite webhook

Il suo relay si può avviare, fermare o riavviare richiamando un indirizzo. Funziona da SAMMI, Streamer.bot, Bitfocus Companion o premendo un tasto su uno Stream Deck.

Caso tipico: ha più relay, ad esempio uno a casa e uno nel data center, e deve esserne attivo uno solo alla volta. Altrimenti NOALBS cambia scena due volte e i comandi chat come !start o !stop vengono eseguiti due volte.

Dove si trovano gli indirizzi

Nell'area clienti apra il relay in Streaming e clicchi su Genera indirizzi webhook nella scheda Controllo remoto del relay (webhook). Riceve cinque indirizzi, uno per azione, in questa forma:

https://vcontrol.glowfish.de:9786/api/v1/relay/SUA-CHIAVE/azione

Le cinque azioni

• start: attiva i servizi del relay.
• stop: ferma il relay. Tutti i servizi vengono chiusi (SRT, SRTLA, RIST, NOALBS e il chat bot), una trasmissione in corso si interrompe. Il relay è quindi fermato e attende start.
• neustart: riavvia tutti i servizi.
• allein: attiva questo relay e ferma tutti gli altri relay del suo account cliente.
• status: fornisce solo informazioni e non modifica nulla.

Chiamata e risposta

L'indirizzo si richiama con GET o POST, senza altri dati. L'azione ha effetto entro cinque secondi. La risposta arriva in JSON, ad esempio:

{"ok":true,"relay":"relay-0001","name":"Relay Zuhause","zustand":"aktiv","sendet":false,"letzte_meldung":"11.11.2026 07:30:12"}

Con una chiave sconosciuta l'indirizzo risponde con lo stato 404. Sono possibili al massimo 30 chiamate al minuto per relay.

Relay self-hosted

Con un relay sul suo server, dopo l'arresto nel container resta attivo solo un piccolo processo di controllo che attende start. Non serve accesso a Docker sul suo server.

Configurazione nei programmi più comuni

• SAMMI: Comando «HTTP Request», metodo GET, con l'indirizzo webhook come URL.
• Streamer.bot: Sub-action «Fetch URL» con l'indirizzo webhook.
• Bitfocus Companion: Modulo «Generic: HTTP Requests», azione GET con l'indirizzo webhook.
• Stream Deck: un plugin per richieste web, ad esempio «API Ready», metodo GET.

Passare da un relay all'altro: crei due tasti, ciascuno con l'indirizzo allein del relativo relay. Una pressione attiva il relay scelto e ferma l'altro.

Sicurezza

Chi conosce l'indirizzo può controllare il suo relay. Lo tratti come una password e non lo mostri mai nello stream. In caso di sospetto clicchi su Genera nuovi indirizzi webhook nell'area clienti. I vecchi indirizzi smettono subito di funzionare.

Inoltre la chiamata si può limitare a determinati indirizzi: nella scheda Controllo remoto del relay (webhook), in Consenti solo da indirizzi specifici (facoltativo), inserisca nel campo Indirizzi IP o reti consentiti singoli indirizzi IPv4 o IPv6 o reti con prefisso, separati da virgole, ad esempio 203.0.113.7, 198.51.100.0/24. Se il campo resta vuoto, la chiamata è possibile da ovunque. Il relay respinge le chiamate da altri indirizzi con lo stato 403 («Chiamata da questo indirizzo non consentita»).

Se l'indirizzo IP della sua connessione cambia, ad esempio a casa, un singolo indirizzo vale solo fino al cambio successivo. In tal caso è meglio inserire la rete del suo provider o lasciare il campo vuoto.

Come configurare il relay e ricevere lo stream in OBS è descritto in Configurare lo streaming IRL.