नेविगेशन पर जाएँ
इंटीग्रेशंससेटअप गाइड्सशेड्यूलिंग

Acuity Scheduling

वेबहुक टूल के साथ Acuity Scheduling में उपलब्ध समय देखें और अपॉइंटमेंट बुक करें।

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

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

1

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

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

2

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

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

3

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

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

printf 'USER_ID:API_KEY' | base64

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

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

4

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

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

टूल बनाएं

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

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

फ़ील्डवैल्यू
Namecheck_acuity_availability
Description”किसी एक तारीख के उपलब्ध अपॉइंटमेंट समय सूचीबद्ध करें। कॉलर को समय देने से पहले इसका इस्तेमाल करें।“
MethodGET
URLhttps://acuityscheduling.com/api/v1/availability/times
Request HeadersAuthorization: Basic के बाद एन्कोड किए गए क्रेडेंशियल
Query ParametersappointmentTypeID (नंबर, आवश्यक): “हमेशा सटीक वैल्यू APPOINTMENT_TYPE_ID।”
date (स्ट्रिंग, आवश्यक): “जांचने की तारीख, YYYY-MM-DD के रूप में।“

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

फ़ील्डवैल्यू
Namebook_acuity_appointment
Description”कॉलर के कोई समय चुन लेने पर उन्हें उपलब्ध समय में बुक करें। पहले उनके साथ तारीख और समय की पुष्टि करें।“
MethodPOST
URLhttps://acuityscheduling.com/api/v1/appointments
Request HeadersAuthorization: Basic के बाद एन्कोड किए गए क्रेडेंशियल
Body Parametersdatetime (स्ट्रिंग, आवश्यक): “चुना गया समय, ठीक वैसे जैसा check_acuity_availability द्वारा time वैल्यू में लौटाया गया है।”
appointmentTypeID (नंबर, आवश्यक): “हमेशा सटीक वैल्यू APPOINTMENT_TYPE_ID।”
firstName (स्ट्रिंग, आवश्यक): “कॉलर का पहला नाम।”
lastName (स्ट्रिंग, आवश्यक): “कॉलर का उपनाम।”
email (स्ट्रिंग, आवश्यक): “कॉलर का ईमेल पता। उनसे इसे अक्षर-अक्षर बताने को कहें।”
phone (स्ट्रिंग): “कॉलर का फ़ोन नंबर।”

हर टूल पर Enable चुनें, फिर अपॉइंटमेंट मांगकर अपने रिसेप्शनिस्ट का परीक्षण करें। बुकिंग आपके Acuity कैलेंडर में दिखाई देगी।

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

सीमाएं

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

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

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