Open in
Unganisha kutoka Twilio
Tuma simu za Twilio kwa ejenti wa ThunderPhone kupitia SIP ukitumia CallSid, kisha uzirudishe kupitia referUrl yako huku uhamisho ukiwa katika anwani ya transfer.
TwiML yako hupiga anwani ya SIP ya ejenti ikiwa na CallSid ya simu katika kichwa.
Mpigaji anapohitaji mtu, ejenti hutuma SIP REFER, Twilio hutuma anwani ya
uhamisho yenye makabidhiano ndani yake kwa kishughulikiaji chako cha referUrl, na
TwiML inayorejeshwa na kishughulikiaji chako huamua mpigaji aende wapi, kama vile kwenye foleni ya Flex.
Kabla ya kuanza
- Ejenti wa ThunderPhone na ufunguo wa API wa shirika.
- Twilio Programmable Voice, na mahali pa kutoa TwiML pamoja na kishughulikiaji
cha
referUrl: seva yako mwenyewe, au TwiML Bin na Twilio Function. Flex si lazima.
1. Unda kituo cha SIP
<Sip> ya Twilio hupokea jina la mtumiaji na nenosiri, kwa hivyo tumia kituo cha kawaida:
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"}'Hifadhi password kutoka kwenye jibu mara moja; huonyeshwa mara moja tu. Ili
kukubali simu kutoka Twilio pekee pia, tazama
Zuia anwani za IP za chanzo.
2. Tuma simu zikiwa na muktadha
Rejesha TwiML hii kwa simu unayotaka kukabidhi kwa ejenti:
<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=tlsni muhimu: Twilio hutumia UDP isipoiagizwa vinginevyo.X-Call-IDhubebaCallSid. Twilio haijaeleza kichwa chake cha call-id, kwa hivyo ongeza hiki: ThunderPhone huihifadhi kamaexternal_call_idya simu.{{CallSid}}hufanya kazi katika TwiML Bin; kutoka seva yako mwenyewe, andikaCallSidya ombi linaloingia.- Ongeza muktadha zaidi kwa njia hiyo hiyo, kama vile
&X-Account-Id=12345. Ndani ya TwiML, andika&kama&, kwa kuwa&isiyo na kinga si XML halali. Kila moja hufika kwenye prompt kama kigeu, hapa{{sip_x_account_id}}. Twilio inaruhusu vichwa vyax-naUser-to-User, vilivyosimbwa kwa asilimia, huku URI nzima ikiwa chini ya vibambo 255 na vichwa vikiwa chini ya 1,024. referUrlhuiruhusu Twilio kukubaliREFERya ejenti; bila hiyo uhamisho hushindwa kwa hitilafu 13802.answerOnBridge="true"humweka mpigaji ameunganishwa hadi anwani mpya ijibu, hivyo uhamisho unaposhindwa unaweza kutumia njia mbadala.
Wijeti ya Studio ya Unganisha Simu Kwa haielezi vichwa maalum au
referUrl, kwa hivyo kutoka Studio kabidhi simu kwa TwiML hii, kwa mfano kwa
kutumia wijeti ya Uelekezaji Upya wa TwiML.
3. Pokea simu tena
Ejenti huhamisha kwa REFER ambayo anwani yake ya uhamishaji hubeba kitambulisho
na nia ya hand-off. Ongeza nambari hii ya uhamishaji (tazama
Ongeza nambari ya uhamishaji
na Vichwa ndani ya anwani ya uhamishaji):
{
"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 hutuma anwani nzima kwenye referUrl yako kama ReferTransferTarget, kwa
mfano <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>.
Kishughulikiaji chako husoma vichwa kutoka humo na kurejesha TwiML ya mahali
mpigaji simu anaelekezwa baadaye. Sehemu ya mtumiaji ya anwani (support) ni
yako kuchagua, hivyo unaweza kuongeza nambari moja ya uhamishaji kwa kila
lengwa na kuelekeza kwa kuitumia.
Twilio Function hii huweka mpigaji simu kwenye foleni ya Flex huku hand-off
ikiwa sifa za jukumu na hutafuta muhtasari kwa kitambulisho cha hand-off. Utafutaji
huendeshwa katika Function kwa sababu wijeti ya HTTP Request ya Studio haiwezi
kutuma kichwa cha 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);
};Hifadhi ufunguo wa API katika vigeu vya mazingira vya Function. Tazama Tafuta simu iliyofanyiwa hand-off kwa sehemu nyingine.
Ijaribu
Piga nambari ya Twilio inayorejesha TwiML iliyo hapo juu, mwombe ejenti akuunganishe
na mtu, na uthibitishe kwamba kishughulikiaji chako cha referUrl kinapokea
ReferTransferTarget yenye vichwa vyote viwili na kwamba mpigaji simu anafika
kwenye foleni. Kisha fungua simu kwa
GET /v1/calls/{call_id}: external_call_id inapaswa kuwa CallSid.
Vikomo
- Twilio huweka kikomo cha
Refer-Tokuwa herufi 256. ThunderPhone huweka anwani kuwa 254 na huacha kichwa kisichotoshea, hivyo fanya majina na thamani za vichwa ziwe fupi. - Twilio haiandiki kuhusu kusoma vichwa kwenye
BYE, hivyo urejeshaji hauwezi kubeba hand-off kurudi Twilio. TumiaREFERkama ilivyo hapo juu. - Twilio haikubali
REFERkwenye simu iliyounganishwa kupitia<Conference>au<Queue>, hivyo piga ejenti kwa<Dial><Sip>kama ilivyo hapo juu.