← Tutte le guide

Aggiungere SMS a un'app creata con l'AI: 3 passi

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, gateway con il tuo telefono e Twilio a confronto per app create con l'AI
TelmianIl tuo telefono (gateway Android)Twilio
Serve il tuo telefonoNo, invia dai numeri europei di TelmianSì, un telefono Android con la tua SIM sempre accesoNo
Prezzo a SMS in Europa0,05 € a segmento più IVA, 44 Paesi europeiNessun costo a messaggio; paga il tuo piano telefonicoItalia $0,0927, Germania $0,112, possibili costi degli operatori in più
Canone mensileNessuno, prepagato da 5 €Di solito un abbonamento, più il telefono e la SIM da curareNoleggio di un numero mobile per SMS semplici, es. $45 al mese in Italia, $30 in Germania
OTP integratoSì, /v1/verify e /v1/verify/checkNo, crei e controlli i codici tuSì con Verify: $0,05 a verifica più il costo SMS
Accesso MCPAccesso dal browser (OAuth)Dipende dal servizio, spesso una chiave API in un file di configurazioneNon verificato per questa guida
SandboxGratis, senza carta, numeri di provaDi solito i test mandano SMS veri dalla tua SIMLa prova scrive solo a numeri verificati
  1. 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 init
  2. Salva 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.

  3. 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.
  4. 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();
  5. 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.

  6. 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.

  7. 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