> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# रिसेप्शन API

रिसेप्शन API से Reception.ai रीसेलर कोड में वे सभी काम कर सकता है जो रीसेलर एडमिन पैनल में मैन्युअल रूप से किए जाते हैं: हर ग्राहक के लिए वर्कस्पेस बनाना, उसे आपका कोई प्लान बेचना, उसका रिसेप्शनिस्ट सेट अप करना और आपके कार्ड से होने वाले शुल्कों को ट्रैक करना। हर एंडपॉइंट `https://api.elevenlabs.io/v1/reception` के अंतर्गत है और Python व TypeScript SDK में `reception` के रूप में उपलब्ध है।

> **Note**
>
> रीसेलर एडमिन पैनल और उसके साथ रिसेप्शन API सिर्फ़ Reception.ai पार्टनर्स के लिए उपलब्ध है। अगर
> आप हमारे साथ पार्टनरशिप करने में रुचि रखते हैं, तो [हमारी सेल्स टीम से संपर्क करें](https://www.reception.ai/contact-sales)।

## प्रमाणीकरण

रीसेलर एडमिन पैनल में API कुंजी बनाएं। सिर्फ़ वहीं बनाई गई कुंजियां रिसेप्शन API को कॉल कर सकती हैं; किसी अन्य ElevenLabs API कुंजी को `not_a_reseller_api_key` के साथ अस्वीकार कर दिया जाता है। कुंजी सिर्फ़ एक बार दिखाई जाती है, इसलिए इसे सीक्रेट मैनेजर में स्टोर करें।

कुंजी को `xi-api-key` हेडर में भेजें या `ELEVENLABS_API_KEY` सेट करें और SDK को इसे पढ़ने दें।

## रीसेलर और वर्कस्पेस एंडपॉइंट्स

API दो स्तरों पर काम करती है।

| स्तर      | किस पर काम करता है                                         | SDK समूह                                                                                                                                              |
| --------- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| रीसेलर    | आपका रीसेलर अकाउंट                                         | `workspaces`, `tiers`, `subscriptions`, `billing`                                                                                                     |
| वर्कस्पेस | एक ग्राहक का वर्कस्पेस, जिसका नाम `xi-workspace-id` में है | `business_profile`, `receptionists`, `phone_numbers`, `services`, `staff`, `locations`, `holidays`, `products`, `assets`, `knowledge_sources`, `team` |

वर्कस्पेस एंडपॉइंट्स के लिए `xi-workspace-id` हेडर चाहिए, जिसमें आपके बनाए वर्कस्पेस की ID सेट हो। इसके बिना या किसी दूसरे रीसेलर के वर्कस्पेस के लिए अनुरोध को अस्वीकार कर दिया जाता है। SDK में यह हेडर Python में `xi_workspace_id` आर्ग्युमेंट और TypeScript में `xiWorkspaceId` फ़ील्ड होता है।

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

workspaces = elevenlabs.reception.workspaces.list(page_size=50)
for workspace in workspaces.workspaces:
    print(workspace.workspace_id, workspace.business_name, workspace.billing_tier)

staff = elevenlabs.reception.staff.list(
    xi_workspace_id=workspaces.workspaces[0].workspace_id,
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

const { workspaces } = await elevenlabs.reception.workspaces.list({ pageSize: 50 });
for (const workspace of workspaces) {
  console.log(workspace.workspaceId, workspace.businessName, workspace.billingTier);
}

const staff = await elevenlabs.reception.staff.list({
  xiWorkspaceId: workspaces[0].workspaceId,
});
```

```bash
elevenlabs reception workspaces list --page-size 50
```

## पेजिनेशन

`workspaces.list` और `billing.list_invoices` एक बार में एक पेज लौटाते हैं। अगला पेज पाने के लिए रिस्पॉन्स के `next_cursor` को `cursor` के रूप में पास करें और `has_more` के `false` होने पर रुक जाएं।

## रेट लिमिट्स

सीमाएं सभी API कुंजियों में, हर रीसेलर पर लागू होती हैं:

| अनुरोध                 | सीमा           |
| ---------------------- | -------------- |
| रीड्स (`GET`)          | 600 प्रति मिनट |
| राइट्स (अन्य सभी मेथड) | 120 प्रति मिनट |

सीमा से अधिक अनुरोध पर `429` मिलता है। इंतज़ार करें और फिर से कोशिश करें।

## आगे के चरण

* [क्विकस्टार्ट](/docs/hi/reception-ai/reception-api/quickstart): ग्राहक का वर्कस्पेस बनाएं और उसके रिसेप्शनिस्ट को फ़ोन नंबर पर लगाएं।
* [प्रोविज़निंग और ऑनबोर्डिंग](/docs/hi/reception-ai/reception-api/provisioning-and-onboarding): बड़ी संख्या में वर्कस्पेस बनाने और बिज़नेस के स्थान, स्टाफ, सेवाएं व रिसेप्शनिस्ट सेटिंग्स जोड़ने के उदाहरण।
* [सब्सक्रिप्शन और बिलिंग](/docs/hi/reception-ai/reception-api/subscriptions-and-billing): ग्राहक का प्लान बदलें और देखें कि आपके कार्ड से कितना शुल्क लिया जा रहा है।