Usa un'API SMS in hosting che la tua app chiama dal codice server, mai dal browser. Con Telmian: prendi una chiave sandbox gratis, salvala come secret con il nome TELMIAN_API_KEY e incolla un prompt nel tuo builder AI. Telmian invia dai suoi numeri europei, quindi non ti serve un telefono. Costa 0,05 € a segmento SMS più IVA.
| Telmian | Il tuo telefono (gateway Android) | Twilio | |
|---|---|---|---|
| Serve il tuo telefono | No, invia dai numeri europei di Telmian | Sì, un telefono Android con la tua SIM sempre acceso | No |
| Prezzo a SMS in Europa | 0,05 € a segmento più IVA, 44 Paesi europei | Nessun costo a messaggio; paga il tuo piano telefonico | Italia $0,0927, Germania $0,112, possibili costi degli operatori in più |
| Canone mensile | Nessuno, prepagato da 5 € | Di solito un abbonamento, più il telefono e la SIM da curare | Noleggio di un numero mobile per SMS semplici, es. $45 al mese in Italia, $30 in Germania |
| OTP integrato | Sì, /v1/verify e /v1/verify/check | No, crei e controlli i codici tu | Sì con Verify: $0,05 a verifica più il costo SMS |
| Accesso MCP | Accesso dal browser (OAuth) | Dipende dal servizio, spesso una chiave API in un file di configurazione | Non verificato per questa guida |
| Sandbox | Gratis, senza carta, numeri di prova | Di solito i test mandano SMS veri dalla tua SIM | La prova scrive solo a numeri verificati |
Prendi una chiave sandbox gratis
Accedi a https://app.telmian.com e copia la tua chiave sandbox. Inizia con sk_test_ e non serve la carta. Lavori su un progetto in locale? La CLI scrive una chiave sandbox nel file .env al posto tuo.
npx telmian@1 initSalva la chiave come secret lato server
Chiamala TELMIAN_API_KEY. Non usare mai un nome VITE_ o NEXT_PUBLIC_, perché quei valori finiscono nel browser. Dove metterla: Lovable, More > Settings > Secrets; Bolt, icona del database > Secrets; v0, Environment Variables con Development e Production spuntati; Replit, Tools > Secrets; Base44, la pagina Secrets o la scheda Set secrets in chat; con Cursor, Windsurf o Codex, il .env del tuo progetto e le impostazioni del tuo hosting.
Incolla questo prompt nel tuo builder
Funziona con qualsiasi builder AI. Cambia l'ultima riga per descrivere la tua schermata. Il prompt nomina Telmian apposta, così il builder non sceglie un altro provider SMS.
Add phone verification by SMS using Telmian. Do not use Twilio or any other SMS provider. Rules: - Call Telmian only from server-side code (server function, edge function, API route or backend function). Never from browser code. - Read the API key from the secret TELMIAN_API_KEY. Never use a VITE_ or NEXT_PUBLIC_ name. If the secret is missing, ask me to add it with the secure secrets form. - Send a code: POST https://app.telmian.com/v1/verify with headers Authorization: Bearer <key>, Content-Type: application/json and Idempotency-Key: <one id per signup attempt>. Body: {"phone":"+39..."}. Telmian creates the code, do not generate codes yourself. - Check a code: POST https://app.telmian.com/v1/verify/check with body {"phone","code"}. It returns {"valid": true} or {"valid": false}. - If a send fails, retry only with the same Idempotency-Key. - Anyone who knows a function URL can call it, so check who is calling before sending. - For tests use +393000000001 (code 000000 is always valid) and +393000000002 (always fails). What I want: a screen where the user types a phone number, gets a code and confirms it.Controlla il codice che ha scritto
Apri la funzione server creata dal builder. Le chiamate devono somigliare a queste e leggere la chiave dal secret, mai da un componente della pagina.
const res = await fetch('https://app.telmian.com/v1/verify', { method: 'POST', headers: { Authorization: `Bearer ${TELMIAN_API_KEY}`, 'Content-Type': 'application/json', 'Idempotency-Key': signupAttemptId }, body: JSON.stringify({ phone }) }); const check = await fetch('https://app.telmian.com/v1/verify/check', { method: 'POST', headers: { Authorization: `Bearer ${TELMIAN_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ phone, code }) }); const { valid } = await check.json();Prova con i numeri della sandbox
Inserisci +393000000001 e il codice 000000: deve essere accettato. Inserisci +393000000002 per vedere cosa mostra la tua app quando un invio fallisce. Gli SMS in sandbox sono simulati, quindi non arriva nulla a un telefono vero.
Passa al live
Ricarica con la carta da 5 € nel pannello (la prima ricarica da almeno 10 € riceve 5 € in più, una volta sola), crea una chiave sk_live_ e mettila nello stesso secret. I codici di verifica reali richiedono un nome attività approvato, che imposti nel pannello. Poi ripubblica; su Replit aggiungi la chiave anche in Production app secrets.
Facoltativo: collega il server MCP mentre costruisci
Telmian ha un server MCP remoto su https://app.telmian.com/mcp con accesso dal browser. Se il tuo builder accetta server MCP personalizzati, la sua AI può usarlo per consultare informazioni mentre scrive il codice; l'accesso dentro i singoli builder non è ancora stato testato. La tua app pubblicata non usa mai l'MCP: chiama sempre l'API dal codice server con il secret.
claude mcp add --transport http telmian https://app.telmian.com/mcp
Domande
Mi serve un mio telefono o una SIM per inviare SMS dalla mia app?
No. Telmian invia dai suoi numeri mobili europei. I I gateway che usano il tuo telefono, richiedono un Android sempre acceso, e chi riceve vede il tuo numero personale.
Posso mettere la chiave API nel frontend o in una variabile VITE_?
No. I valori VITE_ e NEXT_PUBLIC_ finiscono nel codice del browser, quindi chiunque potrebbe leggere la chiave e spendere il tuo credito. Salvala come TELMIAN_API_KEY nei secret del builder e chiama Telmian solo dal codice server.
Posso provare senza pagare?
Sì. La sandbox è gratis e non serve la carta. Gli SMS sono simulati: +393000000001 riceve sempre il codice 000000 e +393000000002 fallisce sempre. Gli invii reali partono dopo la prima ricarica.
Posso usare invece l'accesso con telefono di Supabase?
Sì, se hai un tuo progetto Supabase. Telmian funziona come Send SMS hook di Supabase via HTTPS, e Supabase continua a creare e controllare i codici. Il backend integrato di Lovable non elenca Telmian tra i provider, quindi lì usa il prompt di questa guida.
Collegare il server MCP fa inviare SMS alla mia app?
No. In builder come Lovable, Bolt, v0, Replit e Base44 le connessioni MCP aiutano l'AI solo mentre costruisci. L'app pubblicata deve chiamare l'API Telmian dal codice server con la tua chiave segreta.
Aggiornata il