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

# Twenty

आपका रिसेप्शनिस्ट उन कॉलर्स को पहचान सकता है जो पहले से Twenty में हैं और नए कॉलर्स को उनके नाम, फ़ोन नंबर और कॉल करने की वजह के साथ लोगों के रूप में जोड़ सकता है, ताकि आपकी सेल्स टीम फ़ॉलो-अप कर सके। Reception, Twenty के बिल्ट-इन [MCP सर्वर](/docs/hi/reception-ai/integrations/mcp-server) से कनेक्ट होता है, जो Twenty Cloud और सेल्फ़-होस्टेड Twenty के लिए काम करता है। आप Twenty के REST API के लिए [वेबहुक टूल](/docs/hi/reception-ai/integrations/webhooks) भी बना सकते हैं, लेकिन MCP सर्वर को कम सेटअप चाहिए: यह आपके रिसेप्शनिस्ट को लोगों को ढूंढने और जोड़ने के तैयार टूल देता है, जो आपके वर्कस्पेस के फ़ील्ड्स से पहले ही मेल खाते हैं, जिनमें नीचे दिया गया कॉल की वजह वाला फ़ील्ड भी शामिल है।

## सेट अप करें

### कॉल की वजह के लिए एक फ़ील्ड जोड़ें

Twenty में लोगों का अपना कोई नोट्स फ़ील्ड नहीं होता। कॉलर ने क्यों कॉल किया, यह उनके रिकॉर्ड में रखने के लिए **Settings** → **Data model** पर जाएं, **People** खोलें और `Call reason` नाम का **Text** फ़ील्ड जोड़ें। सिर्फ़ वर्कस्पेस एडमिन ही डेटा मॉडल बदल सकते हैं।

### Reception.ai के लिए एक रोल बनाएं

**Settings** → **Members** → **Roles** पर जाएं और ऐसा रोल बनाएं जो सिर्फ़ People को पढ़ और बना सके। अगले चरण में आप API कुंजी को इस रोल के लिए असाइन करेंगे।

### API कुंजी बनाएं

**Settings** → **Developers** → **API** पर जाएं और **+ Create key** चुनें। इसका नाम रखें, जैसे `Reception.ai`, और इसे तुरंत कॉपी कर लें: Twenty इसे सिर्फ़ एक बार दिखाता है। फिर अपने बनाए रोल को खोलें, उसके **Assignment** टैब पर जाएं और कुंजी को उसके लिए असाइन करें।

> **Warning**
>
> API कुंजी अपने रोल की अनुमति के अनुसार सब कुछ पढ़ और बदल सकती है। इसे साझा दस्तावेज़ों से दूर रखें और
> लीक होने पर Twenty में इसे हटा दें।

### MCP सर्वर जोड़ें

Reception.ai में **Integrations** पर जाएं, **Add integration** चुनें और **MCP Server** चुनें।

| फ़ील्ड           | वैल्यू                                                        |
| ---------------- | ------------------------------------------------------------- |
| **Name**         | Twenty                                                        |
| **Server type**  | Streamable HTTP                                               |
| **Server URL**   | आपके वर्कस्पेस का पता, जिसके बाद `/mcp` हो, जैसा नीचे दिया है |
| **Secret Token** | आपकी API कुंजी                                                |

| Twenty कहाँ चलता है | सर्वर URL                                                                   |
| ------------------- | --------------------------------------------------------------------------- |
| Twenty Cloud        | आपके वर्कस्पेस का URL, उदाहरण के लिए `https://mycompany.twenty.com/mcp`     |
| सेल्फ़-होस्टेड      | आपके इंस्टेंस का सार्वजनिक URL, उदाहरण के लिए `https://crm.example.com/mcp` |

आप Twenty में **Settings** → **AI** → **MCP** से सटीक पता कॉपी कर सकते हैं। URL में `?mode=meta` न जोड़ें: यह मोड आपके रिसेप्शनिस्ट को एक ऐसा टूल देता है जो कोई भी कार्रवाई चला सकता है।

