डिप्लॉय करेंटेलीफोनी

SIP ट्रंकिंग

SIP ट्रंकिंग का इस्तेमाल करके अपने मौजूदा फोन सिस्टम को ElevenLabs Agents से कनेक्ट करें

अवलोकन

SIP (सेशन इनिशिएशन प्रोटोकॉल) ट्रंकिंग आपको अपने मौजूदा टेलीफोनी इन्फ्रास्ट्रक्चर को सीधे ElevenLabs Agents से कनेक्ट करने देती है। यह इंटीग्रेशन सभी ग्राहकों को ElevenLabs की उन्नत वॉइस AI क्षमताओं का उपयोग करते हुए अपने मौजूदा फोन सिस्टम इस्तेमाल करने देता है।

SIP ट्रंकिंग के साथ, आप:

  • अपने प्राइवेट ब्रांच एक्सचेंज (PBX) या SIP-सक्षम फोन सिस्टम को ElevenLabs के वॉइस AI प्लेटफ़ॉर्म से कनेक्ट कर सकते हैं
  • अपने मौजूदा फोन इन्फ्रास्ट्रक्चर को बदले बिना कॉल को AI एजेंट्स तक रूट कर सकते हैं
  • इनबाउंड और आउटबाउंड, दोनों तरह की कॉल संभाल सकते हैं
  • बेहतर सुरक्षा के लिए एन्क्रिप्टेड TLS ट्रांसपोर्ट और मीडिया एन्क्रिप्शन का उपयोग कर सकते हैं

SIP के लिए नए हैं? इस गाइड में इस्तेमाल हुए SIP, SBC, SDP, RTP और MTU जैसे शब्दों की आसान परिभाषाओं के लिए SIP रेफरेंस देखें।

स्टैटिक IP SIP सर्वर्स

ElevenLabs उन एंटरप्राइज़ ग्राहकों के लिए स्टैटिक IP एड्रेस वाले SIP सर्वर देता है, जिन्हें अपनी सुरक्षा नीतियों के लिए IP allowlisting की आवश्यकता होती है।

हमारा स्टैटिक IP इन्फ्रास्ट्रक्चर /24 IP एड्रेस ब्लॉक इस्तेमाल करता है, जिसमें US, EU, भारत और सिंगापुर सहित कई क्षेत्रों में वितरित 256 एड्रेस होते हैं। आपको अपने फ़ायरवॉल कॉन्फ़िगरेशन में पूरे /24 ब्लॉक को allowlist करना होगा।

डिफ़ॉल्ट (US/इंटरनेशनल) एनवायरनमेंट के लिए, अपने SIP एंडपॉइंट के रूप में sip-static.rtc.elevenlabs.io इस्तेमाल करें। अलग क्षेत्रों के लिए, sip-static.rtc.<region>.residency.elevenlabs.io इस्तेमाल करें, जहां <region> आपका डेटा रेज़िडेंसी क्षेत्र कोड है (उदाहरण के लिए eu, in, या sg)। इन एंडपॉइंट्स का उपयोग करने पर, सारा ट्रैफ़िक केवल उसी क्षेत्र के भीतर से आएगा। प्रति-क्षेत्र विशिष्ट allowlisting उपलब्ध नहीं है। उपलब्ध क्षेत्रों की सूची के लिए डेटा रेज़िडेंसी देखें।

यह सुविधा Enterprise अकाउंट्स के लिए उपलब्ध है और टेस्टिंग के लिए Enterprise ट्रायल के दौरान भी चालू की जा सकती है। एक्सेस का अनुरोध करने के लिए Support को support@elevenlabs.io पर ईमेल करें या अपने अकाउंट प्रतिनिधि से संपर्क करें। अधिक जानकारी के लिए, सेल्स से संपर्क करें।

SIP ट्रंकिंग कैसे काम करती है

SIP ट्रंकिंग आपके टेलीफोनी इन्फ्रास्ट्रक्चर और ElevenLabs प्लेटफ़ॉर्म के बीच सीधा कनेक्शन बनाती है:

  1. इनबाउंड कॉल: आपके SIP ट्रंक से आने वाली कॉल आपके कॉन्फ़िगर किए गए SIP INVITE एड्रेस का उपयोग करके ElevenLabs प्लेटफ़ॉर्म पर रूट की जाती हैं।
  2. आउटबाउंड कॉल: ElevenLabs द्वारा शुरू की गई कॉल आपके कॉन्फ़िगर किए गए होस्टनेम का उपयोग करके आपके SIP ट्रंक पर रूट की जाती हैं, जिससे आपके एजेंट्स आउटगोइंग कॉल कर सकते हैं।
  3. ऑथेंटिकेशन: सिग्नलिंग के लिए कनेक्शन सुरक्षा, डाइजेस्ट ऑथेंटिकेशन (यूज़रनेम/पासवर्ड) या सिग्नलिंग सोर्स IP पर आधारित एक्सेस कंट्रोल लिस्ट (ACL) ऑथेंटिकेशन के जरिए बनाए रखी जाती है।
  4. सिग्नलिंग और मीडिया: शुरुआती कॉल सेटअप (सिग्नलिंग) एन्क्रिप्टेड कम्युनिकेशन के लिए TLS सहित कई ट्रांसपोर्ट प्रोटोकॉल सपोर्ट करता है। कॉल स्थापित होने के बाद, वास्तविक ऑडियो डेटा (RTP स्ट्रीम) को आपकी मीडिया एन्क्रिप्शन सेटिंग्स के आधार पर एन्क्रिप्ट किया जा सकता है।

