On this page

JavaScript SDK

L’SDK JavaScript ufficiale Brevo fornisce un modo semplice per integrare i servizi Brevo nelle tue applicazioni Node.js.

Installazione

npm install @brevo/api
# oppure
yarn add @brevo/api

Avvio Rapido

const brevo = require('@brevo/api');

// Configura la chiave API
let apiInstance = new brevo.TransactionalEmailsApi();
apiInstance.setApiKey(brevo.TransactionalEmailsApiApiKeys.apiKey, 'YOUR_API_KEY');

// Invia email transazionale
let sendSmtpEmail = new brevo.SendSmtpEmail();
sendSmtpEmail.subject = "Ciao da Brevo";
sendSmtpEmail.htmlContent = "<html><body><h1>Ciao Mondo</h1></body></html>";
sendSmtpEmail.sender = { "name": "La Tua App", "email": "[email protected]" };
sendSmtpEmail.to = [{ "email": "[email protected]", "name": "Mario Rossi" }];

apiInstance.sendTransacEmail(sendSmtpEmail).then(
  data => console.log('Email inviata con successo:', data),
  error => console.error('Errore:', error)
);

Configurazione

Variabili d’Ambiente

// .env file
BREVO_API_KEY=your_api_key_here

// Configurazione
const brevo = require('@brevo/api');
const apiInstance = new brevo.TransactionalEmailsApi();
apiInstance.setApiKey(
  brevo.TransactionalEmailsApiApiKeys.apiKey,
  process.env.BREVO_API_KEY
);

API Disponibili

Email Transazionali

const emailApi = new brevo.TransactionalEmailsApi();
const smsApi = new brevo.TransactionalSMSApi();
const contactsApi = new brevo.ContactsApi();
const campaignsApi = new brevo.EmailCampaignsApi();
const accountApi = new brevo.AccountApi();

Esempi

Invia Email con Template

const sendTemplateEmail = async (templateId, recipientEmail, templateData) => {
  let sendSmtpEmail = new brevo.SendSmtpEmail();

  sendSmtpEmail.templateId = templateId;
  sendSmtpEmail.to = [{ email: recipientEmail }];
  sendSmtpEmail.params = templateData;

  try {
    const result = await emailApi.sendTransacEmail(sendSmtpEmail);
    return result;
  } catch (error) {
    console.error('Impossibile inviare l\'email:', error);
    throw error;
  }
};

Crea Contatto

const createContact = async (email, firstName, lastName) => {
  let createContactData = new brevo.CreateContact();

  createContactData.email = email;
  createContactData.attributes = {
    FIRSTNAME: firstName,
    LASTNAME: lastName
  };

  try {
    const result = await contactsApi.createContact(createContactData);
    return result;
  } catch (error) {
    console.error('Impossibile creare il contatto:', error);
    throw error;
  }
};

Gestione degli Errori

const handleBrevoError = (error) => {
  if (error.response) {
    // Risposta di errore API
    console.log('Status:', error.response.status);
    console.log('Data:', error.response.body);
  } else {
    // Errore di rete o altro
    console.log('Error:', error.message);
  }
};

// Utilizzo
try {
  await emailApi.sendTransacEmail(sendSmtpEmail);
} catch (error) {
  handleBrevoError(error);
}