Per aggiungere gli SMS a un'app Base44, salva la chiave API di Telmian come secret dell'app e chiedi alla chat AI due backend function: sendOtp chiama POST /v1/verify e verifyOtp chiama POST /v1/verify/check. La pagina le richiama con base44.functions.invoke. La chiave resta sul server. Provi gratis nella sandbox, poi paghi 0,05 € + IVA per segmento SMS.
| Pezzo | Dove in Base44 | Nota |
|---|---|---|
| Chiave API Telmian | Secret dell'app (scheda Set secrets o pagina Secrets) | Leggila con secrets.get dentro l'handler |
| Codice che chiama Telmian | Backend function (Deno, TypeScript) | Mai nel codice frontend |
| Chiamata dalla pagina | base44.functions.invoke("sendOtp", {...}) | Il risultato sta in response.data |
| Accesso con numero di telefono | Non incluso | Costruiscilo con sendOtp e verifyOtp |
| MCP di Telmian | Connessione MCP personalizzata, piano Builder o superiore | Solo nella chat di sviluppo, non nell'app live |
Prendi una chiave sandbox
Crea un account gratuito su https://app.telmian.com e prendi una chiave sandbox. Inizia con sk_test_, non serve la carta e gli SMS sono solo simulati. Se usi il terminale, npx telmian@1 init la scrive in un file .env.
Salva la chiave come secret di Base44
Quando la chat AI mostra la scheda "Set secrets", incolla la chiave come TELMIAN_API_KEY e clicca Submit Secrets. Puoi cambiarla dopo nella pagina Secrets dell'app o con la CLI di Base44.
base44 secrets set TELMIAN_API_KEY=sk_test_...Chiedi alla chat AI una backend function sendOtp
Chiedi una backend function, non codice frontend, e dai l'endpoint esatto di Telmian così l'AI non se ne inventa uno. Leggi il secret dentro l'handler, non in cima al file, altrimenti torna undefined. Gli URL delle function sono pubblici, quindi controlla che l'utente abbia fatto l'accesso prima di inviare.
import { createClientFromRequest } from "npm:@base44/sdk"; import { secrets } from "base44:runtime"; export default async function (req: Request): Promise<Response> { const base44 = createClientFromRequest(req); const user = await base44.auth.me(); if (!user) return Response.json({ error: "Sign in first" }, { status: 401 }); const { phone, signupAttemptId } = await req.json(); const TELMIAN_API_KEY = await secrets.get("TELMIAN_API_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 }) }); return Response.json({ sent: res.ok }, { status: res.ok ? 200 : 502 }); }Aggiungi una backend function verifyOtp
Una seconda function controlla il codice scritto dall'utente. Telmian risponde con valid true o false, quindi non devi salvare i codici tu.
import { createClientFromRequest } from "npm:@base44/sdk"; import { secrets } from "base44:runtime"; export default async function (req: Request): Promise<Response> { const base44 = createClientFromRequest(req); const user = await base44.auth.me(); if (!user) return Response.json({ error: "Sign in first" }, { status: 401 }); const { phone, code } = await req.json(); const TELMIAN_API_KEY = await secrets.get("TELMIAN_API_KEY"); 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 Response.json({ valid }); }Richiama le function dalla pagina
Usa base44.functions.invoke. Restituisce una risposta axios, quindi il risultato sta in .data. Se un invio fallisce per un errore di rete, riprova con lo stesso attemptId, così l'utente non riceve due codici.
const attemptId = crypto.randomUUID(); await base44.functions.invoke("sendOtp", { phone, signupAttemptId: attemptId }); // after the user types the code const check = await base44.functions.invoke("verifyOtp", { phone, code }); if (check.data.valid) { // phone verified }Prova con i numeri della 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.
Passa al live
Ricarica con carta da 5 €, imposta un nome commerciale approvato nel pannello e crea una chiave sk_live_. Sostituisci il secret TELMIAN_API_KEY e ripubblica l'app, perché una versione pubblicata può tenere il vecchio valore finché non lo fai.
Domande
Posso mettere la chiave API di Telmian nel codice frontend di Base44?
No. Chiunque potrebbe leggerla dal browser e inviare SMS col tuo credito. Tienila come secret dell'app e chiama Telmian solo da una backend function.
Base44 ha già l'accesso con numero di telefono?
No. L'accesso di Base44 usa email e password, Google, Microsoft, Facebook, Apple o SSO. Gli SMS per l'accesso a più fattori li invia Base44 stessa, dal piano Builder in su, e Telmian non li sostituisce. Per verificare il telefono dentro la tua app, crea sendOtp e verifyOtp come sopra. L'hook Supabase di Telmian qui non serve, perché Base44 ha autenticazione e database propri.
Perché la mia backend function riceve undefined al posto della chiave?
Probabilmente chiami secrets.get in cima al file. Chiamalo dentro l'handler. Se hai cambiato la chiave, ripubblica l'app, perché una versione pubblicata può tenere il vecchio valore.
Quale piano Base44 mi serve?
La pagina dei prezzi di Base44 elenca le backend function già nel piano Free, quindi la chat AI può crearle. Per modificare il codice a mano nell'editor serve Starter o superiore. Le connessioni MCP personalizzate richiedono Builder o superiore.
Posso collegare il server MCP di Telmian a Base44?
Se vuoi, e se hai Builder o superiore, puoi provare ad aggiungere https://app.telmian.com/mcp come connessione MCP personalizzata, così la chat di sviluppo può usare gli strumenti di Telmian, per esempio set_sender_profile per impostare il nome commerciale. Non abbiamo provato l'accesso di Telmian dentro Base44. Le connessioni MCP di Base44 funzionano solo nella chat di sviluppo, quindi l'app live ha comunque bisogno delle backend function e del secret.
Aggiornata il