---
title: "Povežite iz Twilio"
description: "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](/sl/guides/api-keys) 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:

```bash
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](/sl/guides/sip-addresses).

## 2. Pošljite klice s kontekstom

Za klic, ki ga želite predati agentu, vrnite ta TwiML:

```xml
<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](https://www.twilio.com/docs/api/errors/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](/sl/guides/contact-centers/overview)
in [Glave v naslovu preusmeritve](/sl/guides/call-transfers)):

```json
{
  "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`:

```js
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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
