---
title: "Unganisha kutoka Genesys Cloud"
description: "Tuma simu za Genesys Cloud kwa ejenti wa ThunderPhone kupitia trunk ya BYOC Cloud pamoja na kitambulisho cha mazungumzo na UUI, kisha zirudishe kwa hand-off katika UUI."
---

Mtitiriko wako wa Architect humtuma mpigaji kwa ejenti kupitia trunk ya BYOC Cloud, pamoja na kitambulisho cha mazungumzo na UUI yoyote uliyoweka. Mpigaji anapohitaji mtu, ejenti hutuma `REFER` ya SIP, Genesys hurudisha simu, na kitambulisho cha uhamisho hufika katika UUI ya simu.

## Kabla ya kuanza

- Ejenti wa ThunderPhone na [ufunguo wa API](/sw/guides/api-keys) wa shirika.
- Genesys Cloud yenye BYOC Cloud, na trunk ya nje (aina ya BYOC Carrier au PBX) yenye mipangilio hii imewashwa
  ([mipangilio ya trunk ya nje](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Vichwa vya mazungumzo**, ili Genesys itume kitambulisho chake cha mazungumzo katika
    `x-inin-cnv`. Hii huzimwa kwa chaguo-msingi.
  - **Upitishaji wa UUI**, wenye aina ya kichwa `User-To-User` na usimbaji wa Hex.
  - **Chukua Tena na Hamisha**, ili Genesys ikubali `REFER` ya ejenti.

## 1. Unda mwisho wa SIP

Genesys hujibu changamoto ya digest, kwa hivyo tumia mwisho wa 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": "Genesys Cloud"}'
```

Hifadhi `password` kutoka kwenye jibu mara moja; inaonyeshwa mara moja tu. Kwenye
trunk:

| Mpangilio | Thamani |
|---|---|
| Seva ya SIP | `sip.thunderphone.com`, mlango `5061` |
| Protokali | TLS |
| Uthibitishaji wa digest | `username` na `password` za mwisho |
| Kodeki | PCMU, PCMA au G.722 |

Weka trunk kwenye njia ya kutoka ya tovuti yako ambayo mpango wake wa nambari unajumuisha
anwani inayopigwa na mtiririko.

## 2. Tuma simu zenye muktadha

Katika mtiririko wako wa Architect:

1. Kwa hiari, ongeza kitendo cha **Weka Data ya UUI** chenye muktadha wa ejenti, kama
   `account=12345`. Genesys inapendekeza herufi 128 au chache zaidi.
2. Ongeza kitendo cha **Hamisha hadi Nambari** chenye `sip_uri` ya mwisho, kwa
   mfano `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys hutuma kitambulisho cha mazungumzo katika `x-inin-cnv`. ThunderPhone hukihifadhi kama
`external_call_id` ya simu. UUI hufika kwenye prompt ikiwa imetafsiriwa, kama
`{{sip_uui}}`.

Vichwa maalum vya trunk ni tuli katika Genesys, kwa hivyo weka thamani za kila simu katika UUI.
Genesys hujihifadhi viambishi vya vichwa vya `x-inin`, `x-genesys`, `x-pcv` na `x-gcv`
kwa matumizi yake.

## 3. Rudisha simu

Ejenti huhamisha kwa `REFER` hadi anwani kwenye Genesys, ikiwa na kitambulisho cha uhamisho
kama UUI ya hex ndani ya anwani hiyo. Ongeza nambari hii ya kuhamisha (tazama
[Ongeza nambari ya kuhamisha](/sw/guides/contact-centers/overview)
na [Vichwa ndani ya anwani ya kuhamisha](/sw/guides/call-transfers)):

```json
{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

Badilisha anwani kwa ile inayoelekeza tena kwenye foleni au mtiririko unaopaswa
kumpokea mpigaji; thibitisha muundo wake na Genesys. `REFER` huonekana hivi:

```
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
```

**Chukua Tena na Hamisha** ikiwa imewashwa, Genesys huchukua simu tena kutoka kwenye trunk
na kuielekeza kwenye anwani hiyo. Genesys inaandika kwamba UUI inayoingia huwekwa katika
`Call.UUIData`; haiandiki hili kwa uchukuaji tena, kwa hivyo thibitisha na
Genesys, au kwenye simu ya majaribio, kwamba mtiririko unaompokea mpigaji hupata
kitambulisho cha uhamisho hapo. Ili kupata muhtasari na dhamira, piga utafutaji wa uhamisho kwa
**Kitendo cha Data ya Simu** kwenye ujumuishaji wa Web Services Data Actions:

- Ombi: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  likifuatiwa na kitambulisho kutoka `Call.UUIData`.
- Vitambulisho: ufunguo wako wa API, uliotumwa kama `Authorization: Bearer sk_live_…`.
- Tokeo: ramani `handoff.summary` na `handoff.intent` kwenye vigeu vya mtiririko.

Tazama [Tafuta simu iliyohamishwa](/api-reference/calls#look-up-a-handed-off-call).

## Ijaribu

Piga simu kwa nambari inayofikia mtiririko, mwombe ejenti ampate mtu, na uthibitishe kwamba
Genesys inaelekeza simu kwenye anwani uliyoweka. Katika mtiririko huo, thibitisha kwamba
`Call.UUIData` ina kitambulisho cha hand-off kama maandishi (ikiwa inaonyesha tarakimu za heksadesimali, thibitisha kwamba usimbaji wa UUI wa trunk ni Hex). Kisha fungua simu kwa `GET /v1/calls/{call_id}`:
`external_call_id` inapaswa kuwa kitambulisho cha mazungumzo.

## Vikomo

- Kitendo cha **Pata Vichwa vya SIP** husoma `INVITE` ya awali pekee, kwa hivyo hakiwezi
  kusoma chochote kutoka kwenye `REFER` ya ejenti. Hand-off hufikia Genesys kupitia UUI pekee.
- Genesys huondoa UUI zote wakati simu ina kichwa zaidi ya kimoja cha UUI.
- Anwani ya uhamisho huwekewa kikomo cha herufi 254, kwa hivyo UUI ndefu hukatwa ili itoshee.
  Kitambulisho cha hand-off hutoshea kila wakati.
