Een eigen verbruikslimiet bouwen met de Simbase Usage Guard Toolkit

De ingebouwde gebruikslimieten van Simbase controleren het verbruik zodra CDR's van het netwerk binnenkomen, meestal om de paar uur. Heb je strakkere controles nodig (elke 30 minuten, elke 5 minuten, op aanvraag) of eigen logica (melding bij een waarschuwing, alleen bepaalde SIM's uitschakelen, kantooruren uitsluiten)? Dan is de Usage Guard Toolkit een no-code automatisering die je zelf bouwt met de Simbase API en Make.com.

In dit artikel lees je wat de Toolkit doet, wanneer hij de juiste keuze is en hoe je hem instelt.

Wat de Toolkit doet

Een geplande automatisering die:

1. de usage API van Simbase uitleest voor elke SIM in je account (of een gefilterde selectie).

2. het verbruik vergelijkt per SIM met een drempel die je zelf bepaalt.

3. SIM's boven de drempel uitschakelt via de Simbase API.

4. jou een melding stuurt (Slack, e-mail, webhook, een log in Google Sheets, wat je maar koppelt).

Hij is gebouwd op Make.com omdat het visueel en no-code is en de meeste klanten hem binnen 15 minuten draaiend hebben. Dezelfde logica werkt in Zapier, n8n of een eigen script. Make.com is gewoon de route die Simbase heeft gedocumenteerd.

Wanneer de Toolkit de juiste keuze is

Kies de Toolkit in plaats van (of naast) de standaard gebruikslimieten als je dit nodig hebt:

• Kortere controle-intervallen. De standaard gebruikslimieten draaien zodra CDR's binnenkomen; de Toolkit draait zo vaak als je automatiseringsplatform toestaat.

• Eigen meldingsflows. Een Slack-bericht bij 80% van je limiet en uitschakelen bij 100%? Bouw het.

• Meerdere drempels. Waarschuwen, dan uitschakelen, dan ops alarmeren, allemaal in één flow.

• Voorwaarden op basis van bedrijfsregels. Niet uitschakelen in het weekend, bepaalde tags negeren, alleen test-SIM's uitschakelen, enzovoort.

• Koppeling met andere systemen. Verbruik synchroniseren met je CRM, elke uitschakeling loggen in een datawarehouse, enzovoort.

Blijf bij de standaard gebruikslimieten als:

• het standaardgedrag (uitschakelen bij overschrijding, optioneel maandelijks automatisch resetten) precies is wat je wilt.

• je geen automatisering bij een derde partij wilt onderhouden.

• je geen eigen meldingen of bedrijfslogica nodig hebt.

Je kunt ook allebei gebruiken: de standaard gebruikslimieten als basis en de Toolkit voor de uitzonderingen. Ze zitten elkaar niet in de weg.

Wat de Toolkit niet kan

Dezelfde beperking als bij de standaard gebruikslimieten: hij is afhankelijk van de verbruiksdata van Simbase, en die hangt af van wanneer CDR's van het netwerk binnenkomen. Een Toolkit die elke 5 minuten draait, werkt nog steeds met CDR's die uren oud kunnen zijn.

Voor een echte realtime harde limiet moet je het dataverbruik op het apparaat zelf bijhouden en het apparaat de verbinding laten verbreken zodra de limiet is bereikt. Dat valt buiten wat Simbase of Make.com kan leveren.

Blueprint

Ziet dit er ingewikkeld uit? Geen zorgen. Deze tutorial neemt je stap voor stap mee bij het bouwen van je eigen Usage Guard Toolkit. Je hoeft geen code te schrijven en we laten precies zien hoe je alles instelt in Make.com.

De Toolkit instellen

Stap 1: Kies je automatiseringsplatform

Doe je dit voor het eerst, dan raden we Make.com aan:

• Visuele flowbuilder, geen code nodig.

• De gratis versie is genoeg voor kleine vloten.

• Betaalde abonnementen kunnen grotere vloten en kortere intervallen aan.

Zapier, n8n, Pipedream of een eigen Python- of Node-script werken ook. De rest van deze handleiding gebruikt Make.com; dezelfde modules en logica gelden elders.

Stap 2: Maak een Simbase API-key aan

