# संदेशों को अपने AI एजेंट तक रूट करें

Bird आपको WhatsApp, SMS, Apple Messages या एजेंट मेलबॉक्स पर प्राप्त होने वाला प्रत्येक संदेश आपके AI एजेंट को भेजता है। एजेंट को उसकी जानकारी और क्रेडेंशियल्स के साथ एक बार कनेक्ट करें, और हर नया संदेश उस तक पहुँचेगा।

दो एजेंट समर्थित हैं:

- **Claude Managed Agents**: प्रत्येक संदेश उस एजेंट का एक सेशन शुरू करता है जो आपने Claude Console में बनाया है।
- **Grok Bot**: प्रत्येक संदेश आपकी किसी एक Grok Bot रूटीन को सक्रिय करता है।

Bird प्रत्येक मिलान करने वाले संदेश को आपके एजेंट को भेजता है और विफल डिलीवरी को फिर से प्रयास करता है, इसलिए फिर से भेजा गया संदेश एक और रन शुरू कर सकता है। एजेंट को संदेश का इवेंट JSON प्राप्त होता है, वही पेलोड जो एक सामान्य [webhook एंडपॉइंट](/docs/guides/webhooks) को मिलता है, और वह आपके दिए गए किसी भी टूल से जवाब देता है, जैसे [Bird MCP server](/docs/ai/mcp-server)।

## चुनें कि आपका एजेंट किन संदेशों का जवाब दे

आपका एजेंट केवल आने वाले संदेशों का जवाब दे सकता है: `whatsapp.received`, `sms.received`, `amb.received` (Apple Messages) और `email_mailbox.message_received`। वे चुनें जिन्हें एजेंट को संभालना चाहिए। डिलीवरी रसीदें, स्थिति परिवर्तन और अन्य इवेंट एजेंट को नहीं भेजे जाते।

## Claude Managed Agents

