---
title: "Povežite iz Five9"
description: "Pošljite klice Five9 glasovnemu agentu ThunderPhone prek SIP z AI Agent Connect in jih prejemajte nazaj z usmerjevalnimi glavami, ki jih bere vaš skript IVR."
---

Vaš skript IVR Five9 klicatelja pošlje agentu s podrobnostmi klica Five9. Ko agent konča, prekine klic z glavami za usmerjanje v SIP `BYE`, ki jih skript prebere v spremenljivke klica za usmerjanje klicatelja.

## Preden začnete

- Agent ThunderPhone in organizacijski [ključ API](/sl/guides/api-keys).
- Dodatek Five9 **AI Agent Connect**. Five9 ga omejuje na ponudnike umetne inteligence, ki jih je odobril, njegova implementacijska ekipa Five9 pa ga nastavi: uvozi predlogo skripta IVR ponudnika, ustvari spremenljivke klica in modul skripta **Prenos tretji osebi** usmeri na ponudnika. ThunderPhone še ni na seznamu odobrenih ponudnikov Five9: preden se zanesete nanj, se obrnite na svojo ekipo za račun Five9 ali podporo ThunderPhone.

## 1. Ustvarite končno točko SIP

Modul Five9 za prenos tretji osebi kliče telefonsko številko, ne naslova SIP, integracije Five9 drugih ponudnikov pa Five9 preverjajo z izvornim naslovom namesto z geslom. Zato ustvarite končno točko `ip_allowlist` s številko, ki jo bo Five9 klical, kot številko za dohodne klice (glejte
[Platforme, ki kličejo telefonsko številko](/sl/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`: signalni obsegi SIP vaših podatkovnih centrov Five9, ki jih zagotovi Five9. Vsak mora biti javni obseg IPv4 `/16` ali ožji (IPv6 `/48` ali ožji).
- `dial_in_numbers`: številka, ki jo bo klical skript Five9, zapisana tako, kot jo pošlje Five9. Ni nujno, da je prava telefonska številka. Ne sme biti že uporabljena v ThunderPhone, kot telefonska številka ali na drugi končni točki: v tem primeru se vrne `409`.

Naslove Five9 si delijo vse njegove stranke, zato vsak drug uporabnik Five9, ki pokliče številko, doseže vašega agenta. Pri izbiri številke izberite dolgo številko, ki je nihče ne bi uganil (do 15 mest), zagotovite, da jo Five9 pošlje v ThunderPhone namesto v telefonsko omrežje, in je ne objavite.

## 2. Pošljite klice s kontekstom

Implementacijsko ekipo Five9 prosite, naj:

- Klic iz modula **Prenos tretji osebi** pošlje na
  `sip:+14155550188@sip.thunderphone.com`, pri čemer naj bo številka v URI zahteve in glavi `To`. Modul uporabi številko z domeno SIP ponudnika v glavi.
- Klic pošlje prek TLS (vrata 5061) ali TCP (vrata 5060). Končna točka zavrača UDP, Five9 pa ne objavlja, kateri prenos uporablja, zato preverite, da ne uporablja UDP.
- Vklopi **Vrni se po klicu tretji osebi**, da se skript nadaljuje, ko agent prekine klic (Five9 pri klicu tretji osebi omogoča do 3.600 sekund).

Vodnik Five9 navaja vrednosti, ki jih pošilja (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` in druge), ne pa imen njihovih glav. Integracije Five9 drugih ponudnikov umetne inteligence jih v prenosu dokumentirajo kot `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
in `X-AgentID`; preverite jih pri prvem testnem klicu. Vsaka se v pozivu prikaže kot spremenljivka, na primer
`{{sip_x_callcampaign}}`. `X-CallID` je shranjen kot
`external_call_id` klica.

## 3. Vrnitev klica

Agent vrne klic: poslovi se in prekine povezavo, `BYE` pa vsebuje
štiri glave, ki jih prebere skript Five9. Dodajte to številko za prenos (glejte
[Dodajte številko za prenos](/sl/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` in `X-RouteValue` skriptu povesta, kam naj usmeri klicatelja,
  v tem primeru na veščino Support. Vrednosti za `X-RouteType`, ki jih dokumentirajo
  drugi ponudniki, vključujejo `SkillTransfer`, `PhoneTransfer`, `Hangup` in
  `DispositionOnly`; vrednosti uskladite z osebo, ki vzdržuje skript. Za več
  ciljev dodajte po eno vrnitev za vsak cilj z drugim imenom in `X-RouteValue`.
- `X-RouteReason` vsebuje oznako namena agenta, na primer `billing_dispute`.
- `X-CustomMetaData` vsebuje ID predaje. `BYE` ga vsebuje tudi kot
  `X-TP-Handoff-Id`, česar Five9 ne bere.

Skript Five9 preslika štiri glave v spremenljivke klica. Za povzetek agenta
naj skript z modulom IVR **Poizvedba** pokliče iskanje predaje:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` čemur sledi
`call.call_id`, s profilom avtorizacije, ki pošlje
`Authorization: Bearer` in vaš ključ API. Glejte
[Iskanje predanega klica](/api-reference/calls#look-up-a-handed-off-call).

## Preizkusite

Pokličite skript IVR, agenta prosite za osebo in preverite, ali skript
usmeri klicatelja z izpolnjenimi spremenljivkami klica. Če klic nikoli ne doseže
agenta, preverite, ali se številka v URI-ju zahteve in glavi `To` ujema s
številko za klicanje, ali je izvorni naslov Five9 v `allowed_source_cidrs` in
ali je klic prišel prek TCP ali TLS. Nato odprite klic z
`GET /v1/calls/{call_id}`: `sip_headers` mora navesti `x-callid`, vrednost
`external_call_id` pa se mora ujemati z `call.call_id` v Five9.

## Omejitve

- Vodnik Five9 dokumentira podatke za usmerjanje v `BYE` in ne omenja
  sprejemanja `REFER`, zato skript predajo nazaj izvede kot hladni prenos.
- Five9 bere `X-RouteType`, `X-RouteValue`, `X-RouteReason` in
  `X-CustomMetaData`, ne pa `User-to-User`. ThunderPhone pošlje posamezno
  vrednost glave, dolgo največ 256 bajtov.
- Five9 priporoča, da zaradi preprečevanja fragmentacije paketov ohranite
  število glav po meri na približno deset.
