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

संदेशों को अपने AI एजेंट तक भेजें

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

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

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

Bird हर मेल खाने वाला संदेश आपके एजेंट को भेजता है और विफल डिलीवरी के लिए फिर से प्रयास करता है, इसलिए फिर से भेजा गया संदेश एक और रन शुरू कर सकता है। एजेंट को संदेश का इवेंट JSON मिलता है, यानी वही पेलोड जो एक सामान्य webhook एंडपॉइंट को मिलता है। एजेंट उन टूल के ज़रिए जवाब देता है जो आपने उसे दिए हैं, जैसे Bird MCP सर्वर।

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

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

Claude Managed Agents

  1. Claude Console में एक एजेंट, एक एनवायरनमेंट और एक API कुंजी बनाएँ।
  2. Bird में एक वेबहुक बनाएँ, Claude Managed Agents चुनें और Triggers में संदेश चुनें।
  3. Connect में एजेंट ID, एनवायरनमेंट ID और API कुंजी दर्ज करें, फिर वेबहुक बनाएँ।
  4. Send test चुनें।
  5. (वैकल्पिक) एजेंट को Bird के ज़रिए जवाब देने देने के लिए Claude Console में एजेंट खोलें, + MCP Server चुनें और Bird चुनें।
  6. (वैकल्पिक) Managed Agents > Credential vaults खोलें, एक वॉल्ट बनाएँ, + Add credential चुनें, Type को MCP OAuth पर सेट करें, Bird चुनें और Connect चुनें।
  7. (वैकल्पिक) Connect में वॉल्ट ID दर्ज करें (यह vlt_ से शुरू होती है), या उसे जोड़ने के लिए किसी मौजूदा वेबहुक को संपादित करें।

Grok Bot

सबसे पहले Grok Bot से webhook ट्रिगर वाला एक रूटीन बनाने को कहें। यह आपको रूटीन का webhook URL और सेंडर कुंजी देता है। इसके बजाय ट्रिगर को खुद सेट करने के लिए Cursor के webhook ट्रिगर देखें।

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

  1. एक webhook बनाएँ और Grok Bot चुनें।
  2. Triggers में वे संदेश चुनें जिनका जवाब Grok Bot को देना है।
  3. Connect में webhook को नाम दें और webhook URL और सेंडर कुंजी पेस्ट करें।
  4. वेबहुक की समीक्षा करें और उसे बनाएँ।

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

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

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

Claude के लिए, उस वर्कस्पेस में एक API कुंजी बनाएँ जिसमें आपका एजेंट चलता है। फिर उसे दिखाए बिना एनवायरनमेंट में पढ़ें, ताकि वह कभी किसी कमांड लाइन या आपकी शेल हिस्ट्री में न दिखे:

कोड उदाहरण
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 \
  --field vault_id=vlt_123 --secret-env api_key=ANTHROPIC_API_KEY

API भी POST /v1/webhooks पर यही destination लेता है। url न भेजें: Bird उसे कनेक्टर से बनाता है। किसी भी प्रतिक्रिया में क्रेडेंशियल शामिल नहीं होते।

कनेक्शन का परीक्षण करें

वेबहुक बनाने के तुरंत बाद Send test चुनें। बाद में, वेबहुक के पेज पर या उसकी पंक्ति के ऐक्शन में Send test event का उपयोग करें, या POST /v1/webhooks/{webhook_id}/test कॉल करें। Claude या Cursor में जाँचें कि कोई सेशन या रन शुरू हुआ। फिर अपने किसी नंबर या चैनल पर एक असली संदेश भेजें और पुष्टि करें कि एजेंट उसे संभालता है; Claude के लिए पुष्टि करें कि जवाब भेजने वाले के चैनल पर पहुँचता है और सेशन में कोई session.error नहीं दिखता।

इसे संचालित करें

  • क्रेडेंशियल बदलें। वेबहुक संपादित करें और केवल नया मान दर्ज करें; जो फ़ील्ड आप खाली छोड़ते हैं, उसमें सहेजा हुआ मान बना रहता है। API के ज़रिए बदली हुई कुंजी PATCH /v1/webhooks/{webhook_id} destination.connector.credentials में भेजें। अगली डिलीवरी उसी का उपयोग करती है, फिर से प्रयास भी।
  • इसकी सेटिंग बदलें। एजेंट ID, वॉल्ट ID या किसी Grok Bot रूटीन के वेबहुक URL जैसी कोई सेटिंग बदलने के लिए वेबहुक संपादित करें; अगली डिलीवरी उसी का उपयोग करती है। प्लेटफ़ॉर्म बदलने के लिए एक नया वेबहुक बनाएँ।
  • इसे रोकें या हटाएँ। वेबहुक रोकने पर उसकी डिलीवरी बंद हो जाती हैं। उसे मिटाने पर उसके क्रेडेंशियल मिट जाते हैं।
  • विफलताएं पढ़ें। किसी webhook के प्रयासों में हर डिलीवरी प्लेटफ़ॉर्म के प्रतिक्रिया स्टेटस और बॉडी के साथ दिखती है, या प्लेटफ़ॉर्म तक न पहुंच पाने पर कुछ नहीं दिखता। जो प्रयास Bird के कुछ भी भेजने से पहले विफल हुआ, जैसे इवेंट के बाद बदला गया कनेक्शन, उसमें इसके बजाय failure_reason होता है।

अगले कदम

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

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।

इम्प्लीमेंटेशन ब्रीफ़ पाएँ