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

ServiceM8

वेबहुक टूल से कॉल को ServiceM8 कोटेशन और जॉब में बदलें।

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

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

ServiceM8 में, Settings → API Keys खोलें और एक की बनाएं। नीचे दिया गया हर टूल इसे X-Api-Key रिक्वेस्ट हेडर में भेजता है। की रखने वाला कोई भी व्यक्ति आपका ServiceM8 डेटा पढ़ और बदल सकता है, इसलिए इसे साझा दस्तावेज़ों में न रखें।

टूल बनाएं

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

जॉब बनाएं

फ़ील्डवैल्यू
Namecreate_servicem8_job
Description”जब किसी कॉलर को काम करवाना हो या वह कोटेशन चाहता हो, तब जॉब बनाएं।“
MethodPOST
URLhttps://api.servicem8.com/api_1.0/job.json
Request HeadersX-Api-Key: आपकी API की
Body Parametersstatus (string, required): “हमेशा बिल्कुल यही वैल्यू Quote रखें।”
job_address (string, required): “वह पूरा पता जहां काम होना है, जिसमें पोस्टकोड भी शामिल हो।”
job_description (string, required): “कॉलर का नाम और फ़ोन नंबर, फिर उसे क्या काम करवाना है और उसके दिए हुए विवरण।”

अगर कॉल सीधे तय किए गए काम में जाने चाहिए, तो Quote की जगह Work Order इस्तेमाल करें।

नया क्लाइंट जोड़ें

फ़ील्डवैल्यू
Namecreate_servicem8_client
Description”जब कॉलर कहे कि उसने पहले कभी हमारी सेवाएं नहीं ली हैं, तो उसे नए क्लाइंट के रूप में जोड़ें।“
MethodPOST
URLhttps://api.servicem8.com/api_1.0/company.json
Request HeadersX-Api-Key: आपकी API की
Body Parametersname (string, required): “कॉलर का पूरा नाम या उसके व्यवसाय का नाम।”
address (string): “क्लाइंट का पता, जिसमें पोस्टकोड भी शामिल हो।”

हर टूल पर Enable चुनें, फिर कोटेशन मांगकर अपने रिसेप्शनिस्ट का परीक्षण करें। नया कोटेशन ServiceM8 में दिखेगा।

सीमाएं

  • ServiceM8 दोनों टूल के लिए केवल OK से जवाब देता है। नए रिकॉर्ड की ID ऐसे रिस्पॉन्स हेडर में होती है जिसे आपका रिसेप्शनिस्ट पढ़ नहीं सकता, इसलिए वह जॉब को क्लाइंट से लिंक नहीं कर सकता। आपकी टीम उन्हें ServiceM8 में लिंक करती है।
  • ServiceM8 फ़ोन नंबर और ईमेल को क्लाइंट के कॉन्टैक्ट्स में रखता है, जो एक अलग रिकॉर्ड है और क्लाइंट टूल उसे नहीं बना सकता। इसके बजाय जॉब विवरण में कॉलर का नंबर होता है।
  • किसी मौजूदा क्लाइंट को खोजने के लिए $filter पैरामीटर चाहिए और वेबहुक टूल पैरामीटर के नाम में $ नहीं हो सकता, इसलिए आपका रिसेप्शनिस्ट कॉलर्स को खोज नहीं सकता।

लिंक किए गए क्लाइंट और जॉब बनाने के लिए, Zapier के ज़रिए ServiceM8 के Create Client और Create Job ऐक्शन इस्तेमाल करें।

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

समस्याक्या जांचें
ServiceM8 से 401हेडर का नाम X-Api-Key होना चाहिए और उसमें मौजूदा की होनी चाहिए।
स्टेटस के बारे में 400status बिल्कुल Quote, Work Order, Unsuccessful, या Completed होना चाहिए।
जॉब में पता नहीं हैविवरण में रिसेप्शनिस्ट को जॉब बनाने से पहले पूरा पता पूछने के लिए कहें।
ServiceM8 से 429आपने ServiceM8 की अनुरोध सीमा पूरी कर ली है। एक मिनट रुकें और फिर कोशिश करें।