---
title: "Unganisha kutoka Five9"
description: "Tuma simu za Five9 kwa ejenti wa ThunderPhone kupitia SIP ukitumia AI Agent Connect, kisha uzirudishe zikiwa na vichwa vya uelekezaji ambavyo script yako ya IVR husoma."
---

Script yako ya Five9 IVR humtuma mpigaji kwa ejenti pamoja na maelezo ya simu ya Five9. Ejenti anapomaliza, hukata simu akiwa na vichwa vya kuelekeza kwenye SIP
`BYE`, ambavyo script husoma kama vigeu vya simu ili kumwelekeza mpigaji.

## Kabla ya kuanza

- Ejenti wa ThunderPhone na [ufunguo wa API](/sw/guides/api-keys) wa shirika.
- Nyongeza ya **AI Agent Connect** ya Five9. Five9 huiwekea kikomo kwa watoa huduma wa AI ambao imewaidhinisha, na timu ya utekelezaji ya Five9 huisanidi: huingiza kiolezo cha script ya IVR cha mtoa huduma, huunda vigeu vya simu na kuelekeza moduli ya **Third Party Transfer** ya script kwa mtoa huduma. ThunderPhone bado haiko kwenye orodha ya Five9 ya watoa huduma walioidhinishwa: wasiliana na timu yako ya akaunti ya Five9 au usaidizi wa ThunderPhone kabla ya kupanga kutegemea huduma hii.

## 1. Unda endpoint ya SIP

Moduli ya Third Party Transfer ya Five9 hupiga namba ya simu, si anwani ya SIP,
na miunganisho ya Five9 ya watoa huduma wengine huthibitisha Five9 kwa anwani
chanzi badala ya nenosiri. Kwa hivyo unda endpoint ya `ip_allowlist` yenye namba
ambayo Five9 itapiga kama namba ya kuingia (tazama
[Majukwaa yanayopiga namba ya simu](/sw/guides/sip-addresses)):

```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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: masafa ya uashiriaji wa SIP ya vituo vyako vya data
  vya Five9, kutoka Five9. Kila moja lazima liwe masafa ya umma ya IPv4 ya `/16`
  au yenye upeo mwembamba zaidi (IPv6 `/48` au yenye upeo mwembamba zaidi).
- `dial_in_numbers`: namba ambayo script ya Five9 itapiga, iliyoandikwa kwa
  namna Five9 inavyoituma. Si lazima iwe namba halisi ya simu. Haiwezi kuwa
  tayari inatumika kwenye ThunderPhone, iwe kama namba ya simu au kwenye endpoint
  nyingine: hali hiyo hurejesha `409`.

Anwani za Five9 zinashirikiwa na wateja wake wote, kwa hivyo mteja mwingine yeyote
wa Five9 anayepiga namba hiyo atamfikia ejenti wako. Mahali unapochagua namba,
chagua ndefu ambayo hakuna mtu angeikisia (hadi tarakimu 15), hakikisha Five9
inaituma kwa ThunderPhone badala ya kuituma kwenye mtandao wa simu, na usiichapishe.

## 2. Tuma simu pamoja na muktadha

Iombe timu ya utekelezaji ya Five9:

- Kutuma simu kutoka kwenye moduli ya **Third Party Transfer** hadi
  `sip:+14155550188@sip.thunderphone.com`, ikiwa na namba katika URI ya ombi na
  kichwa cha `To`. Moduli huchukua namba, huku kikoa cha SIP cha mtoa huduma
  kikiwa kwenye kichwa.
- Kuituma kupitia TLS (porti 5061) au TCP (porti 5060). Endpoint hukataa UDP,
  na Five9 haichapishi ni usafirishaji upi unaotumia, kwa hivyo hakikisha si
  UDP.
- Kuwasha **Rudi Baada ya Simu ya Upande wa Tatu**, ili script iendelee ejenti
  anapokata simu (Five9 inaruhusu hadi sekunde 3,600 kwa simu ya upande wa tatu).

Mwongozo wa Five9 unaorodhesha thamani inazotuma (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` na nyinginezo), si majina
ya vichwa vyake. Miunganisho ya Five9 ya watoa huduma wengine wa AI huziorodhesha
katika itifaki kama `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`,
`X-CallCampaign` na `X-AgentID`; zihakiki kwenye simu yako ya kwanza ya majaribio. Kila moja hufika kwenye prompt kama kigeu, kama vile
`{{sip_x_callcampaign}}`. `X-CallID` huhifadhiwa kama
`external_call_id` ya simu.

## 3. Rejesha simu

Ejenti inarejesha simu: inasema kwaheri na kukata simu, na `BYE` hubeba
vichwa vinne ambavyo skripti ya Five9 husoma. Ongeza namba hii ya uhamisho (tazama
[Ongeza namba ya uhamisho](/sw/guides/contact-centers/overview)):

```json
{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
```

- `X-RouteType` na `X-RouteValue` huiambia skripti mahali pa kumtuma mpigaji,
  hapa ni ujuzi wa Support. Thamani ambazo watoa huduma wengine huandika kwa `X-RouteType` zinajumuisha
  `SkillTransfer`, `PhoneTransfer`, `Hangup` na `DispositionOnly`; kubaliana kuhusu
  thamani hizo na anayesimamia skripti. Kwa lengwa kadhaa, ongeza rejesho moja
  kwa kila lengwa lenye jina tofauti na `X-RouteValue`.
- `X-RouteReason` hubeba lebo ya nia ya ejenti, kama vile `billing_dispute`.
- `X-CustomMetaData` hubeba kitambulisho cha uhamisho. `BYE` pia hukibeba kama
  `X-TP-Handoff-Id`, ambacho Five9 haisomi.

Skripti ya Five9 huweka vichwa vinne kwenye vigezo vya simu. Kwa muhtasari wa
ejenti, iwezeshe skripti kuita utafutaji wa uhamisho kwa kutumia moduli ya IVR ya **Hoja**:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` ikifuatiwa na
`call.call_id`, kwa Wasifu wa Uidhinishaji unaotuma
`Authorization: Bearer` na ufunguo wako wa API. Tazama
[Tafuta simu iliyohamishwa](/api-reference/calls#look-up-a-handed-off-call).

## Ijaribu

Piga simu kwenye skripti ya IVR, mwombe ejenti akuhamishe kwa mtu, na uthibitishe kuwa skripti
inamwelekeza mpigaji huku vigezo vya simu vimejazwa. Ikiwa simu haimfikii kamwe
ejenti, thibitisha kuwa namba katika URI ya ombi na kichwa cha `To` inalingana na
namba ya kupiga, kwamba anwani chanzi ya Five9 iko katika `allowed_source_cidrs`, na
kwamba simu ilikuja kupitia TCP au TLS. Kisha fungua simu kwa
`GET /v1/calls/{call_id}`: `sip_headers` inapaswa kuorodhesha `x-callid`, na
`external_call_id` inapaswa kulingana na `call.call_id` katika Five9.

## Vikomo

- Mwongozo wa Five9 huandika data ya kuelekeza kwenye `BYE` na hautaji
  kukubali `REFER`, kwa hivyo urejeshaji ni uhamisho baridi unaofanywa na skripti.
- Five9 husoma `X-RouteType`, `X-RouteValue`, `X-RouteReason` na
  `X-CustomMetaData`, si `User-to-User`. ThunderPhone hutuma kila thamani ya kichwa
  yenye urefu wa hadi baiti 256.
- Five9 inapendekeza kuweka vichwa maalum karibu na kumi ili kuepuka mgawanyiko wa paketi.
