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 తన సొంత call-id హెడర్ను డాక్యుమెంట్ చేయలేదు, కాబట్టి దీన్ని జోడించండి: ThunderPhone దీన్ని కాల్ యొక్కexternal_call_idగా నిల్వ చేస్తుంది.{{CallSid}}TwiML Binలో పనిచేస్తుంది; మీ స్వంత సర్వర్ నుండి అయితే, ఇన్కమింగ్ అభ్యర్థనలోనిCallSidను వ్రాయండి.- అదే విధంగా మరింత సందర్భాన్ని జోడించండి, ఉదాహరణకు
&X-Account-Id=12345. TwiMLలో,&ను&గా వ్రాయండి, ఎందుకంటే సాధారణ&చెల్లుబాటు కాని XML. ప్రతి ఒక్కటి promptకు వేరియబుల్గా చేరుతుంది, ఇక్కడ{{sip_x_account_id}}. Twiliox-హెడర్లు మరియు percent-encodedUser-to-Userను అనుమతిస్తుంది; మొత్తం URI 255 అక్షరాల కంటే తక్కువగా, హెడర్లు 1,024 కంటే తక్కువగా ఉండాలి. referUrlTwilioకు ఏజెంట్ యొక్కREFERను అంగీకరించడానికి అనుమతిస్తుంది; అది లేకుండా బదిలీ లోపం 13802తో విఫలమవుతుంది.answerOnBridge="true"కొత్త గమ్యస్థానం సమాధానం ఇచ్చే వరకు కాలర్ను కనెక్ట్గా ఉంచుతుంది, కాబట్టి విఫలమైన బదిలీకి ప్రత్యామ్నాయ మార్గం ఉపయోగించవచ్చు.
Studio యొక్క కాల్ను దీనికి కనెక్ట్ చేయండి విడ్జెట్ కస్టమ్ హెడర్లు లేదా referUrlను డాక్యుమెంట్ చేయదు, కాబట్టి Studio నుండి కాల్ను ఈ TwiMLకు అప్పగించండి, ఉదాహరణకు TwiML దారిమార్పు విడ్జెట్తో.
3. కాల్ను తిరిగి పొందండి
హ్యాండ్-ఆఫ్ id మరియు intentను కలిగిన బదిలీ చిరునామాతో ఏజెంట్ 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 ఫంక్షన్ హ్యాండ్-ఆఫ్ను టాస్క్ లక్షణాలుగా ఉంచి కాలర్ను Flex క్యూలో ఉంచుతుంది మరియు హ్యాండ్-ఆఫ్ id ద్వారా సారాంశాన్ని వెతుకుతుంది. 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 కీని ఫంక్షన్ ఎన్విరాన్మెంట్ వేరియబుల్లలో ఉంచండి. ఇతర ఫీల్డ్ల కోసం హ్యాండ్-ఆఫ్ చేసిన కాల్ను వెతకండి చూడండి.
దీన్ని పరీక్షించండి
పైన ఉన్న TwiMLను తిరిగి ఇచ్చే Twilio నంబర్కు కాల్ చేయండి, ఒక వ్యక్తితో మాట్లాడాలని ఏజెంట్ను అడగండి, ఆపై మీ referUrl హ్యాండ్లర్ రెండు హెడర్లతో కూడిన ReferTransferTargetను స్వీకరిస్తోందని మరియు కాలర్ క్యూ చేరుకుంటోందని నిర్ధారించండి. తర్వాత GET /v1/calls/{call_id}తో కాల్ను తెరవండి: external_call_id అనేది CallSid అయి ఉండాలి.
పరిమితులు
- Twilio
Refer-Toను 256 అక్షరాలకు పరిమితం చేస్తుంది. ThunderPhone చిరునామాను 254 అక్షరాలకు పరిమితం చేసి, సరిపోని హెడర్ను వదిలివేస్తుంది; కాబట్టి హెడర్ పేర్లు మరియు విలువలను సంక్షిప్తంగా ఉంచండి. BYEలో హెడర్లను చదవడాన్ని Twilio డాక్యుమెంట్ చేయలేదు, కాబట్టి రిటర్న్ హ్యాండ్-ఆఫ్ను తిరిగి Twilioకి తీసుకెళ్లలేదు. పైన చూపినట్లుగాREFERను ఉపయోగించండి.<Conference>లేదా<Queue>ద్వారా కనెక్ట్ చేసిన కాల్లో TwilioREFERను అంగీకరించదు, కాబట్టి పైన చూపినట్లుగా<Dial><Sip>తో ఏజెంట్కు డయల్ చేయండి.