Guida all'uso di SparkPost con Node.js

Email

·

1 set 2017

Guida all'uso di SparkPost con Node.js

Punti Chiave

    • SparkPost offre più modi per inviare email da Node.js: chiamate API dirette, trasporto Nodemailer e consegna multicanale notif.me.

    • Archivia le chiavi API nelle variabili di ambiente, mai codificandole in modo rigido. SparkPost rileva automaticamente SPARKPOST_API_KEY.

    • L'API delle Trasmissioni ti offre una potenza di flessibilità: modelli, dati di sostituzione, allegati e tagging delle campagne.

    • Gli utenti di Nodemailer possono passare istantaneamente a SparkPost con il trasporto ufficiale — senza grandi riscritture di codice.

    • notif.me fornisce consegne multicanale (email, SMS, push) con strategie di fallback, rendendolo ideale per sistemi di notifica robusti.

    • Node.js si adatta naturalmente con le moderne API email cloud e i flussi di lavoro serverless, rendendo facile incorporare funzionalità email direttamente nella tua app.

Punti salienti del Q&A

  • Qual è il modo più veloce per iniziare a inviare email con SparkPost in Node.js?

    Installa il pacchetto sparkpost, inizializza il client con una chiave API (preferibilmente tramite variabili di ambiente) e chiama il metodo transmissions.send() con destinatari + contenuto.

  • Devo conservare la mia chiave API di SparkPost nel codice?

    No — e non dovresti. Usa le variabili d'ambiente. Il client legge automaticamente SPARKPOST_API_KEY.

  • Posso inviare email utilizzando modelli invece di HTML in linea?

    Sì. L'API delle Trasmissioni supporta modelli memorizzati, dati di sostituzione, liste di destinatari, allegati, cc/bcc e altro ancora.

  • E se utilizzo già Nodemailer?

    Sei coperto: SparkPost viene fornito con un trasporto Nodemailer ufficiale. Basta configurarlo con la tua chiave API e usare Nodemailer come al solito.

  • Può SparkPost funzionare con sistemi di messaggistica multicanale?

    Sì. Le librerie come notifme-sdk consentono email, SMS, push e webpush con logica di fallback, e includono un fornitore SparkPost.

  • Node.js è adatto per flussi di lavoro email serverless?

    Assolutamente. Si abbina bene con Cloud Functions, Lambdas, e qualsiasi ambiente serverless che utilizza l'API di SparkPost per email guidate da eventi.

  • Chi dovrebbe usare l'API Transmissions rispetto a Nodemailer o notif.me?

    • Usa Transmissions API quando vuoi avere il pieno controllo e prestazioni.

    • Usa Nodemailer se il tuo progetto lo utilizza già e vuoi un'integrazione rapida.

    • Usa notif.me per la messaggistica multicanale o strategie di consegna di fallback.

  • Qual è la migliore prassi quando si inviano email da Node?

    Tratta la tua chiave API come sensibile - solo variabili d'ambiente, non immetterla mai nel codice.

Introduzione a Node.js

Come Developer Advocate per SparkPost, scrivo molte applicazioni di esempio. La mia esperienza è principalmente nello sviluppo front-end, quindi il mio linguaggio più forte è JavaScript. Grazie a Node.js, sono anche un discreto sviluppatore backend. Parlando di applicazioni di esempio, Node.js funziona anche alla grande per costruire funzioni serverless che si integrano con Flow Builder - come la nostra guida all'integrazione delle Google Cloud Functions e della Vision API. Questo significa che ora sono uno sviluppatore full stack? Comunque, era importante per me che avessimo una fantastica libreria client SparkPost per Node.js. Così, mi sono tuffato e sono diventato un collaboratore (anche prima di essere assunto).

Permettimi di aiutarti a iniziare a inviare email con SparkPost nel tuo progetto Node.js. Prima di immergerti nelle specifiche di Node.js, potresti voler comprendere i fondamenti delle API email nell'infrastruttura cloud e come si inseriscono nello sviluppo di applicazioni moderne.

Installazione e configurazione

Assumerò che tu abbia Node.js installato. Poiché seguiamo il programma di supporto a lungo termine (LTS) di Node.js, dovrai avere la versione 4 o superiore. Puoi vedere quale versione stai eseguendo utilizzando il comando `node –version` nella tua finestra del terminale.

Creiamo un nuovo progetto npm. Se ne hai già uno, puoi saltare questa parte.

> mkdir sparkpost-test > cd sparkpost-test > npm init --yes