ट्रांसपोर्ट सुरक्षा: सर्टिफ़िकेट और सिफ़र सुइट

जब आप TLS ट्रांसपोर्ट इस्तेमाल करते हैं, तो कोई भी SIP सिग्नलिंग एक्सचेंज होने से पहले दोनों पक्ष TLS हैंडशेक करते हैं। हैंडशेक के दौरान वे एक सर्टिफ़िकेट को वैलिडेट करते हैं और एक सिफ़र सुइट पर सहमति बनाते हैं। कनेक्शन स्वीकार करने वाला पक्ष TLS सर्वर के रूप में काम करता है और सर्टिफ़िकेट प्रस्तुत करता है; कनेक्शन खोलने वाला पक्ष TLS क्लाइंट के रूप में काम करता है और उसे वैलिडेट करता है। ElevenLabs के लिए TLS 1.2 या इससे ऊपर का वर्ज़न ज़रूरी है।

भूमिकाएं कॉल की दिशा पर निर्भर करती हैं:

  • ElevenLabs पर इनबाउंड कॉल: आपका सिस्टम कनेक्शन खोलता है, इसलिए ElevenLabs TLS सर्वर के रूप में काम करता है। ElevenLabs sip.rtc.elevenlabs.io के लिए एक वैध सर्टिफ़िकेट प्रस्तुत करता है, और आपका सिस्टम TLS क्लाइंट के रूप में इसे वैलिडेट करता है।
  • ElevenLabs से आउटबाउंड कॉल: ElevenLabs आपके कॉन्फ़िगर किए गए पते पर कनेक्शन खोलता है, इसलिए आपका SIP सर्वर या SBC TLS सर्वर के रूप में काम करता है। आपके सिस्टम को एक वैध, विश्वसनीय सर्टिफ़िकेट प्रस्तुत करना होगा, जिसे ElevenLabs TLS क्लाइंट के रूप में वैलिडेट करता है।

सुनिश्चित करें कि दोनों पक्ष एक-दूसरे के सर्टिफ़िकेट पर भरोसा करते हैं और कम से कम एक समान सिफ़र सुइट साझा करते हैं। अगर ऐसा नहीं है, तो कॉल स्थापित होने से पहले TLS हैंडशेक विफल हो जाएगा। इन शब्दों की परिभाषाओं के लिए SIP रेफरेंस देखें।

फ़ॉलो-अप कनेक्शन

कुछ इन-डायलॉग अनुरोधों, जैसे BYE या REFER, के लिए नया TLS कनेक्शन चाहिए हो सकता है, जब मूल कनेक्शन पहले ही बंद हो चुका हो। इन फ़ॉलो-अप कनेक्शनों के लिए सर्टिफ़िकेट का व्यवहार शुरुआती कॉल सेटअप से अलग होता है:

  • ElevenLabs के लिए फ़ॉलो-अप कनेक्शन: आपका सिस्टम रिस्पॉन्स में लौटाए गए Contact हेडर के पते पर कनेक्शन स्थापित करता है, जो <ip>.hosts.rtc.elevenlabs.io के रूप में एक खास SIP सर्वर पर रिज़ॉल्व होता है। वह सर्वर *.hosts.rtc.elevenlabs.io के लिए वैध सर्टिफ़िकेट प्रस्तुत करता है, जिसे आपका सिस्टम TLS क्लाइंट के रूप में वैलिडेट करता है।
  • ElevenLabs से फ़ॉलो-अप कनेक्शन: जब ElevenLabs BYE या REFER के लिए TLS कनेक्शन शुरू करता है, तो वह सबसे ऊपर वाले Via हेडर के पते से कनेक्ट होता है, जो अक्सर एक IP पता होता है। आपका सिस्टम आम तौर पर उस IP पते के बजाय पूरी तरह योग्य डोमेन नाम (FQDN) के लिए वैध सर्टिफ़िकेट लौटाता है। इस सर्टिफ़िकेट को वैलिडेट करने के लिए, अपनी फ़ोन नंबर सेटिंग्स में Remote domains फ़ील्ड कॉन्फ़िगर करें। अगर प्राप्त सर्टिफ़िकेट के लिए वैध कोई भी डोमेन कॉन्फ़िगर किए गए रिमोट डोमेन से मेल खाता है, तो वैलिडेशन सफल होगा; अन्यथा यह विफल होगा।

अगर TLS पर आउटबाउंड BYE या REFER अनुरोधों का सर्टिफ़िकेट वैलिडेशन विफल हो जाए, तो जिस FQDN के लिए आपके SIP सर्वर का सर्टिफ़िकेट जारी किया गया है, उसे फ़ोन नंबर सेटिंग्स के Remote domains फ़ील्ड में जोड़ें।

ElevenLabs SIP ट्रंक पर कॉल करना

