---
title: "Prisijunkite iš Five9"
description: "Siųskite Five9 skambučius ThunderPhone agentui per SIP naudodami AI Agent Connect ir grąžinkite juos su maršruto parinkimo antraštėmis, kurias nuskaito jūsų IVR scenarijus."
---

Jūsų Five9 IVR scenarijus siunčia skambinantįjį agentui kartu su Five9 skambučio
informacija. Kai agentas baigia darbą, jis nutraukia skambutį ir SIP
`BYE` pranešime pateikia maršruto parinkimo antraštes, kurias scenarijus
nuskaito į skambučio kintamuosius, kad nukreiptų skambinantįjį.

## Prieš pradedant

- ThunderPhone agentas ir organizacijos [API raktas](/lt/guides/api-keys).
- Five9 **AI Agent Connect** priedas. Five9 jį riboja tik savo
  akredituotais DI paslaugų teikėjais, o Five9 diegimo komanda jį sukonfigūruoja:
  importuoja paslaugų teikėjo IVR scenarijaus šabloną, sukuria skambučio
  kintamuosius ir scenarijaus modulį **Trečiosios šalies perdavimas** nukreipia
  į paslaugų teikėją. ThunderPhone dar nėra Five9 akredituotų paslaugų teikėjų
  sąraše: prieš planuodami jo naudojimą kreipkitės į savo Five9 paskyros komandą
  arba ThunderPhone palaikymo tarnybą.

## 1. Sukurkite SIP galinį tašką

Five9 modulis „Trečiosios šalies perdavimas“ renka telefono numerį, o ne SIP adresą,
o kitų paslaugų teikėjų Five9 integracijos autentifikuoja Five9 pagal šaltinio adresą,
o ne slaptažodį. Todėl sukurkite `ip_allowlist` galinį tašką, kuriame numeris,
kuriuo skambins Five9, būtų nurodytas kaip prisijungimo numeris (žr.
[Platformos, kurios renka telefono numerį](/lt/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`: jūsų Five9 duomenų centrų SIP signalizavimo diapazonai,
  kuriuos pateikia Five9. Kiekvienas turi būti viešas `/16` arba siauresnis IPv4
  diapazonas (IPv6 `/48` arba siauresnis).
- `dial_in_numbers`: numeris, kurį rinks Five9 scenarijus, užrašytas taip,
  kaip jį siunčia Five9. Jis neprivalo būti tikras telefono numeris. Jis negali
  būti jau naudojamas ThunderPhone kaip telefono numeris arba kitame galiniame
  taške: tokiu atveju grąžinamas `409`.

Five9 adresais dalijasi visi jos klientai, todėl bet kuris kitas Five9
klientas, surinkęs šį numerį, pasieks jūsų agentą. Rinkdamiesi numerį pasirinkite
ilgą numerį, kurio niekas neatspėtų (iki 15 skaitmenų), įsitikinkite, kad
Five9 siunčia jį į ThunderPhone, o ne į telefono tinklą, ir jo neskelbkite.

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

Paprašykite Five9 diegimo komandos:

- Siųsti skambutį iš modulio **Trečiosios šalies perdavimas** į
  `sip:+14155550188@sip.thunderphone.com`, numerį nurodant ir užklausos
  URI, ir `To` antraštėje. Modulis naudoja numerį, o paslaugų teikėjo
  SIP domeną pateikia antraštėje.
- Siųsti per TLS (5061 prievadas) arba TCP (5060 prievadas). Galinis taškas
  atmeta UDP, o Five9 neskelbia, kokį transportą naudoja, todėl įsitikinkite,
  kad tai nėra UDP.
- Įjungti **Grįžti po trečiosios šalies skambučio**, kad scenarijus būtų
  tęsiamas, kai agentas nutraukia skambutį (Five9 trečiosios šalies skambučiui
  leidžia iki 3 600 sekundžių).

Five9 vadove pateikiamos siunčiamos reikšmės (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` ir kitos), bet ne jų
antraščių pavadinimai. Kitų DI paslaugų teikėjų Five9 integracijose jos
perduodamos kaip `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`,
`X-CallCampaign` ir `X-AgentID`; patikrinkite jas per pirmąjį bandomąjį skambutį.
Kiekviena jų pasiekia raginimą kaip kintamasis, pavyzdžiui,
`{{sip_x_callcampaign}}`. `X-CallID` išsaugomas kaip skambučio
`external_call_id`.

## 3. Grąžinkite skambutį

Agentas grąžina skambutį: atsisveikina ir nutraukia pokalbį, o `BYE` perduoda
keturias antraštes, kurias nuskaito Five9 scenarijus. Pridėkite šį perdavimo numerį (žr.
[Pridėkite perdavimo numerį](/lt/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` ir `X-RouteValue` nurodo scenarijui, kur nukreipti skambinantįjį,
  šiuo atveju į Support kompetenciją. Kiti teikėjai `X-RouteType` reikšmėms dokumentuoja
  `SkillTransfer`, `PhoneTransfer`, `Hangup` ir `DispositionOnly`; suderinkite
  reikšmes su asmeniu, kuris prižiūri scenarijų. Jei yra kelios paskirtys, kiekvienai
  paskirčiai pridėkite po vieną grąžinimo veiksmą su skirtingu pavadinimu ir `X-RouteValue`.
- `X-RouteReason` perduoda agento ketinimo žymą, pvz., `billing_dispute`.
- `X-CustomMetaData` perduoda perdavimo ID. `BYE` jį taip pat perduoda kaip
  `X-TP-Handoff-Id`, kurio Five9 nenuskaito.

Five9 scenarijus susieja keturias antraštes su skambučio kintamaisiais. Kad gautumėte
agento suvestinę, nurodykite scenarijui iškviesti perdavimo paiešką naudojant IVR **Užklausa** modulį:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` po kurio nurodomas
`call.call_id`, naudojant autorizacijos profilį, kuris siunčia
`Authorization: Bearer` ir jūsų API raktą. Žr.
[Perduoto skambučio paieška](/api-reference/calls#look-up-a-handed-off-call).

## Išbandykite

Paskambinkite į IVR scenarijų, paprašykite agento sujungti su žmogumi ir patikrinkite,
ar scenarijus nukreipia skambinantįjį su užpildytais skambučio kintamaisiais. Jei skambutis
niekada nepasiekia agento, patikrinkite, ar užklausos URI ir `To` antraštėje nurodytas numeris
sutampa su įeinančių skambučių numeriu, ar Five9 šaltinio adresas yra `allowed_source_cidrs`,
ir ar skambutis atėjo per TCP arba TLS. Tada atidarykite skambutį naudodami
`GET /v1/calls/{call_id}`: `sip_headers` turėtų būti nurodyta `x-callid`, o
`external_call_id` turėtų sutapti su Five9 `call.call_id`.

## Apribojimai

- Five9 vadove maršruto duomenys dokumentuojami `BYE` pranešime ir neminima,
  kad priimamas `REFER`, todėl atgalinis perdavimas yra scenarijaus atliekamas šaltas perdavimas.
- Five9 nuskaito `X-RouteType`, `X-RouteValue`, `X-RouteReason` ir
  `X-CustomMetaData`, bet ne `User-to-User`. ThunderPhone siunčia kiekvienos antraštės reikšmę,
  kurios ilgis neviršija 256 baitų.
- Five9 rekomenduoja naudoti maždaug iki dešimties pasirinktinių antraščių, kad būtų išvengta paketų
  fragmentavimo.