Questo creerà un nuovo progetto e accetterà tutte le impostazioni predefinite. Puoi anche invece eseguire `npm init` e rispondere a tutte le richieste.

Ora possiamo installare node-sparkpost:

> npm install sparkpost --save

Una volta installato, puoi importare e creare un'istanza della classe SparkPost:

const SparkPost = require('sparkpost') const client = new SparkPost('LA TUA CHIAVE API')

È buona pratica evitare di mettere la tua chiave API nel codice. Ti raccomandiamo vivamente di conservarla al di fuori del tuo codice, quindi abbiamo configurato la libreria client per rilevare la variabile di ambiente SPARKPOST_API_KEY .

Invio Email

Ora che hai un'istanza di SparkPost, sei pronto per inviare. Ci sono diverse opzioni disponibili per l'invio, ma iniziamo con un esempio semplice. Ecco come inviare un'email a un singolo destinatario, specificando contenuti inline:

client.transmissions.send({
  content: {
    from: 'test@your-sending-domain.com',
    subject: 'Hello from node-sparkpost',
    html: '<p>Hello world</p>'
  },
  recipients: [
    { address: 'someone@somedomain.com' }
  ]
})
.then(data => {
  console.log('Woohoo! You just sent your first mailing!')
  console.log(data)
})
.catch(err => {
  console.log('Whoops! Something went wrong')
  console.log(err)
})

Nota: Questo esempio utilizza le Promesse, ma non preoccuparti. Supportiamo anche le funzioni di callback.

Per le applicazioni aziendali che richiedono una gestione completa delle email, gli sviluppatori potrebbero dover considerare la costruzione di sistemi di archiviazione delle email per gestire requisiti di archiviazione e conformità.

Ci sono più opzioni disponibili con le trasmissioni, inclusa la specifica di modelli memorizzati o liste di destinatari, cc e bcc, aggiunta di allegati, specificazione di una campagna, utilizzo di dati di sostituzione e molto altro. Dai un'occhiata agli esempi, ai documenti per la risorsa Trasmissioni, e alla documentazione dell'API Trasmissioni per ulteriori informazioni.

Ora che hai un'istanza di SparkPost, sei pronto per inviare. Ci sono diverse opzioni disponibili per l'invio, ma iniziamo con un esempio semplice. Ecco come inviare un'email a un singolo destinatario, specificando contenuti inline:

client.transmissions.send({
  content: {
    from: 'test@your-sending-domain.com',
    subject: 'Hello from node-sparkpost',
    html: '<p>Hello world</p>'
  },
  recipients: [
    { address: 'someone@somedomain.com' }
  ]
})
.then(data => {
  console.log('Woohoo! You just sent your first mailing!')
  console.log(data)
})
.catch(err => {
  console.log('Whoops! Something went wrong')
  console.log(err)
})

Nota: Questo esempio utilizza le Promesse, ma non preoccuparti. Supportiamo anche le funzioni di callback.

Per le applicazioni aziendali che richiedono una gestione completa delle email, gli sviluppatori potrebbero dover considerare la costruzione di sistemi di archiviazione delle email per gestire requisiti di archiviazione e conformità.

Ci sono più opzioni disponibili con le trasmissioni, inclusa la specifica di modelli memorizzati o liste di destinatari, cc e bcc, aggiunta di allegati, specificazione di una campagna, utilizzo di dati di sostituzione e molto altro. Dai un'occhiata agli esempi, ai documenti per la risorsa Trasmissioni, e alla documentazione dell'API Trasmissioni per ulteriori informazioni.

Ora che hai un'istanza di SparkPost, sei pronto per inviare. Ci sono diverse opzioni disponibili per l'invio, ma iniziamo con un esempio semplice. Ecco come inviare un'email a un singolo destinatario, specificando contenuti inline:

client.transmissions.send({
  content: {
    from: 'test@your-sending-domain.com',
    subject: 'Hello from node-sparkpost',
    html: '<p>Hello world</p>'
  },
  recipients: [
    { address: 'someone@somedomain.com' }
  ]
})
.then(data => {
  console.log('Woohoo! You just sent your first mailing!')
  console.log(data)
})
.catch(err => {
  console.log('Whoops! Something went wrong')
  console.log(err)
})

Nota: Questo esempio utilizza le Promesse, ma non preoccuparti. Supportiamo anche le funzioni di callback.

Per le applicazioni aziendali che richiedono una gestione completa delle email, gli sviluppatori potrebbero dover considerare la costruzione di sistemi di archiviazione delle email per gestire requisiti di archiviazione e conformità.

