WattWanneer koppelen aan Homey

Steeds vaker krijg ik de vraag of WattWanneer ook met Homey werkt. Meestal van mensen die ergens een Home Assistant-opstelling met stroomprijzen hebben zien draaien en dat ook wel willen, zonder er meteen een tweede hobby bij te nemen.

Het antwoord is ja, en hieronder staat hoe. Aan het eind heb je een Flow die je wasmachine, je auto of je thuisbatterij op de goedkoopste uren zet, op basis van onze voorspelling van zeven dagen vooruit. Er zijn vier use-cases en die werken los van elkaar, dus je hoeft alleen op te zetten wat je zelf hebt.

Waarom dit iets toevoegt

Om te beginnen wat Homey al zelf kan, want dat is meer dan je zou denken. Homey Energy ondersteunt dynamische prijzen en je kunt daar Flows op bouwen. Sinds augustus 2026 voorspelt het ook je zonneopwek voor vandaag en morgen. Heb je alleen de prijs van nu nodig, dan hoef je hier niets voor te installeren.

Het verschil zit in hoe ver vooruit. Homey Energy werkt met day-ahead prijzen: de uitkomst van de dagelijkse beursveiling, rond een uur of één 's middags bekend voor de dag erna. Daarmee plan je vanavond en morgen, en verder komt het niet. Wij voorspellen 168 uur vooruit, dus tot en met volgende week donderdag.

Dat maakt vooral uit bij dingen die kunnen wachten. Een auto die pas zaterdag weg hoeft, of een batterij die vanavond leeg mag omdat er overmorgen genoeg zon aankomt. Voor het uur dat nu loopt heb je ons niet nodig.

Dat tweede punt is minstens zo belangrijk als het eerste. Een lijst van 168 getallen is nog geen antwoord. Je moet er zelf je laadvermogen in verwerken, je laadverlies, de uren waarop je auto er niet is, en de vraag of het allemaal past voor je vertrekt. Dat rekenwerk halen wij eruit: je vraagt om een laadplan en je krijgt de blokken terug waarin geladen moet worden.

Voor zover ik kon nagaan zijn we daarmee het verst vooruitkijkende dat je in Homey kunt aansluiten. Er zijn wel meer diensten die verder dan de day-ahead gaan, dus ik houd het bij wat ik kan onderbouwen: zeven dagen, en er komt een plan uit in plaats van alleen een prijslijst.

Twee dingen die ik er eerlijk bij zeg. Dit is een voorspelling, dus voor uren verderop in de week klopt hij benaderend en niet exact. En dit is een HomeyScript-koppeling, geen app uit de Homey App Store. Dat betekent dat je code kopieert en plakt in plaats van dat je iets installeert. Een echte Homey-app is een mogelijke vervolgstap, afhankelijk van hoeveel mensen hier gebruik van gaan maken.

Ik beloof geen bedrag aan besparing. Wat je overhoudt hangt af van je verbruik, je contract en of je apparaten daadwerkelijk kunnen wachten. Ik beloof ook geen ondersteuning voor elke laadpaal: het laden zelf doet Homey via jouw eigen apparaatkoppeling, en die moet je dus al werkend hebben.

Wat je nodig hebt

Eerst dit: de basis opzetten

Stap 1. Installeer HomeyScript

Zoek in de Homey-app in de App Store op HomeyScript en installeer hem. Je beheert de scripts daarna via my.homey.app/script in je browser, wat een stuk prettiger typt dan op je telefoon.

Stap 2. Zet je tarief klaar

Elk script heeft bovenaan een blok met je persoonlijke tarief. Vul dat in, want zonder tarief krijg je alleen de kale beursprijs en dat is niet wat je betaalt. Een kale beursprijs van 2 cent voelt goedkoop, maar met energiebelasting en btw erbij betaal je er ruim 14.

Deze bedragen staan op je jaarafrekening of in de app van je leverancier. Weet je ze niet, begin dan met de waarden hierboven en pas ze later aan.

Wat wil je doen?

Klik open wat op jou van toepassing is. De vier use-cases werken los van elkaar, dus je hoeft niet alles op te zetten. Heb je alleen zonnepanelen, dan ben je klaar na de eerste en hoef je maar twee dingen in te vullen.

Handmatig overrulen

Wil je zelf de baas zijn, bijvoorbeeld omdat je onverwacht weg moet, maak dan twee kleine Flows met de kaart Run code van HomeyScript:

// Altijd laden, ongeacht het plan
global.set('wattwanneer_override', 'force_on');

// Nooit laden
global.set('wattwanneer_override', 'force_off');

// Terug naar het plan
global.set('wattwanneer_override', 'auto');

Vergeet niet om hem daarna weer op auto te zetten, want anders blijft je override staan.

De scripts

Maak op my.homey.app/script een nieuw script per stuk, met exact de naam die erboven staat, en plak de code erin. Bovenaan elk script staat één instellingenblok, en dat is het enige dat je hoeft aan te passen. Vul in ieder geval je API-key in.

