Sign inGet Started
शुरू करें
गाइड
API Reference
SDKs
CLI
Knowledge Base
Changelog

CLI

macOS या Linux टर्मिनल से अपना पहला ईमेल भेजें: bird CLI इंस्टॉल करें, एक बार लॉग इन करें, और भेजें। आपको API key कॉपी करने की ज़रूरत नहीं है।

1. इंस्टॉल करें

कोड उदाहरण
curl -fsSL https://cli.bird.com/install.sh | sh
इंस्टॉलेशन सफल हुआ यह पुष्टि करने के लिए bird version चलाएँ। Windows और अन्य इंस्टॉलेशन विकल्पों के लिए CLI इंस्टॉल करें देखें।

2. लॉग इन करें

कोड उदाहरण
bird auth login --scope emails:write
यह एक ब्राउज़र consent पेज खोलता है जहाँ आप वर्कस्पेस चुनते हैं और grant स्वीकृत करते हैं। emails:write scope स्टेप 3 को भेजने की अनुमति देता है। इसके बिना, bird auth login केवल read-only एक्सेस माँगता है और भेजना अस्वीकार हो जाता है। CLI एक वर्कस्पेस-बाउंड OAuth टोकन ~/.config/bird/credentials.json में स्टोर करता है, ज़रूरत पड़ने पर उसे रिफ़्रेश करता है, और वर्कस्पेस region रिकॉर्ड करता है।

3. ईमेल भेजें

Bird के शेयर्ड onboarding डोमेन से delivered@messagebird.dev sandbox पते पर भेजें: कोई डोमेन सत्यापन नहीं, कोई असली मेलबॉक्स नहीं चाहिए।
कोड उदाहरण
bird email send \
  --from onboarding@messagebird.dev \
  --to delivered@messagebird.dev \
  --subject "Hello from Bird" \
  --html "<p>My first Bird email.</p>"
CLI स्वीकृत संदेश को JSON के रूप में प्रिंट करता है। *_count फ़ील्ड डिलीवरी स्थितियों के ज़रिए प्राप्तकर्ताओं को ट्रैक करते हैं। शुरुआती प्रतिक्रिया में, एक प्राप्तकर्ता स्वीकृत है और कोई भी डिलीवर नहीं हुआ:
कोड उदाहरण
{
  "id": "em_01ky7ma8y2es1s2akzk53tmjn0",
  "status": "accepted",
  "category": "marketing",
  "from": { "email": "onboarding@messagebird.dev" },
  "to": [{ "email": "delivered@messagebird.dev" }],
  "subject": "Hello from Bird",
  "accepted_count": 1,
  "processed_count": 0,
  "delivered_count": 0,
  "deferred_count": 0,
  "bounced_count": 0,
  "complained_count": 0,
  "rejected_count": 0,
  "open_count": 0,
  "click_count": 0,
  "track_opens": true,
  "track_clicks": true,
  "created_at": "2026-07-23T13:58:20.866Z"
}
--to कई प्राप्तकर्ताओं के लिए दोहराया जा सकता है, --text एक plain-text बॉडी भेजता है, और --dry-run भेजे बिना resolved अनुरोध प्रिंट करता है।

4. परिणाम जाँचें

accepted का मतलब है कि Bird ने संदेश स्वीकार किया और उसे असिंक्रोनस रूप से डिलीवर करता है। इसे em_ ID से वापस पढ़ें और स्टेटस को delivered तक पहुँचते देखें:
कोड उदाहरण
bird email get em_01ky7ma8y2es1s2akzk53tmjn0
JSON के बजाय मानव-पठनीय कार्ड के लिए --format text जोड़ें।
हर कमांड डिफ़ॉल्ट रूप से standard output पर JSON लिखता है। त्रुटियाँ standard error पर JSON त्रुटि प्रतिक्रिया का उपयोग करती हैं, और exit code विफलता श्रेणियों की पहचान करते हैं। पूरे अनुबंध के लिए एजेंट्स के लिए CLI देखें।

अगले कदम

संबंधित संसाधन

इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।

गाइड देखेंTesting email without spamming anyoneक्षमता जानेंTest email deliveryलर्निंग पाथ फ़ॉलो करेंOperate messaging reliably
अभ्यास करें और इम्प्लीमेंटेशन ब्रीफ़ पाएँ