Ci sono più opzioni disponibili con le trasmissioni, inclusa la specifica di modelli memorizzati o liste di destinatari, cc e bcc, aggiunta di allegati, specificazione di una campagna, utilizzo di dati di sostituzione e molto altro. Dai un'occhiata agli esempi, ai documenti per la risorsa Trasmissioni, e alla documentazione dell'API Trasmissioni per ulteriori informazioni.

Bonus: Inviare Email con Nodemailer

Nodemailer è una libreria popolare per Node.js che rende l'invio di email "facile come una torta." Per coloro che scelgono di usare questa libreria, abbiamo creato un trasporto SparkPost per Nodemailer. Dovrai installare i pacchetti nodemailer  e nodemailer-sparkpost-transport nel tuo progetto.

> npm install nodemailer nodemailer-sparkpost-transport --save

Ora puoi creare un'istanza di trasporto nodemailer:

const nodemailer = require('nodemailer') 
const sparkPostTransport = require('nodemailer-sparkpost-transport') 
const transporter = nodemailer.createTransport(sparkPostTransport({ 
  'sparkPostApiKey': process.env.SPARKPOST_API_KEY 
}))

Nota come leggo la chiave API da una variabile d'ambiente. È comunque una prassi migliore non inserirla direttamente nel tuo codice.

Ci sono diverse opzioni che possono essere passate al trasporto SparkPost, come l'id della campagna e se il messaggio è transazionale o meno. Dai un'occhiata al README.md per tutte le opzioni.

Ecco come invieresti lo stesso messaggio sopra usando Nodemailer:

transporter.sendMail(
  {
    from: 'test@your-sending-domain.com',
    to: 'someone@somedomain.com',
    subject: 'Hello from nodemailer-sparkpost-transport',
    html: '<p>Hello world</p>'
  },
  (err, info) => {
    if (err) {
      console.error(err);
    } else {
      console.log(info);
    }
  }
);

Nodemailer è una libreria popolare per Node.js che rende l'invio di email "facile come una torta." Per coloro che scelgono di usare questa libreria, abbiamo creato un trasporto SparkPost per Nodemailer. Dovrai installare i pacchetti nodemailer  e nodemailer-sparkpost-transport nel tuo progetto.

> npm install nodemailer nodemailer-sparkpost-transport --save

Ora puoi creare un'istanza di trasporto nodemailer:

const nodemailer = require('nodemailer') 
const sparkPostTransport = require('nodemailer-sparkpost-transport') 
const transporter = nodemailer.createTransport(sparkPostTransport({ 
  'sparkPostApiKey': process.env.SPARKPOST_API_KEY 
}))

Nota come leggo la chiave API da una variabile d'ambiente. È comunque una prassi migliore non inserirla direttamente nel tuo codice.

Ci sono diverse opzioni che possono essere passate al trasporto SparkPost, come l'id della campagna e se il messaggio è transazionale o meno. Dai un'occhiata al README.md per tutte le opzioni.

Ecco come invieresti lo stesso messaggio sopra usando Nodemailer:

transporter.sendMail(
  {
    from: 'test@your-sending-domain.com',
    to: 'someone@somedomain.com',
    subject: 'Hello from nodemailer-sparkpost-transport',
    html: '<p>Hello world</p>'
  },
  (err, info) => {
    if (err) {
      console.error(err);
    } else {
      console.log(info);
    }
  }
);

Nodemailer è una libreria popolare per Node.js che rende l'invio di email "facile come una torta." Per coloro che scelgono di usare questa libreria, abbiamo creato un trasporto SparkPost per Nodemailer. Dovrai installare i pacchetti nodemailer  e nodemailer-sparkpost-transport nel tuo progetto.

> npm install nodemailer nodemailer-sparkpost-transport --save

Ora puoi creare un'istanza di trasporto nodemailer:

const nodemailer = require('nodemailer') 
const sparkPostTransport = require('nodemailer-sparkpost-transport') 
const transporter = nodemailer.createTransport(sparkPostTransport({ 
  'sparkPostApiKey': process.env.SPARKPOST_API_KEY 
}))

Nota come leggo la chiave API da una variabile d'ambiente. È comunque una prassi migliore non inserirla direttamente nel tuo codice.

Ci sono diverse opzioni che possono essere passate al trasporto SparkPost, come l'id della campagna e se il messaggio è transazionale o meno. Dai un'occhiata al README.md per tutte le opzioni.

