AirlyHelpdesk

Appjes in beeld tonen

Keur een appje goed en toon het in je eigen overlay, bijvoorbeeld bij Visual Radio of op tv.

Voor redacteuren en techniciOnderdeel: AppjesBijgewerkt op
Waar in Airly/channels/:channelId/messages
Op deze pagina

Wil je Appjes van luisteraars afhandelen van luisteraars in beeld laten zien, bijvoorbeeld bij Visual Radio of in een tv-overlay? Dan keur je per appje goed wat in beeld mag. Je eigen overlay haalt alleen die appjes op.

Een appje goedkeuren#

  1. Ga bij je zender naar Appjes.
  2. Klik bij het appje op Goedkeuren, naast Gebruikt. Er staat nu Goedgekeurd.

Wil je het appje toch niet in beeld? Klik dan nog een keer op Goedgekeurd. Verwijder je een appje, dan is het ook uit de overlay weg.

Airly zet het appje niet zelf in beeld. Dat doet je eigen overlay. Die bepaalt ook hoe lang een appje blijft staan. Een goedgekeurd appje blijft beschikbaar tot je de goedkeuring weer weghaalt.

Je overlay koppelen#

Dit deel is voor wie de overlay maakt. Je hebt een beheerder nodig om de sleutel te maken. Meer over sleutels staat bij Een ander systeem koppelen met de API.

  1. Ga naar Instellingen › API en kies Nieuwe sleutel.
  2. Geef de sleutel alleen het recht Appjes in beeld.
  3. Haal de appjes op met deze sleutel in de kop x-api-key:
GET https://app.airly.nl/api/v1/public/channels/{zender-id}/messages/approved

Het zender-ID vind je bij Instellingen › Zenders: open de zender en kopieer het op het tabblad Algemeen.

Je krijgt een lijst terug, met de laatst goedgekeurde appjes bovenaan:

[
  {
    "id": "…",
    "channelId": "…",
    "senderName": "Anna",
    "content": "Groetjes aan iedereen in de studio!",
    "transcript": null,
    "imageUrl": null,
    "audioUrl": null,
    "source": "WHATSAPP",
    "createdAt": "2026-11-03T10:36:00.000Z",
    "approvedForAirAt": "2026-11-03T10:38:00.000Z"
  }
]
  • Telefoonnummer en e-mailadres staan hier nooit in.
  • transcript is de uitgeschreven tekst van een spraakbericht. Die heeft AI gemaakt.
  • source is AI als Airly het appje zelf heeft geschreven. Zo’n appje komt dus niet van een echte luisteraar.
  • Aantal: je krijgt er standaard 50, en met ?limit= hooguit 100. Met ?offset= haal je de volgende op. Het totaal staat in de kop X-Total-Count.

Goed om te weten#

  • Je kunt de lijst ook vanuit een browserbron ophalen, zoals in vMix of OBS. De sleutel staat dan wel in je overlay. Geef hem daarom alleen het recht Appjes in beeld.
  • Je omroep mag de API hooguit 250 keer per minuut aanroepen, voor alle sleutels samen. Elke 5 seconden ophalen is meestal genoeg.

Verder lezen

Dit artikel linkt naar

Hier naartoe gelinkt vanuit

Kom je er niet uit? Vraag het aan de beheerder van Airly bij jouw omroep. Die kan zo nodig contact opnemen met ons.