> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Acuity Scheduling

नीचे दिए गए [वेबहुक टूल](/docs/hi/reception-ai/integrations/webhooks) से आपका रिसेप्शनिस्ट देख सकता है कि कोई अपॉइंटमेंट प्रकार कब उपलब्ध है और कॉलर के लिए उपलब्ध स्लॉट बुक कर सकता है। Acuity क्लाइंट को अपना सामान्य कन्फ़र्मेशन ईमेल भेजता है।

## शुरू करने से पहले

### अपना प्लान जांचें

Acuity केवल अपने सबसे ऊंचे प्लान (Premium, जिसे पहले Powerhouse कहा जाता था) में API एक्सेस शामिल करता है। दूसरे प्लान पर नीचे दिए टूल 403 त्रुटि के साथ विफल होते हैं।

### अपने API क्रेडेंशियल पाएं

Acuity में **Integrations** खोलें, **API** खोजें और अपना **User ID** और **API Key** कॉपी करें।

### ऑथराइज़ेशन हेडर बनाएं

Acuity आपके User ID को यूज़रनेम और API कुंजी को पासवर्ड के रूप में इस्तेमाल करता है। दोनों प्लेसहोल्डर बदलते हुए, इन्हें टर्मिनल में एन्कोड करें:

```bash
printf 'USER_ID:API_KEY' | base64
```

हेडर वैल्यू `Basic ` के बाद आउटपुट है।

> **Warning**
>
> अपनी API कुंजी किसी ऑनलाइन एन्कोडर में पेस्ट न करें। जिसके पास भी यह होगी, वह आपके
> अपॉइंटमेंट और क्लाइंट विवरण पढ़ और बदल सकता है।

### अपॉइंटमेंट प्रकार ID खोजें

जिस अपॉइंटमेंट प्रकार को आप अपने रिसेप्शनिस्ट से बुक करवाना चाहते हैं, उसका डायरेक्ट शेड्यूलिंग लिंक कॉपी करें। लिंक में `appointmentType=` के बाद वाला नंबर उसकी ID है। नीचे दिए टूल इसे `APPOINTMENT_TYPE_ID` की जगह इस्तेमाल करते हैं।

## टूल बनाएं

हर टूल के लिए **Integrations** पर जाएं, **Add integration** चुनें, **Webhook Tool** चुनें और **Assign to agents** को **Receptionist** पर सेट करें।

### उपलब्ध समय देखें

| फ़ील्ड               | वैल्यू                                                                                                                                               |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `check_acuity_availability`                                                                                                                          |
| **Description**      | "किसी एक तारीख के उपलब्ध अपॉइंटमेंट समय सूचीबद्ध करें। कॉलर को समय देने से पहले इसका इस्तेमाल करें।"                                                 |
| **Method**           | GET                                                                                                                                                  |
| **URL**              | `https://acuityscheduling.com/api/v1/availability/times`                                                                                             |
| **Request Headers**  | `Authorization`: `Basic ` के बाद एन्कोड किए गए क्रेडेंशियल                                                                                           |
| **Query Parameters** | `appointmentTypeID` (नंबर, आवश्यक): "हमेशा सटीक वैल्यू `APPOINTMENT_TYPE_ID`।"  `date` (स्ट्रिंग, आवश्यक): "जांचने की तारीख, YYYY-MM-DD के रूप में।" |

### अपॉइंटमेंट बुक करें

| फ़ील्ड              | वैल्यू                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**            | `book_acuity_appointment`                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **Description**     | "कॉलर के कोई समय चुन लेने पर उन्हें उपलब्ध समय में बुक करें। पहले उनके साथ तारीख और समय की पुष्टि करें।"                                                                                                                                                                                                                                                                                                                                              |
| **Method**          | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **URL**             | `https://acuityscheduling.com/api/v1/appointments`                                                                                                                                                                                                                                                                                                                                                                                                    |
| **Request Headers** | `Authorization`: `Basic ` के बाद एन्कोड किए गए क्रेडेंशियल                                                                                                                                                                                                                                                                                                                                                                                            |
| **Body Parameters** | `datetime` (स्ट्रिंग, आवश्यक): "चुना गया समय, ठीक वैसे जैसा `check_acuity_availability` द्वारा `time` वैल्यू में लौटाया गया है।"  `appointmentTypeID` (नंबर, आवश्यक): "हमेशा सटीक वैल्यू `APPOINTMENT_TYPE_ID`।"  `firstName` (स्ट्रिंग, आवश्यक): "कॉलर का पहला नाम।"  `lastName` (स्ट्रिंग, आवश्यक): "कॉलर का उपनाम।"  `email` (स्ट्रिंग, आवश्यक): "कॉलर का ईमेल पता। उनसे इसे अक्षर-अक्षर बताने को कहें।"  `phone` (स्ट्रिंग): "कॉलर का फ़ोन नंबर।" |

हर टूल पर **Enable** चुनें, फिर अपॉइंटमेंट मांगकर [अपने रिसेप्शनिस्ट का परीक्षण करें](/docs/hi/reception-ai/receptionist/testing)। बुकिंग आपके Acuity कैलेंडर में दिखाई देगी।

> **Tip**
>
> कई अपॉइंटमेंट प्रकार बुक करने के लिए, दोनों टूल में "हमेशा सटीक वैल्यू" को एक सूची से बदलें, जैसे:
> "30 मिनट के परामर्श के लिए `111` और 60 मिनट के सत्र के लिए `222` का उपयोग करें।"

## सीमाएं

* Acuity को हर बुकिंग के लिए ईमेल पता चाहिए, इसलिए आपका रिसेप्शनिस्ट कॉलर से अपना पता अक्षर-अक्षर बताने को कहता है।
* इंटेक फ़ॉर्म के जवाब सूची के रूप में भेजे जाते हैं, जिन्हें वेबहुक टूल नहीं भेज सकते। बुकिंग नोट केवल एडमिन बुकिंग से सेट हो सकते हैं, जो Acuity की उपलब्धता जांच को छोड़ देती है, इसलिए ऊपर के टूल दोनों में से कोई भी सेट नहीं करते।
* टूल अपॉइंटमेंट रद्द या दोबारा शेड्यूल नहीं कर सकते। इसके लिए URL में अपॉइंटमेंट ID चाहिए।

## समस्या निवारण

| समस्या                                       | क्या जांचें                                                                                              |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Acuity से 401                                | कोलन के साथ `USER_ID:API_KEY` एन्कोड करें और हेडर वैल्यू की शुरुआत `Basic ` और एक स्पेस से करें।         |
| Acuity से 403                                | आपके प्लान में API एक्सेस शामिल नहीं है।                                                                 |
| कोई समय नहीं लौटाया गया                      | अपॉइंटमेंट प्रकार ID जांचें और यह भी कि उस प्रकार के लिए उस तारीख पर उपलब्ध घंटे हैं।                    |
| बुकिंग `not_available` के साथ विफल होती है   | समय ले लिया गया है या उपलब्ध नहीं है। रिसेप्शनिस्ट को बुक करने से पहले फिर से उपलब्ध समय जांचने को कहें। |
| फ़ील्ड गायब होने के कारण बुकिंग विफल होती है | आपके अकाउंट में फ़ोन नंबर ज़रूरी हो सकता है। बुकिंग टूल में `phone` को आवश्यक बनाएं।                     |