Rivendi numeri virtuali privati con l'API di SMS Activate App: compri sul tuo account al nostro prezzo, aggiungi il margine e servi i clienti da bot o sito.
Questa guida fa per te se vuoi offrire numeri virtuali privati ai tuoi clienti con un servizio white label, un bot Telegram o un piccolo sito. Spiega come funziona la configurazione, come fissare il prezzo di ogni numero, quali chiamate API ti servono, come funziona la fatturazione e dove finisce la nostra responsabilità.
Come funziona la rivendita
Hai un account su SMS Activate App e una chiave API. Con l'API compri i numeri su quell'account. Il tuo bot o sito mostra poi a ogni cliente il suo numero e i codici di verifica via SMS che vi arrivano.
Ogni numero è un vero numero mobile o locale preso dalla numerazione di un operatore, a seconda del paese. Il tuo account lo tiene per un periodo di 28 giorni. Riceve SMS e chiamate.
I tuoi clienti restano tuoi. Incassi tu i loro pagamenti, rispondi tu alle loro domande e fissi tu le condizioni. Non serve che abbiano un account da noi. Trovi altri dettagli su questo modello nella pagina per i rivenditori.
Fissa prezzo e margine
Il nostro prezzo cambia per numero e per paese. Lo leggi in tempo reale dall'API:
- GET /v1/public/countries restituisce per ogni paese minPriceCents, maxPriceCents e availableNumbers.
- GET /v1/public/numbers/search?country=US&limit=20 restituisce i numeri in vendita in quel momento. Il campo priceCents di ciascuno è il tuo prezzo.
Nell'API tutti gli importi sono in centesimi di dollaro USA, come numeri interi.
Il tuo prezzo è il nostro prezzo per quel numero più il tuo margine. Se un numero ti costa C e lo vendi a P, il margine è P meno C. La percentuale di margine è (P meno C) diviso P. Il ricarico è un valore diverso: (P meno C) diviso C. Il ricarico è sempre il più alto dei due, quindi decidi quale intendi prima di fissare un obiettivo.
Ricalcola dal prezzo in tempo reale a ogni vendita. Non usare un listino fisso, perché i prezzi possono cambiare da un paese all'altro. Non esistono sconti per rivenditori né fasce per volume: compri al prezzo normale, lo stesso che trovi nella pagina dei prezzi.
Metti in conto anche questi costi:
- Acquisti definitivi. Una volta emesso, un numero è definitivo e non rimborsabile, anche se una piattaforma lo rifiuta.
- Decisioni delle piattaforme. È la piattaforma, non noi, a decidere se accetta un numero. Fai verificare ai clienti che il numero funzioni per il loro servizio prima di affidarcisi, oppure includi questo rischio nel prezzo.
- Rinnovo automatico. Un numero si rinnova e viene addebitato ogni 28 giorni, a meno che tu non disattivi il rinnovo automatico.
- Commissioni di pagamento. Il tuo gestore dei pagamenti ti addebita una commissione su ogni pagamento dei clienti.
- Tempo di assistenza. I clienti ti faranno domande, e rispondere richiede il tuo tempo.
Il flusso API, passo per passo
L'URL di base è https://api.sms-activate.app/v1/public. Ogni chiamata, catalogo compreso, richiede la tua chiave nell'intestazione Authorization: Bearer vpn_xxx.
- Elenca i paesi. Chiama GET /countries per vedere quali paesi hanno numeri e con quale fascia di prezzo.
- Cerca i numeri. Chiama GET /numbers/search?country=US&limit=20 per vedere i numeri disponibili in un paese, ciascuno con il tuo prezzo in priceCents.
- Compra un numero. Chiama POST /numbers con il corpo JSON {"phone": "+15551234567", "country": "US"} e un'intestazione Idempotency-Key impostata su un UUID. Se in un nuovo tentativo invii la stessa chiave, non paghi due volte. Un acquisto riuscito restituisce 201 con il numero, chargedCents e balanceAfterCents. Due campi sono facoltativi: autoRenew (predefinito true) e note. Usa note per salvare il riferimento del tuo cliente.
- Leggi i codici. Chiama GET /numbers/{id}/sms per un singolo numero, oppure GET /sms per tutti i tuoi numeri. Entrambe usano la paginazione a cursore. Per ricevere i codici senza doverli chiedere, chiama PATCH /numbers/{id} con {"forwardWebhookUrl": "https://your-app.example.com/sms"}: da quel momento ogni SMS e ogni chiamata su quel numero vengono inviati al tuo server, firmati con HMAC-SHA256. Abbina ogni codice al cliente giusto prima di mostrarlo.
- Gestisci il periodo. Se un cliente non rinnova, chiama PATCH /numbers/{id} con {"autoRenew": false}. Per liberare un numero che non ti serve più, chiama DELETE /numbers/{id}.
Altre due chiamate ti aiutano con la contabilità. GET /balance restituisce il saldo in centesimi. GET /v1/me/transactions elenca il tuo estratto conto.
Gli errori hanno sempre la stessa forma: {"error": "<code>", "message": "...", "reqId": "..."}. Basa la logica sul codice error, non sullo stato HTTP. Alcuni rifiuti, come insufficientbalance, nonumbers e priceexceeded, sono risposte. Mostrali al cliente invece di ripetere la chiamata alla cieca. Con ratelimited, aspetta il tempo indicato dall'intestazione Retry-After.
La specifica completa è nel file OpenAPI, e la documentazione API spiega ogni chiamata.
Fatturazione: il tuo saldo presso di noi
I tuoi acquisti vengono pagati dal saldo del tuo account. Sul sito ricarichi in criptovaluta (USDT). Il bot Telegram accetta anche una carta bancaria in rubli e le Telegram Stars. Dopo che hai collegato il tuo account, entrambi usano un unico saldo.
Tieni un saldo sufficiente prima delle tue ore di punta. Un acquisto con saldo insufficiente viene rifiutato con insufficient_balance, e il cliente aspetta mentre ricarichi.
I prelievi vengono pagati solo in USDT (TRON, BSC o TON). Li fai in autonomia nel tuo account sul sito o nel bot Telegram: fino a 100 $ al giorno vengono pagati automaticamente in pochi minuti, e un importo maggiore lo paga l'assistenza a mano su richiesta. Il denaro pagato con carta, ricevuto come bonus o tramite trasferimento si può prelevare 180 giorni dopo l'accredito; le ricariche in cripto subito. Il minimo è 10 $. La commissione è il 10% dell'importo, ma non meno di 5 USDT, e viene trattenuta dall'importo.
I tuoi acquisti e il programma partner
Gli acquisti sul tuo account, o su qualsiasi account che controlli, non generano mai commissioni partner.
Alcuni clienti preferiranno avere un account tutto loro. Invia loro il tuo link partner. Guadagni così dal 10 al 30% del nostro margine (non del prezzo) sui loro acquisti e rinnovi, finché il loro account esiste; la quota sale con quante delle persone che hai portato hanno acquistato, dal 10% per i primi 3 acquirenti al 30% dall'acquirente 3001 in poi. Ogni commissione viene accreditata sul tuo saldo 30 giorni dopo l'acquisto. Trovi i dettagli nelle pagine del programma di affiliazione e dei rivenditori.
Assistenza
I tuoi clienti contattano te. Tu contatti noi. Una persona risponde via email a support@sms-activate.app o su Telegram a t.me/BestVoipTelegram, di solito entro 24 ore.
Non promettere ai clienti più di quanto promettiamo a te. Non promettiamo che ogni codice arrivi, e non promettiamo che una piattaforma accetti un numero. La maggior parte dei codici arriva entro pochi minuti da quando la piattaforma li invia. Di' ai clienti di provare un numero con il loro servizio prima di affidarcisi.
Video utili
Video di terzi su prezzi, bot Telegram e progettazione di API. Insegnano tecniche generali e non parlano del nostro servizio.
- Markup vs Margin, they are not the same thing! (Brad Flynn): la differenza tra ricarico e margine, con esempi numerici svolti.
- The 6 Components of a SaaS Pricing Model (Willingness to Pay): metrica, periodo, sconti e livello di prezzo di un modello di pricing.
- Aiogram Basics: Build Your First Telegram Bot with Python (Almaz | Coding): i concetti dei bot Telegram e un primo bot funzionante in Python.
- Build a Python Telegram Bot that Accepts Stars Payment (2025) (Nikandr Surkov): come incassare pagamenti in Telegram Stars dentro un bot Python.
- What is API Idempotency and Why Is It Important? (Be A Better Dev): perché un acquisto ripetuto non deve addebitare due volte, e come lo impedisce una chiave di idempotenza.
- Polling vs Webhooks | System Design Tradeoffs (SoftwareDude): quando chiedere nuovi dati a intervalli regolari e quando farteli inviare.
Inizia
- Crea un account gratuito nella pagina di registrazione.
- Crea una chiave API nella dashboard dell'account, nella scheda delle chiavi API.
- Leggi la documentazione API e il file OpenAPI.
- Controlla i prezzi in tempo reale nella pagina dei prezzi.
- Compra un numero e prova tutto il flusso dall'inizio alla fine prima di aprire le vendite.