---
title: "Unganisha kutoka Twilio"
description: "Tuma simu za Twilio kwa ejenti wa ThunderPhone kupitia SIP ukitumia CallSid, kisha uzirudishe kupitia referUrl yako huku uhamisho ukiwa katika anwani ya transfer."
---

TwiML yako hupiga anwani ya SIP ya ejenti ikiwa na `CallSid` ya simu katika kichwa.
Mpigaji anapohitaji mtu, ejenti hutuma SIP `REFER`, Twilio hutuma anwani ya
uhamisho yenye makabidhiano ndani yake kwa kishughulikiaji chako cha `referUrl`, na
TwiML inayorejeshwa na kishughulikiaji chako huamua mpigaji aende wapi, kama vile kwenye foleni ya Flex.

## Kabla ya kuanza

- Ejenti wa ThunderPhone na [ufunguo wa API](/sw/guides/api-keys) wa shirika.
- Twilio Programmable Voice, na mahali pa kutoa TwiML pamoja na kishughulikiaji
  cha `referUrl`: seva yako mwenyewe, au TwiML Bin na Twilio Function. Flex si
  lazima.

## 1. Unda kituo cha SIP

`<Sip>` ya Twilio hupokea jina la mtumiaji na nenosiri, kwa hivyo tumia kituo cha kawaida:

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

Hifadhi `password` kutoka kwenye jibu mara moja; huonyeshwa mara moja tu. Ili
kukubali simu kutoka Twilio pekee pia, tazama
[Zuia anwani za IP za chanzo](/sw/guides/sip-addresses).

## 2. Tuma simu zikiwa na muktadha

Rejesha TwiML hii kwa simu unayotaka kukabidhi kwa ejenti:

```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` ni muhimu: Twilio hutumia UDP isipoiagizwa vinginevyo.
- `X-Call-ID` hubeba `CallSid`. Twilio haijaeleza kichwa chake cha call-id,
  kwa hivyo ongeza hiki: ThunderPhone huihifadhi kama `external_call_id` ya
  simu. `{{CallSid}}` hufanya kazi katika TwiML Bin; kutoka seva yako mwenyewe,
  andika `CallSid` ya ombi linaloingia.
- Ongeza muktadha zaidi kwa njia hiyo hiyo, kama vile `&amp;X-Account-Id=12345`. Ndani ya
  TwiML, andika `&` kama `&amp;`, kwa kuwa `&` isiyo na kinga si XML halali. Kila moja hufika kwenye
  prompt kama kigeu, hapa `{{sip_x_account_id}}`. Twilio inaruhusu vichwa vya `x-`
  na `User-to-User`, vilivyosimbwa kwa asilimia, huku URI nzima ikiwa chini ya vibambo 255
  na vichwa vikiwa chini ya 1,024.
- `referUrl` huiruhusu Twilio kukubali `REFER` ya ejenti; bila hiyo uhamisho
  hushindwa kwa [hitilafu 13802](https://www.twilio.com/docs/api/errors/13802).
  `answerOnBridge="true"` humweka mpigaji ameunganishwa hadi anwani mpya
  ijibu, hivyo uhamisho unaposhindwa unaweza kutumia njia mbadala.

Wijeti ya Studio ya **Unganisha Simu Kwa** haielezi vichwa maalum au
`referUrl`, kwa hivyo kutoka Studio kabidhi simu kwa TwiML hii, kwa mfano kwa
kutumia wijeti ya **Uelekezaji Upya wa TwiML**.

## 3. Pokea simu tena

Ejenti huhamisha kwa `REFER` ambayo anwani yake ya uhamishaji hubeba kitambulisho
na nia ya hand-off. Ongeza nambari hii ya uhamishaji (tazama
[Ongeza nambari ya uhamishaji](/sw/guides/contact-centers/overview)
na [Vichwa ndani ya anwani ya uhamishaji](/sw/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 hutuma anwani nzima kwenye `referUrl` yako kama `ReferTransferTarget`, kwa
mfano `<sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>`.
Kishughulikiaji chako husoma vichwa kutoka humo na kurejesha TwiML ya mahali
mpigaji simu anaelekezwa baadaye. Sehemu ya mtumiaji ya anwani (`support`) ni
yako kuchagua, hivyo unaweza kuongeza nambari moja ya uhamishaji kwa kila
lengwa na kuelekeza kwa kuitumia.

Twilio Function hii huweka mpigaji simu kwenye foleni ya Flex huku hand-off
ikiwa sifa za jukumu na hutafuta muhtasari kwa kitambulisho cha hand-off. Utafutaji
huendeshwa katika Function kwa sababu wijeti ya HTTP Request ya Studio haiwezi
kutuma kichwa cha `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);
};
```

Hifadhi ufunguo wa API katika vigeu vya mazingira vya Function. Tazama
[Tafuta simu iliyofanyiwa hand-off](/api-reference/calls#look-up-a-handed-off-call)
kwa sehemu nyingine.

## Ijaribu

Piga nambari ya Twilio inayorejesha TwiML iliyo hapo juu, mwombe ejenti akuunganishe
na mtu, na uthibitishe kwamba kishughulikiaji chako cha `referUrl` kinapokea
`ReferTransferTarget` yenye vichwa vyote viwili na kwamba mpigaji simu anafika
kwenye foleni. Kisha fungua simu kwa
`GET /v1/calls/{call_id}`: `external_call_id` inapaswa kuwa `CallSid`.

## Vikomo

- Twilio huweka kikomo cha `Refer-To` kuwa herufi 256. ThunderPhone huweka anwani
  kuwa 254 na huacha kichwa kisichotoshea, hivyo fanya majina na thamani za
  vichwa ziwe fupi.
- Twilio haiandiki kuhusu kusoma vichwa kwenye `BYE`, hivyo urejeshaji hauwezi
  kubeba hand-off kurudi Twilio. Tumia `REFER` kama ilivyo hapo juu.
- Twilio haikubali `REFER` kwenye simu iliyounganishwa kupitia `<Conference>` au
  `<Queue>`, hivyo piga ejenti kwa `<Dial><Sip>` kama ilivyo hapo juu.
