---
title: "अपना पहला WhatsApp संदेश भेजें"
description: "Bird API कुंजी बनाएँ, नंबर कनेक्ट किए बिना अपने फ़ोन पर पहले से स्वीकृत WhatsApp टेम्पलेट संदेश भेजें, और उसकी डिलीवरी स्थिति जाँचें।"
canonical: "https://bird.com/hi-in/dastavez/get-started/send-your-first-whatsapp"
---

# अपना पहला WhatsApp संदेश भेजें

Bird WhatsApp से अपने फ़ोन पर WhatsApp संदेश भेजें, फिर डिलीवरी की पुष्टि के लिए संदेश को वापस पढ़ें। व्यवसाय की ओर से शुरू किए गए संदेशों के लिए पहले से स्वीकृत टेम्पलेट ज़रूरी है। यह क्विकस्टार्ट Bird के प्रबंधित टेम्पलेट कैटलॉग (जैसे `bird_delivery_update` या `bird_otp`) से भेजता है, जो Bird द्वारा प्रबंधित साझा WhatsApp प्रेषक का उपयोग करता है। आपको पहले WhatsApp Business Account कनेक्ट करने या नंबर पंजीकृत करने की ज़रूरत नहीं है।

शुरू करने से पहले सुनिश्चित करें कि आपके संगठन के वॉलेट में राशि है। WhatsApp टेम्पलेट संदेश भेजने का शुल्क वॉलेट से कटता है, और जिस संदेश का खर्च शेष राशि से पूरा नहीं होता, उसे Bird `402` `WalletInsufficientBalance` के साथ अस्वीकार कर देता है। वॉलेट में राशि जोड़ने का तरीका [भुगतान के तरीके और वॉलेट](/docs/knowledge-base/billing/payment-methods-wallet) में बताया गया है।

## 1. API कुंजी बनाएँ

