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

JobNimbus

वेबहुक टूल्स से नए कॉलर्स को नोट्स और जॉब्स के साथ JobNimbus में लीड्स के रूप में जोड़ें।

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

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

  1. JobNimbus में, ऊपर दाएँ कोने में अपना प्रोफ़ाइल आइकन चुनें, फिर Settings → API चुनें और नई API कुंजी बनाएं।
  2. ऐसा Access Profile चुनें जो संपर्क बना सके, और अगर आप वे टूल जोड़ते हैं तो नोट्स और जॉब भी बना सके। ज़रूरत से ज़्यादा अनुमतियाँ न दें। कुंजी में वही अनुमतियाँ रहती हैं जो उसे बनाते समय प्रोफ़ाइल में थीं।
  3. Key ID नहीं, पूरी API कुंजी कॉपी करें। JobNimbus इसे सिर्फ़ एक बार दिखाता है।

हर टूल Authorization रिक्वेस्ट हेडर में कुंजी को Bearer YOUR_API_KEY के रूप में भेजता है। इसका Type Secret पर सेट करें।

API कुंजी आपके JobNimbus डेटा तक पहुँच देती है। इसे सुरक्षित रखें और साझा न करें। नई कुंजियों की अवधि एक साल बाद खत्म हो जाती है, इसलिए उससे पहले नई कुंजी बना लें।

आपको संपर्क वर्कफ़्लो और उस स्टेटस के सटीक नाम भी चाहिए, जिसमें नए लीड जाने चाहिए। ये नाम आपके JobNimbus सेटिंग्स में जैसे दिखाई देते हैं, वैसे ही होने चाहिए, उदाहरण के लिए Customer और Lead। जॉब के लिए आपको जॉब वर्कफ़्लो और स्टेटस के नाम भी चाहिए।

टूल बनाएं

हर टूल के लिए Integrations पर जाएं, Add integration चुनें, Webhook Tool चुनें और नीचे दिए गए फ़ील्ड भरें। जिन फ़ील्ड पर “fixed value” लिखा है, उनके लिए Value को Fixed value पर सेट करें।

कॉलर जोड़ें

फ़ील्डमान
नामcreate_jobnimbus_contact
विवरण”जब कॉलर को काम करवाना हो और उसने पहले हमारी सेवाएँ न ली हों, तो उसे हमारे CRM में नए लीड के रूप में जोड़ें।“
मेथडPOST
URLhttps://app.jobnimbus.com/api1/contacts
रिक्वेस्ट हेडर्सAuthorization (Secret): Bearer YOUR_API_KEY
बॉडी पैरामीटर्सfirst_name (string, required): “कॉलर का पहला नाम।”
last_name (string, required): “कॉलर का अंतिम नाम।”
record_type_name (string): fixed value Customer
status_name (string): fixed value Lead
mobile_phone (string, required): “कॉलर का फ़ोन नंबर, केवल अंक।”
email (string): “कॉलर का ईमेल पता, अगर उन्होंने दिया हो।”
address_line1 (string): “वह सड़क का पता जहाँ काम चाहिए।”
city (string): “उस पते का शहर।”
state_text (string): “राज्य, दो-अक्षर के कोड के रूप में।”
zip (string): “ZIP कोड।”
description (string, required): “कॉलर को क्या चाहिए, वे कब उपलब्ध हैं और उन्होंने जो भी अन्य जानकारी दी है।“
एजेंट्स को असाइन करेंReceptionist

Customer और Lead को अपने वर्कफ़्लो और स्टेटस नामों से बदलें।

नोट जोड़ें

फ़ील्डमान
नामadd_jobnimbus_note
विवरण”कॉलर को क्या चाहिए और वे कब उपलब्ध हैं, इसकी जानकारी उनके संपर्क में नोट के रूप में जोड़ें। create_jobnimbus_contact के बाद, उसके लौटाए गए jnid के साथ इसका उपयोग करें।“
मेथडPOST
URLhttps://app.jobnimbus.com/api1/activities
रिक्वेस्ट हेडर्सAuthorization (Secret): Bearer YOUR_API_KEY
बॉडी पैरामीटर्सnote (string, required): “कॉलर को क्या चाहिए, वे कब उपलब्ध हैं और उन्होंने जो भी अन्य जानकारी दी है।”
record_type_name (string): fixed value Note
primary (object, required): नीचे देखें।
एजेंट्स को असाइन करेंReceptionist

