ThunderPhone v3 ir klāt.Sāciet patstāvīgi — no 2 ¢/min.Lasīt paziņojumu

Contact centers

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 referUrl apstrā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=tls ir svarīgs: Twilio izmanto UDP, ja nav norādīts citādi.
  • X-Call-ID ietver CallSid. Twilio nedokumentē savu call-id galveni, tāpēc pievienojiet šo: ThunderPhone to saglabā kā zvana external_call_id. {{CallSid}} darbojas TwiML Bin; savā serverī ierakstiet ienākošā pieprasījuma CallSid.
  • Tādā pašā veidā pievienojiet papildu kontekstu, piemēram, &amp;X-Account-Id=12345. TwiML iekšpusē rakstiet & kā &amp;, jo neapstrādāts & ir nederīgs XML. Katrs no tiem nonāk uzvednē kā mainīgais, šeit {{sip_x_account_id}}. Twilio atļauj x- galvenes un User-to-User ar 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ģenta REFER; 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-To lī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. Izmantojiet REFER, kā norādīts iepriekš.
  • Twilio nepieņem REFER zvanam, kas savienots, izmantojot <Conference> vai <Queue>, tāpēc zvaniet balss aģentam ar <Dial><Sip>, kā norādīts iepriekš.