नेविगेशन पर जाएँ
डिप्लॉय करेंटेलीफोनी

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 रिक्वेस्ट का सर्टिफ़िकेट वैलिडेशन विफल हो जाए, तो फोन नंबर सेटिंग्स के Remote domains फ़ील्ड में वह FQDN जोड़ें जिसके लिए आपके SIP सर्वर का सर्टिफ़िकेट जारी किया गया है।

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 डैशबोर्ड में Phone Numbers सेक्शन पर जाएँ।

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 एड्रेस को allowlist करना होगा।

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

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

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

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

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

एड्रेस फ़ील्ड बताता है कि 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 डैशबोर्ड में Phone Numbers सेक्शन पर जाएँ
  2. अपना इंपोर्ट किया हुआ SIP ट्रंक फोन नंबर चुनें
  3. “Assign Agent” पर क्लिक करें
  4. वह एजेंट चुनें जिसे इस नंबर पर आने वाली कॉल हैंडल करनी हैं

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

अगर आपको कनेक्शन से जुड़ी समस्याएं आ रही हैं:

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

नेटवर्क आर्किटेक्चर की महत्वपूर्ण जानकारी:

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

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

  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- प्रीफ़िक्स है और कन्वर्सेशन हिस्ट्री में फ़ोन कॉल टैब देखें
  6. समर्थित कस्टम हेडर्स के लिए अपने प्रोवाइडर का डॉक्यूमेंटेशन देखें

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

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

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

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

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

  1. BYE के लिए TCP कनेक्शन दोबारा स्थापित करते समय, हमेशा INVITE रिस्पॉन्स के Contact पते को टारगेट करें, ताकि रिक्वेस्ट उसी SIP सर्वर तक पहुंचे जिसने डायलॉग संभाला था।
  2. BYE को साझा sip.rtc.elevenlabs.io पते पर भेजने से बचें, क्योंकि रिक्वेस्ट किसी दूसरे 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 ज़्यादातर स्टैंडर्ड SIP ट्रंक प्रोवाइडर्स के साथ कम्पैटिबल है, जिनमें Twilio, Vonage, Sinch, Infobip, Telnyx, Exotel, Plivo, Bandwidth और SIP प्रोटोकॉल स्टैंडर्ड्स सपोर्ट करने वाले अन्य प्रोवाइडर शामिल हैं। बेहतर सुरक्षा के लिए TLS ट्रांसपोर्ट और SRTP मीडिया एन्क्रिप्शन सपोर्ट किए जाते हैं।

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

  • 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 रिकॉर्ड देता है।

अगले चरण