Open in
Povežite iz Twilio
Klice Twilio pošljite glasovnemu agentu ThunderPhone prek SIP z CallSid in jih prek svojega referUrl prejmite nazaj s predajo v naslovu za prenos.
Vaš TwiML pokliče SIP-naslov agenta s klicevim CallSid v glavi.
Ko klicatelj potrebuje osebo, agent pošlje SIP REFER, Twilio posreduje
naslov za prenos s predajo v vaš obdelovalnik referUrl, TwiML, ki ga vrne vaš
obdelovalnik, pa določi, kam je klicatelj usmerjen, na primer v čakalno vrsto Flex.
Preden začnete
- Agent ThunderPhone in ključ API organizacije.
- Twilio Programmable Voice ter mesto za streženje TwiML in obdelovalnika
referUrl: lasten strežnik ali TwiML Bin in Twilio Function. Flex ni obvezen.
1. Ustvarite končno točko SIP
Twiliev <Sip> sprejme uporabniško ime in geslo, zato uporabite standardno končno točko:
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"}'Geslo password iz odgovora takoj shranite; prikazano je samo enkrat. Če želite
sprejemati klice tudi samo od Twilia, glejte
Omejitev izvornih naslovov IP.
2. Pošljite klice s kontekstom
Za klic, ki ga želite predati agentu, vrnite ta 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=tlsje pomemben: Twilio uporablja UDP, če mu ne naročite drugače.X-Call-IDvsebujeCallSid. Twilio ne dokumentira lastne glave za ID klica, zato dodajte to: ThunderPhone jo shrani kot klicevexternal_call_id.{{CallSid}}deluje v TwiML Bin; z lastnega strežnika zapišiteCallSiddohodne zahteve.- Na enak način dodajte več konteksta, na primer
&X-Account-Id=12345. V TwiML zapišite&kot&, saj samostojen&ni veljaven XML. Vsak doseže poziv kot spremenljivka, tukaj{{sip_x_account_id}}. Twilio dovoljuje glavex-inUser-to-User, kodirane z odstotki, pri čemer je celoten URI krajši od 255 znakov, glave pa so krajše od 1.024 znakov. referUrlTwiliu omogoča sprejetje agentovegaREFER; brez njega prenos ne uspe z napako 13802.answerOnBridge="true"ohrani klicatelja povezanega, dokler se nova ciljna destinacija ne oglasi, zato se lahko neuspešen prenos povrne.
Gradnik Studio Poveži klic z ne dokumentira glav po meri ali referUrl, zato
iz Studia predajte klic temu TwiML, na primer z gradnikom Preusmeritev TwiML.
3. Prejmite klic nazaj
Agent preusmeri klic z REFER, katerega naslov preusmeritve vsebuje ID predaje
in namen. Dodajte to številko za preusmeritev (glejte
Dodajanje številke za preusmeritev
in Glave v naslovu preusmeritve):
{
"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 pošlje celoten naslov v vaš referUrl kot ReferTransferTarget, na
primer <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>.
Vaš obdelovalnik iz njega prebere glave in vrne TwiML za naslednjo usmeritev
klicatelja. Uporabniški del naslova (support) izberete sami, zato lahko
dodate eno številko za preusmeritev za vsak cilj in na njeni podlagi usmerjate klice.
Ta funkcija Twilio doda klicatelja v čakalno vrsto Flex z atributi opravila
predaje in poišče povzetek po ID-ju predaje. Iskanje se izvaja v funkciji,
ker gradnik HTTP Request v Studio ne more poslati glave 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);
};Ključ API shranite v spremenljivkah okolja funkcije. Za druga polja glejte Iskanje predanega klica.
Preizkusite
Pokličite številko Twilio, ki vrne zgornji TwiML, prosite agenta za povezavo z
osebo in preverite, ali vaš obdelovalnik referUrl prejme ReferTransferTarget
z obema glavama ter ali klicatelj doseže čakalno vrsto. Nato odprite klic z
GET /v1/calls/{call_id}: external_call_id mora biti CallSid.
Omejitve
- Twilio omejuje
Refer-Tona 256 znakov. ThunderPhone omeji naslov na 254 znakov in izpusti glavo, ki ne ustreza omejitvi, zato naj bodo imena in vrednosti glav kratka. - Twilio ne dokumentira branja glav pri
BYE, zato povratek ne more prenesti predaje nazaj v Twilio. UporabiteREFER, kot je prikazano zgoraj. - Twilio ne sprejme
REFERpri klicu, povezanem prek<Conference>ali<Queue>, zato agenta pokličite z<Dial><Sip>, kot je prikazano zgoraj.