---
title: "Povežite se iz Five9"
description: "Šaljite Five9 pozive glasovnom agentu ThunderPhone putem SIP-a uz AI Agent Connect i primajte ih natrag sa zaglavljima za usmjeravanje koja čita vaša IVR skripta."
---

Vaša Five9 IVR skripta šalje pozivatelja glasovnom agentu zajedno s Five9
detaljima poziva. Kada glasovni agent završi, prekida poziv sa zaglavljima za
usmjeravanje u SIP poruci `BYE`, koja skripta čita u varijable poziva radi
usmjeravanja pozivatelja.

## Prije početka

- ThunderPhone glasovni agent i organizacijski [API ključ](/hr/guides/api-keys).
- Five9 dodatak **AI Agent Connect**. Five9 ga ograničava na akreditirane
  pružatelje AI usluga, a Five9 implementacijski tim ga postavlja: uvozi
  predložak IVR skripte pružatelja, stvara varijable poziva i usmjerava modul
  skripte **Prijenos trećoj strani** na pružatelja. ThunderPhone još nije na
  Five9 popisu akreditiranih pružatelja: obratite se svojem Five9 timskom
  računu ili ThunderPhone podršci prije nego što ga uključite u svoje planove.

## 1. Izradite SIP krajnju točku

Five9 modul za prijenos trećoj strani bira telefonski broj, a ne SIP adresu,
a Five9 integracije drugih pružatelja provjeravaju autentičnost Five9 prema
izvornoj adresi, a ne lozinkom. Zato izradite krajnju točku `ip_allowlist` s
brojem koji će Five9 birati kao brojem za dolazne pozive (pogledajte
[Platforme koje biraju telefonski broj](/hr/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`: rasponi SIP signalizacije vaših Five9 podatkovnih
  centara, koje dobivate od Five9. Svaki mora biti javni IPv4 raspon `/16` ili
  uži (IPv6 `/48` ili uži).
- `dial_in_numbers`: broj koji će Five9 skripta birati, zapisan onako kako ga
  Five9 šalje. Ne mora biti stvarni telefonski broj. Ne smije se već koristiti
  u ThunderPhoneu, kao telefonski broj ili na drugoj krajnjoj točki: u tom se
  slučaju vraća `409`.

Five9 adrese zajedničke su svim njegovim korisnicima, pa svaki drugi Five9
korisnik koji bira taj broj dolazi do vašeg glasovnog agenta. Kada birate
broj, odaberite dugačak broj koji nitko ne bi pogodio (do 15 znamenki),
provjerite šalje li ga Five9 u ThunderPhone, a ne u telefonsku mrežu, i nemojte
ga objavljivati.

## 2. Šaljite pozive s kontekstom

Zatražite od Five9 implementacijskog tima da:

- Pošalje poziv iz modula **Prijenos trećoj strani** na
  `sip:+14155550188@sip.thunderphone.com`, s brojem i u URI-ju zahtjeva i u
  zaglavlju `To`. Modul preuzima broj, dok se SIP domena pružatelja nalazi u
  zaglavlju.
- Pošalje ga putem TLS-a (priključak 5061) ili TCP-a (priključak 5060).
  Krajnja točka odbija UDP, a Five9 ne objavljuje koji prijenos koristi, pa
  provjerite da nije UDP.
- Uključi **Povratak nakon poziva trećoj strani**, kako bi se skripta nastavila
  kada glasovni agent prekine poziv (Five9 dopušta do 3.600 sekundi za poziv
  trećoj strani).

Five9 vodič navodi vrijednosti koje šalje (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` i druge), ali ne i
nazive njihovih zaglavlja. Five9 integracije drugih pružatelja AI usluga ih u
SIP prometu dokumentiraju kao `X-CallANI`, `X-CallDNIS`, `X-CallID`,
`X-CallSessionID`, `X-CallCampaign` i `X-AgentID`; provjerite ih pri prvom
testnom pozivu. Svaka dolazi do prompta kao varijabla, primjerice
`{{sip_x_callcampaign}}`. `X-CallID` se pohranjuje kao
`external_call_id` poziva.

## 3. Vratite poziv

Agent vraća poziv: pozdravlja se i prekida vezu, a `BYE` sadrži
četiri zaglavlja koja čita skripta Five9. Dodajte ovaj broj za preusmjeravanje (pogledajte
[Dodajte broj za preusmjeravanje](/hr/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` i `X-RouteValue` skripti određuju kamo usmjeriti pozivatelja,
  u ovom slučaju na vještinu Support. Vrijednosti za `X-RouteType` koje dokumentiraju
  drugi pružatelji uključuju `SkillTransfer`, `PhoneTransfer`, `Hangup` i
  `DispositionOnly`; dogovorite vrijednosti s osobom koja održava skriptu. Za više
  odredišta dodajte po jedan povratni prijenos za svako odredište s drugim nazivom
  i `X-RouteValue`.
- `X-RouteReason` sadrži oznaku namjere agenta, kao što je `billing_dispute`.
- `X-CustomMetaData` sadrži ID predaje. `BYE` ga također sadrži kao
  `X-TP-Handoff-Id`, koji Five9 ne čita.

Skripta Five9 preslikava četiri zaglavlja u varijable poziva. Za sažetak
agenta neka skripta pozove dohvat podataka o predaji pomoću modula IVR **Upit**:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` nakon čega slijedi
`call.call_id`, s profilom autorizacije koji šalje
`Authorization: Bearer` i vaš API ključ. Pogledajte
[Dohvat predanog poziva](/api-reference/calls#look-up-a-handed-off-call).

## Testirajte

Nazovite IVR skriptu, zatražite od agenta razgovor s osobom i provjerite
usmjerava li skripta pozivatelja s popunjenim varijablama poziva. Ako poziv nikada ne stigne do
agenta, provjerite odgovara li broj u URI-ju zahtjeva i zaglavlju `To` broju za biranje,
nalazi li se izvorna adresa Five9 u `allowed_source_cidrs` i
je li poziv stigao putem TCP-a ili TLS-a. Zatim otvorite poziv pomoću
`GET /v1/calls/{call_id}`: `sip_headers` trebao bi navesti `x-callid`, a
`external_call_id` trebao bi odgovarati vrijednosti `call.call_id` u Five9.

## Ograničenja

- Vodič za Five9 dokumentira podatke o usmjeravanju u poruci `BYE` i ne spominje
  prihvaćanje poruke `REFER`, pa je povratni prijenos hladno preusmjeravanje koje izvršava skripta.
- Five9 čita `X-RouteType`, `X-RouteValue`, `X-RouteReason` i
  `X-CustomMetaData`, a ne `User-to-User`. ThunderPhone šalje svaku vrijednost zaglavlja
  duljine najviše 256 bajtova.
- Five9 preporučuje zadržati broj prilagođenih zaglavlja na otprilike deset kako bi se izbjegla
  fragmentacija paketa.
