Open in
Savienošana no Twilio
Nosūtiet Twilio zvanus uz ThunderPhone balss aģentu, izmantojot SIP un CallSid, un pārsūtīšanas adresē norādot nodošanu, atgrieziet tos, izmantojot savu referUrl.
Jūsu TwiML izsauc aģenta SIP adresi ar zvana CallSid galvenē.
Kad zvanītājam ir nepieciešams cilvēks, aģents nosūta SIP REFER, Twilio nodod
pārsūtīšanas adresi ar tajā ietverto pāradresāciju jūsu referUrl apstrādātājam, un
TwiML, ko atgriež jūsu apstrādātājs, nosaka, kur zvanītājs nonāk, piemēram, Flex rindā.
Pirms darba sākšanas
- ThunderPhone aģents un organizācijas API atslēga.
- Twilio Programmable Voice un vieta TwiML un
referUrlapstrādātāja izvietošanai: savs serveris vai TwiML Bin un Twilio Function. Flex nav obligāts.
1. Izveidojiet SIP galapunktu
Twilio <Sip> pieņem lietotājvārdu un paroli, tāpēc izmantojiet standarta galapunktu:
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"}'Nekavējoties saglabājiet atbildē norādīto password; tā tiek parādīta tikai vienreiz. Lai
pieņemtu zvanus arī tikai no Twilio, skatiet
Avota IP adrešu ierobežošana.
2. Nosūtiet zvanus ar kontekstu
Atgrieziet šo TwiML zvanam, kuru vēlaties nodot aģentam:
<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=tlsir svarīgs: Twilio izmanto UDP, ja nav norādīts citādi.X-Call-IDietverCallSid. Twilio nedokumentē savu call-id galveni, tāpēc pievienojiet šo: ThunderPhone to saglabā kā zvanaexternal_call_id.{{CallSid}}darbojas TwiML Bin; savā serverī ierakstiet ienākošā pieprasījumaCallSid.- Tādā pašā veidā pievienojiet papildu kontekstu, piemēram,
&X-Account-Id=12345. TwiML iekšpusē rakstiet&kā&, jo neapstrādāts&ir nederīgs XML. Katrs no tiem nonāk uzvednē kā mainīgais, šeit{{sip_x_account_id}}. Twilio atļaujx-galvenes unUser-to-Userar procentu kodējumu, ja visa URI garums nepārsniedz 255 rakstzīmes un galveņu garums nepārsniedz 1 024. referUrlļauj Twilio pieņemt aģentaREFER; bez tā pārsūtīšana neizdodas ar kļūdu 13802.answerOnBridge="true"uztur zvanītāju savienotu, līdz jaunais galamērķis atbild, tāpēc neveiksmīgai pārsūtīšanai var izmantot rezerves risinājumu.
Studio logrīks Savienot zvanu ar nedokumentē pielāgotas galvenes vai
referUrl, tāpēc no Studio nododiet zvanu šim TwiML, piemēram, izmantojot
logrīku TwiML pāradresēšana.
3. Saņemiet zvanu atpakaļ
Balss aģents pārsūta zvanu ar REFER, kura pārsūtīšanas adresē ir ietverts
nodošanas ID un nolūks. Pievienojiet šo pārsūtīšanas numuru (skatiet
Pievienojiet pārsūtīšanas numuru
un Galvenes pārsūtīšanas adresē):
{
"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 nosūta visu adresi uz jūsu referUrl kā ReferTransferTarget, piemēram,
<sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>.
Jūsu apstrādātājs nolasa no tās galvenes un atgriež TwiML, kas nosaka, kur
zvanītājs nonāk tālāk. Adreses lietotāja daļu (support) varat izvēlēties
jūs, tāpēc varat pievienot vienu pārsūtīšanas numuru katram galamērķim un
maršrutēt pēc tā.
Šī Twilio funkcija ievieto zvanītāju Flex rindā ar nodošanas informāciju kā
uzdevuma atribūtiem un uzmeklē kopsavilkumu pēc nodošanas ID. Uzmeklēšana tiek
veikta funkcijā, jo Studio HTTP Request logrīks nevar nosūtīt Authorization
galveni:
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);
};Glabājiet API atslēgu funkcijas vides mainīgajos. Skatiet Uzmeklējiet nodotu zvanu, lai uzzinātu par pārējiem laukiem.
Pārbaudiet
Piezvaniet uz Twilio numuru, kas atgriež iepriekš minēto TwiML, palūdziet
balss aģentam savienot ar personu un pārbaudiet, vai jūsu referUrl
apstrādātājs saņem ReferTransferTarget ar abām galvenēm un vai zvanītājs
nonāk rindā. Pēc tam atveriet zvanu ar GET /v1/calls/{call_id}:
external_call_id jābūt CallSid.
Ierobežojumi
- Twilio ierobežo
Refer-Tolīdz 256 rakstzīmēm. ThunderPhone uztur adresi 254 rakstzīmju robežās un izlaiž galveni, kas neietilpst, tāpēc izmantojiet īsus galveņu nosaukumus un vērtības. - Twilio nedokumentē galveņu nolasīšanu no
BYE, tāpēc atgrieztais zvans nevar nodot nodošanas informāciju atpakaļ Twilio. IzmantojietREFER, kā norādīts iepriekš. - Twilio nepieņem
REFERzvanam, kas savienots, izmantojot<Conference>vai<Queue>, tāpēc zvaniet balss aģentam ar<Dial><Sip>, kā norādīts iepriekš.