Documentazione

Primi passi

BgLetter è un Channel: uno strumento con cui invia e-mail tramite la Sua casella di posta (bring-your-own-SMTP). L’invio passa dal Suo server di posta, il mittente resta Lei e la reputazione del mittente resta la Sua – non forniamo infrastruttura di invio e non addebitiamo nulla per e-mail.

Il Suo elenco di destinatari resta da Lei: i destinatari provengono da un file CSV, per ogni invio. Non esiste una gestione dei contatti – niente liste salvate, niente segmenti, niente moduli di iscrizione. E i dati necessari a un invio vengono cancellati al più tardi dopo 30 giorni (vedi Conservazione e cancellazione).

Operativi in quattro passi

1. Creare l’account. Si registri gratuitamente su /register.
2. Collegare la propria casella di posta. Inserisca le credenziali del Suo server di posta (vedi «Collegare SMTP»).
3. Creare il contenuto. Scriva la Sua e-mail nel builder o nell’editor di codice.
4. Caricare l’elenco dei destinatari e inviare. Carichi il file CSV di questo invio e invii subito o in modo programmato.

L’offerta si rivolge esclusivamente a imprese e ad altri utenti professionali o istituzionali, non ai consumatori.

Collegare SMTP

In Account mittente registra uno o più account di invio. BgLetter include modelli preconfigurati dei provider che precompilano host, porta e crittografia (ad es. Gmail/Google Workspace, Microsoft 365, Brevo, SendGrid, Mailgun, Postmark). Per alcuni provider (ad es. Amazon SES e all-inkl/KAS) l’host va inserito manualmente, poiché varia in base alla regione o al pacchetto.

Impostazioni tipiche

Host:           smtp.suodominio.it
Porta:          587   (STARTTLS)  oppure  465 (SSL/TLS)
Nome utente:    invio@suodominio.it
Password:       ••••••••  (consigliata una password per app)
Mittente:       "Il Suo nome" <newsletter@suodominio.it>

Dopo il salvataggio può avviare una connessione di prova. BgLetter segnala se login e crittografia funzionano.

Recapitabilità (SPF / DKIM / DMARC)

Che le Sue e-mail arrivino a destinazione dipende soprattutto dalla configurazione DNS. Tre record sono fondamentali:

In breve: SPF autorizza i server, DKIM ne dimostra l’autenticità, DMARC indica ai destinatari cosa fare in caso di falsificazioni. Tutti e tre insieme aumentano notevolmente il tasso di recapito.

Destinatari e invio

I destinatari provengono da un file CSV, per ogni invio. Carica il file nell’editor, assegna le colonne e invia. Non esistono liste salvate, segmenti o moduli di iscrizione: il Suo elenco di destinatari resta da Lei e il file originale rimane sul Suo computer.

Struttura del file CSV

La prima riga è l’intestazione con i nomi delle colonne. Come separatore si usano di norma la virgola o il punto e virgola; salvi il file in UTF-8 per preservare le lettere accentate.

Email;Nome;Fattura;Lingua;Paese
anna@example.com;Anna Berger;R-2041;de;DE
paul@example.org;Paul Vetter;R-2042;fr;FR

Le colonne possono avere un nome qualsiasi: dopo il caricamento sceglie nell’editor quale colonna contiene l’indirizzo e-mail, quale il nome e quale la lingua o il paese. Un file di esempio è disponibile nell’editor in «Come deve essere il CSV?».

Duplicati e lista di blocco

• I duplicati vengono unificati automaticamente: se lo stesso indirizzo compare più volte nel file, viene contattato una sola volta – vale la prima riga con i suoi valori di personalizzazione. Il confronto non distingue maiuscole e minuscole.
• Le righe incomplete, senza indirizzo o con un indirizzo palesemente non valido, vengono escluse prima dell’invio.
• La lista di blocco vale sempre. Gli indirizzi presenti nella Sua lista delle disiscrizioni vengono saltati automaticamente a ogni invio – non deve ripulire il file CSV in anticipo.

Invio

• Anteprima per desktop e mobile – con dati di esempio dalla prima riga del Suo file CSV.
• Personalizzazione tramite segnaposto come {{NAME}}, {{EMAIL}} e le Sue colonne personalizzate.
• Il link di disiscrizione viene inserito automaticamente – obbligatorio e positivo per la reputazione.
• L’invio avviene in modo regolato tramite la Sua casella di posta, per rispettarne i limiti di invio.

