La funzionalità integrata di Simbase Limiti di utilizzo controllare l'utilizzo quando arrivano i CDR dalla rete, in genere ogni poche ore. Se è necessario controlli più rigorosi (ogni 30 minuti, ogni 5 minuti, su richiesta) oppure logica personalizzata (avviso in caso di allarme, disattivazione solo di determinate SIM, esclusione degli orari di lavoro), il Toolkit Usage Guard è una soluzione di automazione “no-code” che puoi realizzare autonomamente utilizzando l’API di Simbase e Make.com.

Questo articolo illustra le funzionalità del Toolkit, quando rappresenta la soluzione più adatta e come configurarlo.

Cosa fa il Toolkit

Un'automazione pianificata che:

1. Interroga l'API di utilizzo di Simbase per ogni SIM presente nel tuo account (o per un sottoinsieme filtrato).

2. Confronta l'utilizzo per ogni SIM rispetto a una soglia da te definita.

3. Disattiva le SIM che superano la soglia tramite l'API Simbase.

4. Ti avvisa (Slack, e-mail, webhook, registro di Google Sheets, qualsiasi cosa tu decida di collegare).

È basato su Make.com perché è visivo, non richiede la scrittura di codice e la maggior parte dei clienti riesce a renderlo operativo in meno di 15 minuti. La stessa logica funziona su Zapier, n8n o tramite uno script personalizzato. Make.com è semplicemente il percorso che Simbase ha documentato.

Quando il Toolkit è la soluzione giusta

Scegli il Toolkit al posto (o in aggiunta) dei limiti di utilizzo nativi quando hai bisogno di:

• Intervalli di controllo più brevi. I limiti di utilizzo nativi vengono applicati all'arrivo dei CDR; il Toolkit può essere eseguito tutte le volte che la piattaforma di automazione lo consente.

• Flussi di notifica personalizzati. Vuoi ricevere una notifica su Slack quando si raggiunge l'80% del limite massimo e disattivarla al 100%? Realizzala.

• Soglie a più livelli. Avvisare, quindi disattivare, quindi avvisare il personale operativo, il tutto in un unico flusso.

• Condizioni relative alle regole aziendali. Non disattivare il servizio nei fine settimana, ignorare determinati tag, disattivare solo le SIM di prova e così via.

• Integrazione tra sistemi. Sincronizza i dati di utilizzo con il tuo CRM, registra ogni evento di disattivazione in un data warehouse e così via.

Attenersi ai limiti di utilizzo predefiniti nei seguenti casi:

• Il comportamento predefinito (disattivazione al superamento del limite, con ripristino automatico mensile facoltativo) è proprio quello che ti serve.

• Non è consigliabile mantenere un sistema di automazione di terze parti.

• Non servono notifiche personalizzate né logica di business.

È possibile utilizzare entrambi: i limiti di utilizzo nativi fungono da riferimento, mentre il Toolkit gestisce i casi limite. Non vi è alcun conflitto.

Cosa non può fare il Toolkit

Stesso vincolo previsto dai limiti di utilizzo nativi: Dipende dai dati di utilizzo di Simbase, che dipende dall'arrivo dei CDR dalla rete. Un Toolkit che viene eseguito ogni 5 minuti continua a lavorare sulla base di CDR che potrebbero risalire a diverse ore prima.

Per avere un limite massimo effettivo in tempo reale, dovresti monitorare il consumo di dati sul dispositivo stesso e fare in modo che il dispositivo interrompa la connessione quando viene raggiunto il limite. Questo va oltre le possibilità di Simbase o Make.com.

Progetto

Se ti sembra complicato, non preoccuparti. Questo tutorial ti guiderà passo dopo passo nella creazione del tuo Usage Guard Toolkit. Non dovrai scrivere alcun codice e ti mostreremo esattamente come configurarlo utilizzando Make.com.

Configurazione del Toolkit

Fase 1: Scegli la tua piattaforma di automazione

Make.com è consigliato a chi lo utilizza per la prima volta:

• Generatore visivo di flussi, senza bisogno di scrivere codice.

• Il piano gratuito è sufficiente per le piccole flotte.

• I piani a pagamento sono pensati per flotte più grandi e intervalli più brevi.

Zapier, n8n, Pipedream o uno script personalizzato in Python/Node vanno tutti bene. Il resto di questa guida utilizza Make.com; gli stessi moduli e la stessa logica valgono anche in altri contesti.

Passaggio 2: Creare una chiave API Simbase

1. Accedi a dashboard.simbase.com.