ElevenLabs प्लेटफ़ॉर्म पर कॉल शुरू करते समय, आपको सही SIP URI फ़ॉर्मैट इस्तेमाल करना होगा। ElevenLabs SIP ट्रंक URI उस ट्रांसपोर्ट पर निर्भर करता है जिसे आप सिग्नलिंग के लिए इस्तेमाल करना चाहते हैं:

  • TCP: sip:sip.rtc.elevenlabs.io:5060;transport=tcp
  • TLS: sip:sip.rtc.elevenlabs.io:5061;transport=tls
  • UDP: sip:sip.rtc.elevenlabs.io:5060;transport=udp (एक्सपेरिमेंटल; इसे केवल टेस्टिंग के लिए इस्तेमाल करें, प्रोडक्शन के लिए नहीं)

कॉल करने के लिए, एक पूरा SIP URI बनाएं जिसमें एक आइडेंटिफ़ायर शामिल हो। उदाहरण के लिए, TCP पर फ़ोन नंबर +19991234567 पर कॉल करने के लिए:

sip:+19991234567@sip.rtc.elevenlabs.io:5060

जहां:

  • +19991234567 आइडेंटिफ़ायर है (आमतौर पर E.164 फ़ॉर्मैट में फ़ोन नंबर)
  • आइडेंटिफ़ायर कोई भी स्ट्रिंग वैल्यू हो सकता है, जैसे 1000 या john

आम गलती: बिना आइडेंटिफ़ायर के सीधे sip@sip.rtc.elevenlabs.io:5060 पर कॉल शुरू न करें। SIP URI में sip: प्रीफ़िक्स के बाद और @ सिंबल से पहले फ़ोन नंबर या आइडेंटिफ़ायर होना ज़रूरी है।

SIP URI फ़ॉर्मैट: एक SIP URI का फ़ॉर्मैट sip:identifier@domain:port होता है, जिसमें कॉल को सही तरीके से रूट करने के लिए आइडेंटिफ़ायर ज़रूरी है।

आवश्यकताएं

SIP ट्रंकिंग सेट अप करने से पहले, सुनिश्चित करें कि आपके पास ये चीज़ें हैं:

  1. SIP-संगत PBX या टेलीफ़ोनी सिस्टम
  2. वे फ़ोन नंबर जिन्हें आप ElevenLabs से कनेक्ट करना चाहते हैं
  3. अपने SIP ट्रंक कॉन्फ़िगरेशन का एडमिनिस्ट्रेटर एक्सेस
  4. SIP ट्रैफ़िक की अनुमति देने के लिए सही फ़ायरवॉल सेटिंग्स
  5. TLS सपोर्ट: बेहतर सुरक्षा के लिए, सुनिश्चित करें कि आपका SIP ट्रंक प्रोवाइडर TLS ट्रांसपोर्ट सपोर्ट करता है
  6. ऑडियो कोडेक संगतता: आपका सिस्टम G.722 या G.711 (PCMU या PCMA) ऑडियो कोडेक में से कम से कम एक को सपोर्ट करता हो, या आपके पक्ष में ऑडियो री-सैंपल करने में सक्षम हो। यह सीधे websocket कनेक्शन के लिए एजेंट पर कॉन्फ़िगर किए गए किसी भी ऑडियो फ़ॉर्मैट से अलग है।

SIP ट्रंकिंग सेट अप करना

1

फ़ोन नंबर पर जाएं

ElevenLabs Agents डैशबोर्ड में फ़ोन नंबर सेक्शन पर जाएं।

2

SIP ट्रंक इंपोर्ट करें

“Import number” बटन पर क्लिक करें, फिर कॉन्फ़िगरेशन डायलॉग खोलने के लिए “From SIP Trunk” चुनें।

From SIP Trunk विकल्प वाला इंपोर्ट नंबर मेनू
3

बेसिक कॉन्फ़िगरेशन दर्ज करें

निम्न जानकारी के साथ बेसिक कॉन्फ़िगरेशन पूरा करें:

  • लेबल: फ़ोन नंबर का वर्णनात्मक नाम
  • फ़ोन नंबर: कनेक्ट करने के लिए E.164 फ़ॉर्मैट वाला फ़ोन नंबर (जैसे, +15551234567)
लेबल और फ़ोन नंबर फ़ील्ड के साथ SIP ट्रंक बेसिक कॉन्फ़िगरेशन
4

इनबाउंड सेटिंग्स कॉन्फ़िगर करें

