Open in
Twilio वरून कनेक्ट करा
CallSid सह SIP द्वारे Twilio कॉल ThunderPhone एजंटकडे पाठवा आणि ट्रान्सफर पत्त्यातील हँड-ऑफसह तुमच्या referUrl द्वारे ते परत घ्या.
तुमचे TwiML कॉलच्या CallSid सह हेडरमध्ये एजंटचा SIP पत्ता डायल करते.
कॉल करणाऱ्याला एखादी व्यक्ती हवी असल्यास, एजंट SIP REFER पाठवतो, Twilio
त्यामधील हस्तांतरण पत्त्यासह तुमच्या referUrl हँडलरकडे पाठवते आणि तुमचा हँडलर
परत करत असलेले TwiML कॉल करणारा कुठे जाईल हे ठरवते, उदाहरणार्थ Flex रांगेत.
सुरू करण्यापूर्वी
- एक ThunderPhone एजंट आणि एक संस्था API की.
- Twilio Programmable Voice आणि TwiML व
referUrlहँडलर उपलब्ध करून देण्यासाठी एखादे ठिकाण: तुमचा स्वतःचा सर्व्हर किंवा TwiML Bin आणि Twilio Function. Flex ऐच्छिक आहे.
1. SIP एंडपॉइंट तयार करा
Twilio च्या <Sip> ला वापरकर्तानाव आणि पासवर्ड लागतो, त्यामुळे मानक एंडपॉइंट वापरा:
curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"agent_id": 12, "name": "Twilio"}'प्रतिसादातील password लगेच साठवा; तो एकदाच दाखवला जातो. फक्त
Twilio कडून कॉल स्वीकारण्यासाठी, हे देखील पहा:
स्रोत IP प्रतिबंधित करा.
2. संदर्भासह कॉल पाठवा
एजंटकडे सोपवायच्या कॉलसाठी हे TwiML परत करा:
<Response>
<Dial answerOnBridge="true" referUrl="https://YOUR_SERVER/thunderphone-refer">
<Sip username="tp409667538f83" password="YOUR_ENDPOINT_PASSWORD">sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls?X-Call-ID={{CallSid}}</Sip>
</Dial>
</Response>;transport=tlsमहत्त्वाचे आहे: वेगळे सांगितले नाही तर Twilio UDP वापरते.X-Call-IDमध्येCallSidअसते. Twilio स्वतःच्या call-id हेडरचे दस्तऐवजीकरण करत नाही, त्यामुळे हा जोडा: ThunderPhone तो कॉलचाexternal_call_idम्हणून साठवते.{{CallSid}}TwiML Bin मध्ये कार्य करते; तुमच्या स्वतःच्या सर्व्हरवरून येणाऱ्या विनंतीचेCallSidलिहा.- याच प्रकारे अधिक संदर्भ जोडा, जसे
&X-Account-Id=12345. TwiML मध्ये&ऐवजी&लिहा, कारण स्वतंत्र&अवैध XML आहे. प्रत्येक मूल्य prompt पर्यंत व्हेरिएबल म्हणून पोहोचते, येथे{{sip_x_account_id}}. Twiliox-हेडर आणिUser-to-Userला अनुमती देते, टक्केवारी-एन्कोड केलेले, ज्यामध्ये संपूर्ण URI 255 वर्णांखाली आणि हेडर 1,024 वर्णांखाली असतात. referUrlमुळे Twilio एजंटचाREFERस्वीकारू शकते; त्याशिवाय हस्तांतरण त्रुटी 13802 सह अयशस्वी होते.answerOnBridge="true"नवीन गंतव्य प्रतिसाद देईपर्यंत कॉल करणाऱ्याला जोडलेले ठेवते, त्यामुळे अयशस्वी हस्तांतरणासाठी पर्यायी मार्ग वापरता येतो.
Studio मधील कॉल यांना जोडा विजेट सानुकूल हेडर किंवा
referUrl चे दस्तऐवजीकरण करत नाही, त्यामुळे Studio मधून कॉल या TwiML कडे
सोपवा, उदाहरणार्थ TwiML पुनर्निर्देशन विजेट वापरून.
3. कॉल परत मिळवा
एजंट REFER वापरून कॉल हस्तांतरित करतो, ज्याच्या हस्तांतरण पत्त्यात हस्तांतरण
id आणि हेतू असतो. हा हस्तांतरण क्रमांक जोडा (पहा
हस्तांतरण क्रमांक जोडा
आणि हस्तांतरण पत्त्यातील हेडर्स):
{
"name": "Twilio support",
"number": "sip:support@acme.sip.twilio.com",
"headers": {"X-Handoff-Id": "{{handoff_id}}", "X-Handoff-Intent": "{{handoff_intent}}"},
"headers_in_uri": true
}Twilio संपूर्ण पत्ता तुमच्या referUrl कडे ReferTransferTarget म्हणून पाठवते, उदाहरणार्थ
<sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>.
तुमचा हँडलर त्यातून हेडर्स वाचतो आणि कॉलर पुढे कुठे जाईल त्यासाठीचे TwiML
परत करतो. पत्त्याचा वापरकर्ता भाग (support) तुम्ही निवडू शकता, त्यामुळे तुम्ही
प्रत्येक गंतव्यस्थानासाठी एक हस्तांतरण क्रमांक जोडू शकता आणि त्यानुसार रूट करू शकता.
हे Twilio Function हस्तांतरणाला टास्क अॅट्रिब्यूट्स म्हणून वापरून कॉलरला Flex मध्ये
रांगेत ठेवते आणि हस्तांतरण id वापरून सारांश शोधते. हे शोधणे Function मध्ये चालते,
कारण Studio चे HTTP Request विजेट Authorization हेडर पाठवू शकत नाही:
exports.handler = async (context, event, callback) => {
const target = (event.ReferTransferTarget || "").replace(/^<|>$/g, "");
const params = new URLSearchParams(target.split("?")[1] || "");
const handoffId = params.get("X-Handoff-Id") || "";
const attributes = { handoff_id: handoffId, intent: params.get("X-Handoff-Intent") || "" };
if (handoffId) {
const response = await fetch(
"https://api.thunderphone.com/v1/calls/handoff?handoff_id=" + encodeURIComponent(handoffId),
{ headers: { Authorization: "Bearer " + context.THUNDERPHONE_API_KEY } }
);
if (response.ok) {
const call = await response.json();
attributes.summary = (call.handoff && call.handoff.summary) || "";
}
}
const twiml = new Twilio.twiml.VoiceResponse();
twiml.enqueue({ workflowSid: context.FLEX_WORKFLOW_SID }).task({}, JSON.stringify(attributes));
callback(null, twiml);
};API की Function च्या एन्व्हायर्नमेंट व्हेरिएबल्समध्ये ठेवा. इतर फील्डसाठी हस्तांतरित केलेला कॉल शोधा पहा.
चाचणी करा
वरील TwiML परत करणाऱ्या Twilio क्रमांकावर कॉल करा, एजंटकडे एखाद्या व्यक्तीशी
बोलण्याची विनंती करा आणि तुमच्या referUrl हँडलरला दोन्ही हेडर्ससह
ReferTransferTarget मिळते व कॉलर रांगेत पोहोचतो याची खात्री करा. नंतर
GET /v1/calls/{call_id} वापरून कॉल तपासा: external_call_id हे CallSid असावे.
मर्यादा
- Twilio
Refer-Toला 256 वर्णांची मर्यादा घालते. ThunderPhone पत्ता 254 वर्णांपर्यंत ठेवते आणि न बसणारा हेडर वगळते, त्यामुळे हेडरची नावे आणि मूल्ये लहान ठेवा. - Twilio
BYEवरील हेडर्स वाचण्याचे दस्तऐवजीकरण करत नाही, त्यामुळे परतीच्या कॉलसह हस्तांतरणाची माहिती Twilio कडे परत पाठवता येत नाही. वरीलप्रमाणेREFERवापरा. <Conference>किंवा<Queue>द्वारे जोडलेल्या कॉलवर TwilioREFERस्वीकारत नाही, त्यामुळे वरीलप्रमाणे<Dial><Sip>वापरून एजंटला डायल करा.