---
title: "Savienošana no Twilio"
description: "Nosūtiet Twilio zvanus uz ThunderPhone balss aģentu, izmantojot SIP un CallSid, un pārsūtīšanas adresē norādot nodošanu, atgrieziet tos, izmantojot savu referUrl."
---

Jūsu TwiML izsauc aģenta SIP adresi ar zvana `CallSid` galvenē.
Kad zvanītājam ir nepieciešams cilvēks, aģents nosūta SIP `REFER`, Twilio nodod
pārsūtīšanas adresi ar tajā ietverto pāradresāciju jūsu `referUrl` apstrādātājam, un
TwiML, ko atgriež jūsu apstrādātājs, nosaka, kur zvanītājs nonāk, piemēram, Flex rindā.

## Pirms darba sākšanas

- ThunderPhone aģents un organizācijas [API atslēga](/lv/guides/api-keys).
- Twilio Programmable Voice un vieta TwiML un `referUrl` apstrādātāja
  izvietošanai: savs serveris vai TwiML Bin un Twilio Function. Flex nav obligāts.

## 1. Izveidojiet SIP galapunktu

Twilio `<Sip>` pieņem lietotājvārdu un paroli, tāpēc izmantojiet standarta galapunktu:

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

Nekavējoties saglabājiet atbildē norādīto `password`; tā tiek parādīta tikai vienreiz. Lai
pieņemtu zvanus arī tikai no Twilio, skatiet
[Avota IP adrešu ierobežošana](/lv/guides/sip-addresses).

## 2. Nosūtiet zvanus ar kontekstu

Atgrieziet šo TwiML zvanam, kuru vēlaties nodot aģentam:

```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` ir svarīgs: Twilio izmanto UDP, ja nav norādīts citādi.
- `X-Call-ID` ietver `CallSid`. Twilio nedokumentē savu call-id galveni,
  tāpēc pievienojiet šo: ThunderPhone to saglabā kā zvana
  `external_call_id`. `{{CallSid}}` darbojas TwiML Bin; savā serverī
  ierakstiet ienākošā pieprasījuma `CallSid`.
- Tādā pašā veidā pievienojiet papildu kontekstu, piemēram, `&amp;X-Account-Id=12345`. TwiML iekšpusē
  rakstiet `&` kā `&amp;`, jo neapstrādāts `&` ir nederīgs XML. Katrs no tiem nonāk
  uzvednē kā mainīgais, šeit `{{sip_x_account_id}}`. Twilio atļauj `x-` galvenes
  un `User-to-User` ar procentu kodējumu, ja visa URI garums nepārsniedz 255 rakstzīmes
  un galveņu garums nepārsniedz 1 024.
- `referUrl` ļauj Twilio pieņemt aģenta `REFER`; bez tā pārsūtīšana
  neizdodas ar [kļūdu 13802](https://www.twilio.com/docs/api/errors/13802).
  `answerOnBridge="true"` uztur zvanītāju savienotu, līdz jaunais galamērķis
  atbild, tāpēc neveiksmīgai pārsūtīšanai var izmantot rezerves risinājumu.

Studio logrīks **Savienot zvanu ar** nedokumentē pielāgotas galvenes vai
`referUrl`, tāpēc no Studio nododiet zvanu šim TwiML, piemēram, izmantojot
logrīku **TwiML pāradresēšana**.

## 3. Saņemiet zvanu atpakaļ

Balss aģents pārsūta zvanu ar `REFER`, kura pārsūtīšanas adresē ir ietverts
nodošanas ID un nolūks. Pievienojiet šo pārsūtīšanas numuru (skatiet
[Pievienojiet pārsūtīšanas numuru](/lv/guides/contact-centers/overview)
un [Galvenes pārsūtīšanas adresē](/lv/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 nosūta visu adresi uz jūsu `referUrl` kā `ReferTransferTarget`, piemēram,
`<sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>`.
Jūsu apstrādātājs nolasa no tās galvenes un atgriež TwiML, kas nosaka, kur
zvanītājs nonāk tālāk. Adreses lietotāja daļu (`support`) varat izvēlēties
jūs, tāpēc varat pievienot vienu pārsūtīšanas numuru katram galamērķim un
maršrutēt pēc tā.

Šī Twilio funkcija ievieto zvanītāju Flex rindā ar nodošanas informāciju kā
uzdevuma atribūtiem un uzmeklē kopsavilkumu pēc nodošanas ID. Uzmeklēšana tiek
veikta funkcijā, jo Studio HTTP Request logrīks nevar nosūtīt `Authorization`
galveni:

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

Glabājiet API atslēgu funkcijas vides mainīgajos. Skatiet
[Uzmeklējiet nodotu zvanu](/api-reference/calls#look-up-a-handed-off-call),
lai uzzinātu par pārējiem laukiem.

## Pārbaudiet

Piezvaniet uz Twilio numuru, kas atgriež iepriekš minēto TwiML, palūdziet
balss aģentam savienot ar personu un pārbaudiet, vai jūsu `referUrl`
apstrādātājs saņem `ReferTransferTarget` ar abām galvenēm un vai zvanītājs
nonāk rindā. Pēc tam atveriet zvanu ar `GET /v1/calls/{call_id}`:
`external_call_id` jābūt `CallSid`.

## Ierobežojumi

- Twilio ierobežo `Refer-To` līdz 256 rakstzīmēm. ThunderPhone uztur adresi
  254 rakstzīmju robežās un izlaiž galveni, kas neietilpst, tāpēc izmantojiet
  īsus galveņu nosaukumus un vērtības.
- Twilio nedokumentē galveņu nolasīšanu no `BYE`, tāpēc atgrieztais zvans nevar
  nodot nodošanas informāciju atpakaļ Twilio. Izmantojiet `REFER`, kā norādīts
  iepriekš.
- Twilio nepieņem `REFER` zvanam, kas savienots, izmantojot `<Conference>` vai
  `<Queue>`, tāpēc zvaniet balss aģentam ar `<Dial><Sip>`, kā norādīts iepriekš.