मीडिया एन्क्रिप्शन और एक्सेस कंट्रोल समेत, अपने SIP ट्रंक पर आने वाली कॉल को ElevenLabs कैसे हैंडल करे, यह कॉन्फ़िगर करें:

  • मीडिया एन्क्रिप्शन: RTP मीडिया स्ट्रीम के लिए एन्क्रिप्शन कॉन्फ़िगर करें:
    • डिसेबल्ड: कोई मीडिया एन्क्रिप्शन नहीं
    • अलाउड: एन्क्रिप्टेड मीडिया स्ट्रीम की अनुमति देता है
    • रिक्वायर्ड: एन्क्रिप्टेड मीडिया स्ट्रीम लागू करता है
  • अनुमत नंबर (वैकल्पिक): इस नंबर पर कॉल करने के लिए अधिकृत फ़ोन नंबर। सभी नंबर को अनुमति देने के लिए खाली छोड़ें।
  • अनुमत सोर्स IP पते (वैकल्पिक): केवल TCP/TLS ट्रांसपोर्ट के लिए काम करता है, UDP के लिए नहीं। IP पते या CIDR रेंज जिन्हें इस ट्रंक पर कॉल भेजने की अनुमति है। सभी पतों को अनुमति देने के लिए 0.0.0.0/0 रखें।
  • रिमोट डोमेन (वैकल्पिक): अपने SIP सर्वर के FQDN डोमेन बताएं, जिनसे आप कॉल शुरू करते हैं, उदाहरण के लिए example.pstn.twilio.com। इन डोमेन का इस्तेमाल TLS सर्टिफ़िकेट वैलिडेशन के लिए होता है। अगर आप TLS इस्तेमाल नहीं करते, तो यह फ़ील्ड खाली छोड़ें।
  • ऑथेंटिकेशन (वैकल्पिक): इनबाउंड कॉल को ऑथेंटिकेट करने के लिए इस्तेमाल होने वाले डाइजेस्ट ऑथेंटिकेशन क्रेडेंशियल दें।
    • SIP ट्रंक यूज़रनेम: SIP डाइजेस्ट ऑथेंटिकेशन के लिए यूज़रनेम
    • SIP ट्रंक पासवर्ड: SIP डाइजेस्ट ऑथेंटिकेशन के लिए पासवर्ड
मीडिया एन्क्रिप्शन, अनुमत नंबर, अनुमत सोर्स IP पते, रिमोट डोमेन और ऑथेंटिकेशन समेत इनबाउंड कॉन्फ़िगरेशन सेटिंग्स
5

आउटबाउंड सेटिंग्स कॉन्फ़िगर करें

अपने फ़ोन नंबर के लिए ElevenLabs को कॉल कहां भेजनी चाहिए, यह कॉन्फ़िगर करें:

  • पता: वह होस्टनेम या IP पता जहां SIP INVITE भेजा जाता है (जैसे, sip.telnyx.com)। यह केवल होस्टनेम या IP पता होना चाहिए, पूरा SIP URI नहीं। TLS इस्तेमाल करने पर, वैध सर्टिफ़िकेट वाले होस्टनेम का उपयोग करें।

  • ट्रांसपोर्ट टाइप: SIP सिग्नलिंग के लिए ट्रांसपोर्ट प्रोटोकॉल चुनें:

    • TCP: स्टैंडर्ड TCP ट्रांसपोर्ट
    • TLS: बेहतर सुरक्षा के लिए एन्क्रिप्टेड TLS ट्रांसपोर्ट
    • UDP: कनेक्शनलेस ट्रांसपोर्ट (एक्सपेरिमेंटल; प्रोडक्शन के लिए TCP या TLS इस्तेमाल करें)

  • मीडिया एन्क्रिप्शन: RTP मीडिया स्ट्रीम के लिए एन्क्रिप्शन कॉन्फ़िगर करें:

    • डिसेबल्ड: कोई मीडिया एन्क्रिप्शन नहीं
    • अलाउड: एन्क्रिप्टेड मीडिया स्ट्रीम की अनुमति देता है
    • रिक्वायर्ड: एन्क्रिप्टेड मीडिया स्ट्रीम लागू करता है

  • एनेबल्ड कोडेक्स: आउटबाउंड कॉल के लिए SDP में ऑफ़र किए जाने वाले कोडेक्स (G.722, PCMU, PCMA)। जब आपका SIP प्रोवाइडर सिर्फ़ कुछ कोडेक्स सपोर्ट करता हो, तब उपयोगी है।

  • कस्टम हेडर्स (वैकल्पिक): आउटबाउंड कॉल के साथ शामिल किए जाने वाले कस्टम SIP हेडर्स जोड़ें। अपने प्रोवाइडर के लिए ज़रूरी हेडर नाम और वैल्यू दर्ज करने के लिए “Add Header” पर क्लिक करें; ज़रूरत के अनुसार कई हेडर्स जोड़ सकते हैं। कस्टम हेडर्स का उपयोग कॉल रूटिंग और पहचान, बिलिंग व ट्रैकिंग, और प्रोवाइडर-विशिष्ट आवश्यकताओं के लिए किया जा सकता है।

  • ऑथेंटिकेशन (वैकल्पिक): अगर आपका SIP ट्रंक प्रोवाइडर मांगता है, तो डाइजेस्ट ऑथेंटिकेशन क्रेडेंशियल दें।

    • SIP ट्रंक यूज़रनेम: SIP डाइजेस्ट ऑथेंटिकेशन के लिए यूज़रनेम
    • SIP ट्रंक पासवर्ड: SIP डाइजेस्ट ऑथेंटिकेशन के लिए पासवर्ड

    खाली छोड़ने पर, एक्सेस कंट्रोल लिस्ट (ACL) ऑथेंटिकेशन इस्तेमाल होगा, जिसके लिए आपको अपने प्रोवाइडर की सेटिंग्स में ElevenLabs IP पतों को अलाउलिस्ट करना होगा।

