ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Contact centers

Povežite se s Twilija

Usmjerite Twilio pozive glasovnom agentu ThunderPhone putem SIP-a uz CallSid, a zatim ih vratite putem svojeg referUrl-a s prosljeđivanjem u adresi prijenosa.

Vaš TwiML bira SIP adresu agenta s CallSid poziva u zaglavlju. Kada pozivatelj treba osobu, agent šalje SIP REFER, Twilio prosljeđuje adresu za prijenos s podacima o preusmjeravanju vašem obrađivaču referUrl, a TwiML koji vaš obrađivač vrati određuje kamo pozivatelj ide, primjerice u Flex red čekanja.

Prije početka

  • ThunderPhone agent i organizacijski API ključ.
  • Twilio Programmable Voice i mjesto za posluživanje TwiML-a te obrađivača referUrl: vlastiti poslužitelj ili TwiML Bin i Twilio Function. Flex je neobavezan.

1. Izradite SIP krajnju točku

Twilio <Sip> prihvaća korisničko ime i lozinku, stoga upotrijebite standardnu krajnju točku:

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

Odmah spremite password iz odgovora; prikazuje se samo jednom. Za prihvaćanje poziva samo od Twilioa pogledajte Ograničite izvorne IP adrese.

2. Šaljite pozive s kontekstom

Vratite ovaj TwiML za poziv koji želite predati agentu:

<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 važan: Twilio koristi UDP ako nije drugačije navedeno.
  • X-Call-ID prenosi CallSid. Twilio ne dokumentira vlastito zaglavlje ID-ja poziva, stoga dodajte ovo: ThunderPhone ga pohranjuje kao external_call_id poziva. {{CallSid}} funkcionira u TwiML Binu; s vlastitog poslužitelja upišite CallSid dolaznog zahtjeva.
  • Na isti način dodajte više konteksta, primjerice &amp;X-Account-Id=12345. Unutar TwiML-a pišite & kao &amp;, jer je samostalni & nevaljan XML. Svaki stiže u prompt kao varijabla, ovdje {{sip_x_account_id}}. Twilio dopušta zaglavlja x- i User-to-User, kodirana postotcima, pri čemu cijeli URI mora imati manje od 255 znakova, a zaglavlja manje od 1.024.
  • referUrl omogućuje Twiliou prihvaćanje agentova REFER; bez njega prijenos ne uspijeva s pogreškom 13802. answerOnBridge="true" održava pozivatelja povezanim dok novo odredište ne odgovori, tako da se pri neuspjelom prijenosu može primijeniti zamjenska opcija.

Studio widget Poveži poziv s ne dokumentira prilagođena zaglavlja ni referUrl, stoga iz Studija predajte poziv ovom TwiML-u, primjerice pomoću widgeta TwiML preusmjeravanje.

3. Primite poziv natrag

Agent preusmjerava poziv pomoću REFER čija adresa za preusmjeravanje sadrži ID i namjeru predaje. Dodajte ovaj broj za preusmjeravanje (pogledajte Dodavanje broja za preusmjeravanje i Zaglavlja unutar adrese za preusmjeravanje):

{
  "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 šalje cijelu adresu na Vaš referUrl kao ReferTransferTarget, na primjer <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>. Vaš rukovatelj iz nje čita zaglavlja i vraća TwiML koji određuje kamo pozivatelj ide dalje. Korisnički dio adrese (support) sami odabirete, pa možete dodati jedan broj za preusmjeravanje po odredištu i usmjeravati pozive prema njemu.

Ova funkcija Twilio stavlja pozivatelja u red čekanja u Flexu s podacima o predaji kao atributima zadatka i dohvaća sažetak prema ID-u predaje. Dohvaćanje se izvodi u funkciji jer Studio widget HTTP Request ne može poslati zaglavlje 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);
};

Spremite API ključ u varijable okruženja funkcije. Pogledajte Dohvaćanje predanog poziva za ostala polja.

Testirajte

Nazovite Twilio broj koji vraća gore navedeni TwiML, zatražite od agenta razgovor s osobom i provjerite prima li Vaš rukovatelj referUrl ReferTransferTarget s oba zaglavlja te dolazi li pozivatelj u red čekanja. Zatim otvorite poziv pomoću GET /v1/calls/{call_id}: external_call_id trebao bi biti CallSid.

Ograničenja

  • Twilio ograničava Refer-To na 256 znakova. ThunderPhone zadržava adresu na 254 znaka i izostavlja zaglavlje koje ne stane, stoga nazivi i vrijednosti zaglavlja trebaju biti kratki.
  • Twilio ne dokumentira čitanje zaglavlja u poruci BYE, pa povratni prijenos ne može prenijeti podatke o predaji natrag u Twilio. Upotrijebite REFER kao gore.
  • Twilio ne prihvaća REFER za poziv povezan putem <Conference> ili <Queue>, stoga birajte agenta pomoću <Dial><Sip> kao gore.