Guida rapida

La versione breve per chi vuole solo la checklist. Ogni punto rimanda al passaggio corrispondente del Tutorial, dove tutto è spiegato con gli screenshot.

1. Account e organizzazione

• Registrati su app.frontmail.dev con email e password, Google o GitHub. Conferma il tuo indirizzo email – fino ad allora puoi dare un’occhiata alla dashboard, ma non inviare.
• Crea la tua organizzazione: compila Nome dell’organizzazione, Paese di fatturazione (determina IVA e valuta) e Cosa invierai? (Modulo di contatto, Email transazionali o Altro), poi clicca su Crea organizzazione.
• Sei sul piano Free con 300 richieste per questo mese. Frontmail ti mostra la tua prima chiave privata – una sola volta. Copiala nel tuo password manager o nei secret del server; ti serve solo per inviare da un server. Poi clicca su Continua con la configurazione.

2. I sei passaggi di configurazione

La pagina Per iniziare ti guida attraverso sei passaggi. Puoi saltarne qualunque (Salta questo passaggio, Salta la configurazione) e tornarci più tardi.

1. Collega un servizio email – Servizi email → Aggiungi servizio, scegli un provider, inserisci le credenziali (oppure Collega con il tuo account per Gmail / Outlook) e Verifica e salva. → Tutorial, passaggio 1
2. Crea un modello – Modelli → Dalla galleria → Modulo di contatto → Usa modello. A è già impostato sul tuo indirizzo, Reply-To sul visitatore. → Tutorial, passaggio 2 (e passaggio 3 per una risposta automatica)
3. Consenti il tuo sito – Sicurezza → Siti consentiti → Aggiungi dominio, ad es. example.com, *.example.com o localhost:3000, poi Salva. Consigliato: aggiungi le chiavi del tuo widget gratuito Cloudflare Turnstile in Protezione dai bot (Turnstile) e clicca su Attiva il CAPTCHA per tutti i modelli. → Tutorial, passaggio 4
4. Invia un’email di prova – nell’editor, Invia prova. Gratis, 20 al giorno. → Tutorial, passaggio 6
5. Aggiungilo al tuo sito – copia il codice dalla scheda Snippet del modello (HTML / JS, React, Vue, Svelte, Node.js, cURL). → Tutorial, passaggio 5
6. Proteggi e invita – se vuoi, attiva la verifica in due passaggi e invita i colleghi (Team).

3. Invio dal codice

La scheda Snippet compila per te la chiave pubblica e gli ID. Il codice nel browser usa la chiave pubblica (pk_…), i server una chiave privata (sk_…):

Browser (npm)

npm install @frontmail/browser

import { init, send } from '@frontmail/browser';

init({ publicKey: 'pk_…' });

const result = await send('svc_…', 'tpl_…', {
  name: 'Giulia Rossi',
  email: 'giulia@example.it',
  message: 'Buongiorno, vorrei un preventivo.',
});
console.log(result.status); // "queued" (o "held" se hai finito i crediti)

Un modello con Richiedi CAPTCHA (Turnstile) ha bisogno anche di un token Turnstile – un modulo completo con sendForm() lo trovi in Costruisci il modulo.

Server (cURL)

curl https://api.frontmail.dev/v1/send \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk_…' \
  -d '{
    "service_id": "svc_…",
    "template_id": "tpl_…",
    "template_params": { "name": "Giulia", "email": "giulia@example.it", "message": "Ciao!" }
  }'

Le richieste con chiave privata saltano i controlli di origin e CAPTCHA. Vedi il riferimento API.

L’API risponde 202 Accepted con un message_id; segui poi l’email in Cronologia.

Attenzione

Non mettere mai la chiave privata (sk_…) nel codice del frontend. Vedi Chiavi pubbliche e private.

Preferisci la versione guidata?Il Tutorial costruisce passo dopo passo un modulo di contatto con risposta automatica, con gli screenshot.