पता, ट्रांसपोर्ट टाइप, मीडिया एन्क्रिप्शन, एनेबल्ड कोडेक्स, कस्टम हेडर्स और ऑथेंटिकेशन समेत आउटबाउंड कॉन्फ़िगरेशन सेटिंग्स

सुरक्षा की सबसे अच्छी प्रैक्टिस: अधिकतम सुरक्षा के लिए Required मीडिया एन्क्रिप्शन के साथ TLS ट्रांसपोर्ट इस्तेमाल करें। इससे सिग्नलिंग और मीडिया, दोनों एंड-टू-एंड एन्क्रिप्टेड रहते हैं।

ऑथेंटिकेशन तरीके:

  • डाइजेस्ट ऑथेंटिकेशन: सुरक्षित ऑथेंटिकेशन के लिए यूज़रनेम/पासवर्ड क्रेडेंशियल इस्तेमाल करता है (सुझाया गया)
  • ACL ऑथेंटिकेशन: एक्सेस कंट्रोल के लिए IP पता अलाउलिस्टिंग इस्तेमाल करता है

डाइजेस्ट ऑथेंटिकेशन की सख़्त सलाह दी जाती है, क्योंकि यह IP अलाउलिस्टिंग पर निर्भर हुए बिना बेहतर सुरक्षा देता है, जिसे डायनेमिक IP पतों के साथ मैनेज करना मुश्किल हो सकता है।

Address फ़ील्ड बताता है कि ElevenLabs आपके AI एजेंट्स से आउटबाउंड कॉल कहां भेजेगा। sip: प्रोटोकॉल प्रीफ़िक्स के बिना केवल होस्टनेम या IP पता दर्ज करें।

6

सेटअप पूरा करें

कॉन्फ़िगरेशन को अंतिम रूप देने के लिए “Import” पर क्लिक करें।

क्लाइंट डेटा और पर्सनलाइज़ेशन

कॉल मेटाडेटा की सही फ़ॉरवर्डिंग और ट्रेसबिलिटी के लिए, अपने webhook payload और SIP INVITE अनुरोध में ये कस्टम SIP हेडर्स शामिल करें:

  • X-CALL-ID: कॉल के लिए यूनिक आइडेंटिफ़ायर
  • X-CALLER-ID: कॉल करने वाले पक्ष का आइडेंटिफ़ायर

ये हेडर्स सिस्टम को कॉल मेटाडेटा को बातचीत से जोड़ने और पर्सनलाइज़ेशन के लिए संदर्भ देने में सक्षम बनाते हैं।

फ़ॉलबैक हेडर सपोर्ट

अगर ऊपर दिए गए स्टैंडर्ड हेडर्स मौजूद नहीं हैं, तो सिस्टम अपने-आप Twilio-विशिष्ट SIP हेडर ढूंढेगा:

  • sip.twilio.callSid: Twilio का यूनिक कॉल आइडेंटिफ़ायर

यह फ़ॉलबैक कॉन्फ़िगरेशन में बदलाव किए बिना Twilio के Elastic SIP Trunking के साथ संगतता सुनिश्चित करता है।

प्रोसेसिंग फ़्लो

समर्थित हेडर्स में से किसी से संबंधित मेटाडेटा मिल जाने पर, caller_id और/या call_id कन्वर्सेशन इनिशिएशन webhook में और सिस्टम डायनेमिक वेरिएबल्स के रूप में उपलब्ध होते हैं।

डायनेमिक वेरिएबल्स के रूप में इनबाउंड कस्टम हेडर्स

इनबाउंड SIP ट्रंकिंग कॉल के कस्टम SIP X- हेडर्स बातचीत में अपने-आप डायनेमिक वेरिएबल्स के रूप में उपलब्ध होते हैं।

हेडर नामों को X- प्रीफ़िक्स हटाकर, नाम को लोअरकेस में बदलकर, हाइफ़न को अंडरस्कोर से बदलकर और sip_ प्रीफ़िक्स जोड़कर नॉर्मलाइज़ किया जाता है। उदाहरण के लिए, X-Contact-ID {{sip_contact_id}} बनता है और X-Campaign-ID {{sip_campaign_id}} बनता है।

कॉलर द्वारा दिए गए संदर्भ के साथ बातचीत को पर्सनलाइज़ करने के लिए इन वेरिएबल्स का इस्तेमाल एजेंट प्रॉम्प्ट, पहले मैसेज और टूल्स में करें। वैल्यू बातचीत के इतिहास में Phone Call टैब के अंतर्गत भी दिखती हैं।

X-Call-ID और X-Caller-ID जैसे रिज़र्व्ड हेडर्स अब भी system__call_sid और system__caller_id से मैप होते हैं। कस्टम इनबाउंड हेडर्स इन सिस्टम वेरिएबल्स को ओवरराइड नहीं कर सकते।

डायनेमिक वेरिएबल्स से BYE हेडर्स

कॉल खत्म होने पर, ElevenLabs डायलॉग समाप्त करने के लिए SIP BYE भेजता है। आप अपने SIP ट्रंक कॉन्फ़िगरेशन में डायनेमिक वेरिएबल्स को हेडर नामों से मैप करके उस BYE में कस्टम हेडर्स जोड़ सकते हैं।

