Per aggiungere SMS a un'app v0, salva la chiave Telmian come TELMIAN_API_KEY nel pannello Vars di v0, per Development e Production, mai con NEXT_PUBLIC_. Poi chiedi a v0 due route handler Next.js: uno chiama /v1/verify per inviare il codice, l'altro /v1/verify/check. Prova gratis in sandbox, poi ricarica e pubblica.
Prendi una chiave sandbox gratuita
Crea un account Telmian su https://app.telmian.com e prendi una chiave sandbox, che inizia con sk_test_. Non serve la carta: in sandbox gli SMS sono simulati, quindi non parte niente e non paghi niente.
Salva la chiave in Vars di v0
In v0 apri il menu del progetto (...) > Settings > Environment Variables (il pannello Vars). Aggiungi TELMIAN_API_KEY e spunta sia Development sia Production: l'anteprima di v0 legge solo le variabili Development. Non chiamarla mai NEXT_PUBLIC_TELMIAN_API_KEY, perché le variabili NEXT_PUBLIC_ arrivano al browser.
Spiega a v0 cosa costruire
Prima fai costruire la schermata di registrazione, poi chiedi il backend in un prompt separato. Nomina Telmian e gli endpoint, altrimenti v0 potrebbe scrivere codice in stile Twilio.
Create two Next.js route handlers, app/api/otp/send/route.ts and app/api/otp/verify/route.ts, that use Telmian's built-in OTP verification at https://app.telmian.com/v1 with header Authorization: Bearer ${process.env.TELMIAN_API_KEY}. The send handler calls POST /v1/verify with body {phone} and an Idempotency-Key header set to one attempt ID per sign-up attempt (reused on a retry). The verify handler calls POST /v1/verify/check with body {phone, code}, which returns {valid}. Server only: never call Telmian from a 'use client' component and never use NEXT_PUBLIC_. The client only posts the phone number, the attempt ID and the code. Ask me to add TELMIAN_API_KEY as an environment variable.Invia il codice da un route handler
Questo codice gira sul server, quindi la chiave non arriva mai al browser. Il client manda un ID per ogni tentativo di registrazione e lo riusa se riprova, così la stessa richiesta non parte due volte.
// app/api/otp/send/route.ts export async function POST(req: Request) { const { phone, attemptId } = await req.json(); const res = await fetch('https://app.telmian.com/v1/verify', { method: 'POST', headers: { Authorization: `Bearer ${process.env.TELMIAN_API_KEY}`, 'Content-Type': 'application/json', 'Idempotency-Key': attemptId }, body: JSON.stringify({ phone }) }); return Response.json({ ok: res.ok }, { status: res.ok ? 200 : 502 }); }Verifica il codice
Telmian risponde con valid true o false. Segna l'utente come verificato, sul server, solo quando valid è true.
// app/api/otp/verify/route.ts export async function POST(req: Request) { const { phone, code } = await req.json(); const check = await fetch('https://app.telmian.com/v1/verify/check', { method: 'POST', headers: { Authorization: `Bearer ${process.env.TELMIAN_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ phone, code }) }); const { valid } = await check.json(); return Response.json({ valid }); }Prova nell'anteprima di v0
Usa +393000000001: riceve sempre il codice 000000. Usa +393000000002 per vedere cosa succede quando l'invio fallisce. Entrambi sono simulati e gratuiti.
Vai live
Fai la prima ricarica (da 5 €), crea una chiave sk_live_ nel pannello, imposta un nome aziendale approvato e metti la chiave live nella variabile Production. Poi clicca Publish, oppure Publish Changes per gli aggiornamenti successivi.
Domande
Posso chiamare Telmian direttamente da un componente React di v0?
No. Tutto ciò che sta in un componente 'use client' gira nel browser, quindi la chiave sarebbe visibile. Tieni le chiamate in un route handler o in una Server Action e leggi lì process.env.TELMIAN_API_KEY.
Perché il codice funziona in produzione ma non nell'anteprima di v0?
L'anteprima di v0 legge solo le variabili d'ambiente attive per Development. Apri Settings > Environment Variables e spunta Development per TELMIAN_API_KEY, oltre a Production.
La mia app v0 pubblicata può usare il server MCP di Telmian?
No. In v0 i server MCP danno strumenti solo a v0 mentre genera il codice. La tua app deve chiamare l'API REST o il pacchetto npm 'telmian' con TELMIAN_API_KEY. Puoi provare ad aggiungere https://app.telmian.com/mcp come server personalizzato (+ > MCPs, OAuth) così v0 consulta i dati mentre costruisce, se l'accesso lì funziona.
Dove ricevo le conferme di consegna e le risposte?
Chiedi a v0 un route handler come app/api/telmian/webhook/route.ts, verifica la firma e pubblica. Punta il webhook al tuo dominio di produzione: gli URL delle preview deployment sono protetti da Vercel Deployment Protection, quindi le richieste esterne non ci arrivano.
Quanto costa?
0,05 € per segmento SMS verso cellulari in 44 Paesi europei, più IVA. Paghi in anticipo con carta da 5 €, senza canone mensile né contratto. Gli SMS rifiutati dalla rete o non consegnati vengono rimborsati in automatico.
Aggiornata il