Per aggiungere gli SMS a un'app Lovable, salva la chiave Telmian come secret del progetto con il nome TELMIAN_API_KEY (mai VITE_), poi chiedi a Lovable di chiamare https://app.telmian.com/v1 da una server function o da una Edge Function. Invii il codice con POST /v1/verify e lo controlli con POST /v1/verify/check. Inizia gratis nella sandbox con una chiave sk_test_.
| La tua app | Dove gira il codice server | Come legge la chiave |
|---|---|---|
| Creata dal 13 maggio 2026 (TanStack Start) | Server function e API route dentro l'app | Dai Secrets, inseriti lato server |
| App React + Vite più vecchia | Edge Function del backend integrato | Deno.env.get('TELMIAN_API_KEY') |
| Tuo progetto Supabase | Edge Function di Supabase | Secret impostato in Supabase nelle impostazioni Edge Functions |
Prendi una chiave sandbox
Sul tuo computer esegui npx telmian@1 login e poi npx telmian@1 init: scrive una chiave sandbox sk_test_ nel file .env, da cui copi il valore. La sandbox è gratuita e non chiede la carta. Gli SMS sono simulati: +393000000001 riceve sempre il codice 000000 e +393000000002 fallisce sempre.
Salva la chiave come secret di Lovable
Aggiungi al prompt "Ask me for any API keys you need" e Lovable apre un modulo sicuro per il secret, oppure vai su More → Settings → Secrets → Add secret. Chiamalo TELMIAN_API_KEY. Lovable rifiuta i nomi VITE_ perché finiscono nel browser, e il modulo tiene la chiave fuori dalla cronologia della chat.
Chiedi a Lovable di scrivere il codice server
Descrivi la funzione nella chat del progetto. Le app create dal 13 maggio 2026 eseguono il codice server come server function; le app React + Vite più vecchie usano le Edge Function del backend integrato. In entrambi i casi la chiave resta sul server.
Add phone verification with the Telmian SMS API. Base URL: https://app.telmian.com/v1. Auth: Bearer token from the secret TELMIAN_API_KEY. Ask me for any API keys you need. Call Telmian only from server-side code (server function or Edge Function), never from the browser. POST /v1/verify {"phone"} sends a code (send an Idempotency-Key header, one per sign-up attempt). POST /v1/verify/check {"phone","code"} returns {"valid":true|false}. Check who is calling before sending.Controlla il codice che scrive Lovable
La funzione dovrebbe somigliare a questa. signupAttemptId è un ID per ogni tentativo: se una richiesta fallisce, riprova solo con lo stesso ID, così l'utente non riceve due codici. Chiunque conosca l'indirizzo di una funzione può chiamarla, quindi assicurati che controlli chi la sta chiamando.
// Edge Function (Deno). The key never reaches the browser. const TELMIAN_API_KEY = Deno.env.get('TELMIAN_API_KEY'); // 1. Send the code 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 }) }); // 2. Check the code the user typed 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();Scegli come gestire l'accesso col telefono
L'accesso col telefono integrato in Lovable elenca solo Twilio, Twilio Verify, TextLocal, Vonage e MessageBird: Telmian non c'è. Usa l'OTP di Telmian dal codice server come sopra e segna l'utente come verificato quando valid è true. Oppure collega un tuo progetto Supabase e imposta Telmian come Send SMS hook: trovi i passi nella guida Supabase.
Ricevi esiti di consegna e risposte
Chiedi a Lovable di creare una Edge Function che faccia da endpoint webhook. Copia il suo indirizzo da More → Database → Manage → Edge functions → Copy URL e dallo a Telmian. Telmian firma ogni webhook, quindi chiedi a Lovable di verificare la firma a ogni chiamata (l'SDK npm telmian ha verifyWebhook).
Passa al live
Imposta un nome aziendale approvato nel pannello Telmian su https://app.telmian.com: serve per i codici reali. Ricarica con carta da 5 € (la prima ricarica di almeno 10 € riceve 5 € in più, una volta sola), crea una chiave sk_live_ nel pannello e mettila come nuovo valore del secret. Ogni segmento SMS costa 0,05 € più IVA, e gli SMS rifiutati dalla rete o non consegnati vengono rimborsati in automatico.
Domande
Posso scegliere Telmian nelle impostazioni di accesso col telefono di Lovable?
No. Quell'elenco ha solo Twilio, Twilio Verify, TextLocal, Vonage e MessageBird. Usa l'OTP di Telmian da una server function o da una Edge Function, oppure collega un tuo progetto Supabase e usa Telmian come Send SMS hook. Il tool MCP setup_supabase_sms ti dà URL e secret dell'hook.
Perché non posso chiamare la chiave VITE_TELMIAN_API_KEY?
I valori VITE_ finiscono nel codice del browser, quindi chiunque visiti la tua app potrebbe leggerli. Per questo Lovable rifiuta i nomi VITE_ nei Secrets. Usa TELMIAN_API_KEY e chiama Telmian solo dal codice server.
Qualcuno può usare la mia funzione per mandare SMS col mio credito?
Chiunque conosca l'indirizzo di una funzione può chiamarla, quindi chiedi a Lovable di controllare chi chiama prima di inviare. Manda anche un Idempotency-Key a ogni invio e riprova solo con la stessa chiave, così un nuovo tentativo non invia mai un secondo SMS.
Posso mandare promemoria o aggiornamenti sugli ordini, non solo codici?
Sì. Usa POST /v1/messages con un template approvato (GET /v1/templates li elenca) e il numero del cliente. Un template nuovo viene revisionato dall'AI in pochi secondi o da una persona. I promemoria si possono programmare con send_at. Il testo libero vale solo per avvisi ai tuoi numeri verificati.
Posso collegare il server MCP di Telmian a Lovable?
È un extra facoltativo mentre costruisci. Puoi provare Connectors → Add custom → MCP server con https://app.telmian.com/mcp e OAuth; se l'accesso va a buon fine, Lovable può leggere il contesto Telmian in chat. Non fa mai parte dell'app pubblicata, che ha comunque bisogno del codice server e del secret visti sopra.
Aggiornata il