EspoCRM | ElevenLabs Documentation

नीचे दिए गए webhook tools के साथ, आपका रिसेप्शनिस्ट उन कॉलर्स को पहचान सकता है जो पहले से EspoCRM में हैं और नए कॉलर्स को उनके नाम, फ़ोन नंबर और ज़रूरतों के साथ leads के रूप में जोड़ सकता है, ताकि आपकी टीम फ़ॉलो-अप कर सके। EspoCRM का API एक स्थिर API key और JSON request bodies लेता है, इसलिए यह EspoCRM Cloud और self-hosted installs के लिए एक ही तरह से काम करता है।

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

एक role बनाएं

EspoCRM में, Administration → Roles पर जाएं और ऐसा role बनाएं जो Leads को पढ़ और बना सके और Contacts को पढ़ सके। बाकी सभी scopes को disabled रहने दें।

एक API user बनाएं

Administration → API Users पर जाएं और एक user बनाएं। authentication method को API Key पर सेट करें और अभी बनाया गया role असाइन करें। सेव करें, फिर user के detail view से API key कॉपी करें।

नीचे दिया गया हर tool, X-Api-Key नाम के request header में key भेजता है। इसका Type Secret पर सेट करें।

API key अपने role द्वारा अनुमति दी गई हर चीज़ को पढ़ और बदल सकती है। role को सीमित रखें और key लीक होने पर EspoCRM में इसे regenerate करें।

अपना EspoCRM address ढूंढें

आपके tools के URLs, उस address से शुरू होते हैं जिसे आप EspoCRM इस्तेमाल करने के लिए अपने browser में खोलते हैं, जिसके बाद /api/v1/ आता है। नीचे की tables में https://YOUR-CRM.example.com इस्तेमाल किया गया है; इसे अपने address से बदलें।

tools बनाएं

हर tool के लिए, Integrations पर जाएं, Add integration चुनें, Webhook Tool चुनें और Assign to agents को Receptionist पर सेट करें। नीचे “Always” के रूप में चिह्नित हर parameter के लिए Value को Fixed value पर सेट करें।

एक lead ढूंढें

Field	Value
Name	`find_espocrm_lead`
Description	”फ़ोन नंबर से हमारे leads में caller को ढूंढें। यह देखने के लिए कि क्या उन्होंने पहले हमसे संपर्क किया है, कॉल की शुरुआत में इसका उपयोग करें।“
Method	GET
URL	`https://YOUR-CRM.example.com/api/v1/Lead`
Request Headers	`X-Api-Key`: आपकी API key
Query Parameters	`textFilter` (string, required): “country code सहित caller का फ़ोन नंबर, उदाहरण के लिए +14155550123।” `select` (string): Always `id,name,status`. `maxSize` (integer): Always `5`.

मौजूदा customers को भी पहचानने के लिए, इन्हीं settings और https://YOUR-CRM.example.com/api/v1/Contact URL के साथ find_espocrm_contact नाम का दूसरा tool बनाएं।

नया lead जोड़ें

Field	Value
Name	`create_espocrm_lead`
Description	”जब `find_espocrm_lead` caller को न ढूंढ पाए, तो उसे नए lead के रूप में जोड़ें।“
Method	POST
URL	`https://YOUR-CRM.example.com/api/v1/Lead`
Request Headers	`X-Api-Key`: आपकी API key
Body Parameters	`firstName` (string, required): “caller का पहला नाम।” `lastName` (string, required): “caller का उपनाम।” `phoneNumber` (string, required): “international format में caller का फ़ोन नंबर, उदाहरण के लिए +14155550123।” `emailAddress` (string): “caller का email address, अगर उन्होंने दिया हो।” `description` (string, required): “caller को क्या चाहिए और वे कब वापस कॉल चाहते हैं।” `status` (string): Always `New`. `source` (string): Always `Call`.

नए leads को एक salesperson को भेजने के लिए, उस user की ID के साथ assignedUserId (string) को fixed value के रूप में जोड़ें। EspoCRM में user खोलने पर address bar में ID दिखाई देगी।

हर tool पर Enable चुनें, फिर quote मांगने वाले नए caller के रूप में अपने रिसेप्शनिस्ट को test करें। lead EspoCRM में New status और Call source के साथ दिखाई देगा।

एक procedure जोड़ें, ताकि आपका रिसेप्शनिस्ट पहले खोजे और match न मिलने पर ही lead जोड़े।

खोज names और email addresses से भी match करती है, इसलिए कोई caller किसी दूसरे व्यक्ति की जानकारी ढूंढने की कोशिश कर सकता है। एक rule जोड़ें कि आपका रिसेप्शनिस्ट CRM records कभी भी callers को पढ़कर न सुनाए, और select को id,name,status तक सीमित रखें।

सीमाएं

textFilter, EspoCRM के अपने search box जैसी ही खोज है: यह names, email addresses और phone numbers में देखता है। फ़ोन नंबर से खोज करने पर किसी दूसरे record का match भी मिल सकता है जिसका नंबर उन्हीं अंकों से शुरू होता हो, इसलिए आपके रिसेप्शनिस्ट को caller के नाम की पुष्टि करनी चाहिए।
इन tools के साथ आपका रिसेप्शनिस्ट किसी मौजूदा lead या contact में note या task नहीं जोड़ सकता। नए lead की description में कॉल की जानकारी रहती है।
tools teams सेट नहीं करते। EspoCRM teams को team IDs की सूची (teamsIds) के रूप में लेता है और webhook tool हमेशा conversation से सूची भरता है, इसलिए यह हर lead को एक ही team में नहीं डाल सकता और आपके रिसेप्शनिस्ट को teams नहीं चुननी चाहिए। इसके बजाय leads को भेजने के लिए assignedUserId इस्तेमाल करें।

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

समस्या	क्या जांचें
EspoCRM से 401	header का नाम `X-Api-Key` होना चाहिए और उसमें API user के detail view वाली key होनी चाहिए। जांचें कि API user active है।
EspoCRM से 403	API user का role leads को पढ़ या बना नहीं सकता। Administration → Roles में role को edit करें।
lead जोड़ते समय 409	EspoCRM को संभावित duplicate मिला है, जैसे समान नाम या email address वाला lead। आपके रिसेप्शनिस्ट को पहले खोज करनी चाहिए।
जाने-पहचाने callers नहीं मिले	phone numbers को international format में स्टोर करें, जैसे `+14155550123`, और जांचें कि नंबर केवल account पर नहीं, बल्कि lead या contact पर है।
`status` या `source` errors	values आपके lead के Status और Source options से बिल्कुल मेल खाने चाहिए, जैसा कि Administration → Entity Manager → Lead में सेट है।