Tutorial: op welke streamingsdienst staat deze film?

Hier is een stapsgewijze tutorial om de flow in te stellen zodat je snel kunt zien op welke streamingsdienst(en) jouw film staat. Deze flow ontvangt een WhatsApp-bericht met een titel (bijvoorbeeld een filmtitel), zoekt via de Streaming Availability API naar streamingopties en stuurt de resultaten terug naar WhatsApp. Als er geen opties zijn, krijg je een melding met alternatieven.

Stap 1: Stel de Trigger in – Ontvang een WhatsApp-bericht

1. Trigger: Begin de flow met de trigger Een nieuw bericht is ontvangen van de WhatsApp – Thuis app.
   • Deze trigger activeert de flow telkens wanneer er een nieuw bericht binnenkomt op je WhatsApp-account.

Stap 2: Controleer of het Bericht het Woord “Film” Bevat

1. Voeg een Logica-kaart toe om te controleren of de inhoud van het ontvangen WhatsApp-bericht het woord “film” bevat.
   • Gebruik hiervoor de kaart: Tekst bevat en stel deze in op “film”.
   • Als het bericht het woord “film” bevat, gaat de flow verder naar de volgende stappen. Dit helpt om de flow alleen te activeren voor berichten die om filminformatie vragen.

Stap 3: Maak een API-verzoek naar de Streaming Availability API

1. Ga naar https://rapidapi.com/ en log in met google of maak een account aan. zoek naar de api: Streaming Availability. Je kunt hier op op het basic plan subscriben, wat gratis is. Als je nu links naar workspace gaat en bij “My subscriptions” op “Streaming availability” klikt, kom je in de playground waar je jouw X-RapidAPI-key ziet. Deze heb je zometeen nodig.
2. Voeg een Logica-kaart toe om een GET-verzoek te maken naar de Streaming Availability API.
3. Gebruik de volgende URL als endpoint voor de API-aanroep: https://streaming-availability.p.rapidapi.com/shows/search/title?country=nl&title={Tekst}
4. Stel de parameter title gelijk aan de inhoud van het WhatsApp-bericht.
   • De URL moet je tekstvariabele bevatten (bijvoorbeeld &title={tekst}) om de titel in te vullen.
5. Voeg headers toe:
   • x-rapidapi-host: streaming-availability.p.rapidapi.com
   • x-rapidapi-key: [jouw API-sleutel]

Dit zal zoeken naar streamingopties voor de titel die is doorgegeven in het WhatsApp-bericht.

Stap 4: Verwerk het API-Antwoord

1. Voeg een Logica-kaart toe om het antwoord van de API als JSON te lezen.
   • Gebruik het pad [0].streamingOptions.nl om de Nederlandse streamingopties uit het JSON-resultaat te halen.
   • Dit zal helpen om de beschikbare streamingdiensten (zoals Netflix of Prime Video) in Nederland voor de opgegeven titel te achterhalen.

Stap 5: Controleer het Resultaat met HomeyScript

1. Voeg een HomeyScript-kaart toe om de JSON-resultaten te verwerken.
   • Het HomeyScript kan bijvoorbeeld controleren of er daadwerkelijk een resultaat is en de lijst met streamingopties omzetten naar tekst.
   • Laat het script een tekstwaarde retourneren die aangeeft op welke diensten de film beschikbaar is:

films = JSON.parse(args[0]);
// Variabele om de streamingdiensten te verzamelen
let streamingServices = new Set();

// Verwerken van de JSON-gegevens
films.forEach(item => {
    let serviceName = item.service.name;
    let link = item.link;
    streamingServices.add(serviceName + ": " + link);
});

 let resultString = Array.from(streamingServices).join('\n');

// Return de verzamelde streamingdiensten
return resultString;

Stap 6: Verstuur het Resultaat naar WhatsApp

1. Voeg een WhatsApp-kaart toe om de resultaten terug te sturen.
   • Als er streamingopties zijn gevonden: Verstuur een bericht met de streamingopties (zoals “Deze film is beschikbaar op Netflix en Videoland”).
   • Als er geen streamingopties zijn gevonden: Verstuur een bericht zoals “Geen streamingopties gevonden. Probeer Videoland of HBO Max.” Videoland zit helaas niet in de api, en HBO Max ook niet altijd.

Resultaat

Met deze flow kun je eenvoudig filminformatie opvragen door een WhatsApp-bericht te sturen met een titel. De flow zoekt automatisch naar beschikbare streamingopties en stuurt het resultaat terug naar je WhatsApp. Dit is handig om snel te checken waar je een film kunt kijken zonder zelf verschillende apps te hoeven doorzoeken.