API के ज़रिए SIP ट्रंक फ़ोन नंबर बनाते समय या अपडेट करते समय, inbound_trunk_config या outbound_trunk_config पर attributes_to_headers सेट करें। हर एंट्री एक डायनेमिक वेरिएबल नाम को BYE में शामिल करने वाले SIP हेडर नाम से मैप करती है:

"inbound_trunk_config": {
  "attributes_to_headers": {
    "dynamic_variable_name": "bye_header_name"
  }
}

हेडर वैल्यू बातचीत के अंत में डायनेमिक वेरिएबल की अंतिम वैल्यू होती है। कॉल के दौरान सेट की गई वैल्यू—एजेंट टूल्स, webhook ओवरराइड्स या अन्य रनटाइम अपडेट्स के ज़रिए—BYE में दिखाई जाती हैं।

उदाहरण के लिए, अगर attributes_to_headers में "disposition_code": "X-Disposition" है और बातचीत खत्म होने पर disposition_code डायनेमिक वेरिएबल resolved है, तो BYE में X-Disposition: resolved शामिल होगा।

फ़ोन नंबरों को एजेंट्स असाइन करना

अपना SIP ट्रंक फ़ोन नंबर इंपोर्ट करने के बाद, आप उसे एक ElevenLabs एजेंट को असाइन कर सकते हैं:

  1. ElevenAgents डैशबोर्ड में फ़ोन नंबर सेक्शन पर जाएं
  2. अपना इंपोर्ट किया हुआ SIP ट्रंक फ़ोन नंबर चुनें
  3. “Assign Agent” पर क्लिक करें
  4. वह एजेंट चुनें जिसे आप इस नंबर पर कॉल हैंडल करने देना चाहते हैं

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

अगर आपको कनेक्शन संबंधी समस्याएं आ रही हैं:

  1. ElevenLabs और अपने प्रोवाइडर, दोनों तरफ़ अपना SIP ट्रंक कॉन्फ़िगरेशन जांचें
  2. जांचें कि आपका फ़ायरवॉल कॉन्फ़िगर किए गए ट्रांसपोर्ट प्रोटोकॉल और पोर्ट (TCP के लिए 5060, TLS के लिए 5061) पर SIP सिग्नलिंग ट्रैफ़िक की अनुमति देता है और कोई अलाउलिस्टिंग लागू नहीं है
  3. पुष्टि करें कि आपका एड्रेस होस्टनेम सही फ़ॉर्मैट में है और एक्सेस किया जा सकता है
  4. डाइजेस्ट ऑथेंटिकेशन क्रेडेंशियल के साथ और उनके बिना टेस्ट करें
  5. TLS ट्रांसपोर्ट इस्तेमाल करने पर, सुनिश्चित करें कि आपके प्रोवाइडर के TLS सर्टिफ़िकेट वैध और सही तरीके से कॉन्फ़िगर हैं
  6. TLS-विशिष्ट समस्याओं को अलग करने के लिए अलग-अलग ट्रांसपोर्ट टाइप (TCP या TLS; UDP सपोर्ट एक्सपेरिमेंटल है) आज़माएं

नेटवर्क आर्किटेक्चर की अहम जानकारी:

  • ElevenLabs साझा पते sip.rtc.elevenlabs.io के पीछे कई SIP सर्वर से SIP ट्रैफ़िक प्रदान करता है
  • ये SIP सर्वर आपके SIP सर्वर से सीधे संवाद करते हैं
  • हमारे डिस्ट्रीब्यूटेड इन्फ़्रास्ट्रक्चर के कारण SIP अनुरोध अलग-अलग IP पतों से आ सकते हैं
  • अगर आपकी सुरक्षा नीति में इनबाउंड ट्रैफ़िक की अलाउलिस्टिंग ज़रूरी है, तो मदद के लिए हमारी सपोर्ट टीम से संपर्क करें।

अगर ऑथेंटिकेशन समस्याओं के कारण कॉल विफल हो रही हैं:

  1. डाइजेस्ट ऑथेंटिकेशन इस्तेमाल करने पर अपना SIP ट्रंक यूज़रनेम और पासवर्ड दोबारा जांचें
  2. खास ऑथेंटिकेशन एरर मैसेज के लिए अपने SIP ट्रंक प्रोवाइडर के लॉग्स जांचें
  3. अगर कॉन्फ़िगर किए गए हैं, तो पुष्टि करें कि कस्टम हेडर्स आपके प्रोवाइडर की ज़रूरतों से मेल खाते हैं
  4. ऑथेंटिकेशन समस्याओं को अलग करने के लिए सरल कॉन्फ़िगरेशन (कोई कस्टम हेडर नहीं) से टेस्ट करें