**Enable** चुनें। Reception.ai कुंजी को बेयरर टोकन के रूप में भेजता है और Twenty के टूल सूचीबद्ध करता है।

### टूल असाइन करें

Twenty हर ऑब्जेक्ट पर हर कार्रवाई के लिए एक टूल सूचीबद्ध करता है। **Tools** टैब खोलें और सिर्फ़ इन्हें **Client** (रिसेप्शनिस्ट) के लिए असाइन करें:

* `find_many_people`: फ़ोन नंबर से कॉलर ढूंढें।
* `create_one_person`: नाम, फ़ोन नंबर और कॉल की वजह के साथ नया कॉलर जोड़ें।

अपडेट और डिलीट टूल, और दूसरे ऑब्जेक्ट के टूल, असाइन न करें।

### एक प्रक्रिया जोड़ें

नए लीड के लिए एक [प्रक्रिया](/docs/hi/reception-ai/receptionist/rules-and-procedures) जोड़ें: पहले फ़ोन नंबर से कॉलर खोजें, मैच न मिलने पर ही व्यक्ति बनाएं, और हमेशा पहला नाम, अंतिम नाम, फ़ोन नंबर और कॉल की वजह भरें। एक नियम जोड़ें कि आपका रिसेप्शनिस्ट कभी भी CRM रिकॉर्ड कॉलर्स को पढ़कर न सुनाए।

### इसका परीक्षण करें

Twenty में सेव किए गए किसी व्यक्ति के नंबर से कॉल करके, फिर कोटेशन चाहने वाले नए कॉलर के रूप में [अपने रिसेप्शनिस्ट का परीक्षण करें](/docs/hi/reception-ai/receptionist/testing)। नया व्यक्ति **People** में भरी हुई कॉल की वजह के साथ दिखेगा।

## सीमाएं

* Twenty, देश का कॉलिंग कोड बाकी नंबर से अलग रखता है। देश के कोड के बिना या किसी अलग फ़ॉर्मैट में सेव किए गए कॉलर नहीं मिल सकते, इसलिए लौटकर कॉल करने वाला कॉलर दो बार जोड़ा जा सकता है।
* इस सेटअप में आपका रिसेप्शनिस्ट नोट्स, टास्क या अवसर नहीं बनाता। आपकी टीम नए लोगों को **People** सूची से लेती है, उदाहरण के लिए **Call reason** पर फ़िल्टर किए गए व्यू से।
* सेल्फ़-होस्टेड इंस्टेंस के लिए MCP सर्वर वाला Twenty वर्शन चाहिए और सार्वजनिक URL इंटरनेट से HTTPS के ज़रिए पहुंच योग्य होना चाहिए।
* Twenty का API प्रति मिनट 100 अनुरोधों की अनुमति देता है। अन्य इंटीग्रेशन वाले व्यस्त वर्कस्पेस सीमा तक पहुंच सकते हैं।

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

| समस्या                              | क्या जांचें                                                                                                                                                   |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| कोई टूल सूचीबद्ध नहीं है            | **Streamable HTTP** सर्वर टाइप इस्तेमाल करें और जांचें कि URL का अंत `/mcp` से होता है। सेल्फ़-होस्टेड में `SERVER_URL` सेटिंग आपका सार्वजनिक URL होना चाहिए। |
| कोई टूल अनुमति की गड़बड़ी लौटाता है | कुंजी का रोल People को पढ़ या बना नहीं सकता। **Settings** → **Members** → **Roles** में रोल बदलें।                                                            |
| पहचाने हुए कॉलर नहीं मिलते          | फ़ोन नंबर उनके देश कोड के साथ और एक ही फ़ॉर्मैट में स्टोर करें।                                                                                               |
| कॉल की वजह खाली है                  | `Call reason` फ़ील्ड जोड़ने के बाद **Refresh tools** चुनें, फिर बदले हुए टूल पर **Update** चुनें।                                                             |
| आपने कुंजी बदल दी                   | इंटीग्रेशन बदलें और **Rotate Secret Token (optional)** इस्तेमाल करें। सेव की गई कुंजी फिर कभी नहीं दिखाई जाती।                                                |