Automatisation des diffusions

PanoPaper peut prévenir un site web, un système domotique comme Home Assistant, un service de messagerie comme Slack ou Discord, ou un raccourci quand une diffusion commence et quand elle se termine, avec le lien pour la regarder - pour afficher un bouton « Regarder en direct » sur votre propre site web, par exemple, ou pour publier un message dans le canal de votre équipe.

Configurez-le dans Quand vous passez en direct : le bouton avec l’antenne, au bout des onglets des services dans Réglages ▸ Diffusion. Quand quelque chose est configuré, l’antenne s’affiche en couleur, et pointer le bouton indique ce qui est activé.

Webhook et raccourci

« Appeler un webhook » - PanoPaper envoie un message à une adresse web : votre propre serveur, un système domotique comme Home Assistant ou un service qui accepte les webhooks. Cliquez sur « Définir… » pour saisir ou coller l’adresse, et sur « Modifier… » pour la changer ; elle reste dans votre trousseau, car une telle adresse contient souvent un secret. « Tester » envoie aussitôt un message d’exemple et affiche la réponse du serveur. Si le serveur répond par une page web, l’adresse est sans doute celle d’un site plutôt que d’un webhook.
« Exécuter un raccourci » (édition web) - exécute le raccourci que vous choisissez en dessous, avec le même message en entrée : un petit fichier JSON, que le raccourci peut lire comme un dictionnaire.

Quand les messages partent

Un message « live » part dès que le service a accepté votre flux, et de nouveau chaque fois qu’un service s’ajoute ou s’arrête pendant qu’un autre continue ; « stopped » part quand le dernier s’arrête. Cliquer sur Arrêter le flux dans YouTube Studio n’arrête pas le flux de PanoPaper : rien n’est envoyé tant que vous n’arrêtez pas la diffusion dans PanoPaper.

Avec votre compte YouTube relié, un message « live » pour YouTube contient aussi les liens de la diffusion elle-même ; PanoPaper attend jusqu’à une demi-minute que YouTube signale la vidéo avant de l’envoyer. Pendant le direct, un message « viewers » part aussi chaque fois que le nombre de personnes qui regardent sur YouTube change ; PanoPaper vérifie toutes les cinq minutes.

Le message

PanoPaper envoie le message en HTTP POST avec le type de contenu application/json, en UTF-8, et l’agent utilisateur PanoPaper/ suivi de sa version. Toute réponse 2xx vaut réception, et le corps de la réponse n’est pas lu. Chaque tentative attend une réponse jusqu’à 15 secondes. Si le réseau fait défaut, ou si le serveur répond 408, 429 ou 5xx, PanoPaper réessaie après 5 secondes, puis une dernière fois 30 secondes plus tard ; les autres réponses ne donnent lieu à aucun nouvel essai, et « Tester » n’essaie qu’une fois. Les messages partent l’un après l’autre, dans l’ordre des événements, si bien qu’un « stopped » n’arrive jamais avant son « live ».

Un message « live » pour YouTube et Facebook, avec votre compte YouTube relié :

{
  "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 est en direct sur YouTube et Facebook : https://www.youtube.com/watch?v=AbCdEfGhIjK",
  "content" : "Port Dome est en direct sur YouTube et Facebook : https://www.youtube.com/watch?v=AbCdEfGhIjK"
}

Champ	Type	Contenu
`event`	chaîne	`live`, `stopped`, `viewers` ou `test`. Fiez-vous à ce champ, et non à `text`, pour savoir ce qui s’est passé.
`services`	tableau de chaînes	Les services : `YouTube`, `Facebook` et, pour un autre service, le nom de son serveur, par exemple `live.twitch.tv` (un nom de plus de 20 caractères est envoyé sous la forme « Serveur personnalisé », dans la langue de PanoPaper). Dans « live » et « viewers », tous les services à l’antenne à ce moment ; dans « stopped », ceux qui étaient à l’antenne ; dans « test », ceux qui sont prêts à passer en direct.
`watch`	chaîne (URL)	Le lien pour regarder : la page en direct de votre chaîne, `https://www.youtube.com/@<channel>/live` - ou, avec votre compte relié et « Rendre la diffusion publique » désactivé, la page propre à la diffusion, car une diffusion non répertoriée n’apparaît pas sur votre page en direct. Seulement quand YouTube fait partie des services et que votre Chaîne est indiquée, et dans « test » dès que votre Chaîne est indiquée.
`videoId`	chaîne	L’identifiant vidéo de la diffusion sur YouTube. Seulement avec votre compte YouTube relié, une fois que YouTube a signalé la vidéo : dans « live », « viewers » et « test », jamais dans « stopped ».
`video`	chaîne (URL)	La page de la diffusion elle-même, `https://www.youtube.com/watch?v=<videoId>`. Envoyé avec `videoId`.
`embed`	chaîne (URL)	La diffusion à afficher dans une page web, `https://www.youtube.com/embed/<videoId>`, comme adresse d’un `<iframe>`. Envoyé avec `videoId`.
`viewers`	entier	Le nombre de personnes qui regardent sur YouTube, tel que YouTube le compte. Seulement avec votre compte YouTube relié et une fois que PanoPaper a vérifié, environ une minute après le début de la diffusion : dans « viewers », et dans « live » et « test » tant qu’il est connu ; jamais dans « stopped ».
`camera`	chaîne	Le nom de la caméra tel que PanoPaper l’affiche : la caméra à l’antenne, et dans « stopped » la dernière qui l’était. Avec des caméras à tour de rôle, celle qui était à l’antenne à l’envoi du message - le passage à la caméra suivante n’envoie aucun message.
`time`	chaîne	Le moment où le message a été créé, en ISO 8601 et UTC, à la seconde près : `2026-10-20T14:03:12Z`.
`text`, `content`	chaîne	La même phrase deux fois, dans la langue de PanoPaper - dans « live », avec le lien de la diffusion elle-même s’il est connu, sinon la page en direct de votre chaîne : `text` est ce que Slack affiche comme message, `content` ce qu’affiche Discord. Elle est faite pour être lue par des personnes et sa formulation peut changer : n’en tirez donc aucune information.

Un champ sans valeur est omis, jamais envoyé vide ni comme null. Les champs peuvent arriver dans n’importe quel ordre, et les versions futures de PanoPaper pourront en ajouter : ignorez ceux que vous ne connaissez pas.

Garder l’adresse secrète

PanoPaper ne signe pas le message et n’y ajoute aucun mot de passe. Pour que seul PanoPaper puisse envoyer des messages à votre serveur, mettez un secret dans l’adresse elle-même, comme un long chemin aléatoire ou un jeton dans la chaîne de requête - les adresses de webhook de Home Assistant fonctionnent d’ailleurs déjà ainsi. C’est pourquoi l’adresse reste dans votre trousseau.

Dans un raccourci

Un raccourci reçoit le même JSON sous forme de fichier nommé d’après l’événement, par exemple « PanoPaper live.json ».

Raccourcis et Siri peuvent aussi lancer et arrêter une diffusion.