1. Log in op dashboard.simbase.com.

2. Ga naar Integrations → API.

3. Klik op Create New API Key.

4. Geef hem de naam Usage Guard Toolkit (of iets vergelijkbaars).

5. Zet All resources op Write. Laat de geavanceerde instellingen op hun standaardwaarden staan.

6. Klik op Create en kopieer de key.

Zie API-keys voor wat elk rechtenniveau omvat.

Stap 3: Importeer de Make.com-blueprint

Simbase biedt een kant-en-klare blueprint die je in één stap importeert:

1. Download de blueprint (zoek naar Simbase-Usage-Guard-Toolkit.blueprint.json, ~27 KB).

2. Maak in Make.com een nieuw scenario aan.

3. Gebruik Import Blueprint en selecteer het gedownloade JSON-bestand.

4. Open elk van de drie HTTP-modules en vervang de placeholder YoUrApiKeYHeRe door je API-key.

5. Pas de verbruiksdrempel aan in de vergelijkingsmodule (standaardvoorbeeld: 10 GB).

6. Test het scenario handmatig voordat je de planning inschakelt.

De blueprint regelt de basisflow: verbruik ophalen → over SIM's itereren → vergelijken met de drempel → huidige SIM-status controleren → SIM's uitschakelen die nog niet uitgeschakeld zijn.

Stap 4: Pas aan wat je nodig hebt

De blueprint is een startpunt. Veelgebruikte aanpassingen:

• Drempel omrekenen. De API geeft verbruik in bytes, in binaire gigabytes: 1 GB = 1.073.741.824 bytes, dus 10 GB = 10.737.418.240. Dat is een andere conventie dan in het dashboard, waar een gebruikslimiet van 1 GB gelijk is aan 1.000 MB. Een Toolkit-drempel van 10 GB ligt dus zo'n 7% hoger dan een gebruikslimiet van 10 GB. Wil je dat ze gelijk lopen, zet de vergelijking in de Toolkit dan op 10.000.000.000.

• Paginering. Nodig vanaf ongeveer 500 SIM's. Zie Paginering voor grote vloten hieronder.

• Meldingen. Voeg een module toe die een Slack-bericht, e-mail of webhook verstuurt zodra een SIM de drempel overschrijdt.

• Filter op tag. Voer de controle alleen uit voor SIM's met een bepaalde tag (bijvoorbeeld alleen production en niet test).

Over de SIM-array itereren

De usage API zet een array met SIM-objecten in het veld data.simcards van de respons. Om ze in Make.com een voor een te verwerken:

1. Zet in de HTTP-module Parse response op Yes.

2. Voeg een module Iterator toe.

3. Stel de array van de iterator in op data.simcards uit de HTTP-respons.

Elke iteratie is dan één SIM die je kunt vergelijken en verwerken.

Paginering voor grote vloten

De blueprint bevat standaard geen paginering. Voor vloten tot een paar honderd SIM's werkt hij zonder aanpassingen. Voor grotere vloten:

• Controleer de API-respons op "has_more": true.

• Is dat zo, lees dan de waarde van cursor uit.

• Doe een nieuwe request naar /v2/usage/simcards?cursor=<value>.

• Herhaal dit tot has_more false is.

In Make.com doe je dit met een Repeater en een HTTP-requestlus, wat buiten de basisblueprint valt.

Disclaimer

De Usage Guard Toolkit is doe-het-zelf. Hij gebruikt de officiële Simbase API, maar Simbase is niet verantwoordelijk voor:

• Gemiste limieten door vertraging in CDR's of de API.

• SIM's die niet op tijd worden uitgeschakeld.

• Overschrijdingen, kosten of serviceonderbrekingen die daaruit volgen.

Test je setup grondig, controleer hem regelmatig en vertrouw er niet op als enige beveiliging voor SIM's waarbij te hoge kosten rampzalig zouden zijn.

Veelgestelde vragen

Gerelateerd

• Gebruikslimieten: het standaard alternatief met minder gedoe

• Auto-disable: uitschakelen op basis van een datum

• API-keys: maak en beperk de key waarmee de Toolkit zich aanmeldt

• API: de onderliggende interface

• Tags: handig om de Toolkit tot een deel van je vloot te beperken