सबसे पहले, अपना एजेंट [Claude Console](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session) में सेट करें: एजेंट और उसका एनवायरनमेंट बनाएँ, और उसी वर्कस्पेस में एक [API key](https://platform.claude.com/settings/keys) बनाएँ। एजेंट ID और एनवायरनमेंट ID नोट करें। नए सेशन एजेंट के नवीनतम वर्शन का उपयोग करते हैं।

फिर इसे Bird में कनेक्ट करें:

1. [वेबहुक बनाएँ](https://bird.com/dashboard/w/webhooks/new) और **Claude Managed Agents** चुनें।
2. **Triggers** में, वे संदेश चुनें जिनका Claude को जवाब देना चाहिए।
3. **Connect** में, वेबहुक का नाम दें और agent ID, environment ID और API key दर्ज करें।
4. वेबहुक की समीक्षा करें और उसे बनाएँ।

हर संदेश एक सेशन शुरू करता है जिसका पहला user message `New Bird event:` होता है, उसके बाद इवेंट JSON आता है।

## Grok Bot

पहले, Grok Bot से webhook trigger वाली एक routine बनाने को कहें। यह आपको routine का webhook URL और sender key देगा। अगर आप trigger मैन्युअली सेट करना चाहते हैं, तो [Cursor के webhook triggers](https://cursor.com/docs/cloud-agent/automations#webhook-triggers) देखें।

फिर इसे Bird में कनेक्ट करें:

1. [वेबहुक बनाएँ](https://bird.com/dashboard/w/webhooks/new) और **Grok Bot** चुनें।
2. **Triggers** में, वे संदेश चुनें जिनका Grok Bot को जवाब देना चाहिए।
3. **Connect** में, वेबहुक का नाम दें और webhook URL तथा sender key पेस्ट करें।
4. वेबहुक की समीक्षा करें और उसे बनाएँ।

हर मैसेज इवेंट JSON को रूटीन के वेबहुक URL पर पोस्ट करता है, sender key को Bearer टोकन के रूप में भेजता है, और रूटीन अपना सहेजा हुआ प्रॉम्प्ट चलाता है।

## CLI या API से बनाएँ

`bird webhooks create --help` हर कनेक्टर को उसके फ़ील्ड्स, उनमें से कौन-से सीक्रेट हैं, वह कौन-से इवेंट स्वीकार करता है और पहले क्या सेटअप करना है, के साथ सूचीबद्ध करता है। नॉन-सीक्रेट फ़ील्ड्स `--field name=value` के साथ पास करें और हर सीक्रेट को एनवायरनमेंट वेरिएबल से `--secret-env name=ENV_VAR` के साथ भेजें, या `--secret-stdin name` से पाइप करें, ताकि यह आपकी शेल हिस्ट्री से बाहर रहे। `--events` डिफ़ॉल्ट रूप से कनेक्टर द्वारा स्वीकार किए जाने वाले हर मैसेज इवेंट पर सेट होता है।

Claude के लिए, जिस वर्कस्पेस में आपका एजेंट चलता है उसमें एक [API key](https://platform.claude.com/settings/keys) बनाएँ, फिर उसे बिना दिखाए एनवायरनमेंट में पढ़ें, ताकि यह कभी कमांड लाइन या आपकी शेल हिस्ट्री में न दिखे:

```bash
read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY  # paste the key, then press Enter
bird webhooks create --connector claude_managed_agents \
  --field agent_id=agent_123 --field environment_id=env_123 \
  --secret-env api_key=ANTHROPIC_API_KEY
```

API वही `destination` [`POST /v1/webhooks`](/docs/api/reference/create-webhook) पर लेता है। `url` छोड़ दें: Bird इसे कनेक्टर से बनाता है। किसी भी रिस्पॉन्स में क्रेडेंशियल्स शामिल नहीं होते।

## कनेक्शन टेस्ट करें

वेबहुक बनाने के तुरंत बाद **Send test** चुनें। बाद में, वेबहुक के पेज पर या उसकी row actions में **Send test event** का उपयोग करें, या [`POST /v1/webhooks/{webhook_id}/test`](/docs/api/reference/test-webhook) कॉल करें। Claude या Cursor में देखें कि कोई सेशन या रन शुरू हुआ। फिर अपने किसी नंबर या चैनल पर एक असली मैसेज भेजें और पुष्टि करें कि एजेंट उसे संभालता है।

## संचालन करें

- **क्रेडेंशियल रोटेट करें।** वेबहुक एडिट करें और केवल नई वैल्यू दर्ज करें; जिस फ़ील्ड को आप खाली छोड़ते हैं वह अपनी संग्रहित वैल्यू बनाए रखता है। API के ज़रिए, बदली हुई key को [`PATCH /v1/webhooks/{webhook_id}`](/docs/api/reference/update-webhook) `credentials` में भेजें। अगली डिलीवरी इसे उपयोग करती है, फिर से प्रयास सहित।
- **किसी दूसरे एजेंट की ओर इंगित करें।** एक नया वेबहुक बनाएँ। एडिट से प्लेटफ़ॉर्म नहीं बदला जा सकता और न ही agent ID या वेबहुक URL जैसी सेटिंग्स बदली जा सकतीं।
- **रोकें या हटाएँ।** वेबहुक को पॉज़ करने से उसकी डिलीवरीज़ रुक जाती हैं। डिलीट करने से उसके क्रेडेंशियल्स मिट जाते हैं।
- **विफलताएँ देखें।** किसी webhook की प्रयास सूची में हर डिलीवरी प्लेटफ़ॉर्म की प्रतिक्रिया स्टेटस और बॉडी के साथ दिखती है, या प्लेटफ़ॉर्म तक पहुँच न हो पाने पर कुछ नहीं दिखता। जो प्रयास Bird द्वारा कुछ भेजे जाने से पहले विफल हुआ, जैसे इवेंट के बाद कनेक्शन बदल गया, उसमें इसके बजाय `failure_reason` होता है।

## अगले कदम

- [Webhooks और इवेंट](/docs/guides/webhooks)
- [MCP server](/docs/ai/mcp-server)
- [अपना कोडिंग एजेंट सेट अप करें](/docs/ai/set-up-your-agent)

## Related resources

- [Setting up your coding agent](/learn/basics/setting-up-your-coding-agent) (video)
- [What is an MCP server, and how does an agent use one to send messages?](/explained/platform/what-is-an-mcp-server-and-how-does-an-agent-send-messages) (answer)
- [Coding agents](/ai) (product)
- [Build with AI agents](/learn/paths/agents) (course)

[Get an implementation brief](/learn/workspace?topic=agents)