Ecco come invieresti lo stesso messaggio sopra usando Nodemailer:

transporter.sendMail(
  {
    from: 'test@your-sending-domain.com',
    to: 'someone@somedomain.com',
    subject: 'Hello from nodemailer-sparkpost-transport',
    html: '<p>Hello world</p>'
  },
  (err, info) => {
    if (err) {
      console.error(err);
    } else {
      console.log(info);
    }
  }
);

Doppio Bonus: Invio di email con notif.me

Sappiamo tutti che l'email è il re della comunicazione, ma a volte si desidera raggiungere le persone tramite più canali. notif.me è una libreria Node.js per inviare tutti i tipi di messaggi transazionali. Che tu voglia inviare un'email, un sms, un push o webpushes, puoi farlo con facilità. Ha anche strategie integrate di fallback e round robin per più fornitori. Recentemente abbiamo lavorato con i creatori per costruire un fornitore SparkPost. Dovrai installare il pacchetto `notifme-sdk` nel tuo progetto.

> npm install notifme-sdk --save

Ora puoi creare un'istanza di notifme con il fornitore SparkPost:

const NotifmeSdk = require('notifme-sdk').default;
const notifmeSdk = new NotifmeSdk({
  channels: {
    email: {
      providers: [
        {
          type: 'sparkpost',
          apiKey: process.env.SPARKPOST_API_KEY
        }
      ]
    }
  }
});

Ancora una volta, stiamo estraendo la chiave API da una variabile di ambiente. L'abbiamo detto tre volte: è così importante. 🙂

Ora ripetiamo questo stesso esempio, questa volta utilizzando notif.me:

notifmeSdk.send({
  email: {
    from: 'test@your-sending-domain.com',
    to: 'someone@somedomain.com',
    subject: 'Hello from the SparkPost notif.me provider',
    html: '<p>Hello world</p>'
  }
})
.then(console.log)
.catch(console.error);

È davvero facile da usare e ti consiglio di dare un'occhiata alle altre funzionalità.

Confronto delle opzioni per l'invio di email in Node.js

Metodo

Pacchetti Richiesti

Gestione della Chiave API

Ideale per

Note

API SparkPost (node-sparkpost)

sparkpost

Utilizza la variabile d'ambiente SPARKPOST_API_KEY

Controllo API diretto, accesso completo alle funzionalità delle Trasmissioni

Il più flessibile; supporta modelli, dati di sostituzione, allegati, campagne

Nodemailer + SparkPost Transport

nodemailer, nodemailer-sparkpost-transport

Utilizza la variabile d'ambiente nella configurazione del trasporto

Sviluppatori che già utilizzano Nodemailer

Percorso di migrazione più semplice; minime modifiche al codice

notif.me + Fornitore SparkPost

notifme-sdk

Utilizza la variabile d'ambiente nella configurazione del fornitore

Messaggistica multi-canale (email, SMS, push)

Include strategie di fallback + round-robin tra fornitori

Sappiamo tutti che l'email è il re della comunicazione, ma a volte si desidera raggiungere le persone tramite più canali. notif.me è una libreria Node.js per inviare tutti i tipi di messaggi transazionali. Che tu voglia inviare un'email, un sms, un push o webpushes, puoi farlo con facilità. Ha anche strategie integrate di fallback e round robin per più fornitori. Recentemente abbiamo lavorato con i creatori per costruire un fornitore SparkPost. Dovrai installare il pacchetto `notifme-sdk` nel tuo progetto.

> npm install notifme-sdk --save

Ora puoi creare un'istanza di notifme con il fornitore SparkPost:

const NotifmeSdk = require('notifme-sdk').default;
const notifmeSdk = new NotifmeSdk({
  channels: {
    email: {
      providers: [
        {
          type: 'sparkpost',
          apiKey: process.env.SPARKPOST_API_KEY
        }
      ]
    }
  }
});

Ancora una volta, stiamo estraendo la chiave API da una variabile di ambiente. L'abbiamo detto tre volte: è così importante. 🙂

Ora ripetiamo questo stesso esempio, questa volta utilizzando notif.me:

notifmeSdk.send({
  email: {
    from: 'test@your-sending-domain.com',
    to: 'someone@somedomain.com',
    subject: 'Hello from the SparkPost notif.me provider',
    html: '<p>Hello world</p>'
  }
})
.then(console.log)
.catch(console.error);

È davvero facile da usare e ti consiglio di dare un'occhiata alle altre funzionalità.

Confronto delle opzioni per l'invio di email in Node.js

