De ingebouwde functie van Simbase Gebruiksbeperkingen controleer het gebruik zodra de CDR’s van het netwerk binnenkomen, meestal om de paar uur. Als je strengere controles (om de 30 minuten, om de 5 minuten, op aanvraag) of aangepaste logica (waarschuwing geven, alleen bepaalde simkaarten uitschakelen, kantooruren uitsluiten), de Usage Guard Toolkit is een ‘no-code’-automatisering die je zelf kunt bouwen met behulp van de Simbase API en Make.com.

In dit artikel wordt uitgelegd wat de Toolkit doet, wanneer deze de juiste oplossing is en hoe je hem instelt.

Wat de Toolkit doet

Een geplande automatisering die:

1. De gebruikers-API van Simbase opvragen voor elke simkaart in je account (of een geselecteerde subset daarvan)

2. Vergelijkt het gebruik voor elke simkaart, afgemeten aan een door jou vastgestelde drempelwaarde

3. Schakelt simkaarten uit die de drempelwaarde overschrijden via de Simbase-API

4. Houdt je op de hoogte (Slack, e-mail, webhook, Google Sheets-logboek, wat je ook aansluit)

Het is gebaseerd op Make.com omdat het visueel en ‘no-code’ is, en de meeste klanten het binnen 15 minuten aan de praat kunnen krijgen. Dezelfde logica geldt ook voor Zapier, n8n of een aangepast script. Make.com is gewoon de methode die Simbase heeft gedocumenteerd.

Wanneer de Toolkit de juiste oplossing is

Kies de Toolkit in plaats van (of naast) de standaard gebruikslimieten wanneer je het volgende nodig hebt:

• Kortere controle-intervallen. Native Limits worden uitgevoerd bij binnenkomst van een CDR; de Toolkit kan zo vaak worden uitgevoerd als je automatiseringsplatform toestaat

• Aangepaste meldingsstromen. Wil je een melding via Slack krijgen bij 80% van de limiet en deze uitschakelen bij 100%? Bouw het dan zelf

• Drempels op meerdere niveaus. Eerst waarschuwen, vervolgens uitschakelen en daarna de operatieteamleden op de hoogte brengen, allemaal in één werkstroom

• Voorwaarden voor bedrijfsregels. In het weekend deze functie niet uitschakelen, bepaalde tags negeren, alleen test-simkaarten uitschakelen, enzovoort

• Systeemoverschrijdende integratie. Synchroniseer het gebruik met je CRM, registreer elke uitschakeling in een datawarehouse, enzovoort

Houd je aan de standaard gebruikslimieten wanneer:

Het standaardgedrag (uitschakelen bij overschrijding van de limiet, optionele maandelijkse automatische reset) is precies wat je wilt.

• Je wilt geen automatisering van een derde partij onderhouden

• Je hebt geen aangepaste meldingen of bedrijfslogica nodig

Je kunt gebruikmaken van beide: de standaardgebruikslimieten van het systeem dienen als uitgangspunt, terwijl de Toolkit de uitzonderingsgevallen afhandelt. Er is geen sprake van tegenstrijdigheid.

Wat de Toolkit niet kan

Dezelfde beperking als de standaard gebruikslimieten: dat hangt af van de gebruiksgegevens van Simbase, wat afhankelijk is van de ontvangst van CDR’s vanuit het netwerk. Een Toolkit die om de 5 minuten wordt uitgevoerd, werkt nog steeds op basis van CDR’s die mogelijk al uren oud zijn.

Voor een echte realtime hard cap zou je het dataverbruik moeten bijhouden op het apparaat zelf en ervoor zorgen dat het apparaat de verbinding verbreekt zodra de limiet is bereikt. Dat valt buiten de mogelijkheden van Simbase of Make.com.

Blauwdruk

Als dit ingewikkeld lijkt, maak je dan geen zorgen. Deze handleiding leidt je stap voor stap door het samenstellen van je eigen Usage Guard Toolkit. Je hoeft geen code te schrijven, en we laten je precies zien hoe je het met Make.com kunt instellen.

De Toolkit installeren

Stap 1: Kies je automatiseringsplatform

Make.com wordt aanbevolen voor beginnende gebruikers:

• Visuele flow-builder, programmeren is niet nodig

• Het gratis pakket is voldoende voor kleine wagenparken

• Betaalde abonnementen zijn geschikt voor grotere wagenparken en kortere intervallen

Zapier, n8n, Pipedream of een zelfgemaakt Python-/Node-script werken allemaal. In de rest van deze handleiding wordt Make.com gebruikt; dezelfde modules en logica zijn ook elders van toepassing.

Stap 2: Maak een Simba aandeze API-sleutel

1. Log in op dashboard.simbase.com