In Modalità di invio sceglie una di tre velocità: Consegna sicura (massima affidabilità, consigliato), Velocità media (equilibrato) o Velocità elevata (solo per caselle con limiti di invio elevati). BgLetter distribuisce automaticamente l’invio in modo che le e-mail allo stesso provider non si susseguano troppo ravvicinate – non sono necessarie impostazioni manuali degli intervalli, e i recapiti temporaneamente falliti vengono ripetuti automaticamente fino a due volte. Invia subito oppure in modo programmato a un orario scelto.

Con l’invio immediato segue l’avanzamento in tempo reale e può mettere in pausa, riprendere o annullare l’invio in corso. Il tracciamento di aperture e clic è sempre attivo.

Disiscrizioni / lista di blocco

La gestione delle disiscrizioni è la Sua lista di blocco centrale: ogni indirizzo qui elencato viene saltato in modo affidabile a ogni invio – anche se è ancora presente nel Suo file CSV. Se un destinatario clicca sul link di disiscrizione – anche tramite one-click list unsubscribe direttamente nella casella di posta –, viene inserito qui immediatamente.

Dal piano Pro una voce di menu dedicata Disiscrizioni porta alla pagina; in alternativa può raggiungerla direttamente all’indirizzo /app/unsubscribes.

• Aggiungere: inserire indirizzi manualmente (uno per riga) – con un motivo a scelta: Manuale, Reclamo, Non recapitabile (rimbalzo) o Altro.
• Importare: caricare liste di blocco esistenti come file CSV o di testo.
• Esportare: scaricare la lista completa come CSV (e-mail, motivo, data).

La lista di blocco è l’unico insieme di dati conservato in modo permanente. È un obbligo di legge: solo così una disiscrizione ha effetto oltre il singolo invio, anche se lo stesso indirizzo ricompare in un file CSV mesi dopo.

Conservazione e cancellazione

BgLetter conserva il meno possibile e per il minor tempo possibile. Per ogni invio vale un termine fisso: al più tardi 30 giorni dopo l’invio i dati relativi vengono cancellati automaticamente. Ciò avviene senza alcun intervento da parte Sua e non è prorogabile.

Cosa viene cancellato dopo 30 giorni

• Gli indirizzi dei destinatari del file CSV caricato.
• I dati di personalizzazione – nomi e tutte le altre colonne del Suo file.
• Il contenuto del messaggio dell’invio (testo, HTML, blocchi, traduzioni).
• Gli eventi di tracciamento – singole aperture e clic, con orario e riferimento al destinatario.

Cosa rimane

• L’oggetto e la data dell’invio.
• Indicatori anonimi: numero di destinatari, inviate, fallite, tasso di recapito, nonché aperture e clic come totali – senza riferimento a singole persone.
• La lista delle disiscrizioni (lista di blocco). Resta permanentemente, altrimenti una disiscrizione perderebbe efficacia dopo 30 giorni.

Bozze e modelli

Anche le bozze non modificate vengono cancellate 30 giorni dopo l’ultima modifica. I contenuti che desidera conservare e riutilizzare vanno quindi salvati in un modello: i modelli non sono legati ad alcun invio e restano finché non li elimina Lei stesso.

Meno dati conservati significa meno dati che possono andare perduti. Il termine non è un limite, ma il motivo per cui il Suo elenco di destinatari non resta mai in modo permanente presso di noi.

Messaggi (transazionali)

Tramite l’area Messaggi invia singole e-mail transazionali – ad esempio fatture, solleciti di pagamento, ricevute di pagamento, promemoria di appuntamenti, conferme d’ordine o notifiche – a un solo destinatario tramite il Suo account mittente. I messaggi sono disponibili in ogni piano (anche Free).

Per i pagamenti l’Editor a blocchi include due elementi: il pulsante di pagamento (un link di pagamento come modello – PayPal.Me, PayPal Checkout, Stripe Payment Link o un qualsiasi URL personalizzato; variabili come {{AMOUNT}} o {{INVOICE_NUMBER}} vengono inserite per ogni destinatario al momento dell’invio, importi nel formato con il punto come 12.50) e il codice QR SEPA (Girocode): i destinatari lo scansionano con la loro app bancaria e ottengono un bonifico precompilato con IBAN, importo e causale – senza alcun fornitore di pagamenti. Entrambi gli elementi sono già predisposti nei modelli “Fattura” e “Sollecito di pagamento” e vengono inviati solo quando sono configurati (URL o IBAN).

