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

# रिसेप्शन API क्विकस्टार्ट

इस गाइड में [रिसेप्शन API](/docs/hi/reception-ai/reception-api/overview) की मदद से एक ग्राहक को शुरू से आखिर तक प्रोविज़न किया जाता है: पेड प्लान वाला वर्कस्पेस, रिसेप्शनिस्ट के जवाब देने के लिए बिज़नेस प्रोफ़ाइल और उस तक पहुंचने वाला फ़ोन नंबर।

## ज़रूरी शर्तें

* रीसेलर एडमिन पैनल की एक API कुंजी, जो `ELEVENLABS_API_KEY` के रूप में सेट हो। एडमिन पैनल सिर्फ़ Reception.ai पार्टनर्स के लिए उपलब्ध है; पार्टनर बनने के लिए [हमारी सेल्स टीम से संपर्क करें](https://www.reception.ai/contact-sales)।
* आपके रीसेलर अकाउंट के लिए फ़ाइल में मौजूद कार्ड। वर्कस्पेस को सब्सक्राइब करने पर उससे शुल्क लिया जाता है।
* Python SDK (`pip install elevenlabs`) या TypeScript SDK (`npm install @elevenlabs/elevenlabs-js`)।

## ग्राहक को प्रोविज़न करें

### प्लान चुनें

आप जिन टियर्स को बेचते हैं उनकी सूची देखें। वे सबसे सस्ते से शुरू होते हैं और पहला ट्रायल होता है।

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

tiers = elevenlabs.reception.tiers.list()
for tier in tiers:
    print(tier.tier_id, tier.display_name, tier.tier_economics.monthly_price_usd)
```

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

const elevenlabs = new ElevenLabsClient();

const tiers = await elevenlabs.reception.tiers.list();
for (const tier of tiers) {
  console.log(tier.tierId, tier.displayName, tier.tierEconomics.monthlyPriceUsd);
}
```

```bash
curl "https://api.elevenlabs.io/v1/reception/reseller/tier-ladder" \
  -H "xi-api-key: $ELEVENLABS_API_KEY"
```

### वर्कस्पेस बनाएं

ग्राहक का वर्कस्पेस बनाएं, उसे पेड टियर पर सब्सक्राइब करें और बिज़नेस मालिक को आमंत्रित करें। आमंत्रण बेस्ट-एफ़र्ट होते हैं: हर आमंत्रण का परिणाम `member_results` में होता है।

```python
from elevenlabs import ProvisionResellerWorkspaceSubscription, TeamInviteRequest

workspace = elevenlabs.reception.workspaces.create(
    business_name="Bright Smile Dental",
    subscription=ProvisionResellerWorkspaceSubscription(
        tier_id=tiers[1].tier_id,
        billing_period="monthly_period",
    ),
    members=[
        TeamInviteRequest(email="owner@brightsmiledental.com", role="workspace_admin"),
    ],
)

workspace_id = workspace.workspace_id
```

```typescript
const workspace = await elevenlabs.reception.workspaces.create({
  businessName: "Bright Smile Dental",
  subscription: {
    tierId: tiers[1].tierId,
    billingPeriod: "monthly_period",
  },
  members: [{ email: "owner@brightsmiledental.com", role: "workspace_admin" }],
});

const workspaceId = workspace.workspaceId;
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/reseller/workspaces" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "business_name": "Bright Smile Dental",
    "subscription": { "tier_id": "smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0", "billing_period": "monthly_period" },
    "members": [{ "email": "owner@brightsmiledental.com", "role": "workspace_admin" }]
  }'
```

बिना प्लान का वर्कस्पेस बनाने के लिए `subscription` छोड़ दें और [बाद में प्लान असाइन करें](/docs/hi/reception-ai/reception-api/subscriptions-and-billing#assign-a-plan)।

### बिज़नेस का विवरण दें

रिसेप्शनिस्ट बिज़नेस प्रोफ़ाइल के आधार पर जवाब देता है। अब से हर कॉल नए वर्कस्पेस पर काम करती है, इसलिए उसमें `xi-workspace-id` हेडर होता है। `operating_hours` में दिन `0` (सोमवार) से `6` (रविवार) तक होते हैं और जिस दिन के लिए कोई एंट्री नहीं है, उस दिन बंद रहता है।

```python
from elevenlabs import TimeRangeModel, WorkingHours

weekday = [TimeRangeModel(start_hour=8, start_minute=0, end_hour=17, end_minute=0)]

elevenlabs.reception.business_profile.update(
    xi_workspace_id=workspace_id,
    business_country="US",
    business_description="Family dental practice offering cleanings, fillings, crowns and teeth whitening.",
    timezone="America/Los_Angeles",
    operating_hours=WorkingHours(hours={str(day): weekday for day in range(5)}),
)

elevenlabs.reception.knowledge_sources.add_url(
    xi_workspace_id=workspace_id,
    url="https://brightsmiledental.com",
    crawl_entire_site=True,
)
```

```typescript
const weekday = [{ startHour: 8, startMinute: 0, endHour: 17, endMinute: 0 }];

await elevenlabs.reception.businessProfile.update({
  xiWorkspaceId: workspaceId,
  businessCountry: "US",
  businessDescription:
    "Family dental practice offering cleanings, fillings, crowns and teeth whitening.",
  timezone: "America/Los_Angeles",
  operatingHours: {
    hours: { "0": weekday, "1": weekday, "2": weekday, "3": weekday, "4": weekday },
  },
});

await elevenlabs.reception.knowledgeSources.addUrl({
  xiWorkspaceId: workspaceId,
  url: "https://brightsmiledental.com",
  crawlEntireSite: true,
});
```

```bash
curl -X PUT "https://api.elevenlabs.io/v1/reception/agent-info" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "xi-workspace-id: 8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7" \
  -H "Content-Type: application/json" \
  -d '{
    "business_country": "US",
    "business_description": "Family dental practice offering cleanings, fillings, crowns and teeth whitening.",
    "timezone": "America/Los_Angeles",
    "operating_hours": {
      "hours": {
        "0": [{ "start_hour": 8, "start_minute": 0, "end_hour": 17, "end_minute": 0 }],
        "1": [{ "start_hour": 8, "start_minute": 0, "end_hour": 17, "end_minute": 0 }],
        "2": [{ "start_hour": 8, "start_minute": 0, "end_hour": 17, "end_minute": 0 }],
        "3": [{ "start_hour": 8, "start_minute": 0, "end_hour": 17, "end_minute": 0 }],
        "4": [{ "start_hour": 8, "start_minute": 0, "end_hour": 17, "end_minute": 0 }]
      }
    }
  }'

curl -X POST "https://api.elevenlabs.io/v1/reception/knowledge-sources/urls" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "xi-workspace-id: 8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://brightsmiledental.com", "crawl_entire_site": true }'
```

सेवाएं, स्टाफ, स्थान और छुट्टियां भी इसी तरह `services`, `staff`, `locations` और `holidays` समूहों से जोड़ी जाती हैं।

### ऑनबोर्डिंग पूरी करें

ऑनबोर्डिंग पूरी करने पर बिज़नेस प्रोफ़ाइल से वर्कस्पेस का रिसेप्शनिस्ट बनता है। इसे दोबारा चलाना सुरक्षित है। वर्कस्पेस बनाते समय आप `complete_onboarding=True` भी पास कर सकते हैं, लेकिन तब रिसेप्शनिस्ट सिर्फ़ बिज़नेस के नाम से बनाया जाता है।

```python
onboarding = elevenlabs.reception.workspaces.complete_onboarding(workspace_id)

receptionist_id = onboarding.customer_facing_agent_id
```

```typescript
const onboarding = await elevenlabs.reception.workspaces.completeOnboarding(workspaceId);

const receptionistId = onboarding.customerFacingAgentId;
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/reseller/workspaces/8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7/complete-onboarding" \
  -H "xi-api-key: $ELEVENLABS_API_KEY"
```

### रिसेप्शनिस्ट को फ़ोन नंबर दें

अमेरिका और कनाडा में, अनुरोध किए गए एरिया कोड वाला नंबर पूल से लिया या खरीदा जाता है। उपलब्ध न होने पर बिज़नेस के देश का कोई भी नंबर इस्तेमाल किया जाता है।

```python
assignment = elevenlabs.reception.phone_numbers.create(
    xi_workspace_id=workspace_id,
    customer_facing_agent_id=receptionist_id,
    area_codes=["415", "628"],
)

print(assignment.phone_number)
```

```typescript
const assignment = await elevenlabs.reception.phoneNumbers.create({
  xiWorkspaceId: workspaceId,
  customerFacingAgentId: receptionistId,
  areaCodes: ["415", "628"],
});

console.log(assignment.phoneNumber);
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/phone-numbers/assignments" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "xi-workspace-id: 8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7" \
  -H "Content-Type: application/json" \
  -d '{ "customer_facing_agent_id": "agent_7101k5zvyjhmfg983brhmhkd98n6", "area_codes": ["415", "628"] }'
```

रिसेप्शनिस्ट अब `phone_number` पर आने वाली कॉल का जवाब देता है।

## आगे के चरण

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