← Tutte le guide

Aggiungere SMS a un'app Bolt.new: codici OTP con Telmian

Per aggiungere SMS a un'app Bolt.new, salva la chiave API di Telmian come secret di Bolt Cloud (icona database > Secrets) e chiedi a Bolt di creare server function che chiamano l'API di Telmian. Il browser chiama solo quelle funzioni, mai Telmian. Prova gratis con i numeri sandbox, poi passa a una chiave live dopo la prima ricarica.

Dove sta ogni pezzo in Bolt
CosaDove in Bolt
TELMIAN_API_KEYIcona database > Secrets
Chiamate a TelmianServer function (create chiedendolo a Bolt)
Log di ogni chiamataIcona database > Server Functions > View Logs (ultima ora)
Modifiche sul sito pubblicatoPublish > Update
  1. Prendi una chiave sandbox

    Registrati su https://app.telmian.com e prendi una chiave sandbox. Inizia con sk_test_. La sandbox è gratuita, non chiede la carta e simula gli SMS, quindi non parte nulla di reale.

  2. Salva la chiave come secret di Bolt

    Nel progetto Bolt clicca l'icona database nel menu in alto, poi Secrets. In Name scrivi TELMIAN_API_KEY (maiuscole e minuscole contano), incolla la chiave in Value e clicca Save. Se Secrets non si apre, chiedi prima a Bolt di aggiungere un database. Non mettere la chiave in .env: in Bolt il file .env fa parte del codice del progetto e gli editor lo vedono.

  3. Chiedi a Bolt due server function

    I secret funzionano solo dentro le server function, che girano sui server di Bolt e non nel browser. Nel prompt scrivi il nome del secret e l'API. Bolt pubblica le server function da solo.

    Create two server functions, send-code and check-code. Both read the secret TELMIAN_API_KEY and call https://app.telmian.com/v1 with fetch and the header Authorization: Bearer <key>. send-code posts {phone} to /verify with an Idempotency-Key header (one id per signup attempt). check-code posts {phone, code} to /verify/check and returns valid. Never put the key in frontend code or .env. The frontend only calls these functions.
  4. Controlla cosa inviano le funzioni

    La server function deve fare queste due chiamate. Il codice lo crea e lo invia Telmian, quindi la tua app non salva codici. Se un invio fallisce, riprova solo con la stessa Idempotency-Key.

    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 sandbox

    Inserisci +393000000001 nella tua app: il codice è sempre 000000. Inserisci +393000000002 per vedere un errore. Per capire cosa è successo apri icona database > Server Functions > View Logs (i log coprono solo l'ultima ora).

  6. Passa al live

    Nel pannello Telmian imposta un nome aziendale approvato (compare dentro il testo dell'SMS), ricarica con carta da 5 € e crea una chiave che inizia con sk_live_. Sostituisci il valore di TELMIAN_API_KEY nei Secrets di Bolt, poi clicca Publish > Update così il sito pubblicato riceve le modifiche.

  7. Facoltativo: collega l'MCP di Telmian mentre sviluppi

    Bolt accetta connettori MCP personalizzati da icona più della chat > Connectors > Manage connectors > Custom MCP server. Usa URL https://app.telmian.com/mcp, trasporto HTTP e MCP OAuth, poi accedi dal browser. L'agente di Bolt può così usare gli strumenti di Telmian mentre sviluppi. Gli invii reali a pagamento dall'AI restano spenti se non li spunti al consenso. Serve solo durante lo sviluppo: l'app pubblicata usa comunque le server function e il secret.

Domande

Posso mettere la chiave Telmian in .env su Bolt?

No. In Bolt i valori di .env fanno parte del codice del progetto, editor e co-owner li vedono, e ogni valore letto nel codice del browser finisce sul sito pubblicato. Usa icona database > Secrets e leggi la chiave solo in una server function.

Bolt supporta il login con numero di telefono via SMS?

Le impostazioni di autenticazione di Bolt elencano email, Google e accesso anonimo, non il telefono. La strada semplice è tenere quel login e aggiungere la verifica del numero con l'OTP di Telmian in una server function. Se colleghi un tuo progetto Supabase (piano Pro o Teams), Telmian può fare anche da Send SMS hook di Supabase, ma la documentazione di Bolt non descrive questa configurazione.

Quanto costano gli SMS?

0,05 € per segmento SMS verso numeri mobili in 44 Paesi europei, più IVA. Paghi in anticipo con carta da 5 €, senza canone mensile e senza contratto. Gli SMS rifiutati dalla rete o non consegnati vengono rimborsati in automatico. La sandbox è gratuita.

La mia app Bolt può mandare anche promemoria o avvisi?

Sì, con lo stesso schema della server function. Chiama POST /v1/messages con un template approvato (GET /v1/templates li elenca). I promemoria si possono programmare con send_at. Il testo libero è solo per avvisi ai tuoi numeri verificati.

Perché il sito pubblicato non mostra la funzione SMS?

Bolt aggiorna da solo le server function, ma il sito pubblicato non si aggiorna in automatico. Dopo le modifiche clicca Publish > Update.

Aggiornata il