ThunderPhone v3 je zdaj na voljo.Začnite sami, že od 2 ¢/min.Preberite obvestilo

Contact centers

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=tls je pomemben: Twilio uporablja UDP, če mu ne naročite drugače.
  • X-Call-ID vsebuje CallSid. Twilio ne dokumentira lastne glave za ID klica, zato dodajte to: ThunderPhone jo shrani kot klicev external_call_id. {{CallSid}} deluje v TwiML Bin; z lastnega strežnika zapišite CallSid dohodne zahteve.
  • Na enak način dodajte več konteksta, na primer &amp;X-Account-Id=12345. V TwiML zapišite & kot &amp;, saj samostojen & ni veljaven XML. Vsak doseže poziv kot spremenljivka, tukaj {{sip_x_account_id}}. Twilio dovoljuje glave x- in User-to-User, kodirane z odstotki, pri čemer je celoten URI krajši od 255 znakov, glave pa so krajše od 1.024 znakov.
  • referUrl Twiliu omogoča sprejetje agentovega REFER; 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-To na 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. Uporabite REFER, kot je prikazano zgoraj.
  • Twilio ne sprejme REFER pri klicu, povezanem prek <Conference> ali <Queue>, zato agenta pokličite z <Dial><Sip>, kot je prikazano zgoraj.