اطلب الوصول المبكر

أدخل اسمك الأول وبريدك الإلكتروني أو رقم هاتفك. سنتواصل معك لتزويدك بتفاصيل الوصول إلى Tajo.

في هذه الصفحة

حزمة JavaScript SDK

توفّر حزمة Brevo JavaScript SDK الرسمية طريقة بسيطة لدمج خدمات Brevo في تطبيقات Node.js لديك.

التثبيت

npm install @getbrevo/brevo
# or
yarn add @getbrevo/brevo

البدء السريع

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

// Configure API key
let apiInstance = new brevo.TransactionalEmailsApi();
apiInstance.setApiKey(brevo.TransactionalEmailsApiApiKeys.apiKey, 'YOUR_API_KEY');

// Send transactional email
let sendSmtpEmail = new brevo.SendSmtpEmail();
sendSmtpEmail.subject = "Hello from Brevo";
sendSmtpEmail.htmlContent = "<html><body><h1>Hello World</h1></body></html>";
sendSmtpEmail.sender = { "name": "Your App", "email": "[email protected]" };
sendSmtpEmail.to = [{ "email": "[email protected]", "name": "John Doe" }];

apiInstance.sendTransacEmail(sendSmtpEmail).then(
  data => console.log('Email sent successfully:', data),
  error => console.error('Error:', error)
);

الإعداد

متغيّرات البيئة

// .env file
BREVO_API_KEY=your_api_key_here

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

واجهات API المتاحة

رسائل البريد الإلكتروني للمعاملات

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();

أمثلة

إرسال بريد إلكتروني باستخدام قالب

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('Failed to send email:', error);
    throw error;
  }
};

إنشاء جهة اتصال

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('Failed to create contact:', error);
    throw error;
  }
};

معالجة الأخطاء

const handleBrevoError = (error) => {
  if (error.response) {
    // API error response
    console.log('Status:', error.response.status);
    console.log('Data:', error.response.body);
  } else {
    // Network or other error
    console.log('Error:', error.message);
  }
};

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