ThunderPhone v3 jau veikia.Viską atlikite savarankiškai – nuo 2 ct/min.Skaityti pranešimą

Contact centers

Prisijunkite iš Twilio

Siųskite Twilio skambučius ThunderPhone agentui per SIP naudodami CallSid ir nukreipkite juos atgal per savo referUrl, perdavimą nurodę perdavimo adrese.

Jūsų TwiML surenka agento SIP adresą, skambučio CallSid perduodamas antraštėje. Kai skambinančiajam reikia žmogaus, agentas siunčia SIP REFER, Twilio perduoda perdavimo adresą su jame esančia perdavimo informacija jūsų referUrl tvarkyklei, o jūsų tvarkyklės grąžinamas TwiML nustato, kur nukreipiamas skambinantysis, pavyzdžiui, į Flex eilę.

Prieš pradedant

  • ThunderPhone agentas ir organizacijos API raktas.
  • Twilio Programmable Voice ir vieta TwiML bei referUrl tvarkyklei: nuosavas serveris arba TwiML Bin ir Twilio Function. Flex yra pasirinktinis.

1. Sukurkite SIP galinį tašką

Twilio <Sip> naudoja naudotojo vardą ir slaptažodį, todėl naudokite standartinį galinį tašką:

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"}'

Nedelsdami išsaugokite atsakyme pateiktą password; jis rodomas vieną kartą. Jei taip pat norite priimti skambučius tik iš Twilio, žr. Riboti šaltinio IP adresus.

2. Siųskite skambučius su kontekstu

Grąžinkite šį TwiML skambučiui, kurį norite perduoti agentui:

<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 yra svarbus: nenurodžius kitaip, Twilio naudoja UDP.
  • X-Call-ID perduoda CallSid. Twilio nedokumentuoja savo skambučio ID antraštės, todėl pridėkite šią: ThunderPhone ją išsaugo kaip skambučio external_call_id. {{CallSid}} veikia TwiML Bin aplinkoje; naudodami nuosavą serverį, įrašykite gaunamos užklausos CallSid.
  • Tuo pačiu būdu pridėkite daugiau konteksto, pavyzdžiui, &amp;X-Account-Id=12345. TwiML viduje & rašykite kaip &amp;, nes neįrašytas & yra netinkamas XML. Kiekviena reikšmė pasiekia užklausą kaip kintamasis, šiuo atveju {{sip_x_account_id}}. Twilio leidžia x- antraštes ir User-to-User, koduotą procentais, kai visas URI yra trumpesnis nei 255 simboliai, o antraštės trumpesnės nei 1 024.
  • referUrl leidžia Twilio priimti agento REFER; be jo perdavimas nepavyksta su klaida 13802. answerOnBridge="true" palaiko skambinančiojo ryšį, kol atsiliepia naujas paskirties taškas, todėl nepavykus perdavimui galima naudoti atsarginį veiksmą.

Studio valdiklyje Prijungti skambutį prie nėra dokumentuotos pasirinktinės antraštės ar referUrl, todėl iš Studio perduokite skambutį šiam TwiML, pavyzdžiui, naudodami valdiklį TwiML peradresavimas.

3. Grąžinkite skambutį

Agentas peradresuoja naudodamas REFER, kurio peradresavimo adrese nurodytas perdavimo ID ir tikslas. Pridėkite šį peradresavimo numerį (žr. Pridėkite peradresavimo numerį ir Antraštės peradresavimo adrese):

{
  "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 siunčia visą adresą į jūsų referUrl kaip ReferTransferTarget, pvz., <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>. Jūsų tvarkyklė iš jo nuskaito antraštes ir grąžina TwiML, nurodantį, kur skambintojas nukreipiamas toliau. Adreso naudotojo dalį (support) galite pasirinkti patys, todėl kiekvienai paskirčiai galite pridėti po vieną peradresavimo numerį ir pagal jį nukreipti skambučius.

Ši Twilio funkcija įtraukia skambintoją į Flex eilę, perdavimą įrašydama kaip užduoties atributus, ir pagal perdavimo ID randa suvestinę. Paieška vykdoma funkcijoje, nes Studio HTTP Request valdiklis negali siųsti Authorization antraštės:

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);
};

API raktą laikykite funkcijos aplinkos kintamuosiuose. Kitus laukus rasite skyriuje Raskite perduotą skambutį.

Išbandykite

Paskambinkite į Twilio numerį, kuris grąžina pirmiau pateiktą TwiML, paprašykite agento sujungti su žmogumi ir patikrinkite, ar jūsų referUrl tvarkyklė gauna ReferTransferTarget su abiem antraštėmis ir ar skambintojas pasiekia eilę. Tada atidarykite skambutį naudodami GET /v1/calls/{call_id}: external_call_id turi būti CallSid.

Ribojimai

  • Twilio riboja Refer-To iki 256 simbolių. ThunderPhone apriboja adresą iki 254 simbolių ir neįtraukia netelpančios antraštės, todėl antraščių pavadinimai ir reikšmės turi būti trumpi.
  • Twilio nedokumentuoja antraščių nuskaitymo naudojant BYE, todėl grąžinant skambutį perdavimo duomenų negalima perduoti atgal į Twilio. Naudokite REFER, kaip nurodyta pirmiau.
  • Twilio nepriima REFER skambučiui, sujungtam naudojant <Conference> arba <Queue>, todėl skambinkite agentui naudodami <Dial><Sip>, kaip nurodyta pirmiau.