---
title: "Prisijunkite iš Twilio"
description: "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](/lt/guides/api-keys).
- 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ą:

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

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

## 2. Siųskite skambučius su kontekstu

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

```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` 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](https://www.twilio.com/docs/api/errors/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į](/lt/guides/contact-centers/overview)
ir [Antraštės peradresavimo adrese](/lt/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 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:

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

API raktą laikykite funkcijos aplinkos kintamuosiuose. Kitus laukus rasite
skyriuje [Raskite perduotą skambutį](/api-reference/calls#look-up-a-handed-off-call).

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