Open in
Conectați-vă din Twilio
Trimiteți apelurile Twilio către un agent ThunderPhone prin SIP cu CallSid și preluați-le înapoi prin referUrl, cu transferul în adresa de transfer.
TwiML-ul dumneavoastră apelează adresa SIP a agentului vocal cu CallSid al apelului într-un antet.
Când apelantul are nevoie de o persoană, agentul vocal trimite un REFER SIP, Twilio transmite
adresa de transfer care conține predarea apelului către handlerul dumneavoastră referUrl, iar
TwiML-ul returnat de handlerul dumneavoastră decide unde ajunge apelantul, de exemplu într-o coadă Flex.
Înainte de a începe
- Un agent vocal ThunderPhone și o cheie API a organizației.
- Twilio Programmable Voice și un loc pentru a servi TwiML și un handler
referUrl: propriul server sau un TwiML Bin și o Twilio Function. Flex este opțional.
1. Creați endpointul SIP
Elementul <Sip> din Twilio acceptă un nume de utilizator și o parolă, așadar utilizați un endpoint standard:
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"}'Stocați imediat password din răspuns; este afișată o singură dată. Pentru a
accepta apeluri numai de la Twilio, consultați
Restricționați IP-urile sursă.
2. Trimiteți apeluri cu context
Returnați acest TwiML pentru apelul pe care doriți să îl predați agentului vocal:
<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=tlseste important: Twilio utilizează UDP dacă nu i se specifică altfel.X-Call-IDtransmiteCallSid. Twilio nu documentează un antet call-id propriu, așadar adăugați-l pe acesta: ThunderPhone îl stochează dreptexternal_call_idal apelului.{{CallSid}}funcționează într-un TwiML Bin; de pe propriul server, includețiCallSidal cererii de intrare.- Adăugați mai mult context în același mod, de exemplu
&X-Account-Id=12345. În TwiML, scrieți&ca&, deoarece un&simplu este XML nevalid. Fiecare ajunge în prompt ca variabilă, aici{{sip_x_account_id}}. Twilio permite antetex-șiUser-to-User, codificate procentual, cu întregul URI sub 255 de caractere și antetele sub 1.024. referUrlpermite Twilio să accepteREFER-ul agentului vocal; fără acesta, transferul eșuează cu eroarea 13802.answerOnBridge="true"menține apelantul conectat până când noua destinație răspunde, astfel încât un transfer eșuat să poată reveni la o opțiune alternativă.
Widgetul Conectare apel către din Studio nu documentează antete personalizate sau
referUrl, așadar din Studio predați apelul acestui TwiML, de exemplu cu un
widget Redirecționare TwiML.
3. Preluați apelul înapoi
Agentul vocal transferă apelul cu un REFER a cărui adresă de transfer conține
ID-ul și intenția predării. Adăugați acest număr de transfer (consultați
Adăugați numărul de transfer
și Antete în adresa de transfer):
{
"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 trimite întreaga adresă către referUrl ca ReferTransferTarget, de
exemplu <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>.
Gestionarul dumneavoastră extrage antetele din aceasta și returnează TwiML
pentru următoarea destinație a apelantului. Partea de utilizator a adresei
(support) este la alegerea dumneavoastră, astfel încât puteți adăuga câte un
număr de transfer pentru fiecare destinație și puteți direcționa apelurile pe
baza acesteia.
Această Funcție Twilio pune apelantul în coada Flex cu datele predării ca
atribute ale sarcinii și caută rezumatul după ID-ul predării. Căutarea rulează
într-o Funcție deoarece widgetul HTTP Request din Studio nu poate trimite
antetul 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);
};Păstrați cheia API în variabilele de mediu ale Funcției. Consultați Căutați un apel predat pentru celelalte câmpuri.
Testați
Apelați un număr Twilio care returnează TwiML-ul de mai sus, cereți agentului
să vă transfere la o persoană și verificați că gestionarul referUrl
primește ReferTransferTarget cu ambele antete și că apelantul ajunge în
coadă. Apoi deschideți apelul cu GET /v1/calls/{call_id}: external_call_id
ar trebui să fie CallSid.
Limite
- Twilio limitează
Refer-Tola 256 de caractere. ThunderPhone menține adresa la 254 de caractere și omite un antet care nu încape, așa că păstrați numele și valorile antetelor scurte. - Twilio nu documentează citirea antetelor într-un
BYE, astfel că o revenire nu poate transmite predarea înapoi către Twilio. Utilizați unREFERca mai sus. - Twilio nu acceptă un
REFERpentru un apel conectat prin<Conference>sau<Queue>, așa că apelați agentul cu<Dial><Sip>ca mai sus.