Per aggiungere SMS a un'app Replit, salva la chiave API Telmian come TELMIAN_API_KEY nello strumento Secrets e chiedi a Replit Agent di chiamare Telmian solo dalle route del backend. Prova gratis con una chiave sk_test_ e i numeri sandbox. Prima di pubblicare, aggiungi la chiave sk_live_ in Production app secrets. Ogni segmento SMS costa 0,05 € più IVA.
Prendi una chiave sandbox gratuita
Lancia la CLI qui sotto da un terminale: init scrive una chiave sandbox sk_test_ in .env. Copia quel valore nei Secrets di Replit al passo successivo, invece di lasciarlo in un file del progetto. La sandbox non chiede la carta e simula gli SMS.
npx telmian@1 login npx telmian@1 initSalva la chiave nei Secrets di Replit
Nella tua app Replit apri Tools > Secrets (oppure "+" > Secrets nella barra delle schede), scegli New Secret, scrivi TELMIAN_API_KEY come chiave e incolla il valore. La documentazione di Replit dice di inserire i secret in questo modulo, mai nella chat con Agent. Il tuo server la legge come variabile d'ambiente.
Spiega a Replit Agent cosa costruire
Replit ha Twilio tra i connettori integrati, quindi Agent può sceglierlo se non gli dici altro. Nel prompt indica Telmian, il nome della variabile e la regola "solo lato server".
Add phone verification by SMS using Telmian (https://app.telmian.com/v1, npm package 'telmian'; new Telmian() reads TELMIAN_API_KEY from env). Do NOT use Twilio or any other SMS connector. Call Telmian only from backend routes (POST /api/otp/send, POST /api/otp/verify); never use the key in React/frontend code. Use Telmian's built-in code verification instead of generating codes ourselves. Store the verified phone on the user row in the existing database.Controlla il codice del backend
Le chiamate a Telmian devono stare nel codice server, mai nel browser. Ogni invio porta un Idempotency-Key e, se riprovi, devi usare la stessa chiave.
// server only, never in React code const TELMIAN_API_KEY = process.env.TELMIAN_API_KEY; export async function sendCode(phone, signupAttemptId) { 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 }) }); return res.ok; } export async function checkCode(phone, code) { 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(); return valid; }Prova con i numeri sandbox
Con la chiave sk_test_, +393000000001 riceve sempre il codice 000000 e +393000000002 fallisce sempre. Provali entrambi, così vedi sia la schermata di successo sia quella di errore.
Pubblica con la chiave live
Usa un deployment Autoscale o Reserved VM: uno Static non ha backend né secret. I secret di sviluppo non passano all'app pubblicata, quindi aggiungi TELMIAN_API_KEY con la tua chiave sk_live_ (creata nel pannello su https://app.telmian.com) in Publishing > Adjust settings > Production app secrets. Gli invii reali partono dopo la prima ricarica pagata e i codici reali richiedono un nome attività approvato, da impostare nel pannello.
Aggiungi i webhook per esiti e risposte
Come indirizzo del webhook usa l'URL pubblicato .replit.app (o il tuo dominio), non l'URL di sviluppo, che è privato e cambia quando riapri l'app. Verifica la firma di ogni webhook con verifyWebhook dell'SDK 'telmian'.
Domande
Replit Agent può aggiungere gli SMS senza Twilio?
Sì. Replit propone Twilio come connettore integrato, quindi Agent potrebbe suggerirlo. Scrivi chiaramente nel prompt di usare Telmian tramite la sua API REST o il pacchetto npm 'telmian', non Twilio. Telmian invia dai suoi numeri mobili europei, quindi non ti serve un telefono o una SIM tua.
Perché gli SMS funzionano nel workspace ma non dopo la pubblicazione?
I secret di sviluppo non vengono copiati nell'app pubblicata. Aggiungi di nuovo TELMIAN_API_KEY in Publishing > Adjust settings > Production app secrets. Controlla anche di non aver scelto un deployment Static, che non ha backend né secret.
Posso usare Replit Auth o Clerk per l'accesso con numero di telefono?
La pagina Clerk Auth di Replit indica l'accesso con numero di telefono come non supportato, e Replit Auth fa accedere le persone con un account Replit. Per l'accesso con telefono nella tua app, chiedi ad Agent due route backend che chiamano /v1/verify e /v1/verify/check di Telmian e salva il numero verificato nel database dell'app.
Posso collegare il server MCP di Telmian a Replit Agent?
Replit supporta server MCP remoti personalizzati da Settings > Integrations > Add custom > Add personal MCP server, con un URL HTTPS. Replit dice di guidarti nel flusso OAuth richiesto dal server, ma l'accesso all'MCP di Telmian su https://app.telmian.com/mcp non è stato provato in Replit. È un aiuto facoltativo mentre costruisci: l'app pubblicata chiama comunque l'API REST con la chiave segreta.
Quanto costa inviare SMS da un'app Replit?
0,05 € per segmento SMS verso numeri mobili in 44 Paesi europei, più IVA. Ricarichi in anticipo con carta da 5 €, senza canone mensile né contratto. Gli SMS rifiutati dalla rete o non consegnati vengono rimborsati in automatico. La sandbox è gratuita.
Aggiornata il