Open in
Twilio ನಿಂದ ಸಂಪರ್ಕಿಸಿ
CallSid ಬಳಸಿ Twilio ಕರೆಗಳನ್ನು SIP ಮೂಲಕ 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-IDCallSidಅನ್ನು ಸಾಗಿಸುತ್ತದೆ. Twilio ತನ್ನದೇ ಆದ ಕಾಲ್-ಐಡಿ ಹೆಡರ್ ಅನ್ನು ದಾಖಲಿಸುವುದಿಲ್ಲ, ಆದ್ದರಿಂದ ಇದನ್ನು ಸೇರಿಸಿ: ThunderPhone ಇದನ್ನು ಕರೆಯexternal_call_idಆಗಿ ಸಂಗ್ರಹಿಸುತ್ತದೆ.{{CallSid}}TwiML Bin ನಲ್ಲಿ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತದೆ; ನಿಮ್ಮ ಸ್ವಂತ ಸರ್ವರ್ನಿಂದ, ಒಳಬರುವ ವಿನಂತಿಯCallSidಅನ್ನು ಬರೆಯಿರಿ.&X-Account-Id=12345ನಂತಹ ಹೆಚ್ಚಿನ ಸಂದರ್ಭವನ್ನು ಇದೇ ರೀತಿಯಲ್ಲಿ ಸೇರಿಸಿ. TwiML ಒಳಗೆ,&ಬದಲಿಗೆ&ಎಂದು ಬರೆಯಿರಿ, ಏಕೆಂದರೆ ಸರಳ&ಅಮಾನ್ಯ XML ಆಗಿದೆ. ಪ್ರತಿಯೊಂದೂ ಪ್ರಾಂಪ್ಟ್ಗೆ ಚರವಾಗಿ ತಲುಪುತ್ತದೆ, ಇಲ್ಲಿ{{sip_x_account_id}}. Twiliox-ಹೆಡರ್ಗಳು ಮತ್ತುUser-to-Userಅನ್ನು ಅನುಮತಿಸುತ್ತದೆ, ಶೇಕಡಾ-ಎನ್ಕೋಡ್ ರೂಪದಲ್ಲಿ, ಸಂಪೂರ್ಣ URI 255 ಅಕ್ಷರಗಳಿಗಿಂತ ಕಡಿಮೆ ಮತ್ತು ಹೆಡರ್ಗಳು 1,024 ಕ್ಕಿಂತ ಕಡಿಮೆ ಇರಬೇಕು.referUrlಏಜೆಂಟ್ನREFERಅನ್ನು Twilio ಸ್ವೀಕರಿಸಲು ಅನುಮತಿಸುತ್ತದೆ; ಅದು ಇಲ್ಲದೆ ವರ್ಗಾವಣೆ ದೋಷ 13802 ನೊಂದಿಗೆ ವಿಫಲವಾಗುತ್ತದೆ.answerOnBridge="true"ಹೊಸ ಗಮ್ಯಸ್ಥಾನವು ಉತ್ತರಿಸುವವರೆಗೆ ಕರೆ ಮಾಡುವವರನ್ನು ಸಂಪರ್ಕದಲ್ಲೇ ಇರಿಸುತ್ತದೆ, ಆದ್ದರಿಂದ ವಿಫಲವಾದ ವರ್ಗಾವಣೆಗೆ ಹಿಮ್ಮುಖ ಆಯ್ಕೆ ಇರಬಹುದು.
Studio ದ ಕರೆಗೆ ಸಂಪರ್ಕಿಸಿ ವಿಜೆಟ್ ಕಸ್ಟಮ್ ಹೆಡರ್ಗಳು ಅಥವಾ referUrl ಅನ್ನು ದಾಖಲಿಸುವುದಿಲ್ಲ, ಆದ್ದರಿಂದ Studio ನಿಂದ ಕರೆಯನ್ನು ಈ TwiML ಗೆ ಹಸ್ತಾಂತರಿಸಿ, ಉದಾಹರಣೆಗೆ TwiML ಮರುನಿರ್ದೇಶನ ವಿಜೆಟ್ನೊಂದಿಗೆ.
3. ಕರೆಯನ್ನು ಮರಳಿ ಪಡೆಯಿರಿ
ಏಜೆಂಟ್ REFER ಮೂಲಕ ವರ್ಗಾಯಿಸುತ್ತದೆ, ಇದರ ವರ್ಗಾವಣೆ ವಿಳಾಸವು ಹ್ಯಾಂಡ್-ಆಫ್
ಐಡಿ ಮತ್ತು ಉದ್ದೇಶವನ್ನು ಒಳಗೊಂಡಿರುತ್ತದೆ. ಈ ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಯನ್ನು ಸೇರಿಸಿ (ನೋಡಿ
ವರ್ಗಾವಣೆ ಸಂಖ್ಯೆಯನ್ನು ಸೇರಿಸಿ
ಮತ್ತು ವರ್ಗಾವಣೆ ವಿಳಾಸದೊಳಗಿನ ಹೆಡರ್ಗಳು):
{
"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 ಗೆ ಕ್ಯೂ ಮಾಡುತ್ತದೆ ಮತ್ತು ಹ್ಯಾಂಡ್-ಆಫ್ ಐಡಿ ಮೂಲಕ
ಸಾರಾಂಶವನ್ನು ಹುಡುಕುತ್ತದೆ. Studio ನ HTTP Request ವಿಜೆಟ್ Authorization
ಹೆಡರ್ ಅನ್ನು ಕಳುಹಿಸಲು ಸಾಧ್ಯವಿಲ್ಲದ ಕಾರಣ ಹುಡುಕಾಟವು Function ನಲ್ಲಿ ನಡೆಯುತ್ತದೆ:
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ಬಳಸಿ. - Twilio
<Conference>ಅಥವಾ<Queue>ಮೂಲಕ ಸಂಪರ್ಕಗೊಂಡ ಕರೆಯಲ್ಲಿREFERಅನ್ನು ಸ್ವೀಕರಿಸುವುದಿಲ್ಲ, ಆದ್ದರಿಂದ ಮೇಲಿನಂತೆ<Dial><Sip>ಬಳಸಿ ಏಜೆಂಟ್ಗೆ ಡಯಲ್ ಮಾಡಿ.