डैशबोर्ड में **Platform tools** > [**API keys**](https://bird.com/dashboard/w/api-keys) पर जाएँ और `whatsapp:write` स्कोप वाली कुंजी बनाएँ, जिससे संदेश भेजे और पढ़े जा सकते हैं। कुंजियाँ किसी एक क्षेत्र तक सीमित होती हैं और `bk_us1_...` या `bk_eu1_...` जैसी दिखती हैं। प्रीफ़िक्स में दिया क्षेत्र बताता है कि किस API होस्ट को कॉल करना है: `https://us1.platform.bird.com` या `https://eu1.platform.bird.com`।

![Bird डैशबोर्ड में API Keys पेज, जिसमें कुंजियाँ उनके छिपे हुए प्रीफ़िक्स, स्कोप और अंतिम उपयोग के समय के साथ सूचीबद्ध हैं](/images/docs/dashboard-api-keys.png)

पूरी कुंजी केवल **एक बार**, बनाते समय दिखाई जाती है। इसे किसी सुरक्षित जगह कॉपी करें, फिर cURL उदाहरणों के लिए इसे एक्सपोर्ट करें:

```bash
export BIRD_API_KEY="bk_us1_..."
```

## 2. टेम्पलेट संदेश भेजें

Bird के प्रबंधित कैटलॉग से पहले से स्वीकृत `bird_delivery_update` टेम्पलेट अपने फ़ोन पर भेजें, या एक बार उपयोग होने वाला सत्यापन कोड भेजने के लिए `bird_otp` का उपयोग करें। प्रबंधित टेम्पलेट `bird_` से शुरू होते हैं और साझा Bird नंबर से भेजे जाते हैं, इसलिए आप `from` नहीं देते। अपनी भाषा के लिए Bird SDK उसके [SDK क्विकस्टार्ट](/docs/get-started/quickstarts) के अनुसार इंस्टॉल करें। अगर आप [Bird CLI](/docs/cli) टैब का उपयोग करते हैं, तो पहले उसे इंस्टॉल करें (`curl -fsSL https://cli.bird.com/install.sh | sh`) और लिखने की अनुमति के साथ प्रमाणित करें (`bird auth login --scope whatsapp:write`)।

SDK टैब में उदाहरण वाली API कुंजी बदलें, और `+15551234567` की जगह [E.164](https://en.wikipedia.org/wiki/E.164) फ़ॉर्मैट में अपना मोबाइल नंबर डालें। CLI आपके लॉगिन का उपयोग करता है, और cURL टैब `BIRD_API_KEY` का उपयोग करता है।

**TypeScript**

```typescript
import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: "bk_XXXXXXXXXXXXXXXXXXXXXXXX" });

const msg = await bird.whatsapp.send({
  to: "+15551234567",
  template: {
    slug: "bird_delivery_update",
    components: [
      {
        type: "body",
        parameters: [
          { type: "text", name: "ref", text: "A1B2C3D4" },
          { type: "text", name: "date", text: "10 Jul 2026" },
        ],
      },
    ],
  },
});

console.log(msg.id, msg.status);
```

Examples: [TypeScript](/hi-in/dastavez/get-started/send-your-first-whatsapp.ts.md) · [Python](/hi-in/dastavez/get-started/send-your-first-whatsapp.py.md) · [Go](/hi-in/dastavez/get-started/send-your-first-whatsapp.go.md) · [PHP](/hi-in/dastavez/get-started/send-your-first-whatsapp.php.md) · [CLI](/hi-in/dastavez/get-started/send-your-first-whatsapp.cli.md) · [MCP](/hi-in/dastavez/get-started/send-your-first-whatsapp.mcp.md) · [cURL](/hi-in/dastavez/get-started/send-your-first-whatsapp.curl.md)

यदि आपकी कुंजी `bk_eu1_` से शुरू होती है, तो इसके बजाय `https://eu1.platform.bird.com` को कॉल करें।

API `202 Accepted` और बनाए गए संदेश के साथ प्रतिक्रिया देता है। इसका `id` `wam_` से शुरू होता है, और इसका `status` `accepted` होता है: Bird ने संदेश स्वीकार कर लिया है और उसे एसिंक्रोनस रूप से डिलीवर करता है। अगले चरण के लिए `id` संभालकर रखें।

## 3. डिलीवरी की स्थिति जाँचें

संदेश को उसकी `wam_` ID से प्राप्त करें। `WHATSAPP_MESSAGE_ID` को चरण 2 के `id` से बदलें, और SDK टैब में उदाहरण वाली API कुंजी को अपनी कुंजी से बदलें:

**TypeScript**

```typescript
import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: "bk_XXXXXXXXXXXXXXXXXXXXXXXX" });

const msg = await bird.whatsapp.get("WHATSAPP_MESSAGE_ID");

console.log(msg.id, msg.status);
```

Examples: [TypeScript](/hi-in/dastavez/get-started/send-your-first-whatsapp.ts.md) · [Python](/hi-in/dastavez/get-started/send-your-first-whatsapp.py.md) · [Go](/hi-in/dastavez/get-started/send-your-first-whatsapp.go.md) · [PHP](/hi-in/dastavez/get-started/send-your-first-whatsapp.php.md) · [CLI](/hi-in/dastavez/get-started/send-your-first-whatsapp.cli.md) · [cURL](/hi-in/dastavez/get-started/send-your-first-whatsapp.curl.md)

`status` फ़ील्ड बताता है कि संदेश किस स्थिति में है:

- `accepted`: Bird ने संदेश स्वीकार कर लिया है और उसे WhatsApp को सौंपने की तैयारी कर रहा है।
- `sent`: WhatsApp ने संदेश स्वीकार कर लिया, और `sent_at` में इसका समय दर्ज होता है।
- `delivered`: WhatsApp ने प्राप्तकर्ता के डिवाइस पर डिलीवरी की पुष्टि की, और `delivered_at` में इसका समय दर्ज होता है। जब प्राप्तकर्ता संदेश पढ़ लेता है, तो `read_at` सेट हो जाता है, जबकि `status` `delivered` ही रहता है।
- `failed` या `rejected`: संदेश फ़ोन तक नहीं पहुँचा। `last_error` इसका कारण बताता है, और [संदेश स्थिति इवेंट](/docs/guides/whatsapp/events/message-status) में त्रुटि कोड की सूची है।

तब तक पोल करते रहें जब तक स्थिति `accepted` और `sent` से आगे न बढ़ जाए, या डिलीवरी और पढ़े जाने की हर स्थिति बदलने की सूचना (`whatsapp.sent`, `whatsapp.delivered`, `whatsapp.read`, `whatsapp.failed`) पाने के लिए [WhatsApp वेबहुक](/docs/guides/whatsapp/webhooks) की सदस्यता लें। साझा Bird-प्रबंधित नंबर केवल संदेश भेजते हैं और आने वाले जवाब आपके वर्कस्पेस तक नहीं पहुँचाते; जवाब पाने के लिए [अपना नंबर कनेक्ट करें](/docs/guides/whatsapp/numbers/connect)। हर संदेश अपनी इवेंट टाइमलाइन के साथ [**Messages**](https://bird.com/dashboard/w/whatsapp/messages) पेज पर भी दिखता है।

## विफल संदेश को ठीक करें

- **`402` `WalletInsufficientBalance`**: वॉलेट में संदेश का खर्च उठाने लायक बैलेंस नहीं है। वॉलेट में पैसे जोड़ें, फिर दोबारा भेजें।
- **`403` `InsufficientScope`**: API कुंजी में `whatsapp` स्कोप नहीं है। कुंजी के स्कोप संपादित करें या `whatsapp:write` वाली नई कुंजी बनाएँ।
- **`422` `WhatsAppInvalidRecipient`**: `to` नंबर मान्य E.164 फ़ोन नंबर नहीं है। शुरुआती `+`, देश कोड और सब्सक्राइबर अंक जाँचें।

## आगे के चरण

- [WhatsApp संदेश भेजना](/docs/guides/whatsapp/sending-whatsapp): 24 घंटे की ग्राहक सेवा विंडो के भीतर टेम्पलेट और मुक्त-रूप सेवा संदेश भेजें।
- [WhatsApp टेम्पलेट](/docs/guides/whatsapp/templates): प्रबंधित कैटलॉग (`bird_otp`, `bird_delivery_update` और अन्य) देखें या [अपने स्वयं के टेम्पलेट बनाएँ](/docs/guides/whatsapp/authoring-templates)।
- [फ़ोन नंबर कनेक्ट करें](/docs/guides/whatsapp/numbers/connect): अपना स्वयं का WhatsApp Business Account और प्रेषक नंबर जोड़ें, ताकि आपका वर्कस्पेस आने वाले जवाब भी प्राप्त कर सके।
- [WhatsApp वेबहुक](/docs/guides/whatsapp/webhooks): डिलीवरी रसीदें और पढ़ने की रसीदें प्राप्त करें (और अपना स्वयं का कनेक्ट किया गया नंबर इस्तेमाल करने पर आने वाले संदेश भी)।
- [WhatsApp API संदर्भ](/docs/api/reference/create-whatsapp-message): पूरा अनुरोध और प्रतिक्रिया स्कीमा।

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [Connect WhatsApp](/whatsapp-api) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp-connect)