---
title: "Savienojiet no Five9"
description: "Nosūtiet Five9 zvanus uz ThunderPhone balss aģentu, izmantojot SIP un AI Agent Connect, un saņemiet tos atpakaļ ar maršrutēšanas galvenēm, ko nolasa jūsu IVR skripts."
---

Jūsu Five9 IVR skripts nosūta zvanītāju pie aģenta kopā ar Five9 zvana
detalizēto informāciju. Kad aģents ir pabeidzis darbu, tas pārtrauc zvanu,
SIP `BYE` iekļaujot maršrutēšanas galvenes, kuras skripts nolasa zvana
mainīgajos, lai maršrutētu zvanītāju.

## Pirms sākat

- ThunderPhone aģents un organizācijas [API atslēga](/lv/guides/api-keys).
- Five9 **AI aģenta savienojuma** papildinājums. Five9 to ierobežo ar AI pakalpojumu sniedzējiem, kurus tas ir
  akreditējis, un Five9 ieviešanas komanda to iestata: tā importē
  pakalpojumu sniedzēja IVR skripta veidni, izveido zvana mainīgos un konfigurē
  skripta **Trešās puses pārsūtīšanas** moduli pakalpojumu sniedzējam. ThunderPhone vēl
  nav Five9 akreditēto pakalpojumu sniedzēju sarakstā: pirms plānojat to izmantot,
  jautājiet savai Five9 konta komandai vai ThunderPhone atbalsta dienestam.

## 1. Izveidojiet SIP galapunktu

Five9 Trešās puses pārsūtīšanas modulis izsauc tālruņa numuru, nevis SIP adresi,
un citu pakalpojumu sniedzēju Five9 integrācijas autentificē Five9 pēc avota adreses,
nevis paroles. Tāpēc izveidojiet `ip_allowlist` galapunktu ar numuru, kuru
Five9 izsauks, kā iezvanes numuru (skatiet
[Platformas, kas izsauc tālruņa numuru](/lv/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ūsu Five9 datu centru SIP signalizācijas diapazoni,
  ko nodrošina Five9. Katram jābūt publiskam IPv4 diapazonam ar `/16` vai šaurāku
  masku (IPv6 — `/48` vai šaurāku).
- `dial_in_numbers`: numurs, kuru Five9 skripts izsauks, rakstīts tā, kā to
  nosūta Five9. Tam nav jābūt reālam tālruņa numuram. To nedrīkst jau izmantot
  ThunderPhone — ne kā tālruņa numuru, ne citā galapunktā; pretējā gadījumā tiek atgriezts `409`.

Five9 adreses ir kopīgas visiem tā klientiem, tāpēc jebkurš cits Five9
klients, kurš izsauc šo numuru, sasniedz jūsu aģentu. Izvēloties numuru,
izvēlieties garu numuru, kuru neviens neuzminētu (līdz 15 cipariem), pārliecinieties,
ka Five9 to nosūta uz ThunderPhone, nevis tālruņu tīklu, un
nepublicējiet to.

## 2. Sūtiet zvanus ar kontekstu

Lūdziet Five9 ieviešanas komandai:

- Sūtīt zvanu no **Trešās puses pārsūtīšanas** moduļa uz
  `sip:+14155550188@sip.thunderphone.com`, numuru iekļaujot gan pieprasījuma
  URI, gan `To` galvenē. Modulis izmanto numuru ar pakalpojumu sniedzēja
  SIP domēnu galvenē.
- Sūtīt to, izmantojot TLS (ports 5061) vai TCP (ports 5060). Galapunkts atsaka UDP,
  un Five9 nepublicē, kuru transportu tas izmanto, tāpēc pārliecinieties, ka tas nav
  UDP.
- Ieslēgt **Atgriezties pēc trešās puses zvana**, lai skripts turpinātu darbu, kad
  aģents pārtrauc zvanu (Five9 trešās puses zvanam atļauj līdz 3 600 sekundēm).

Five9 ceļvedī ir norādītas vērtības, ko tas nosūta (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` un citas), nevis to
galveņu nosaukumi. Citu AI pakalpojumu sniedzēju Five9 integrācijas tās protokola līmenī
dokumentē kā `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
un `X-AgentID`; pārbaudiet tās savā pirmajā testa zvanā. Katra nonāk uzvednē kā mainīgais, piemēram,
`{{sip_x_callcampaign}}`. `X-CallID` tiek saglabāts kā zvana
`external_call_id`.

## 3. Saņemiet zvanu atpakaļ

Aģents atdod zvanu: tas atvadās un noliek klausuli, un `BYE` ietver
četras galvenes, ko nolasa Five9 skripts. Pievienojiet šo pārsūtīšanas numuru (skatiet
[Pievienojiet pārsūtīšanas numuru](/lv/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` un `X-RouteValue` norāda skriptam, kur nosūtīt zvanītāju —
  šajā gadījumā uz Support prasmi. Citu pakalpojumu sniedzēju dokumentētās `X-RouteType` vērtības ietver
  `SkillTransfer`, `PhoneTransfer`, `Hangup` un `DispositionOnly`; saskaņojiet
  vērtības ar personu, kas uztur skriptu. Vairākiem galamērķiem pievienojiet vienu
  atgriešanu katram galamērķim ar citu nosaukumu un `X-RouteValue`.
- `X-RouteReason` ietver aģenta nodoma etiķeti, piemēram, `billing_dispute`.
- `X-CustomMetaData` ietver nodošanas ID. `BYE` to ietver arī kā
  `X-TP-Handoff-Id`, ko Five9 nenolasa.

Five9 skripts kartē četras galvenes uz zvana mainīgajiem. Lai iegūtu aģenta
kopsavilkumu, lieciet skriptam izsaukt nodošanas meklēšanu ar IVR **Vaicājuma** moduli:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` kam seko
`call.call_id`, izmantojot autorizācijas profilu, kas nosūta
`Authorization: Bearer` un jūsu API atslēgu. Skatiet
[Meklējiet nodotu zvanu](/api-reference/calls#look-up-a-handed-off-call).

## Testējiet

Piezvaniet uz IVR skriptu, palūdziet aģentam savienot ar personu un pārbaudiet, vai skripts
maršrutē zvanītāju ar aizpildītiem zvana mainīgajiem. Ja zvans nekad nenonāk pie
aģenta, pārbaudiet, vai numurs pieprasījuma URI un `To` galvenē atbilst
iezvanes numuram, vai Five9 avota adrese ir iekļauta `allowed_source_cidrs` un
vai zvans tika veikts, izmantojot TCP vai TLS. Pēc tam atveriet zvanu ar
`GET /v1/calls/{call_id}`: `sip_headers` jānorāda `x-callid`, un
`external_call_id` jāatbilst Five9 `call.call_id`.

## Ierobežojumi

- Five9 ceļvedī ir dokumentēti maršrutēšanas dati `BYE` ziņojumā, bet nav minēta
  `REFER` pieņemšana, tāpēc atdošana ir skripta veikta aukstā pārsūtīšana.
- Five9 nolasa `X-RouteType`, `X-RouteValue`, `X-RouteReason` un
  `X-CustomMetaData`, nevis `User-to-User`. ThunderPhone katras galvenes vērtību
  nosūta ne garāku par 256 baitiem.
- Five9 iesaka saglabāt pielāgoto galveņu skaitu apmēram līdz desmit, lai izvairītos no pakešu
  fragmentācijas.
