Open in
Повежите из Twilio
Усмерите Twilio позиве ка ThunderPhone агенту преко SIP-а помоћу CallSid-а и вратите их преко свог referUrl-а, уз прослеђивање у адреси за трансфер.
Ваш TwiML позива SIP адресу агента са CallSid позива у заглављу.
Када је позиваоцу потребна особа, агент шаље 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 не документује сопствено заглавље ИД-а позива, зато додајте ово: ThunderPhone га чува каоexternal_call_idпозива.{{CallSid}}функционише у TwiML Bin-у; са сопственог сервера упишитеCallSidдолазног захтева.- Додајте још контекста на исти начин, као што је
&X-Account-Id=12345. Унутар TwiML-а пишите&као&, јер је самостални&неважећи XML. Сваки параметар стиже у промпт као променљива, овде{{sip_x_account_id}}. Twilio дозвољаваx-заглавља иUser-to-User, са процентуалним кодирањем, при чему цео URI има мање од 255 знакова, а заглавља мање од 1,024. referUrlомогућава Twilio-у да прихватиREFERагента; без њега пренос не успева са грешком 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 функција ставља позиваоца у Flex ред са предајом као атрибутима
задатка и проналази сажетак по ИД-у предаје. Претрага се извршава у
функцији јер 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 кључ у променљивим окружења функције. Погледајте Проналажење предатог позива за остала поља.
Тестирајте
Позовите Twilio број који враћа горњи TwiML, затражите од агента да Вас повеже
са особом и проверите да ли Ваш referUrl обрађивач прима
ReferTransferTarget са оба заглавља и да ли позивалац стиже у ред. Затим
отворите позив помоћу GET /v1/calls/{call_id}: external_call_id треба да
буде CallSid.
Ограничења
- Twilio ограничава
Refer-Toна 256 знакова. ThunderPhone задржава адресу на 254 знака и изоставља заглавље које не може да стане, па имена и вредности заглавља нека буду кратки. - Twilio не документује читање заглавља у захтеву
BYE, па повратни позив не може да пренесе предају назад у Twilio. КориститеREFERкао горе. - Twilio не прихвата
REFERу позиву повезаном преко<Conference>или<Queue>, па позовите агента помоћу<Dial><Sip>као горе.