primary एक ऑब्जेक्ट है, जिसमें एक फ़ील्ड है:

  • id (string, required): “संपर्क का jnid, जो create_jobnimbus_contact से मिलता है।”

record_type_name आपके JobNimbus सेटिंग्स में मौजूद किसी एक गतिविधि प्रकार से बिल्कुल मेल खाना चाहिए।

जॉब बनाएं

अगर आपकी टीम जॉब्स के आधार पर काम करती है, तो यह टूल जोड़ें।

फ़ील्डमान
नामcreate_jobnimbus_job
विवरण”कॉलर को जिस काम की ज़रूरत है उसके लिए, उनके संपर्क से लिंक किया गया जॉब बनाएं। create_jobnimbus_contact के बाद, उसके लौटाए गए jnid के साथ इसका उपयोग करें।“
मेथडPOST
URLhttps://app.jobnimbus.com/api1/jobs
रिक्वेस्ट हेडर्सAuthorization (Secret): Bearer YOUR_API_KEY
बॉडी पैरामीटर्सname (string, required): “काम और कॉलर के नाम वाला छोटा शीर्षक, उदाहरण के लिए: Roof inspection - Jane Doe।”
record_type_name (string): fixed value, आपके जॉब वर्कफ़्लो का नाम
status_name (string): fixed value, वह जॉब स्टेटस जिसमें नया काम जाता है
description (string, required): “कॉलर को क्या चाहिए और वे कब उपलब्ध हैं।”
address_line1 (string): “वह सड़क का पता जहाँ काम चाहिए।”
city (string): “उस पते का शहर।”
state_text (string): “राज्य, दो-अक्षर के कोड के रूप में।”
zip (string): “ZIP कोड।”
primary (object, required): नीचे देखें।
एजेंट्स को असाइन करेंReceptionist

primary एक ऑब्जेक्ट है, जिसमें एक फ़ील्ड है:

  • id (string, required): “संपर्क का jnid, जो create_jobnimbus_contact से मिलता है।”

हर टूल पर Enable चुनें, फिर छत के निरीक्षण की ज़रूरत वाले नए कॉलर के रूप में अपने रिसेप्शनिस्ट का परीक्षण करें। संपर्क आपके लीड स्टेटस में JobNimbus में दिखाई देगा, साथ ही नोट और जॉब भी होगा।

अपने रिसेप्शनिस्ट को कॉलर जोड़ने से पहले पूरा पता लेने और फिर नोट व जॉब जोड़ने के लिए कहने वाली एक प्रक्रिया जोड़ें।

सीमाएँ

  • JobNimbus संपर्कों को खोजने के लिए JSON सर्च फ़िल्टर चाहिए, इसलिए ये टूल कॉलर्स को खोजते नहीं हैं। लौटकर आने वाला कॉलर दो बार जोड़ा जा सकता है।
  • ये टूल टास्क नहीं बनाते। JobNimbus टास्क का शुरू होने का समय Unix टाइमस्टैम्प के रूप में लेता है, जिसे आपका रिसेप्शनिस्ट कॉल के दौरान भरोसेमंद तरीके से तय नहीं कर सकता।

ईमेल से कॉलर्स खोजने के लिए, Zapier के ज़रिए JobNimbus की Find Contact by Email कार्रवाई का उपयोग करें।

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

समस्याक्या जाँचें
JobNimbus से 401 या 403हेडर मान में पूरी API कुंजी के पहले Bearer होना चाहिए, Key ID नहीं। जाँचें कि कुंजी की अवधि खत्म तो नहीं हुई है।
वर्कफ़्लो या स्टेटस से जुड़ी त्रुटिrecord_type_name और status_name किसी वर्कफ़्लो और उसके किसी स्टेटस से बिल्कुल मेल खाने चाहिए: संपर्कों के लिए संपर्क वर्कफ़्लो और जॉब्स के लिए जॉब वर्कफ़्लो।
अनुमतियों वाले संदेश के साथ 403कुंजी का Access Profile संपर्क नहीं बना सकता। ऐसा कर सकने वाली प्रोफ़ाइल के साथ नई कुंजी बनाएं।
नोट या जॉब लिंक नहीं हुआprimary एक ऑब्जेक्ट होना चाहिए, जिसका id संपर्क का jnid हो। जाँचें कि create_jobnimbus_contact पहले चला था।
संपर्कों में पता नहीं हैविवरण में रिसेप्शनिस्ट को कॉलर जोड़ने से पहले पूरा पता पूछने के लिए कहें।