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

اپنا پہلا نام اور دفتری ای میل پتہ درج کریں۔ ہم 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

Terminal window
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"
}

پیرامیٹرز

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

پیرامیٹرقسمتفصیل
senderobjectبھیجنے والے کی معلومات
toarrayوصول کنندگان کے آبجیکٹس کی array
subjectstringای میل کی سبجیکٹ لائن

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

پیرامیٹرقسمتفصیل
htmlContentstringای میل کا HTML مواد
textContentstringای میل کا ٹیکسٹ مواد
ccarrayCC وصول کنندگان
bccarrayBCC وصول کنندگان
replyToobjectجواب دینے کا پتہ
attachmentsarrayفائل اٹیچمنٹس
paramsobjectٹیمپلیٹ کے پیرامیٹرز
tagsarrayٹریکنگ کے لیے ای میل ٹیگز
headersobjectکسٹم ہیڈرز

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

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

{
"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"
}
]
}

بہترین طریقے

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

ریٹ لمٹس

  • API ریٹ لمٹ: جنرل ٹائر پر، جو ہر پلان کو ملتا ہے، یہ اینڈ پوائنٹ فی سیکنڈ 1,000 اور فی گھنٹہ 3,600,000 درخواستوں کی اجازت دیتا ہے۔ ایڈوانسڈ ٹائر (Professional اور Enterprise) فی سیکنڈ 2,000 اور ایکسٹینڈڈ ٹائر (Enterprise) 6,000 کی اجازت دیتا ہے۔
  • بھیجنے کا حجم: آپ کتنی ای میلز بھیج سکتے ہیں، یہ آپ کے Brevo پلان سے طے ہوتا ہے، جو ریٹ لمٹ سے الگ ہے۔

ریٹ لمٹس اور Brevo کا ریٹ لمٹس صفحہ دیکھیں۔

ٹریکنگ

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

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

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

متعلقہ اینڈ پوائنٹس

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

اپنا پہلا نام اور دفتری ای میل پتہ درج کریں۔ ہم Tajo تک رسائی کی درخواست کی تصدیق کے لیے ایک لنک ای میل کریں گے۔

AI معاون

السلام علیکم! دستاویزات کے بارے میں کچھ بھی پوچھیں۔

یہ صفحہ Markdown میں: send-email.md

Markdown لوڈ ہو رہا ہے…
Claude میں کھولیں ChatGPT میں کھولیں