wattwanneer-refresh

Haalt elk half uur de prijzen en het laadplan op en zet ze in Tags. Nodig voor use-case 1 en 2.

Download wattwanneer-refresh.js

Laden...

wattwanneer-check

Beslist lokaal of er nu geladen moet worden, zonder de API aan te roepen. Nodig voor use-case 2. Hier hoef je niets in te vullen.

Download wattwanneer-check.js

Laden...

wattwanneer-battery

Vraagt een batterijplan op en zet de eerstvolgende actie in Tags. Nodig voor use-case 3.

Download wattwanneer-battery.js

Laden...

Controleren of het werkt

Klik op Run bij wattwanneer-refresh. In het logvenster hoor je zoiets te zien:

Prijzen: 168 uur (34 markt, 134 voorspeld), status ok
Laadplan: 4 blokken, 33.33 kWh, 7.02 euro, haalbaar: true

Zie je een melding over een 401, dan klopt je key niet of loopt je abonnement niet meer. Onder problemen oplossen staat wat je dan doet.

De Tags

Na een geslaagde run staan deze Tags klaar in de Flow-editor, onder HomeyScript.

De drie waarden van laadstatus zijn bewust gescheiden. unavailable betekent dat we het niet weten, wat iets anders is dan wait. Een storing bij ons hoort niet automatisch je auto stil te zetten, en met de instelling bijGeenData bepaal jij wat er dan gebeurt.

Tags houden hun type vast zodra ze bestaan, dus een getal blijft een getal. De scripts schrijven daarom nooit een lege waarde weg, want dat zou de Tag verwijderen en elke Flow breken die hem gebruikt.

Wat er getest is, en wat niet

Eerlijk zijn over de status voorkomt teleurstelling. Dit is wat er daadwerkelijk gecontroleerd is en hoe.

Werkt iets bij jou wel of juist niet, dan hoor ik dat graag via contact. Dan kan deze tabel groeien met wat er in de praktijk blijkt.

Problemen oplossen

Foutmelding over een 401

De API herkent je key niet. Controleer of je hem volledig hebt geplakt, inclusief het ww_-begin en zonder spaties ervoor of erachter. Blijft het misgaan, dan is je abonnement mogelijk opgezegd of verlopen. Mail wattwanneer@negoci.nl en ik kijk mee.

Foutmelding over een 429

Je vraagt te snel achter elkaar op. De limiet voor deze endpoints staat op 20 aanvragen per minuut per key, wat neerkomt op ruim voldoende voor een Flow die elk half uur draait. Krijg je toch een 429, kijk dan of Flow A niet per ongeluk elke minuut loopt.

Deze limiet staat los van de limiet op de oudere v1-endpoints. Gebruik je WattWanneer ook in Home Assistant op dezelfde key, dan eten Homey en Home Assistant elkaars ruimte dus niet op.

De data is verouderd

Kijk naar de tag WattWanneer data-leeftijd min. Loopt die op boven de 180 minuten, dan is Flow A waarschijnlijk niet gedraaid. Controleer of de Flow aanstaat en draai het script een keer met de hand.

Wat er bij verouderde data gebeurt bepaal je zelf met bijGeenData bovenin het eerste script: wait laadt niet, charge laadt gewoon door en hold houdt de laatste stand aan.

De tijden lijken zes uur te vroeg

De tags laadstart en laadeinde staan in UTC, herkenbaar aan de Z aan het eind. In de zomer is dat twee uur eerder dan de klok in Nederland, in de winter één uur. De scripts rekenen intern met echte tijdstippen, dus je Flows kloppen wel. Alleen wat je op je scherm ziet staat in UTC.

Het laadplan is niet haalbaar

Staat er een tekort in WattWanneer tekort kWh, dan past de gevraagde energie niet in de beschikbare tijd. Drie dingen om na te lopen: klopt je vertrektijd, klopt je laadvermogen, en sluit je beschikbaarheidsvenster niet te veel uren uit. Met 3,7 kW duurt 50 kWh laden veertien uur, en dat past niet in één nacht.

Voorspellen is iets anders dan uitvoeren

Voor vandaag en morgen werkt de koppeling met gepubliceerde marktprijzen, die staan vast. Verder vooruit is het een voorspelling, en die schuift nog. Het plan wordt elk half uur opnieuw berekend, dus een blok dat er vanochtend in zat kan er vanavond uit zijn. In de response staat per blok of hij op een marktprijs of op een voorspelling berust.

Ik wil het handmatig kunnen bedienen

Gebruik de override hierboven. Zet hem op force_off als je een tijd helemaal niets automatisch wilt, en op auto als je weer terug wilt naar het plan. Je bestaande Flows en apparaten blijven gewoon werken, want de scripts bedienen zelf geen enkel apparaat.

Zakelijk gebruik

Het huishoudelijke abonnement is bedoeld voor je eigen huis. Verwerk je onze data in een product of dienst voor anderen, of draai je dit voor meerdere adressen, kijk dan op de pagina over zakelijk gebruik van de API.