2. Vai a Integrazioni → API.

3. Clicca Crea una nuova chiave API.

4. Dagli un nome Toolkit Usage Guard (o simili).

5. Imposta tutte le risorse su Scrivi. Lascia le impostazioni avanzate sui valori predefiniti.

6. Clicca Crea e copia la chiave.

Vedi Chiavi API per sapere cosa comprende ciascun livello di autorizzazione.

Fase 3: Importare il progetto da Make.com

Simbase pubblica un modello preconfigurato che puoi importare in un solo passaggio:

1. Scarica il progetto (cerca Simbase-Usage-Guard-Toolkit.blueprint.json, ~27 KB).

2. Su Make.com, crea un nuovo scenario.

3. Utilizzo Importa schema e selezionare il file JSON scaricato.

4. Apri ciascuno dei tre moduli HTTP e sostituisci il segnaposto YoUrApiKeYHeRe con la tua chiave API.

5. Regolare il soglia di utilizzo nel modulo di confronto (esempio predefinito: 10 GB).

6. Verifica manualmente lo scenario prima di attivare la pianificazione.

Il progetto gestisce il flusso di base: recupero dei dati di utilizzo → iterazione sulle SIM → verifica rispetto alla soglia → verifica dello stato attuale delle SIM → disabilitazione delle SIM che non sono già disabilitate.

Fase 4: Personalizza in base alle tue esigenze

Il progetto è un punto di partenza. Personalizzazioni più comuni:

• Conversione della soglia. L'API restituisce l'utilizzo in byte, in gigabyte binari: 1 GB = 1.073.741.824 byte, quindi 10 GB = 10.737.418.240. Questa convenzione non corrisponde a quella della dashboard, dove un limite di utilizzo di 1 GB corrisponde a 1.000 MB. Una soglia del Toolkit di 10 GB è approssimativamente superiore del 7% rispetto a un limite di utilizzo di 10 GB; se si desidera che i due valori coincidano, impostare invece il confronto del Toolkit su 10.000.000.000.

• Impaginazione. Sono necessarie circa 500 SIM. Vedi la sezione "Impostazione delle pagine" per le flotte di grandi dimensioni qui sotto.

• Notifiche. Aggiungi un modulo per inviare una notifica su Slack, via e-mail o tramite webhook quando una SIM supera la soglia.

• Filtro per tag. Applicare il controllo solo alle SIM con un tag specifico (ad esempio, produzione solo, escludere test).

Iterazione sull'array SIM

L'API di utilizzo restituisce un array di oggetti SIM presenti sotto il data.simcards campo. Per elaborarli singolarmente su Make.com:

1. Nel modulo HTTP, impostare Analizza la risposta a Sì.

2. Aggiungi un Iteratore modulo.

3. Imposta l'array dell'iteratore su data.simcards dalla risposta HTTP.

Ogni iterazione rappresenta quindi una singola SIM che puoi confrontare e su cui puoi intervenire.

Impaginazione per grandi flotte

Il modello non prevede l'impaginazione per impostazione predefinita. Funziona senza modifiche per flotte fino a qualche centinaio di SIM. Per flotte più grandi:

• Verifica la risposta dell'API per "has_more": true.

• Se vero, leggi il cursore valore.

• Invia un'altra richiesta a /v2/usage/simcards?cursor=<value>.

• Ripeti fino a quando has_more è falso.

In Make.com, ciò viene implementato con un Ripetitore e ciclo di richieste HTTP, che esula dall'ambito del progetto di base.

Dichiarazione di non responsabilità

Il kit di strumenti Usage Guard è fai-da-te. Sebbene utilizzi l'API ufficiale di Simbase, Simbase non si assume alcuna responsabilità per:

• Partite internazionali saltate a causa di ritardi nel CDR o nell'API.

• Le SIM non vengono disattivate in tempo.

• Eventuali eccedenze, costi o interruzioni del servizio che ne derivano.

Verificate attentamente la vostra configurazione, monitoratela regolarmente e non consideratela l’unica misura di protezione per le SIM in cui eventuali superamenti dei costi potrebbero avere conseguenze catastrofiche.

Domande frequenti

Correlati

• Limiti di utilizzo — l’alternativa nativa a basso attrito

• Disattivazione automatica — disattivazione in base al calendario

• Chiavi API — creare e definire l’ambito della chiave utilizzata dal Toolkit per l’autenticazione

• API — l'interfaccia sottostante

• Tag — utile per limitare l'ambito di applicazione del Toolkit a sottogruppi della flotta