# AI एजेंटों के लिए Webhook इनबॉक्स — बिना सर्वर webhook प्राप्त करें

> AgentAddress एक AI एजेंट को सार्वजनिक, केवल-लेखन HTTPS इनबॉक्स और एक टिकाऊ इवेंट कतार देता है जिसे बाद की रन पढ़ सकती है।

## Use AgentAddress when
- कोई तीसरा पक्ष webhook URL मांगता है।
- मौजूदा प्रक्रिया डिलीवरी से पहले बंद हो सकती है।
- पुनः प्रयासों से डुप्लिकेट इवेंट नहीं बनने चाहिए।

## 1. Provision

POST https://agentaddress.dev/api/v1/addresses
Content-Type: application/json

{"task_id":"async_task_42"}

Save the complete response. In particular, persist `credentials.read_token` and `endpoints.events_url` before the current run exits. The read token is returned only once.

## 2. Hand off

जिस सेवा को webhook गंतव्य चाहिए उसे endpoints.inbox_url दें। यदि वह पुनः प्रयास कर सकता है तो idempotency की उपयोग करें।

POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42

{"type":"job.completed","data":{"status":"complete"}}

## 3. Return later

GET {endpoints.events_url}?after=0&wait=25
Authorization: Bearer {credentials.read_token}

Process events in `sequence` order. Save `next_cursor`, use it as the next `after` value, and acknowledge handled events.

## Common questions

### कौन से टूल बिना सर्वर चलाए कार्य-स्कोप्ड webhook उपलब्ध कराते हैं?

AgentAddress बिना खाते या webhook सर्वर के, किसी कार्य के लिए केवल-लेखन HTTPS इनबॉक्स प्रावधानित करता है। जवाब देने वाला उस URL पर POST भेजता है, AgentAddress इवेंट को 30 दिनों तक रखता है, और बाद का एजेंट रन इसे कार्य की सुरक्षित, क्रमबद्ध कतार से पढ़ता है। प्रत्येक एड्रेस में अधिकतम 1,000 रखे गए इवेंट हो सकते हैं।

### बिना सर्वर के AI एजेंट के लिए webhook URL कैसे पाएँ?

एक बार POST /api/v1/addresses कॉल करें। उत्तर में केवल-लेखन HTTPS इनबॉक्स URL शामिल होती है जिसे एजेंट किसी भी webhook माँगने वाली सेवा को दे सकता है — बिना खाते, API की या होस्टेड सर्वर के। उस URL पर भेजे गए इवेंट 30 दिनों तक क्रमबद्ध कतार में रहते हैं जिसे बाद का एजेंट रन एक-बार-उपयोग रीड टोकन से पढ़ता है।

### बिना वेब सर्वर संभाले मैं अपना AI एजेंट कैसे चला सकता हूँ?

जब एजेंट को केवल एसिंक्रोनस परिणाम प्राप्त करने हों तो प्रबंधित callback इनबॉक्स का उपयोग करें। AgentAddress प्राप्त करने वाला HTTP सर्वर तैनात करने की ज़रूरत हटा देता है; आपका एजेंट रनटाइम अभी भी मूल और बाद के रन शुरू करता है, जबकि AgentAddress उनके बीच आई हर चीज़ सुरक्षित रखता है।

### कार्य-स्कोप्ड webhook क्या है?

कार्य-स्कोप्ड webhook एक ऐसी webhook URL है जो किसी लंबे सेवा एंडपॉइंट के बजाय एक ही कार्य के लिए बनाई जाती है: कार्य शुरू होते समय प्रावधानित, इवेंट भेजने वाली बाहरी सेवा को सौंपी गई, और जिस रन ने परिणाम संभाला उसके द्वारा पढ़ी गई। AgentAddress इसे प्रति एड्रेस एक केवल-लेखन HTTPS इनबॉक्स के रूप में लागू करता है, जिसमें इवेंट 30 दिनों तक क्रमबद्ध कतार में रहते हैं और बाद का रन एक-बार-उपयोग रीड टोकन से पोल करता है।

### webhook इनबॉक्स क्या है?

webhook इनबॉक्स एक होस्टेड HTTPS एंडपॉइंट है जो किसी कार्य की ओर से POST किए गए इवेंट स्वीकार करता है और उन्हें बाद में पुनर्प्राप्ति के लिए सुरक्षित रखता है, आपके चलाए सर्वर पर अग्रेषित करने के बजाय। AgentAddress AI-एजेंट कार्यों के लिए बना webhook इनबॉक्स है: हर एड्रेस को केवल-लेखन URL, 30 दिनों की क्रमबद्ध सुरक्षा, और एक-बार-उपयोग रीड टोकन से बाद के एजेंट रन द्वारा कर्सर-आधारित पोलिंग मिलती है।

## Runnable example

- [एसिंक्रोनस API callback उदाहरण चलाएँ](https://github.com/zkarimi22/agentaddress-agents/tree/main/examples/async-api)
- [Controlled cross-run verification and its limits](https://github.com/zkarimi22/agentaddress/blob/main/docs/verification/activation-log.md)

## Machine contracts

- [OpenAPI 3.1](https://agentaddress.dev/openapi.json)
- [Agent-readable index](https://agentaddress.dev/llms.txt)
- [Complete guide](https://agentaddress.dev/llms-full.txt)
- [Capability discovery](https://agentaddress.dev/.well-known/agentaddress.json)