ابتدائی رسائی کی درخواست کریں

اپنا پہلا نام اور ای میل یا فون نمبر درج کریں۔ ہم Tajo تک رسائی کی تفصیلات کے ساتھ آپ سے رابطہ کریں گے۔

ای میل بھیجیں

/v3/smtp/email اینڈ پوائنٹ استعمال کرتے ہوئے انفرادی ٹرانزیکشنل ای میلز بھیجیں۔

اینڈ پوائنٹ

POST /v3/smtp/email

درخواست کی باڈی

بنیادی ای میل

{
  "sender": {
    "name": "Your App",
    "email": "[email protected]"
  },
  "to": [
    {
      "email": "[email protected]",
      "name": "John Doe"
    }
  ],
  "subject": "Welcome to our service!",
  "htmlContent": "<html><body><h1>Welcome!</h1><p>Thank you for signing up.</p></body></html>"
}

جدید ای میل

{
  "sender": {
    "name": "Your App",
    "email": "[email protected]"
  },
  "to": [
    {
      "email": "[email protected]",
      "name": "John Doe"
    }
  ],
  "cc": [
    {
      "email": "[email protected]",
      "name": "CC User"
    }
  ],
  "bcc": [
    {
      "email": "[email protected]"
    }
  ],
  "subject": "Order Confirmation #{{order_id}}",
  "htmlContent": "<html><body><h1>Order Confirmed</h1><p>Your order {{order_id}} has been confirmed.</p></body></html>",
  "textContent": "Your order {{order_id}} has been confirmed.",
  "params": {
    "order_id": "12345"
  },
  "tags": ["transactional", "order-confirmation"],
  "headers": {
    "X-Custom-Header": "custom-value"
  }
}

کوڈ کی مثالیں

JavaScript/Node.js

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

const apiInstance = new brevo.TransactionalEmailsApi();
apiInstance.setApiKey(brevo.TransactionalEmailsApiApiKeys.apiKey, process.env.BREVO_API_KEY);

const sendEmail = async () => {
  const sendSmtpEmail = new brevo.SendSmtpEmail();

  sendSmtpEmail.subject = "Welcome to our service!";
  sendSmtpEmail.htmlContent = "<html><body><h1>Welcome!</h1></body></html>";
  sendSmtpEmail.sender = { name: "Your App", email: "[email protected]" };
  sendSmtpEmail.to = [{ email: "[email protected]", name: "John Doe" }];

  try {
    const result = await apiInstance.sendTransacEmail(sendSmtpEmail);
    console.log('Email sent:', result);
    return result;
  } catch (error) {
    console.error('Error sending email:', error);
    throw error;
  }
};

Python

import sib_api_v3_sdk
from sib_api_v3_sdk.rest import ApiException

configuration = sib_api_v3_sdk.Configuration()
configuration.api_key['api-key'] = 'YOUR_API_KEY'

api_instance = sib_api_v3_sdk.TransactionalEmailsApi(sib_api_v3_sdk.ApiClient(configuration))

send_smtp_email = sib_api_v3_sdk.SendSmtpEmail(
    to=[{"email": "[email protected]", "name": "John Doe"}],
    sender={"name": "Your App", "email": "[email protected]"},
    subject="Welcome to our service!",
    html_content="<html><body><h1>Welcome!</h1></body></html>"
)

try:
    api_response = api_instance.send_transac_email(send_smtp_email)
    print(api_response)
except ApiException as e:
    print("Exception when calling TransactionalEmailsApi->send_transac_email: %s\n" % e)

cURL

curl -X POST "https://api.brevo.com/v3/smtp/email" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "api-key: YOUR_API_KEY" \
  -d '{
    "sender": {
      "name": "Your App",
      "email": "[email protected]"
    },
    "to": [
      {
        "email": "[email protected]",
        "name": "John Doe"
      }
    ],
    "subject": "Welcome to our service!",
    "htmlContent": "<html><body><h1>Welcome!</h1></body></html>"
  }'

جواب

کامیابی کا جواب (201 Created)

{
  "messageId": "<[email protected]>"
}

خامی کے جوابات

غلط API کلید (401)

{
  "code": "unauthorized",
  "message": "Invalid API key provided"
}

ای میل کا غلط فارمیٹ (400)

{
  "code": "invalid_parameter",
  "message": "Invalid email format in 'to' field"
}

ریٹ لمٹ سے تجاوز (429)

{
  "code": "too_many_requests",
  "message": "Rate limit exceeded"
}

پیرامیٹرز

لازمی پیرامیٹرز

پیرامیٹر	قسم	تفصیل
`sender`	object	بھیجنے والے کی معلومات
`to`	array	وصول کنندگان کے آبجیکٹس کی array
`subject`	string	ای میل کی سبجیکٹ لائن

اختیاری پیرامیٹرز

پیرامیٹر	قسم	تفصیل
`htmlContent`	string	ای میل کا HTML مواد
`textContent`	string	ای میل کا ٹیکسٹ مواد
`cc`	array	CC وصول کنندگان
`bcc`	array	BCC وصول کنندگان
`replyTo`	object	جواب دینے کا پتہ
`attachments`	array	فائل اٹیچمنٹس
`params`	object	ٹیمپلیٹ کے پیرامیٹرز
`tags`	array	ٹریکنگ کے لیے ای میل ٹیگز
`headers`	object	کسٹم ہیڈرز

ٹیمپلیٹ ویری ایبلز

اپنے سبجیکٹ اور مواد میں ٹیمپلیٹ ویری ایبلز استعمال کریں:

{
  "subject": "Welcome {{firstName}}!",
  "htmlContent": "<h1>Hello {{firstName}} {{lastName}}</h1>",
  "params": {
    "firstName": "John",
    "lastName": "Doe"
  }
}

اٹیچمنٹس

فائل اٹیچمنٹس شامل کریں:

{
  "attachments": [
    {
      "content": "base64_encoded_content",
      "name": "invoice.pdf"
    },
    {
      "url": "https://example.com/document.pdf",
      "name": "document.pdf"
    }
  ]
}

بہترین طریقے

HTML اور ٹیکسٹ دونوں مواد ہمیشہ شامل کریں تاکہ ڈیلیوری بہتر ہو
ٹیمپلیٹ ویری ایبلز استعمال کریں، مواد کو جوڑنے کے بجائے
بھیجنے والے کی درست معلومات شامل کریں تاکہ اسپام فلٹرز سے بچا جا سکے
ٹیگز شامل کریں ٹریکنگ اور اینالیٹکس کے لیے
ای میل پتوں کی تصدیق کریں بھیجنے سے پہلے
خامیوں کو احتیاط سے سنبھالیں ری ٹرائی لاجک کے ساتھ

ریٹ لمٹس

مفت اکاؤنٹس: 300 ای میلز فی دن
ادا شدہ اکاؤنٹس: آپ کے پلان کے مطابق
برسٹ لمٹ: 100 ای میلز فی منٹ

ٹریکنگ

اس اینڈ پوائنٹ کے ذریعے بھیجی گئی ای میلز کے لیے یہ خودکار طور پر ٹریک ہوتا ہے:

ڈیلیوری کی حالت
اوپن ریٹس
کلک ٹریکنگ
باؤنس ہینڈلنگ

تفصیلی اینالیٹکس اپنے Brevo ڈیش بورڈ میں Statistics → Transactional کے تحت دیکھیں۔

ٹرانزیکشنل ای میلز

ٹرانزیکشنل SMS

رابطے

ایونٹس