> 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 **इंटरैक्टिव मैसेज** भेज सकता है: अधिकतम तीन टैप करने योग्य रिप्लाई बटन या अधिकतम दस विकल्पों की लिस्ट। यूज़र का टैप उसके अगले मैसेज के रूप में वापस आता है और एजेंट को ठीक-ठीक पता चलता है कि कौन-सा विकल्प चुना गया।

इंटरैक्टिव मैसेज सिर्फ़ सक्रिय WhatsApp मैसेज बातचीत में काम करते हैं। एजेंट इन्हें दो इंटीग्रेशन टूल्स के जरिए भेजता है:

* **Send Interactive Buttons** — छोटे विकल्प सेट के लिए अधिकतम तीन रिप्लाई बटन।
* **Send Interactive List** — तीन से अधिक विकल्पों के लिए सेक्शन में व्यवस्थित विकल्पों की टैप करने योग्य लिस्ट।

स्रोत: [WhatsApp इंटरैक्टिव मैसेज के लिए Meta की गाइड](https://developers.facebook.com/docs/whatsapp/guides/interactive-messages/)।

## टूल्स सक्षम करना

#### WhatsApp इंटीग्रेशन जोड़ें

अपना WhatsApp बिज़नेस अकाउंट इंपोर्ट करें ([निर्देश](/docs/hi/eleven-agents/whatsapp)), फिर
[Integrations पेज](https://elevenlabs.io/app/agents/integrations) पर जाएं, **\_Add
integration \_** बटन पर क्लिक करें, WhatsApp चुनें और अपना अकाउंट कनेक्ट करें।

#### टूल्स जोड़ें

[Tools पेज](https://elevenlabs.io/app/agents/tools) पर जाएं, **\_Add integration
tool \_** बटन पर क्लिक करें, WhatsApp इंटीग्रेशन चुनें और **\_ Send Interactive Buttons \_** और
***Send Interactive List*** टूल्स जोड़ें।

> **Warning**
>
> अगर आपने एक से ज़्यादा WhatsApp अकाउंट इंपोर्ट किए हैं, तो हर एक का अपना WhatsApp इंटीग्रेशन होता है।
> पक्का करें कि आप उस अकाउंट से जुड़े इंटीग्रेशन के टूल्स जोड़ें जिसे आपका एजेंट इस्तेमाल करता है —
> किसी दूसरे अकाउंट के इंटीग्रेशन से जोड़े गए टूल्स इस एजेंट की
> बातचीत के लिए काम नहीं करेंगे।

#### टूल्स को अपने एजेंट से जोड़ें

अपने एजेंट कॉन्फ़िगरेशन में टूल्स जोड़ें। टूल्स हमेशा लाइव बातचीत के यूज़र को मैसेज भेजते हैं —
एजेंट कंटेंट चुनता है, प्राप्तकर्ता कभी नहीं।

## इंटरैक्टिव बटन भेजें

**Send Interactive Buttons** मौजूदा WhatsApp मैसेज बातचीत में एक से तीन विकल्प दिखाता है।

| पैरामीटर      | ज़रूरी | विवरण                                                   |
| ------------- | ------ | ------------------------------------------------------- |
| `body_text`   | हाँ    | बटन के ऊपर दिखने वाला मैसेज। अधिकतम 1024 वर्ण।          |
| `buttons`     | हाँ    | डिस्प्ले क्रम में एक से तीन बटन। शीर्षक अलग होने चाहिए। |
| `footer_text` | नहीं   | बटन के नीचे दिखने वाला छोटा टेक्स्ट। अधिकतम 60 वर्ण।    |

हर बटन में ये होते हैं:

| फ़ील्ड  | ज़रूरी | विवरण                                                                               |
| ------- | ------ | ----------------------------------------------------------------------------------- |
| `id`    | हाँ    | यूज़र के इस बटन को टैप करने पर वापस रिपोर्ट किया गया आइडेंटिफ़ायर। अधिकतम 256 वर्ण। |
| `title` | हाँ    | बटन लेबल। अधिकतम 20 वर्ण।                                                           |

## इंटरैक्टिव लिस्ट भेजें

**Send Interactive List** मौजूदा WhatsApp मैसेज बातचीत में सेक्शन में व्यवस्थित विकल्प दिखाता है। यूज़र लिस्ट खोलता है और एक पंक्ति चुनता है।

| पैरामीटर      | ज़रूरी | विवरण                                                                                      |
| ------------- | ------ | ------------------------------------------------------------------------------------------ |
| `body_text`   | हाँ    | लिस्ट के ऊपर दिखने वाला मैसेज। अधिकतम 4096 वर्ण।                                           |
| `button_text` | हाँ    | लिस्ट खोलने वाले बटन का लेबल। अधिकतम 20 वर्ण।                                              |
| `sections`    | हाँ    | विकल्पों के एक से 10 समूह। सभी सेक्शन मिलाकर एक लिस्ट में अधिकतम 10 पंक्तियां हो सकती हैं। |
| `header_text` | नहीं   | मैसेज बॉडी के ऊपर दिखने वाली हेडिंग। अधिकतम 60 वर्ण।                                       |
| `footer_text` | नहीं   | लिस्ट के नीचे दिखने वाला छोटा टेक्स्ट। अधिकतम 60 वर्ण।                                     |

हर सेक्शन में ये होते हैं:

| फ़ील्ड  | ज़रूरी | विवरण                          |
| ------- | ------ | ------------------------------ |
| `title` | हाँ    | सेक्शन हेडिंग। अधिकतम 24 वर्ण। |
| `rows`  | हाँ    | इस सेक्शन में एक से 10 विकल्प। |

हर पंक्ति में ये होते हैं:

| फ़ील्ड        | ज़रूरी | विवरण                                                                               |
| ------------- | ------ | ----------------------------------------------------------------------------------- |
| `id`          | हाँ    | यूज़र के इस पंक्ति को चुनने पर वापस रिपोर्ट किया गया आइडेंटिफ़ायर। अधिकतम 200 वर्ण। |
| `title`       | हाँ    | पंक्ति लेबल। अधिकतम 24 वर्ण।                                                        |
| `description` | नहीं   | पंक्ति लेबल के नीचे दिखने वाला सेकेंडरी टेक्स्ट। अधिकतम 72 वर्ण।                    |

अगर एजेंट सीमा से ज़्यादा कंटेंट बनाता है, तो टूल कॉल विफल हो जाती है और एजेंट को कारण बताया जाता है, ताकि वह छोटे कंटेंट के साथ फिर कोशिश कर सके।

## एजेंट को प्रॉम्प्ट करना

सिस्टम प्रॉम्प्ट में एजेंट को बताएं कि विकल्प कब देने हैं। उदाहरण के लिए:

```text
When you need the user to pick from a fixed set of options (appointment slots,
product variants, yes/no confirmations), use the Send Interactive Buttons tool
for up to 3 options or the Send Interactive List tool for more. Keep option
titles short. Do not use interactive messages for open-ended questions.
```

### वैकल्पिक: एजेंट के टूल इस्तेमाल को निर्देशित करने के लिए एक प्रक्रिया जोड़ें

एजेंट को टूल्स देना आधा काम है — एक [प्रक्रिया](/docs/hi/eleven-agents/customization/procedures) उसे इन्हें अच्छी तरह इस्तेमाल करना बताती है।

> **Note**
>
> नीचे दी गई प्रक्रिया एक टेम्पलेट है, सीधे इस्तेमाल करने के लिए तैयार नहीं। इसे कॉपी करने के बाद अपना बनाएं: अपने फ्लो के अनुसार
> ट्रिगर बदलें, सिर्फ़ वही टूल्स रखें जो आपके एजेंट के पास वास्तव में हैं, और विकल्पों के
> उदाहरणों और नियमों को अपने इस्तेमाल के मामले के अनुसार फिर से लिखें।

#### नमूना प्रक्रिया कॉपी करें

```markdown
---
name: Offer choices with interactive messages
trigger: The user must pick from a fixed set of known options in a WhatsApp message conversation, such as appointment slots, product variants, or order confirmations.
---

Offer the options as an interactive message instead of asking the user
to type an answer.

1. Check which interactive tools you have. Prefer Send Interactive
   Buttons for 2–3 options and Send Interactive List for 4–10. If only
   one of the two is available, use it for any option count that fits its
   limits; if no interactive tool fits, ask the question in plain text.
   Never present more than 10 options; narrow them down with a question
   first.
2. Write a body_text that asks one clear question. Do not stack multiple
   questions into one interactive message.
3. Give every option a stable, machine-readable id (for example
   slot_2026-08-20_10am) and a short human title — 20 characters for
   buttons, 24 for list rows.
4. For lists, group related rows into titled sections, and add a
   description to a row only when its title alone is ambiguous.
5. Send the message with the tool, then wait for the user's reply. Do not
   send a second interactive message before the user responds to the first.
6. Treat the reply as the user's choice. Confirm it back in one short line
   and continue the flow.

Rules:

- Never use interactive messages for open-ended questions.
- When the fixed options may not cover everyone, include a final option
  such as "Something else" and follow up with a free-text question.
- If the tool call fails because content exceeds a limit, shorten titles
  and descriptions and retry once.
- If the user types an answer instead of tapping, accept it — do not
  re-send the options.
```

## सीमाएं

* इंटरैक्टिव मैसेज सिर्फ़ **मैसेज** बातचीत में भेजे जा सकते हैं — WhatsApp वॉइस कॉल के दौरान नहीं और दूसरे चैनलों पर भी नहीं।
* WhatsApp Flows (इंटरैक्टिव फ़ॉर्म) समर्थित नहीं हैं। अगर कोई यूज़र Flow जवाब देता है, तो वह एजेंट को पास नहीं किया जाता।
* इंटरैक्टिव मैसेज सेशन मैसेज होते हैं: इन्हें सिर्फ़ सक्रिय बातचीत के अंदर भेजा जा सकता है, पहले आउटबाउंड संपर्क के रूप में नहीं। बातचीत शुरू करने के लिए [मैसेज टेम्पलेट्स](/docs/hi/eleven-agents/whatsapp/outbound) इस्तेमाल करें।