2. Ga naar Integraties → API-sleutels

3. Klik API-sleutel aanmaken

4. Noem het maar op Usage Guard Toolkit (of iets dergelijks)

5. Inschakelen Schrijf toestemming. Laat de overige instellingen op de standaardinstellingen staan

6. Klik Aanmaken en kopieer de sleutel

Behandel de API-sleutel als een wachtwoord. Iedereen die deze sleutel heeft, kan je simkaarten beheren. Sla de sleutel op in de geheimen- of verbindingsbeheerder van je automatiseringsplatform, en niet in leesbare tekst.

Stap 3: Importeer de blauwdruk van Make.com

Simbase publiceert een vooraf geconfigureerde blauwdruk die je in één stap kunt importeren:

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

2. Maak in Make.com een nieuw scenario aan

3. Gebruik Blauwdruk importeren en selecteer het gedownloade JSON-bestand

4. Openen elk van de drie HTTP-modules en de plaatshouder vervangen YoUrApiKeYHeRe met je API-sleutel

5. Stel de gebruiksdrempel in de vergelijkingsmodule (standaardvoorbeeld: 10 GB)

6. Test het scenario handmatig voordat je het schema inschakelt

Het ontwerp beschrijft de basisworkflow: gebruiksgegevens ophalen → SIM-kaarten doorlopen → vergelijken met drempelwaarde → huidige status van SIM-kaarten controleren → SIM-kaarten uitschakelen die nog niet zijn uitgeschakeld.

Stap 4: Pas het aan uw behoeften aan

Het ontwerp is een uitgangspunt. Veelvoorkomende aanpassingen:

• Drempelomzetting. De API geeft het verbruik weer in bytes, in binaire gigabytes: 1 GB = 1.073.741.824 bytes, dus 10 GB = 10.737.418.240. Dit is niet dezelfde conventie als in het dashboard, waar een gebruikslimiet van 1 GB 1.000 MB betekent. Een drempelwaarde van 10 GB in de Toolkit is ongeveer 7% hoger dan een gebruikslimiet van 10 GB — als u wilt dat beide waarden overeenkomen, stelt u de vergelijkingswaarde in de Toolkit in op 10.000.000.000

• Paginering. Hierboven zijn ongeveer 500 simkaarten nodig. Zie hieronder ‘Paginering’ voor grote vloten.

• Meldingen. Voeg een module toe om een Slack-bericht, e-mail of webhook te versturen wanneer een SIM de drempelwaarde overschrijdt

• Tagfilter. Pas de controle alleen toe op simkaarten met een specifieke tag (bijvoorbeeld, productie alleen, uitsluiten test)

De SIM-array doorlopen

De gebruiks-API retourneert een array met SIM-objecten onder de data.simkaarten veld. Om ze afzonderlijk te verwerken in Make.com:

1. Stel in de HTTP-module het volgende in: Antwoord parseren naar Ja

2. Voeg een Iterator module

3. Stel de array van de iterator in op data.simkaarten uit het HTTP-antwoord

Elke iteratie is dan één SIM-kaart die je kunt vergelijken en waarop je actie kunt ondernemen.

Paginering voor grote wagenparken

De blauwdruk bevat standaard geen paginering. Deze werkt zonder aanpassingen voor vloten tot enkele honderden SIM-kaarten. Voor grotere vloten:

• Controleer het API-antwoord op "has_more": true

• Als dat klopt, lees dan de cursor waarde

• Dien nog een verzoek in bij /v2/usage/simcards?cursor=<value>

• Herhaal dit totdat has_more is onwaar

In Make.com wordt dit geïmplementeerd met een Repeater en een HTTP-verzoeklus, wat buiten het toepassingsgebied van het basisontwerp valt.

Disclaimer

De Usage Guard Toolkit is doe-het-zelf. Hoewel het gebruikmaakt van de officiële Simbase-API, Simbase aanvaardt geen aansprakelijkheid voor:

• Gemiste caps als gevolg van vertragingen bij CDR of API

• SIM-kaarten worden niet op tijd uitgeschakeld

• Hieruit voortvloeiende overschrijdingen, kosten of onderbrekingen van de dienstverlening

Test je opstelling zorgvuldig, houd deze regelmatig in de gaten en vertrouw er niet op als enige beveiliging voor SIM’s waarbij kostenoverschrijdingen catastrofaal zouden zijn.

Veelgestelde vragen

Gerelateerd

• Gebruiksbeperkingen, het alternatief dat van nature minder wrijving veroorzaakt

• Functie voor automatisch uitschakelen, uitschakeling op basis van de kalender

• API, de onderliggende interface

• Tags, handig om de Toolkit af te stemmen op subgroepen van de vloot