Uitzendingen automatiseren

PanoPaper kan een website, domotica zoals Home Assistant, een chatdienst zoals Slack of Discord, of een opdracht laten weten wanneer een uitzending begint en eindigt, met de link om te kijken - om bijvoorbeeld een knop ‘Kijk live’ op je eigen website te tonen, of om een bericht in het kanaal van je team te plaatsen.

Stel het in bij Als je live gaat: de knop met de antenne aan het eind van de tabbladen van de diensten in Instellingen ▸ Uitzending. Is er iets ingesteld, dan is de antenne gekleurd, en als je naar de knop wijst, zie je wat er aan staat.

Webhook en opdracht

‘Roep een webhook aan’ - PanoPaper stuurt een bericht naar een webadres: je eigen server, domotica zoals Home Assistant of een dienst die webhooks aanneemt. Klik op ‘Stel in…’ om het adres te typen of te plakken en op ‘Wijzig…’ om het te veranderen; het blijft in je sleutelhanger, want zo’n adres bevat vaak een geheim. ‘Test’ stuurt meteen een voorbeeldbericht en toont het antwoord van de server. Antwoordt de server met een webpagina, dan is het adres waarschijnlijk een website en geen webhook.
‘Voer een opdracht uit’ (webeditie) - voert de opdracht uit die je eronder kiest, met hetzelfde bericht als invoer: een klein JSON-bestand dat de opdracht als woordenboek kan lezen.

Wanneer berichten uitgaan

Een bericht ‘live’ gaat uit zodra de dienst je stream heeft aangenomen, en opnieuw telkens als er een dienst bij komt of afhaakt terwijl een andere live blijft; ‘stopped’ gaat uit als de laatste stopt. Klikken op Stream beëindigen in YouTube Studio stopt de stream van PanoPaper niet; er wordt dus niets verstuurd tot je de uitzending in PanoPaper stopt.

Is je YouTube-account verbonden, dan bevat een bericht ‘live’ voor YouTube ook de eigen links van de uitzending; PanoPaper wacht maximaal een halve minuut tot YouTube de video meldt, voordat het het bericht verstuurt. Terwijl je live bent, gaat er ook een ‘viewers’-bericht uit zodra het aantal mensen dat op YouTube kijkt verandert; PanoPaper kijkt elke vijf minuten.

Het bericht

PanoPaper verstuurt het bericht als HTTP-POST met het contenttype application/json, in UTF-8, en de user-agent PanoPaper/ gevolgd door zijn versie. Elk antwoord 2xx telt als ontvangen; de inhoud van het antwoord wordt niet gelezen. Elke poging wacht tot 15 seconden op een antwoord. Als het netwerk uitvalt of de server met 408, 429 of 5xx antwoordt, probeert PanoPaper het na 5 seconden opnieuw en nog één keer 30 seconden daarna; na andere antwoorden volgt geen nieuwe poging, en ‘Test’ probeert het maar één keer. Berichten gaan na elkaar uit, in de volgorde waarin het gebeurde, dus een ‘stopped’ komt nooit aan vóór zijn ‘live’.

Een bericht ‘live’ voor YouTube en Facebook, met je YouTube-account verbonden:

{
  "event" : "live",
  "services" : [
    "YouTube",
    "Facebook"
  ],
  "watch" : "https://www.youtube.com/@yourchannel/live",
  "videoId" : "AbCdEfGhIjK",
  "video" : "https://www.youtube.com/watch?v=AbCdEfGhIjK",
  "embed" : "https://www.youtube.com/embed/AbCdEfGhIjK",
  "camera" : "Port Dome",
  "time" : "2026-10-20T14:03:12Z",
  "text" : "Port Dome is live op YouTube en Facebook: https://www.youtube.com/watch?v=AbCdEfGhIjK",
  "content" : "Port Dome is live op YouTube en Facebook: https://www.youtube.com/watch?v=AbCdEfGhIjK"
}

Veld	Type	Wat erin staat
`event`	string	`live`, `stopped`, `viewers` of `test`. Gebruik dit veld, niet `text`, om te zien wat er is gebeurd.
`services`	array van strings	De diensten: `YouTube`, `Facebook` en voor een andere dienst de naam van zijn server, zoals `live.twitch.tv` (een naam van meer dan 20 tekens wordt verstuurd als ‘Eigen server’, in de taal van PanoPaper). In ‘live’ en ‘viewers’ elke dienst die op dat moment in de lucht is; in ‘stopped’ de diensten die in de lucht waren; in ‘test’ de diensten die klaar zijn om live te gaan.
`watch`	string (URL)	De link om te kijken: de livepagina van je kanaal, `https://www.youtube.com/@<channel>/live` - of, met je account verbonden en ‘Uitzending openbaar maken’ uit, de eigen pagina van de uitzending, want een verborgen uitzending staat niet op je livepagina. Alleen zolang YouTube een van de diensten is en je Kanaal is ingevuld, en in ‘test’ altijd als je Kanaal is ingevuld.
`videoId`	string	De video-ID van de YouTube-uitzending. Alleen met je YouTube-account verbonden, zodra YouTube de video heeft gemeld: in ‘live’, ‘viewers’ en ‘test’, nooit in ‘stopped’.
`video`	string (URL)	De eigen pagina van de uitzending, `https://www.youtube.com/watch?v=<videoId>`. Wordt samen met `videoId` verstuurd.
`embed`	string (URL)	De uitzending om in een webpagina te tonen, `https://www.youtube.com/embed/<videoId>`, als adres van een `<iframe>`. Wordt samen met `videoId` verstuurd.
`viewers`	geheel getal	Hoeveel mensen er op YouTube kijken, zoals YouTube ze telt. Alleen met je YouTube-account verbonden en zodra PanoPaper heeft gekeken, ongeveer een minuut nadat de uitzending begint: in ‘viewers’, en in ‘live’ en ‘test’ zolang het aantal bekend is; nooit in ‘stopped’.
`camera`	string	De naam van de camera zoals PanoPaper die toont: de camera die in de lucht is, in ‘stopped’ de laatste die in de lucht was. Gaan camera's om de beurt, dan de camera die in de lucht was toen het bericht werd verstuurd - overschakelen naar de volgende camera verstuurt geen bericht.
`time`	string	Wanneer het bericht is gemaakt, in ISO 8601 en UTC, tot op de seconde: `2026-10-20T14:03:12Z`.
`text`, `content`	string	Twee keer dezelfde zin, in de taal van PanoPaper - in ‘live’ met de eigen link van de uitzending als die bekend is, anders met de livepagina van je kanaal: `text` is wat Slack als bericht toont, `content` wat Discord toont. De zin is bedoeld voor mensen en de formulering kan veranderen, dus haal er geen gegevens uit.

Een veld zonder waarde wordt weggelaten, nooit leeg of als null verstuurd. De velden kunnen in elke volgorde komen, en latere versies van PanoPaper kunnen velden toevoegen: sla de velden over die je niet kent.

Het adres geheim houden

PanoPaper ondertekent het bericht niet en voegt geen eigen wachtwoord toe. Om ervoor te zorgen dat alleen PanoPaper berichten naar je server kan sturen, zet je een geheim in het adres zelf, zoals een lang willekeurig pad of een token in de querystring - de webhookadressen van Home Assistant werken bijvoorbeeld al zo. Daarom blijft het adres in je sleutelhanger.

In een opdracht

Een opdracht krijgt dezelfde JSON als een bestand dat naar de gebeurtenis is genoemd, zoals ‘PanoPaper live.json’.

Ook Opdrachten en Siri kunnen live gaan en een uitzending stoppen.