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

Twenty

इसके MCP सर्वर के ज़रिए कॉलर पहचानें और Twenty CRM में नए लीड जोड़ें।

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

सेट अप करें

1

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

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

2

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

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

3

API कुंजी बनाएं

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

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

4

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

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

फ़ील्डवैल्यू
NameTwenty
Server typeStreamable 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 के टूल सूचीबद्ध करता है।

5

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

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

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

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

6

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

नए लीड के लिए एक प्रक्रिया जोड़ें: पहले फ़ोन नंबर से कॉलर खोजें, मैच न मिलने पर ही व्यक्ति बनाएं, और हमेशा पहला नाम, अंतिम नाम, फ़ोन नंबर और कॉल की वजह भरें। एक नियम जोड़ें कि आपका रिसेप्शनिस्ट कभी भी CRM रिकॉर्ड कॉलर्स को पढ़कर न सुनाए।

7

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

Twenty में सेव किए गए किसी व्यक्ति के नंबर से कॉल करके, फिर कोटेशन चाहने वाले नए कॉलर के रूप में अपने रिसेप्शनिस्ट का परीक्षण करें। नया व्यक्ति 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) इस्तेमाल करें। सेव की गई कुंजी फिर कभी नहीं दिखाई जाती।