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-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, ഏജന്റിന്റെREFERTwilioയ്ക്ക് സ്വീകരിക്കാൻ അനുവദിക്കുന്നു; ഇത് ഇല്ലെങ്കിൽ ട്രാൻസ്ഫർ പിശക് 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 മുഴുവൻ വിലാസവും ReferTransferTarget ആയി നിങ്ങളുടെ referUrl-ലേക്ക് അയയ്ക്കുന്നു, ഉദാഹരണത്തിന് <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 നമ്പറിലേക്ക് വിളിക്കുക, ഒരു വ്യക്തിയിലേക്ക് ബന്ധിപ്പിക്കാൻ ഏജന്റിനോട് ആവശ്യപ്പെടുക,
തുടർന്ന് രണ്ട് ഹെഡറുകളോടുകൂടിയ ReferTransferTarget നിങ്ങളുടെ referUrl ഹാൻഡ്ലറിന് ലഭിക്കുന്നുണ്ടെന്നും വിളിക്കുന്നയാൾ ക്യൂവിലെത്തുന്നുണ്ടെന്നും പരിശോധിക്കുക. തുടർന്ന്
GET /v1/calls/{call_id} ഉപയോഗിച്ച് കോൾ തുറക്കുക: external_call_id, CallSid ആയിരിക്കണം.
പരിധികൾ
- Twilio,
Refer-To256 അക്ഷരങ്ങളായി പരിമിതപ്പെടുത്തുന്നു. ThunderPhone വിലാസം 254 അക്ഷരങ്ങളായി നിലനിർത്തുകയും ഉൾക്കൊള്ളാത്ത ഒരു ഹെഡർ ഒഴിവാക്കുകയും ചെയ്യുന്നു; അതിനാൽ ഹെഡർ പേരുകളും മൂല്യങ്ങളും ചെറുതാക്കി സൂക്ഷിക്കുക. BYE-യിലെ ഹെഡറുകൾ വായിക്കുന്നതിനെക്കുറിച്ച് Twilio രേഖപ്പെടുത്തുന്നില്ല, അതിനാൽ ഒരു റിട്ടേണിന് ഹാൻഡ്-ഓഫ് Twilio-യിലേക്ക് തിരികെ കൊണ്ടുപോകാൻ കഴിയില്ല. മുകളിൽ പറഞ്ഞതുപോലെREFERഉപയോഗിക്കുക.<Conference>അല്ലെങ്കിൽ<Queue>വഴി ബന്ധിപ്പിച്ച കോളിൽ Twilio ഒരുREFERസ്വീകരിക്കുന്നില്ല, അതിനാൽ മുകളിൽ പറഞ്ഞതുപോലെ<Dial><Sip>ഉപയോഗിച്ച് ഏജന്റിലേക്ക് ഡയൽ ചെയ്യുക.