ThunderPhone v3 este disponibil.Self-service, de la 2 ¢/min.Citiți anunțul

Contact centers

Conectați-vă din Twilio

Trimiteți apelurile Twilio către un agent ThunderPhone prin SIP cu CallSid și preluați-le înapoi prin referUrl, cu transferul în adresa de transfer.

TwiML-ul dumneavoastră apelează adresa SIP a agentului vocal cu CallSid al apelului într-un antet. Când apelantul are nevoie de o persoană, agentul vocal trimite un REFER SIP, Twilio transmite adresa de transfer care conține predarea apelului către handlerul dumneavoastră referUrl, iar TwiML-ul returnat de handlerul dumneavoastră decide unde ajunge apelantul, de exemplu într-o coadă Flex.

Înainte de a începe

  • Un agent vocal ThunderPhone și o cheie API a organizației.
  • Twilio Programmable Voice și un loc pentru a servi TwiML și un handler referUrl: propriul server sau un TwiML Bin și o Twilio Function. Flex este opțional.

1. Creați endpointul SIP

Elementul <Sip> din Twilio acceptă un nume de utilizator și o parolă, așadar utilizați un endpoint standard:

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

Stocați imediat password din răspuns; este afișată o singură dată. Pentru a accepta apeluri numai de la Twilio, consultați Restricționați IP-urile sursă.

2. Trimiteți apeluri cu context

Returnați acest TwiML pentru apelul pe care doriți să îl predați agentului vocal:

<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 este important: Twilio utilizează UDP dacă nu i se specifică altfel.
  • X-Call-ID transmite CallSid. Twilio nu documentează un antet call-id propriu, așadar adăugați-l pe acesta: ThunderPhone îl stochează drept external_call_id al apelului. {{CallSid}} funcționează într-un TwiML Bin; de pe propriul server, includeți CallSid al cererii de intrare.
  • Adăugați mai mult context în același mod, de exemplu &amp;X-Account-Id=12345. În TwiML, scrieți & ca &amp;, deoarece un & simplu este XML nevalid. Fiecare ajunge în prompt ca variabilă, aici {{sip_x_account_id}}. Twilio permite antete x- și User-to-User, codificate procentual, cu întregul URI sub 255 de caractere și antetele sub 1.024.
  • referUrl permite Twilio să accepte REFER-ul agentului vocal; fără acesta, transferul eșuează cu eroarea 13802. answerOnBridge="true" menține apelantul conectat până când noua destinație răspunde, astfel încât un transfer eșuat să poată reveni la o opțiune alternativă.

Widgetul Conectare apel către din Studio nu documentează antete personalizate sau referUrl, așadar din Studio predați apelul acestui TwiML, de exemplu cu un widget Redirecționare TwiML.

3. Preluați apelul înapoi

Agentul vocal transferă apelul cu un REFER a cărui adresă de transfer conține ID-ul și intenția predării. Adăugați acest număr de transfer (consultați Adăugați numărul de transfer și Antete în adresa de transfer):

{
  "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 trimite întreaga adresă către referUrl ca ReferTransferTarget, de exemplu <sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>. Gestionarul dumneavoastră extrage antetele din aceasta și returnează TwiML pentru următoarea destinație a apelantului. Partea de utilizator a adresei (support) este la alegerea dumneavoastră, astfel încât puteți adăuga câte un număr de transfer pentru fiecare destinație și puteți direcționa apelurile pe baza acesteia.

Această Funcție Twilio pune apelantul în coada Flex cu datele predării ca atribute ale sarcinii și caută rezumatul după ID-ul predării. Căutarea rulează într-o Funcție deoarece widgetul HTTP Request din Studio nu poate trimite antetul 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);
};

Păstrați cheia API în variabilele de mediu ale Funcției. Consultați Căutați un apel predat pentru celelalte câmpuri.

Testați

Apelați un număr Twilio care returnează TwiML-ul de mai sus, cereți agentului să vă transfere la o persoană și verificați că gestionarul referUrl primește ReferTransferTarget cu ambele antete și că apelantul ajunge în coadă. Apoi deschideți apelul cu GET /v1/calls/{call_id}: external_call_id ar trebui să fie CallSid.

Limite

  • Twilio limitează Refer-To la 256 de caractere. ThunderPhone menține adresa la 254 de caractere și omite un antet care nu încape, așa că păstrați numele și valorile antetelor scurte.
  • Twilio nu documentează citirea antetelor într-un BYE, astfel că o revenire nu poate transmite predarea înapoi către Twilio. Utilizați un REFER ca mai sus.
  • Twilio nu acceptă un REFER pentru un apel conectat prin <Conference> sau <Queue>, așa că apelați agentul cu <Dial><Sip> ca mai sus.