Guida completa all'utilizzo di RPO Check

Cos'e' il RPO

Il Registro Pubblico delle Opposizioni (RPO) e' un servizio istituito dal Governo italiano che consente ai cittadini di opporsi alla ricezione di chiamate telefoniche e comunicazioni postali a scopo di telemarketing.

Dal 27 luglio 2022, il RPO e' stato esteso a tutti i numeri telefonici nazionali, inclusi i cellulari. Gli operatori di telemarketing sono obbligati per legge a consultare il registro prima di effettuare campagne promozionali.

Come funziona la nostra piattaforma

RPO Check funge da intermediario tra la tua azienda e il portale ufficiale del RPO. Ecco cosa facciamo per te:

• Gestiamo l'autenticazione mTLS con il portale RPO (certificati client, token JWT)
• Forniamo un'API REST semplice per integrare le verifiche nel tuo software
• Generiamo automaticamente i certificati client necessari per la connessione
• Offriamo una dashboard web per verifiche manuali e upload CSV massivi

Step 1: Registrazione come Operatore RPO

Prima di utilizzare la nostra piattaforma, devi essere registrato come operatore sul portale ufficiale del RPO.

1. Vai su registrodelleopposizioni.it
2. Clicca su "Area Riservata" e poi "Registra Operatore"
3. Compila il modulo con i dati della tua azienda
4. Carica i documenti richiesti:
   • Visura camerale (non piu' vecchia di 6 mesi)
   • Documento di identita' del legale rappresentante
   • Modulo di adesione firmato digitalmente
5. Attendi la conferma di attivazione via email (solitamente 2-5 giorni lavorativi)

Step 2: Attivazione Utente Automatico

Una volta attivato come operatore, devi configurare l'Utente Automatico per consentire l'accesso programmatico alle API del RPO.

1. Accedi all'Area Riservata su registrodelleopposizioni.it
2. Nel menu laterale, clicca su "Utente Automatico"
3. Clicca su "Crea Utente Automatico"
4. Il sistema generera' automaticamente:
   • Username (es. UA_NOME_AZIENDA)
   • Password (una stringa alfanumerica)
5. Salva queste credenziali in un luogo sicuro: ti serviranno nel passaggio 4

Step 3: Generazione Certificato Client

Il portale RPO richiede l'autenticazione mTLS (mutual TLS) per le chiamate API. Questo significa che, oltre al normale HTTPS, il client deve presentare un certificato digitale al server.

La nostra piattaforma genera automaticamente il certificato client per te. Ecco come fare:

1. Accedi alla Dashboard → Certificati
2. Clicca su "Genera nuovo certificato"
3. Inserisci i dati richiesti (Common Name, Organizzazione)
4. Il sistema generera' il certificato e mostrera' il fingerprint
5. Copia il fingerprint del certificato
6. Vai nell'Area Riservata del portale RPO → Utente Automatico → Certificati
7. Incolla il fingerprint nel campo apposito e salva

Step 4: Configurazione nella piattaforma

Ora inserisci le credenziali dell'Utente Automatico nella nostra piattaforma:

1. Vai alla Dashboard → Credenziali RPO
2. Inserisci lo Username e la Password dell'Utente Automatico (ottenuti nello Step 2)
3. Seleziona l'ambiente:
   • Test: per verifiche di prova (usa il portale di test del RPO)
   • Produzione: per verifiche reali
4. Clicca "Salva"
5. Usa il pulsante "Testa connessione" per verificare che tutto funzioni

Step 5: Prima verifica

Sei pronto! Puoi verificare i numeri in due modi:

Utilizzo API

Ecco degli esempi rapidi per utilizzare le nostre API. Per la documentazione completa, consulta Swagger Docs.

1. Autenticazione

curl -X POST https://api.rpocheck.it/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "tuaemail@azienda.it",
    "password": "la_tua_password"
  }'

# Risposta:
# { "token": "eyJhbGciOiJIUzI1NiIs..." }

2. Invio numeri per verifica

curl -X POST https://api.rpocheck.it/api/v1/verify \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "numbers": ["+393331234567", "+393339876543"],
    "registry": "telefonico"
  }'

# Risposta:
# { "request_id": "abc-123", "status": "processing", "count": 2 }

3. Controllo stato

curl https://api.rpocheck.it/api/v1/verify/abc-123 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

# Risposta:
# { "request_id": "abc-123", "status": "completed", "results": [...] }

4. Risultati

curl https://api.rpocheck.it/api/v1/verify/abc-123/results \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

# Risposta:
# {
#   "results": [
#     { "number": "+393331234567", "registered": true },
#     { "number": "+393339876543", "registered": false }
#   ]
# }

Domande frequenti