Metodo

Pacchetti Richiesti

Gestione della Chiave API

Ideale per

Note

API SparkPost (node-sparkpost)

sparkpost

Utilizza la variabile d'ambiente SPARKPOST_API_KEY

Controllo API diretto, accesso completo alle funzionalità delle Trasmissioni

Il più flessibile; supporta modelli, dati di sostituzione, allegati, campagne

Nodemailer + SparkPost Transport

nodemailer, nodemailer-sparkpost-transport

Utilizza la variabile d'ambiente nella configurazione del trasporto

Sviluppatori che già utilizzano Nodemailer

Percorso di migrazione più semplice; minime modifiche al codice

notif.me + Fornitore SparkPost

notifme-sdk

Utilizza la variabile d'ambiente nella configurazione del fornitore

Messaggistica multi-canale (email, SMS, push)

Include strategie di fallback + round-robin tra fornitori

Sappiamo tutti che l'email è il re della comunicazione, ma a volte si desidera raggiungere le persone tramite più canali. notif.me è una libreria Node.js per inviare tutti i tipi di messaggi transazionali. Che tu voglia inviare un'email, un sms, un push o webpushes, puoi farlo con facilità. Ha anche strategie integrate di fallback e round robin per più fornitori. Recentemente abbiamo lavorato con i creatori per costruire un fornitore SparkPost. Dovrai installare il pacchetto `notifme-sdk` nel tuo progetto.

> npm install notifme-sdk --save

Ora puoi creare un'istanza di notifme con il fornitore SparkPost:

const NotifmeSdk = require('notifme-sdk').default;
const notifmeSdk = new NotifmeSdk({
  channels: {
    email: {
      providers: [
        {
          type: 'sparkpost',
          apiKey: process.env.SPARKPOST_API_KEY
        }
      ]
    }
  }
});

Ancora una volta, stiamo estraendo la chiave API da una variabile di ambiente. L'abbiamo detto tre volte: è così importante. 🙂

Ora ripetiamo questo stesso esempio, questa volta utilizzando notif.me:

notifmeSdk.send({
  email: {
    from: 'test@your-sending-domain.com',
    to: 'someone@somedomain.com',
    subject: 'Hello from the SparkPost notif.me provider',
    html: '<p>Hello world</p>'
  }
})
.then(console.log)
.catch(console.error);

È davvero facile da usare e ti consiglio di dare un'occhiata alle altre funzionalità.

Confronto delle opzioni per l'invio di email in Node.js

Metodo

Pacchetti Richiesti

Gestione della Chiave API

Ideale per

Note

API SparkPost (node-sparkpost)

sparkpost

Utilizza la variabile d'ambiente SPARKPOST_API_KEY

Controllo API diretto, accesso completo alle funzionalità delle Trasmissioni

Il più flessibile; supporta modelli, dati di sostituzione, allegati, campagne

Nodemailer + SparkPost Transport

nodemailer, nodemailer-sparkpost-transport

Utilizza la variabile d'ambiente nella configurazione del trasporto

Sviluppatori che già utilizzano Nodemailer

Percorso di migrazione più semplice; minime modifiche al codice

notif.me + Fornitore SparkPost

notifme-sdk

Utilizza la variabile d'ambiente nella configurazione del fornitore

Messaggistica multi-canale (email, SMS, push)

Include strategie di fallback + round-robin tra fornitori

Non c'è un modo sbagliato di usare Node

Quando si tratta di inviare email utilizzando Node.js, hai molte opzioni. Abbiamo lavorato duramente per rendere il tutto il meno doloroso possibile.

Altre notizie

Leggi di più da questa categoria

1 giu 2021

Inizia con l'estensione Bird su Firebase

6 ott 2020

Come utilizzare Flows con Google Vision API e Google Cloud Functions

24 giu 2021

Come usare SWAKS con SparkPost

A person is standing at a desk while typing on a laptop.

La piattaforma completa nativa dell'IA che si espande con la tua azienda.

Contatta le vendite

Inizia gratis

© 2026 Uccello

Contatta il supporto

A person is standing at a desk while typing on a laptop.

La piattaforma completa nativa dell'IA che si espande con la tua azienda.

Contatta le vendite

Inizia gratis

© 2026 Uccello

Contatta il supporto

A person is standing at a desk while typing on a laptop.

La piattaforma completa nativa dell'IA che si espande con la tua azienda.

Contatta le vendite

Inizia gratis

© 2026 Uccello

Contatta il supporto