Twilio पर्सनलाइज़ेशन

वेबहुक का इस्तेमाल करके इनकमिंग Twilio कॉल्स के लिए पर्सनलाइज़ेशन कॉन्फ़िगर करें।

खास जानकारी

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

webhook कब ट्रिगर होता है और अनुरोध का स्वरूप जानने के लिए, बातचीत शुरू करने वाले webhooks देखें।

यह कैसे काम करता है

Twilio कॉल मिलने पर, ElevenAgents कॉल की जानकारी (caller_id, agent_id, called_number, call_sid, conversation_id) को आर्ग्युमेंट के रूप में भेजते हुए आपके बताए गए endpoint पर webhook कॉल करेगा
आपका webhook बातचीत शुरू करने का क्लाइंट डेटा लौटाता है, जिसमें डाइनैमिक वेरिएबल और overrides शामिल होते हैं (उदाहरण नीचे दिया गया है)
इस डेटा का इस्तेमाल बातचीत शुरू करने के लिए किया जाता है

सिस्टम webhook डेटा को समानांतर रूप से फ़ेच करने के लिए Twilio के कनेक्शन/डायलिंग समय का उपयोग करता है, जिससे सहज अनुभव मिलता है, जहाँ:

यूज़र्स को अपेक्षित टेलीफ़ोन कनेक्शन ध्वनि सुनाई देती है
समानांतर रूप से, ElevenAgents ज़रूरी webhook डेटा फ़ेच करता है
ऑडियो कनेक्शन स्थापित होते-होते फ़ेच किए गए डेटा के साथ बातचीत शुरू हो जाती है

कॉन्फ़िगरेशन

webhook की जानकारी कॉन्फ़िगर करें

ElevenAgents के सेटिंग्स पेज में webhook URL कॉन्फ़िगर करें और authentication के लिए ज़रूरी secrets जोड़ें।

headers में कौन से secrets भेजे जाएँ, इसे बदलने के लिए webhook पर क्लिक करें।

बातचीत शुरू करने का डेटा फ़ेच करना सक्षम करें

एजेंट के पेज के “Security” टैब में, इनबाउंड Twilio कॉल के लिए बातचीत शुरू करने का डेटा फ़ेच करना सक्षम करें और उन फ़ील्ड को तय करें जिन्हें override किया जा सकता है।

Twilio डेटा पाने के लिए webhook endpoint लागू करें

webhook को इन पैरामीटर के साथ POST अनुरोध मिलेगा:

पैरामीटर	प्रकार	विवरण
`caller_id`	string	कॉलर का फ़ोन नंबर
`agent_id`	string	कॉल पाने वाले एजेंट की ID
`called_number`	string	जिस Twilio नंबर पर कॉल किया गया
`call_sid`	string	Twilio कॉल का यूनीक आइडेंटिफ़ायर
`conversation_id`	string	ElevenLabs बातचीत आइडेंटिफ़ायर

बातचीत शुरू करने का क्लाइंट डेटा लौटाएँ

आपके webhook को एजेंट के लिए initiation डेटा वाली JSON प्रतिक्रिया लौटानी होगी।

dynamic_variables फ़ील्ड में एजेंट के लिए तय किए गए सभी डाइनैमिक वेरिएबल होने चाहिए। दूसरी ओर, overrides पूरी तरह वैकल्पिक हैं। डाइनैमिक वेरिएबल और overrides की अधिक जानकारी के लिए डाइनैमिक वेरिएबल और overrides दस्तावेज़ देखें।

एक उदाहरण प्रतिक्रिया यह हो सकती है:

{
  "type": "conversation_initiation_client_data",
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "prompt": "The customer's bank account balance is $100. They are based in San Francisco.",
        "llm": "gpt-5.6-luna"
      },
      "first_message": "Hi, how can I help you today?",
      "language": "en"
    },
    "tts": {
      "voice_id": "new-voice-id"
    },
    "conversation": {
      "text_only": false
    }
  },
  "dynamic_variables": {
    "customer_name": "John Doe",
    "account_status": "premium",
    "last_interaction": "2026-01-15"
  },
  "branch_id": "agtbrch_xxxx",
  "environment": "production"
}

ElevenAgents बातचीत शुरू करने के डेटा को भरने के लिए डाइनैमिक वेरिएबल का इस्तेमाल करेगा, और बातचीत आसानी से शुरू हो जाएगी।

कॉल हैंडलिंग में देरी से बचने के लिए, सुनिश्चित करें कि आपका webhook उचित timeout अवधि के भीतर जवाब दे।

सुरक्षा

केवल HTTPS endpoints का उपयोग करें
request headers का उपयोग करके authentication लागू करें
संवेदनशील वैल्यू को ElevenLabs secrets manager के ज़रिए secrets के रूप में स्टोर करें
आने वाले अनुरोध के पैरामीटर को वैलिडेट करें