• Modelli per i casi più frequenti (fattura, sollecito di pagamento, ricevuta, promemoria di appuntamento, conferma d’ordine, notifica).
• Allegati: fino a 10 file per un totale di max 10 MB (ad es. la fattura in PDF).
• Personalizzazione tramite {{NAME}} e {{EMAIL}}.
• Tracciamento delle aperture facoltativo per messaggio.

Editor e builder

Le newsletter si creano nell’editor con due modalità: il builder (blocchi con drag & drop, con formattazione inline – il testo selezionato si modifica direttamente in dimensione, colore, grassetto ecc.) e l’editor di codice per HTML personalizzato. Il builder genera codice e-mail visualizzato in modo affidabile in Outlook, Gmail e Apple Mail.

Blocchi disponibili

• Testo, pulsante e immagine per i contenuti.
• Colonne (2, 3 o 4), linea di separazione e spaziatura per il layout.
• Social network e un blocco HTML per snippet personalizzati.

Traduzione IA

Nell’editor traduce oggetto e contenuto con un clic in fino a 36 lingue. Sceglie la lingua di partenza, la forma di cortesia (Lei/formale o tu/informale) e le lingue di destinazione desiderate. I segnaposto come {{NAME}} vengono mantenuti.

Per l’invio multilingue ogni destinatario riceve la variante linguistica adatta: se il Suo file CSV contiene una colonna lingua (ad es. «Lingua») o una colonna paese (ad es. «Paese»), per ogni destinatario viene inviata automaticamente la traduzione corretta – altrimenti la versione originale.

Non deve tradurre in anticipo: tutte le lingue rilevate tra i Suoi destinatari vengono tradotte automaticamente all’inizio dell’invio (visibile come stato «Traduzione in corso») – il recapito parte solo quando tutte le versioni sono pronte.

Ecco come funziona l’assegnazione della lingua: la colonna può avere un nome qualsiasi – dopo il caricamento sceglie nell’editor quale colonna contiene la lingua. Vengono riconosciuti codici lingua (de, deu, ger), locale (de-DE, en-US), nomi di lingue (Deutsch, German) nonché nomi e codici di paesi (Deutschland, Germany, DE, AT). I valori vuoti o sconosciuti ricevono la versione originale. La colonna resta inoltre utilizzabile come segnaposto.

Tracciamento

BgLetter registra aperture e clic per ogni invio. Nell’analisi vede il tasso di apertura e di clic e i link più cliccati.

I singoli eventi restano associati a un destinatario solo finché l’invio esiste – al più tardi 30 giorni dopo l’invio vengono cancellati. In seguito restano solo i totali anonimi (vedi Conservazione e cancellazione).

Invii e report

In Campagne e statistiche trova tutti gli invii con data, oggetto, stato, numero di destinatari, inviate, fallite e il tasso di recapito (inviate ÷ destinatari totali). I più recenti sono in alto. Con l’icona a forma di occhio apre il report.

Il report mostra in alto le metriche, incluse aperture e clic, e una barra «Avanzamento invio». La scheda Reazioni dei destinatari riporta aperture e clic sia come unici sia come totali e calcola il tasso di clic (CTR) dai clic unici per apertura unica. Una tabella elenca i link più cliccati con clic e clic unici.

• Tabella dei destinatari: per ciascun destinatario e-mail, provider e-mail, nome, stato e – in caso di errori – l’esatto messaggio di errore SMTP e l’orario di invio. Questa tabella è disponibile per 30 giorni.
• Filtri: tutti, inviate, fallite, in sospeso.
• Esportazione CSV: «Esporta come tabella (CSV)» scarica tutti i destinatari – indipendentemente dal filtro attivo. Esporti per tempo, finché i dati sono ancora disponibili.

Nella panoramica non esiste una cancellazione manuale – e non serve: dopo 30 giorni BgLetter rimuove da sé i dati dei destinatari, il contenuto e gli eventi di tracciamento. Restano l’oggetto e gli indicatori anonimi come storico.

API REST (panoramica)

