---
title: "Yhdistä Five9:stä"
description: "Lähetä Five9-puhelut ThunderPhone-agentille SIP:n kautta AI Agent Connectilla ja palauta ne reititysotsakkeilla, joita IVR-skriptisi lukee."
---

Five9:n IVR-komentosarja ohjaa soittajan agentille Five9:n puhelutietojen kanssa. Kun agentti on valmis, se katkaisee puhelun SIP-`BYE`-viestin reititysotsakkeilla, jotka komentosarja lukee puhelumuuttujiin soittajan reitittämistä varten.

## Ennen kuin aloitat

- ThunderPhone-agentti ja organisaation [API-avain](/fi/guides/api-keys).
- Five9:n **AI Agent Connect** -lisäosa. Five9 rajoittaa sen tekoälypalveluntarjoajiin, jotka se on hyväksynyt, ja Five9:n käyttöönottotiimi määrittää sen: se tuo palveluntarjoajan IVR-komentosarjamallin, luo puhelumuuttujat ja ohjaa komentosarjan **Kolmannen osapuolen siirto** -moduulin palveluntarjoajalle. ThunderPhone ei ole vielä Five9:n hyväksyttyjen palveluntarjoajien luettelossa: kysy Five9-asiakastiimiltäsi tai ThunderPhone-tuesta ennen kuin suunnittelet sen varaan.

## 1. Luo SIP-päätepiste

Five9:n Kolmannen osapuolen siirto -moduuli soittaa puhelinnumeroon, ei SIP-osoitteeseen, ja muiden palveluntarjoajien Five9-integraatiot todentavat Five9:n lähdeosoitteen eikä salasanan perusteella. Luo siis `ip_allowlist`-päätepiste ja määritä numero, johon Five9 soittaa, sisääntulonumeroksi (katso
[Alustat, jotka soittavat puhelinnumeroon](/fi/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`: Five9:ltä saadut Five9-datakeskustesi SIP-signalointialueet. Jokaisen on oltava julkinen IPv4-alue, jonka maski on `/16` tai tarkempi (IPv6: `/48` tai tarkempi).
- `dial_in_numbers`: numero, johon Five9:n komentosarja soittaa, Five9:n lähettämässä muodossa. Sen ei tarvitse olla oikea puhelinnumero. Se ei voi olla jo käytössä ThunderPhonessa puhelinnumerona tai toisessa päätepisteessä: tällöin palautetaan `409`.

Five9:n osoitteet ovat kaikkien sen asiakkaiden yhteiskäytössä, joten kuka tahansa muu Five9-asiakas, joka soittaa numeroon, pääsee agentillesi. Kun valitset numeron, valitse pitkä numero, jota kukaan ei arvaisi (enintään 15 numeroa), varmista, että Five9 lähettää sen ThunderPhonelle eikä puhelinverkkoon, äläkä julkaise sitä.

## 2. Lähetä puhelut kontekstin kanssa

Pyydä Five9:n käyttöönottotiimiä:

- Lähettämään puhelu **Kolmannen osapuolen siirto** -moduulista osoitteeseen
  `sip:+14155550188@sip.thunderphone.com` siten, että numero on sekä pyyntö-URI:ssa että `To`-otsakkeessa. Moduuli ottaa numeron vastaan palveluntarjoajan SIP-verkkotunnuksen ollessa otsakkeessa.
- Lähettämään se TLS:n (portti 5061) tai TCP:n (portti 5060) kautta. Päätepiste hylkää UDP:n, eikä Five9 julkaise käyttämäänsä siirtotapaa, joten varmista, ettei se ole UDP.
- Ottamaan käyttöön **Palaa kolmannen osapuolen puhelun jälkeen**, jotta komentosarja jatkuu, kun agentti katkaisee puhelun (Five9 sallii kolmannen osapuolen puhelulle enintään 3 600 sekuntia).

Five9:n ohjeessa luetellaan sen lähettämät arvot (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` ja muut), mutta ei niiden
otsakenimiä. Muiden tekoälypalveluntarjoajien Five9-integraatioissa ne on dokumentoitu siirrettäviksi muodossa
`X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
ja `X-AgentID`; tarkista ne ensimmäisessä testipuhelussasi. Kukin välittyy kehotteeseen muuttujana, kuten
`{{sip_x_callcampaign}}`. `X-CallID` tallennetaan puhelun
`external_call_id`-tunnukseksi.

## 3. Palauta puhelu

Agentti palauttaa puhelun: se sanoo hyvästit ja katkaisee puhelun, ja `BYE` sisältää
neljä otsaketta, jotka Five9:n skripti lukee. Lisää tämä siirtonumero (katso
[Lisää siirtonumero](/fi/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` ja `X-RouteValue` kertovat skriptille, minne soittaja ohjataan,
  tässä tapauksessa Support-taitoon. Muut palveluntarjoajat dokumentoivat `X-RouteType`-arvolle
  esimerkiksi `SkillTransfer`, `PhoneTransfer`, `Hangup` ja `DispositionOnly`; sovi
  arvoista skriptiä ylläpitävän henkilön kanssa. Jos kohteita on useita, lisää yksi
  palautus kohdetta kohden eri nimellä ja `X-RouteValue`-arvolla.
- `X-RouteReason` sisältää agentin tarkoitustunnisteen, kuten `billing_dispute`.
- `X-CustomMetaData` sisältää luovutuksen tunnuksen. `BYE` sisältää sen myös muodossa
  `X-TP-Handoff-Id`, jota Five9 ei lue.

Five9:n skripti yhdistää neljä otsaketta puhelumuuttujiin. Agentin
yhteenvedon hakemista varten määritä skripti kutsumaan luovutushakua IVR:n **Kysely**-moduulilla:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` ja sen perään
`call.call_id`, sekä Authorization Profile -profiililla, joka lähettää
`Authorization: Bearer`-otsakkeen ja API-avaimesi. Katso
[Hae luovutettu puhelu](/api-reference/calls#look-up-a-handed-off-call).

## Testaa

Soita IVR-skriptiin, pyydä agentilta henkilöä ja tarkista, että skripti
reitittää soittajan täytetyillä puhelumuuttujilla. Jos puhelu ei koskaan saavu
agentille, tarkista, että pyyntö-URI:n ja `To`-otsakkeen numero vastaa
soittonumeroa, että Five9:n lähdeosoite on `allowed_source_cidrs`-asetuksessa ja
että puhelu saapui TCP:n tai TLS:n kautta. Avaa sitten puhelu kutsulla
`GET /v1/calls/{call_id}`: `sip_headers`-kohdassa pitäisi näkyä `x-callid`, ja
`external_call_id`-arvon pitäisi vastata Five9:n `call.call_id`-arvoa.

## Rajoitukset

- Five9:n ohje dokumentoi reititystiedot `BYE`-viestissä eikä mainitse
  `REFER`-viestin hyväksymistä, joten palautus on skriptin tekemä kylmä siirto.
- Five9 lukee `X-RouteType`, `X-RouteValue`, `X-RouteReason` ja
  `X-CustomMetaData` -otsakkeet, ei `User-to-User`-otsaketta. ThunderPhone lähettää
  kunkin otsakearvon enintään 256 tavun pituisena.
- Five9 suosittelee pitämään mukautettujen otsakkeiden määrän noin kymmenessä
  pakettien pirstoutumisen välttämiseksi.
