> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# EspoCRM

नीचे दिए गए [webhook tools](/docs/hi/reception-ai/integrations/webhooks) के साथ, आपका रिसेप्शनिस्ट उन कॉलर्स को पहचान सकता है जो पहले से 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** पर सेट करें।

> **Warning**
>
> 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 करें](/docs/hi/reception-ai/receptionist/testing)। lead EspoCRM में **New** status और **Call** source के साथ दिखाई देगा।

> **Tip**
>
> एक [procedure](/docs/hi/reception-ai/receptionist/rules-and-procedures) जोड़ें, ताकि आपका रिसेप्शनिस्ट
> पहले खोजे और match न मिलने पर ही lead जोड़े।

> **Warning**
>
> खोज 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** में सेट है। |