अगर आपको TLS ट्रांसपोर्ट या मीडिया एन्क्रिप्शन में समस्याएं आ रही हैं:

  1. पुष्टि करें कि आपका SIP ट्रंक प्रोवाइडर पोर्ट 5061 पर TLS ट्रांसपोर्ट सपोर्ट करता है
  2. सर्टिफ़िकेट की वैधता, एक्सपायरी डेट और ट्रस्ट चेन जांचें
  3. “Required” मीडिया एन्क्रिप्शन इस्तेमाल करने पर, सुनिश्चित करें कि आपका प्रोवाइडर SRTP मीडिया एन्क्रिप्शन सपोर्ट करता है
  4. एन्क्रिप्शन समस्याओं को अलग करने के लिए “Required” इस्तेमाल करने से पहले “Allowed” मीडिया एन्क्रिप्शन से टेस्ट करें
  5. TLS-विशिष्ट समस्याओं को अलग करने के लिए TCP ट्रांसपोर्ट आज़माएं (UDP सपोर्ट एक्सपेरिमेंटल है)
  6. TLS और SRTP सपोर्ट की पुष्टि करने के लिए अपने SIP ट्रंक प्रोवाइडर से संपर्क करें

अगर आपको कस्टम हेडर्स में समस्याएं आ रही हैं:

  1. अपने प्रोवाइडर के लिए ज़रूरी सटीक हेडर नाम और वैल्यू जांचें
  2. हेडर नामों में केस सेंसिटिविटी जांचें
  3. सुनिश्चित करें कि हेडर वैल्यू में ऐसे विशेष वर्ण नहीं हैं जिन्हें एस्केप करने की ज़रूरत हो
  4. पहले कस्टम हेडर्स के बिना टेस्ट करें, फिर उन्हें धीरे-धीरे जोड़ें
  5. इनबाउंड कस्टम हेडर डायनेमिक वेरिएबल्स के लिए, पुष्टि करें कि हेडर्स X- प्रीफ़िक्स इस्तेमाल करते हैं और बातचीत के इतिहास में Phone Call टैब देखें
  6. समर्थित कस्टम हेडर्स के लिए अपने प्रोवाइडर का दस्तावेज़ देखें

अगर कॉल कनेक्ट होती है, लेकिन ऑडियो नहीं है या सिर्फ़ एक दिशा में ऑडियो जाता है:

  1. पुष्टि करें कि आपका फ़ायरवॉल RTP मीडिया स्ट्रीम के लिए UDP ट्रैफ़िक की अनुमति देता है (आमतौर पर पोर्ट 10000-60000)
  2. RTP डायनेमिक IP पते इस्तेमाल करता है, इसलिए सुनिश्चित करें कि फ़ायरवॉल नियम सिर्फ़ खास स्टैटिक IP तक सीमित नहीं हैं
  3. नेटवर्क एड्रेस ट्रांसलेशन (NAT) से जुड़ी समस्याएं जांचें, जो RTP स्ट्रीम को ब्लॉक कर सकती हैं
  4. “Required” मीडिया एन्क्रिप्शन इस्तेमाल करने पर, सुनिश्चित करें कि दोनों एंडपॉइंट SRTP सपोर्ट करते हैं
  5. एन्क्रिप्शन से जुड़ी ऑडियो समस्याओं को अलग करने के लिए “Disabled” मीडिया एन्क्रिप्शन से टेस्ट करें

अगर आपको खराब ऑडियो क्वालिटी का अनुभव होता है:

  1. सुनिश्चित करें कि आपके नेटवर्क में पर्याप्त बैंडविड्थ (प्रति कॉल कम से कम 100 Kbps) और UDP ट्रैफ़िक के लिए कम लेटेंसी/जिटर है
  2. नेटवर्क कंजेशन या पैकेट लॉस जांचें, खासकर UDP पाथ पर
  3. पुष्टि करें कि दोनों सिरों पर कोडेक सेटिंग्स मेल खाती हैं
  4. मीडिया एन्क्रिप्शन इस्तेमाल करने पर, सुनिश्चित करें कि दोनों एंडपॉइंट SRTP प्रोसेसिंग को कुशलता से हैंडल करते हैं
  5. क्वालिटी संबंधी समस्याओं को अलग करने के लिए अलग-अलग मीडिया एन्क्रिप्शन सेटिंग्स से टेस्ट करें

BYE पर 481 रिस्पॉन्स का आमतौर पर मतलब है कि अनुरोध ऐसे SIP सर्वर तक पहुंचा है जिसके पास कॉल के लिए डायलॉग स्टेट नहीं है। ऐसा अक्सर तब होता है, जब शुरुआती TCP कनेक्शन पहले ही बंद हो गया हो और BYE को खास Contact URI के बजाय जनरिक साझा पते (उदाहरण के लिए sip.rtc.elevenlabs.io) पर फिर से भेजा जाता है, जो 200 OK रिस्पॉन्स में लौटाया गया था।

  1. BYE के लिए TCP कनेक्शन दोबारा स्थापित करते समय, हमेशा INVITE रिस्पॉन्स के Contact पते को टारगेट करें, ताकि अनुरोध उसी SIP सर्वर तक पहुंचे जिसने डायलॉग हैंडल किया था।
  2. साझा sip.rtc.elevenlabs.io पते पर BYE भेजने से बचें, क्योंकि अनुरोध किसी दूसरे SIP नोड पर पहुंच सकता है, जो इसे 481 के साथ अस्वीकार कर देगा।

Contact हेडर्स और डायलॉग रूटिंग को नियंत्रित करने वाले मानक व्यवहार के लिए RFC 3261 सेक्शन 8.1.1.8 देखें।

