Open in
Povežite se s Twilija
Usmjerite Twilio pozive glasovnom agentu ThunderPhone putem SIP-a uz CallSid, a zatim ih vratite putem svojeg referUrl-a s prosljeđivanjem u adresi prijenosa.
Vaš TwiML bira SIP adresu agenta s CallSid poziva u zaglavlju.
Kada pozivatelj treba osobu, agent šalje SIP REFER, Twilio prosljeđuje
adresu za prijenos s podacima o preusmjeravanju vašem obrađivaču referUrl, a
TwiML koji vaš obrađivač vrati određuje kamo pozivatelj ide, primjerice u Flex red čekanja.
Prije početka
- ThunderPhone agent i organizacijski API ključ.
- Twilio Programmable Voice i mjesto za posluživanje TwiML-a te obrađivača
referUrl: vlastiti poslužitelj ili TwiML Bin i Twilio Function. Flex je neobavezan.
1. Izradite SIP krajnju točku
Twilio <Sip> prihvaća korisničko ime i lozinku, stoga upotrijebite standardnu krajnju točku:
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"}'Odmah spremite password iz odgovora; prikazuje se samo jednom. Za
prihvaćanje poziva samo od Twilioa pogledajte
Ograničite izvorne IP adrese.
2. Šaljite pozive s kontekstom
Vratite ovaj TwiML za poziv koji želite predati agentu:
<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 važan: Twilio koristi UDP ako nije drugačije navedeno.X-Call-IDprenosiCallSid. Twilio ne dokumentira vlastito zaglavlje ID-ja poziva, stoga dodajte ovo: ThunderPhone ga pohranjuje kaoexternal_call_idpoziva.{{CallSid}}funkcionira u TwiML Binu; s vlastitog poslužitelja upišiteCallSiddolaznog zahtjeva.- Na isti način dodajte više konteksta, primjerice
&X-Account-Id=12345. Unutar TwiML-a pišite&kao&, jer je samostalni&nevaljan XML. Svaki stiže u prompt kao varijabla, ovdje{{sip_x_account_id}}. Twilio dopušta zaglavljax-iUser-to-User, kodirana postotcima, pri čemu cijeli URI mora imati manje od 255 znakova, a zaglavlja manje od 1.024. referUrlomogućuje Twiliou prihvaćanje agentovaREFER; bez njega prijenos ne uspijeva s pogreškom 13802.answerOnBridge="true"održava pozivatelja povezanim dok novo odredište ne odgovori, tako da se pri neuspjelom prijenosu može primijeniti zamjenska opcija.
Studio widget Poveži poziv s ne dokumentira prilagođena zaglavlja ni
referUrl, stoga iz Studija predajte poziv ovom TwiML-u, primjerice pomoću
widgeta TwiML preusmjeravanje.
3. Primite poziv natrag
Agent preusmjerava poziv pomoću REFER čija adresa za preusmjeravanje sadrži
ID i namjeru predaje. Dodajte ovaj broj za preusmjeravanje (pogledajte
Dodavanje broja za preusmjeravanje
i Zaglavlja unutar adrese za preusmjeravanje):
{
"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 šalje cijelu adresu na Vaš referUrl kao ReferTransferTarget, na
primjer <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>.
Vaš rukovatelj iz nje čita zaglavlja i vraća TwiML koji određuje kamo
pozivatelj ide dalje. Korisnički dio adrese (support) sami odabirete, pa
možete dodati jedan broj za preusmjeravanje po odredištu i usmjeravati pozive
prema njemu.
Ova funkcija Twilio stavlja pozivatelja u red čekanja u Flexu s podacima o
predaji kao atributima zadatka i dohvaća sažetak prema ID-u predaje. Dohvaćanje
se izvodi u funkciji jer Studio widget HTTP Request ne može poslati zaglavlje
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);
};Spremite API ključ u varijable okruženja funkcije. Pogledajte Dohvaćanje predanog poziva za ostala polja.
Testirajte
Nazovite Twilio broj koji vraća gore navedeni TwiML, zatražite od agenta
razgovor s osobom i provjerite prima li Vaš rukovatelj referUrl
ReferTransferTarget s oba zaglavlja te dolazi li pozivatelj u red čekanja.
Zatim otvorite poziv pomoću GET /v1/calls/{call_id}: external_call_id
trebao bi biti CallSid.
Ograničenja
- Twilio ograničava
Refer-Tona 256 znakova. ThunderPhone zadržava adresu na 254 znaka i izostavlja zaglavlje koje ne stane, stoga nazivi i vrijednosti zaglavlja trebaju biti kratki. - Twilio ne dokumentira čitanje zaglavlja u poruci
BYE, pa povratni prijenos ne može prenijeti podatke o predaji natrag u Twilio. UpotrijebiteREFERkao gore. - Twilio ne prihvaća
REFERza poziv povezan putem<Conference>ili<Queue>, stoga birajte agenta pomoću<Dial><Sip>kao gore.