अर्ली एक्सेस का अनुरोध करें

अपना नाम और ईमेल या फ़ोन नंबर दर्ज करें. हम 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 Key (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	प्राप्तकर्ता ऑब्जेक्ट का ऐरे
`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

संपर्क

इवेंट