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 крайна точка
<Sip> на Twilio приема потребителско име и парола, затова използвайте стандартна крайна точка:
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 Function поставя обаждащия се на опашка към Flex с предаването като
атрибути на задачата и намира обобщението по идентификатор на предаването.
Търсенето се изпълнява във Function, защото уиджетът HTTP Request на Studio не
може да изпраща заглавката 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 ключа в променливите на средата на Function. Вижте Намиране на предадено обаждане за останалите полета.
Тествайте
Обадете се на 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>, както е описано по-горе.