सीमाएं और ध्यान देने योग्य बातें

  • एक साथ कई कॉल का सपोर्ट आपके सब्सक्रिप्शन टियर पर निर्भर करता है। सीमा पूरी होने पर इनबाउंड कॉलर्स को अस्वीकार करने के बजाय होल्ड पर रखने के लिए कॉल क्यूइंग एनेबल करें
  • कॉल रिकॉर्डिंग और एनालिटिक्स सुविधाएं उपलब्ध हैं, लेकिन इनके लिए अतिरिक्त कॉन्फ़िगरेशन की ज़रूरत हो सकती है
  • आउटबाउंड कॉलिंग क्षमताएं आपके SIP ट्रंक प्रोवाइडर द्वारा सीमित हो सकती हैं
  • TLS सपोर्ट: एन्क्रिप्टेड ट्रांसपोर्ट के लिए सुनिश्चित करें कि आपका SIP ट्रंक प्रोवाइडर TLS 1.2 या इससे ऊपर का वर्ज़न सपोर्ट करता है
  • मीडिया एन्क्रिप्शन: SRTP सपोर्ट प्रोवाइडर के अनुसार अलग-अलग होता है; एन्क्रिप्शन ज़रूरी करने से पहले संगतता जांचें
  • ऑडियो फ़ॉर्मैट: ElevenLabs का SIP डिप्लॉयमेंट PCMU या PCMA (G.711, 8kHz) या G.722 (16kHz) कोडेक्स के ज़रिए ऑडियो आउटपुट और रिसीव करता है। यह सीधे websocket कनेक्शन के लिए एजेंट पर कॉन्फ़िगर किए गए किसी भी ऑडियो फ़ॉर्मैट से अलग है। आपके SIP ट्रंक सिस्टम को इनमें से किसी एक कोडेक को नेटिव रूप से सपोर्ट करना होगा या आपके सिस्टम की ज़रूरतों के अनुसार री-सैंपलिंग करनी होगी

अक्सर पूछे जाने वाले सवाल

हाँ, SIP ट्रंकिंग आपको अपने मौजूदा फ़ोन नंबरों को पोर्ट किए बिना सीधे ElevenLabs के ElevenAgents से कनेक्ट करने देती है।

ElevenLabs, Twilio, Vonage, RingCentral, Sinch, Infobip, Telnyx, Exotel, Plivo, Bandwidth और SIP प्रोटोकॉल मानकों का समर्थन करने वाले अन्य अधिकांश मानक SIP ट्रंक प्रोवाइडरों के साथ संगत है। बेहतर सुरक्षा के लिए TLS ट्रांसपोर्ट और SRTP मीडिया एन्क्रिप्शन समर्थित हैं।

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

  • TCP: विश्वसनीय, लेकिन अनएन्क्रिप्टेड सिग्नलिंग - TLS: एन्क्रिप्टेड और विश्वसनीय सिग्नलिंग (प्रोडक्शन के लिए सुझाया गया) - UDP: कनेक्शनलेस सिग्नलिंग, फ़िलहाल एक्सपेरिमेंटल

UDP ट्रांसपोर्ट एक्सपेरिमेंटल है और सिर्फ़ टेस्टिंग के लिए है। प्रोडक्शन और सुरक्षा-महत्वपूर्ण एप्लिकेशन के लिए हमेशा TLS ट्रांसपोर्ट इस्तेमाल करें।

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

एक साथ कॉल्स की संख्या आपके सब्सक्रिप्शन प्लान पर निर्भर करती है। एंटरप्राइज़ प्लान आम तौर पर ज़्यादा संख्या में एक साथ कॉल्स की अनुमति देते हैं। सीमा पूरी होने पर, इनबाउंड कॉलर्स को अस्वीकार कर दिया जाता है जब तक एजेंट के लिए कॉल क्यूइंग सक्षम न हो। ऐसे में उन्हें होल्ड ऑडियो के साथ रखा जाता है और क्षमता उपलब्ध होते ही कनेक्ट किया जाता है।

हाँ, आप अपने मौजूदा PBX सिस्टम के रूटिंग नियमों से कॉल्स को अलग-अलग फ़ोन नंबरों पर भेज सकते हैं, जिनमें से हर एक अलग ElevenLabs एजेंट से कनेक्ट होगा।

हाँ, आपके SIP URI और इंपोर्ट किए गए फ़ोन नंबर कॉन्फ़िगरेशन के बीच फ़ोन नंबर का फ़ॉर्मेट एक जैसा होना चाहिए। अगर आप शुरुआती + के साथ SIP URI पर कॉल करते हैं (जैसे, sip:+19991234567@sip.rtc.elevenlabs.io:5060), तो आपको फ़ोन नंबर भी शुरुआती + के साथ इंपोर्ट करना होगा (जैसे, +19991234567)। इसी तरह, अगर आप शुरुआती + के बिना कॉल करते हैं, तो फ़ोन नंबर को उसके बिना इंपोर्ट करें। फ़ॉर्मेट मेल न खाने पर कॉल रूटिंग ठीक से नहीं होगी।

हाँ, ElevenLabs RFC 3263 अनुरूप SIP सर्वर डिस्कवरी के लिए NAPTR और SRV रिकॉर्ड देता है।

अगले चरण