Per le integrazioni BgLetter offre una API REST. Le chiavi API si generano nell’area sviluppatori del Suo account. L’autenticazione avviene tramite bearer token nell’header.

# Inviare un messaggio transazionale
curl -X POST https://bgletter.com/api/v1/messages \
  -H "Authorization: Bearer LA_SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "to": "cliente@example.com", "subject": "La Sua fattura", "html": "<p>Buongiorno …</p>" }'

L’URL di base è <il-suo-dominio>/api/v1; l’autenticazione avviene tramite Authorization: Bearer bgl_… o X-Api-Key: bgl_…. Sono disponibili endpoint per i messaggi transazionali (POST /api/v1/messages), per la lista delle disiscrizioni nonché endpoint in lettura per account e invii. La specifica completa si trova in /api/v1/openapi.json.

• Idempotenza: un header Idempotency-Key nell’invio di messaggi evita recapiti doppi in caso di ripetizioni.
• Firma dei webhook: ogni consegna contiene X-BgLetter-Signature: sha256=… (HMAC-SHA256 sul testo grezzo con la Sua chiave whsec_) – la verifichi prima dell’elaborazione.
• Limite di richieste: 120 richieste/minuto per account (messaggi: in aggiunta 300/ora).

In aggiunta sono disponibili webhook per notificare il Suo sistema in tempo reale in caso di eventi (ad es. disiscrizione, rimbalzo/bounce). Endpoint e risposte di esempio si trovano nell’area sviluppatori.

Fatturazione

BgLetter applica un prezzo mensile fisso per piano – nessun costo per e-mail. I piani si differenziano per volume di invio mensile, numero di account mittente e altri limiti.

• Piano Free gratuito per provare – nessuna carta di credito necessaria.
• Upgrade in qualsiasi momento nell’area Fatturazione. Per un piano inferiore disdica l’abbonamento (passa a «Free» alla fine del periodo).
• Tutti i prezzi sono in euro; la fatturazione è a cura di Fontemia GmbH, Grammetstr. 14, CH-4410 Liestal.

Team e account

In Amministrazione invita i membri del team e assegna i ruoli: Proprietario, Admin o Membro. Solo proprietario e admin vedono l’amministrazione; solo il proprietario può invitare, modificare i ruoli e rimuovere membri.

Il numero di posti dipende dal piano – un secondo membro del team è possibile dal piano Pro. Ogni membro attiva autonomamente la propria autenticazione a due fattori (2FA) nelle impostazioni.

Impostazioni

In Impostazioni gestisce il Suo account in un’unica pagina con cinque schede. Password e autenticazione a due fattori sono accessibili a ogni membro; indirizzo di fatturazione, branding nonché dati e privacy sono riservati al proprietario.

• Cambiare password – nuova password di almeno 8 caratteri. Una modifica disconnette automaticamente tutte le altre sessioni.
• Autenticazione a due fattori – configurazione tramite codice QR; poi vengono mostrati una sola volta 8 codici di recupero monouso (li conservi al sicuro – non possono essere visualizzati di nuovo). Per la disattivazione serve un codice attuale dalla Sua app.
• Indirizzo di fatturazione – azienda, indirizzo e partita IVA; compare sulle Sue fatture (solo proprietario).
• Branding – colore del marchio, URL del logo, indirizzo postale e un piè di pagina e-mail personalizzato (dettagli sotto).
• Dati e privacy – «Esporta i miei dati (JSON)» come file e la cancellazione definitiva dell’account (in due passaggi, irreversibile).

Nel branding, colore del marchio e URL del logo incidono solo sulle pagine pubbliche che i Suoi destinatari vedono – come la pagina di disiscrizione –, non sulle e-mail inviate. L’indirizzo postale (mittente) invece viene inserito nel piè di pagina di ogni e-mail in uscita – se lo lascia vuoto, la riga dell’indirizzo manca (obbligo di impressum secondo il § 5 TMG). Un piè di pagina HTML personalizzato è disponibile dal piano Business.

Risoluzione dei problemi

Le domande più frequenti e la loro soluzione a colpo d’occhio. La maggior parte dei problemi di recapito si risolve in pochi minuti.

Una funzione è in grigio? Allora non è inclusa nel Suo piano – accanto al pulsante è indicato il piano necessario (ad es. «Da Pro»). Un upgrade nell’area Fatturazione la sblocca.