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 चुनें। उसके टोकन उपयोग को कम रखने के लिए केवल वे Bird टूल सक्षम करें जिनका वह उपयोग करता है, जैसा Claude Managed Agents में बताया गया है।
  6. (वैकल्पिक) Managed Agents > Credential vaults खोलें, एक वॉल्ट बनाएँ, + Add credential चुनें, Type को MCP OAuth पर सेट करें, Bird चुनें और Connect चुनें।
  7. (वैकल्पिक) Connect में वॉल्ट ID दर्ज करें (यह vlt_ से शुरू होती है), या उसे जोड़ने के लिए किसी मौजूदा वेबहुक को संपादित करें।

Grok Bot

  1. Grok Bot में Bird इंस्टॉल करें और अपना Bird वर्कस्पेस कनेक्ट करें।
  2. Grok Bot से वेबहुक ट्रिगर वाला रूटीन बनाने को कहें। रूटीन का Webhook सेक्शन खोलें और उसका URL और सेंडर कुंजी कॉपी करें।
  3. Bird में वेबहुक इनमें से किसी एक तरीके से बनाएँ:
    • Grok Bot से कहें कि वह चरण 2 के URL और सेंडर कुंजी का उपयोग करके amb.received या email_mailbox.message_received जैसे किसी इवेंट के लिए Grok Bot गंतव्य वाला वेबहुक बनाए। ईमेल के लिए मेलबॉक्स का नाम बताएँ।
    • इसे डैशबोर्ड में बनाएँ: Grok Bot चुनें, Triggers में इवेंट चुनें और Connect में URL और सेंडर कुंजी पेस्ट करें।
  4. Send test चुनें, फिर अपने व्यवसाय या मेलबॉक्स पर एक असली संदेश भेजें।

किसी टेम्पलेट से शुरू करें (वैकल्पिक)। चरण 2 से पहले AMB Booking Desk या Email Support Desk चुनें, फिर उसकी bot.md और shared/message-safety.md को Grok Bot को स्थायी निर्देशों के रूप में दें। Your settings और Knowledge भरें, उसका चैनल स्किल सक्षम करें और चरण 2 के लिए उसके Routine prompt का उपयोग करें।

टेम्पलेट के जवाब डिफ़ॉल्ट रूप से ड्राफ़्ट होते हैं।

अगर कोई रन शुरू नहीं होता, तो रूटीन के Webhook URL और सेंडर कुंजी का मिलान Bird में दिए मानों से करें।

इसे 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 होता है।

अगले कदम

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

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

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