---
title: "Povežite se s Twilija"
description: "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č](/hr/guides/api-keys).
- 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:

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

Odmah spremite `password` iz odgovora; prikazuje se samo jednom. Za
prihvaćanje poziva samo od Twilioa pogledajte
[Ograničite izvorne IP adrese](/hr/guides/sip-addresses).

## 2. Šaljite pozive s kontekstom

Vratite ovaj TwiML za poziv koji želite predati agentu:

```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 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](https://www.twilio.com/docs/api/errors/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](/hr/guides/contact-centers/overview)
i [Zaglavlja unutar adrese za preusmjeravanje](/hr/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 š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`:

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

Spremite API ključ u varijable okruženja funkcije. Pogledajte
[Dohvaćanje predanog poziva](/api-reference/calls#look-up-a-handed-off-call)
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.
