> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# शुरू करें

## आप क्या बनाएंगे

इस गाइड के अंत तक, आपका एजेंट आपके बिज़नेस नंबर पर WhatsApp टेक्स्ट मैसेज और वॉइस नोट्स का जवाब देगा, और आप API से शुरू किया गया एक टेम्पलेट मैसेज भेज चुके होंगे। इसमें लगभग 20 मिनट लगेंगे, साथ ही Meta द्वारा आपके पहले टेम्पलेट को मंज़ूरी देने के लिए थोड़ा इंतज़ार करना होगा।

## शुरू करने से पहले

आपको चाहिए:

* एक [ElevenLabs एजेंट](/docs/hi/eleven-agents/quickstart)। कोई भी मौजूदा एजेंट काम करेगा।
* एक [Meta बिज़नेस पोर्टफोलियो](https://business.facebook.com/), जिसे आप एडमिन कर सकते हों।
* ऐसा फ़ोन नंबर जो अभी WhatsApp Business ऐप में इस्तेमाल न हो रहा हो या किसी दूसरे WhatsApp प्रदाता के साथ रजिस्टर्ड न हो। कहीं और उपयोग में मौजूद नंबर इंपोर्ट नहीं किए जा सकते — [सीमाएं](/docs/hi/eleven-agents/whatsapp#limitations) देखें।
* अगर आप टेम्पलेट भेजना या कॉल करना चाहते हैं, तो [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/) में भुगतान का तरीका। Meta इनका बिल ElevenLabs से अलग करता है।

#### अपना WhatsApp बिज़नेस अकाउंट इंपोर्ट करें

[WhatsApp पेज](https://elevenlabs.io/app/agents/whatsapp) पर जाएं और ***Import account*** बटन पर क्लिक करें। इससे Meta का ऑथराइज़ेशन फ्लो खुलता है, जहां आप WhatsApp बिज़नेस अकाउंट और फ़ोन नंबर चुनते हैं (या बनाते हैं) और ElevenLabs को इसे मैनेज करने की अनुमति देते हैं:

![WhatsApp ऑथराइज़ेशन फ्लो](/docs/_fern-img/9e5238e98f926582db314e9debc187a7dc29fd38a980cb732b4563b373110351.webp)

#### अपना एजेंट असाइन करें और व्यवहार चुनें

इंपोर्ट के बाद आप अकाउंट सेटिंग्स पेज पर पहुंचेंगे। एक एजेंट असाइन करें — जब तक आप ऐसा नहीं करते, इनबाउंड मैसेज अनदेखे किए जाते हैं और इनबाउंड कॉल अस्वीकार कर दी जाती हैं:

![WhatsApp अकाउंट पेज](/docs/_fern-img/f5598ac70ade00048effb5ee3bf6cbc93cd61876652eb3ce5917ac21c6209bf6.webp)

इस नंबर पर एजेंट का व्यवहार कॉन्फ़िगर करें (पूरे रेफरेंस के लिए [अकाउंट सेटिंग्स](/docs/hi/eleven-agents/whatsapp#account-settings) देखें):

* **मैसेजिंग सक्षम करें** — एजेंट मैसेज का जवाब देता है या नहीं। अगर कोई दूसरा सिस्टम मैसेज संभालता है और ElevenLabs को केवल कॉल संभालनी हैं, तो इसे बंद कर दें।
* **ऑडियो मैसेज जवाब सक्षम करें** — चालू होने पर एजेंट वॉइस नोट्स का जवाब अपनी आवाज़ में वॉइस नोट्स से देता है; बंद होने पर वह हमेशा टेक्स्ट में जवाब देता है।
* **टाइपिंग इंडिकेटर सक्षम करें** — चालू होने पर एजेंट इनकमिंग मैसेज को पढ़ा हुआ मार्क करता है और काम करते समय टाइपिंग इंडिकेटर दिखाता है।

#### अपनी पहली बातचीत करें

अपने निजी फ़ोन से अपने बिज़नेस नंबर पर मैसेज भेजें। एजेंट जवाब देगा। एक वॉइस नोट भेजें — एजेंट के लिए उसका ट्रांसक्रिप्शन बनता है और एजेंट अपने वॉइस नोट से जवाब देता है:

![WhatsApp टेक्स्ट बातचीत](/docs/_fern-img/4c31b4d2b5eccccd7cddfa81144176a6d3c32f4670add5306f3a6ef78bc05244.webp)

बातचीत होते ही आपकी [बातचीत हिस्ट्री](https://elevenlabs.io/app/agents/history) में दिखाई देती है।

> **Info**
>
> मैसेज बातचीत तब खत्म होती है जब एजेंट ***End conversation*** सिस्टम टूल इस्तेमाल करता है,
> ***Max conversation duration*** पूरा हो जाता है, या एजेंट के सबसे हाल के जवाब के बाद
> डिफ़ॉल्ट 15 मिनट का निष्क्रियता टाइमआउट बीत जाता है। यूज़र का अगला मैसेज एक नई
> बातचीत शुरू करता है। [बातचीत टाइमआउट्स](/docs/hi/eleven-agents/customization/conversation-flow#maximum-conversation-duration) के बारे में और जानें।

#### अपना पहला आउटबाउंड मैसेज भेजें

किसी यूज़र से पहले संपर्क करने के लिए Meta से मंज़ूर **मैसेज टेम्पलेट** चाहिए — WhatsApp सिर्फ़ सक्रिय बातचीत में फ़्री-फ़ॉर्म बिज़नेस मैसेज की अनुमति देता है। [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/message_templates) में एक आसान Utility टेम्पलेट बनाएं, उदाहरण के लिए:

```text
Hi {{name}}, thanks for signing up. Reply here if you have any questions.
```

टेम्पलेट मंज़ूर होने के बाद, इसे भेजें:

#### Python

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.whatsapp.outbound_message(
    whatsapp_phone_number_id="524029457612345",
    whatsapp_user_id="12213231492",
    template_name="welcome",
    template_language_code="en",
    template_params=[
        {
            "type": "body",
            "parameters": [
                {"type": "text", "parameter_name": "name", "text": "Daniele"}
            ],
        }
    ],
    agent_id="agent_9201kwcrbq9qfxaa2t8nnnkqf2w9",
)
```

#### TypeScript

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.whatsapp.outboundMessage({
  whatsappPhoneNumberId: "524029457612345",
  whatsappUserId: "12213231492",
  templateName: "welcome",
  templateLanguageCode: "en",
  templateParams: [
    {
      type: "body",
      parameters: [{ type: "text", parameterName: "name", text: "Daniele" }],
    },
  ],
  agentId: "agent_9201kwcrbq9qfxaa2t8nnnkqf2w9",
});
```

#### cURL

```bash
curl -X POST https://api.elevenlabs.io/v1/convai/whatsapp/outbound-message \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "whatsapp_phone_number_id": "524029457612345",
    "whatsapp_user_id": "12213231492",
    "template_name": "welcome",
    "template_language_code": "en",
    "template_params": [
      {
        "type": "body",
        "parameters": [
          {"type": "text", "parameter_name": "name", "text": "Daniele"}
        ]
      }
    ],
    "agent_id": "agent_9201kwcrbq9qfxaa2t8nnnkqf2w9"
  }'
```

यहां दो बातें महत्वपूर्ण हैं:

* `template_params` कंपोनेंट ऑब्जेक्ट्स की सूची है — `{"type": "body", ...}` रैपर ज़रूरी है।
* `whatsapp_user_id` में सिर्फ़ अंक होते हैं, कंट्री कोड के साथ और बिना `+` के (उदाहरण के लिए `14155552671`)।

[WhatsApp पेज](https://elevenlabs.io/app/agents/whatsapp) पर अकाउंट मेनू के ***Copy phone number ID*** विकल्प से अपना `whatsapp_phone_number_id` ढूंढें।

आपके फ़ोन पर टेम्पलेट आएगा। उसका जवाब दें — एजेंट वहां से बातचीत संभाल लेगा।

## अगर कुछ काम नहीं किया

* **एजेंट कभी जवाब नहीं देता**: नंबर पर कोई एजेंट असाइन नहीं है, या **मैसेजिंग सक्षम करें** बंद है। अगर ये सही लगते हैं, तो देखें कि एजेंट को [डायनामिक वेरिएबल्स](/docs/hi/eleven-agents/customization/personalization/dynamic-variables) की ज़रूरत तो नहीं — इनबाउंड WhatsApp बातचीत बिना यूज़र द्वारा दिए गए मानों के शुरू होती है, इसलिए जिस एजेंट के टूल्स या पहले मैसेज के लिए कोई मान चाहिए, वह जवाब देने से पहले विफल हो जाता है, जब तक बातचीत शुरू करने वाला वेबहुक उसे न दे। [इनिशियलाइज़ेशन कॉन्टेक्स्ट](/docs/hi/eleven-agents/whatsapp#initialization-context) देखें।
* **इंपोर्ट विफल होता है**: नंबर पहले से किसी दूसरे प्रदाता या WhatsApp Business ऐप के साथ रजिस्टर्ड है।
* **API ने 200 लौटाया, लेकिन कोई मैसेज नहीं आया**: टेम्पलेट अभी मंज़ूर नहीं है, पैरामीटर टेम्पलेट से मेल नहीं खाते, या आपके WhatsApp बिज़नेस अकाउंट में भुगतान बकाया है (Meta त्रुटि 131042)।
* **यूज़र के जवाब ने बिना कॉन्टेक्स्ट अलग बातचीत शुरू कर दी**: प्राप्तकर्ता ID का फ़ॉर्मैट गलत था — [प्राप्तकर्ता नंबर फ़ॉर्मैट](/docs/hi/eleven-agents/whatsapp/outbound#recipient-number-format) देखें।

बाकी सभी मामलों के लिए, [समस्या निवारण और FAQ](/docs/hi/eleven-agents/whatsapp/troubleshooting) देखें।

## अगले चरण

* [डायनामिक वेरिएबल्स](/docs/hi/eleven-agents/whatsapp/outbound#dynamic-variables-branches-and-environments) और [पर्सनलाइज़ेशन सिस्टम वेरिएबल्स](/docs/hi/eleven-agents/whatsapp#personalization) के साथ बातचीत को व्यक्तिगत बनाएं।
* [आउटबाउंड मैसेज और टेम्पलेट्स](/docs/hi/eleven-agents/whatsapp/outbound) के साथ बड़े स्तर पर संपर्क अभियान चलाएं।
* एजेंट को [इंटरैक्टिव मैसेज](/docs/hi/eleven-agents/whatsapp/interactive-messages) के साथ टैप करने योग्य विकल्प देने दें।
* दूसरे चैनलों पर मौजूद एजेंट्स से [WhatsApp टूल्स](/docs/hi/eleven-agents/whatsapp/tools) के जरिए WhatsApp मैसेज भेजें।
* [प्राइसिंग FAQ](/docs/hi/eleven-agents/whatsapp/troubleshooting#faq) में लागत समझें।