SMS e messaggi

Filtro spam SMS

API · Pro2026-10-28

Copertura: iOS / Android

In questa pagina

A cosa serve

Su iPhone, attiva NoCall come filtro SMS nelle impostazioni di sistema di Messaggi e controlla lì i messaggi filtrati. L’estensione non filtra iMessage. Su Android, l’analizzatore esamina il testo condiviso: non legge automaticamente la posta in arrivo e non modifica la consegna degli SMS. Il sito non attiva il filtro del telefono.

Requisiti

Piano dello strumento: Gratis / Pro

Chiunque può leggere queste guide, senza account. Alcuni strumenti richiedono Pro, come indicato in ogni guida.

Come usarlo

Scarica l'app
Su iPhone apri l’attivazione SMS in NoCall e segui i passaggi nelle Impostazioni per selezionare il filtro. Su Android incolla un messaggio nell’analizzatore manuale. Controlla regole e sincronizzazione nell’app.
Su iPhone, attiva NoCall come filtro SMS nelle impostazioni di sistema di Messaggi e controlla lì i messaggi filtrati. L’estensione non filtra iMessage. Su Android, l’analizzatore esamina il testo condiviso: non legge automaticamente la posta in arrivo e non modifica la consegna degli SMS. Il sito non attiva il filtro del telefono.

Esempio inventato

Esempio inventato, non una ricerca reale. Non chiamare e non aprire i suoi link.

DHL: Ultimo avviso. Il tuo pacco è bloccato. Azione richiesta su https://parcel.example

Interpretare il risultato

Presenta alcuni segnali di truffa. Non aprire il link; verifica le informazioni direttamente sul sito o nell’app ufficiale.

Limiti

Risultato indicativo basato su segnali automatici, non sulla verifica del mittente. Nessun risultato garantisce che un messaggio sia sicuro.

Risoluzione dei problemi

Su iPhone apri l’attivazione SMS in NoCall e segui i passaggi nelle Impostazioni per selezionare il filtro. Su Android incolla un messaggio nell’analizzatore manuale. Controlla regole e sincronizzazione nell’app.

Usare con l’API

Richiede una API key e dei crediti. Ogni chiamata completata costa 1 credito, anche quando non ci sono dati. Un account Pro attivo include 20 crediti per mese solare UTC, condivisi da tutte le rotte API e consumati per primi; i crediti mensili non usati non passano al mese successivo. I crediti acquistati nella pagina del tuo account funzionano senza Pro e non scadono mai.

Gli errori non vengono mai addebitati: 401 invalid_api_key (chiave mancante o non valida), 403 pro_required (nessun credito Pro e nessun credito acquistato), 422 input non valido, 429 quota_exceeded (crediti esauriti), rate_limit_exceeded o ai_busy (l’IA di sms-check è al limite della capacità), 503 tool_warming (i dati sono ancora in preparazione) o tool o provider non disponibile. Dopo un 429 o un 503, riprova quando sono trascorsi i secondi indicati nell’intestazione Retry-After.

Versione, fonte e numero di regole del filtro SMS "Base NoCall" del paese. Solo i conteggi, mai le liste.

Invia il corpo JSON alla rotta specifica del tool, oppure a POST /v2/tools aggiungendo il campo tool. Entrambe le rotte restituiscono lo stesso risultato.

POST https://api.nocall.io/v2/sms-filter
POST https://api.nocall.io/v2/tools  {"tool":"sms-filter","country":"ES"}

Parametri

Nome	Tipo	Obbligatorio	Descrizione
country	string (enum, 55)	No (predefinito: "ES")	Paese di cui si usa il set di regole SMS.

REQUEST_ID="$(uuidgen)" && [ -n "$REQUEST_ID" ] &&
curl --request POST 'https://api.nocall.io/v2/sms-filter' \
  --header "Authorization: Bearer $NOCALL_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: $REQUEST_ID" \
  --data '{"country":"ES"}'

import json
import os
import urllib.request
import uuid

api_key = os.environ.get('NOCALL_API_KEY')
if not api_key:
    raise SystemExit('Set NOCALL_API_KEY')

request = urllib.request.Request(
    'https://api.nocall.io/v2/sms-filter',
    method='POST',
    data=json.dumps({'country': 'ES'}).encode(),
    headers={
        'Authorization': 'Bearer ' + api_key,
        'Content-Type': 'application/json',
        'Idempotency-Key': str(uuid.uuid4()),
    },
)
with urllib.request.urlopen(request, timeout=30) as response:
    result = json.load(response)
print(result['data']['result'], result['meta']['unitsCharged'])

import { randomUUID } from 'node:crypto';

const requestId = randomUUID();
const apiKey = process.env.NOCALL_API_KEY;
if (!apiKey) throw new Error('Set NOCALL_API_KEY');

const response = await fetch('https://api.nocall.io/v2/sms-filter', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + apiKey,
    'Content-Type': 'application/json',
    'Idempotency-Key': requestId,
  },
  body: JSON.stringify({ country: 'ES' }),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code ?? 'request_failed');
console.log(result.data.result, result.meta.unitsCharged);

Esempio di risposta (200)

Questo è l’esempio documentato nel riferimento API. Le ricerche usano un numero fittizio, mentre aggregati e risposte dell’IA mostrano la struttura del risultato, non dati reali.

{
  "data": {
    "tool": "sms-filter",
    "result": {
      "country": "ES",
      "version": "2026-03-10",
      "updatedAt": "2026-03-10T00:00:00.000Z",
      "source": "default",
      "counts": {
        "riskKeywords": 27,
        "brandKeywords": 13,
        "trustedDomains": 20,
        "shortenerDomains": 10,
        "blockedKeywords": 0
      }
    }
  },
  "meta": {
    "requestId": "req_example",
    "unitsCharged": 1,
    "usage": {
      "periodStart": "2026-10-01",
      "unitLimit": 20,
      "unitsUsed": 3,
      "unitsRemaining": 17
    }
  }
}

Campi del risultato (data.result)

Campo	Tipo	Descrizione
country	string	Paese del set di regole.
version	string	Versione del set di regole.
updatedAt	string \| null	Data dell’ultimo aggiornamento delle regole, oppure null.
source	"database" \| "legacy_default" \| "default" \| "empty"	Provenienza delle regole.
counts	object	Numero di regole in ciascuna lista. Le liste stesse non vengono mai restituite.

Riferimento API