नेविगेशन पर जाएँ

रिसेप्शन API

अपने सिस्टम से अपने ग्राहकों के Reception.ai वर्कस्पेस बनाएं और मैनेज करें।

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

रीसेलर एडमिन पैनल और उसके साथ रिसेप्शन API सिर्फ़ Reception.ai पार्टनर्स के लिए उपलब्ध है। अगर आप हमारे साथ पार्टनरशिप करने में रुचि रखते हैं, तो हमारी सेल्स टीम से संपर्क करें।

प्रमाणीकरण

रीसेलर एडमिन पैनल में 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 फ़ील्ड होता है।

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,
)

पेजिनेशन

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

रेट लिमिट्स

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

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

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

आगे के चरण