---
title: "Pripojenie z Five9"
description: "Odosielajte hovory z Five9 hlasovému agentovi ThunderPhone cez SIP pomocou AI Agent Connect a získajte ich späť so smerovacími hlavičkami, ktoré číta váš IVR skript."
---

Skript IVR vo Five9 odošle volajúceho k agentovi s údajmi o hovore z Five9. Keď hlasový agent skončí, ukončí hovor so smerovacími hlavičkami v SIP `BYE`, ktoré skript načíta do premenných hovoru na presmerovanie volajúceho.

## Skôr než začnete

- Agent ThunderPhone a [kľúč API](/sk/guides/api-keys) organizácie.
- Doplnok Five9 **Pripojenie AI agenta**. Five9 ho obmedzuje na poskytovateľov AI, ktorých schválil, a implementačný tím Five9 ho nastavuje: importuje šablónu skriptu IVR poskytovateľa, vytvorí premenné hovoru a nasmeruje modul skriptu **Prenos tretej strany** na poskytovateľa. ThunderPhone zatiaľ nie je na zozname schválených poskytovateľov Five9: pred plánovaním tejto integrácie sa obráťte na svoj tím pre účet Five9 alebo podporu ThunderPhone.

## 1. Vytvorte koncový bod SIP

Modul Five9 Prenos tretej strany vytáča telefónne číslo, nie adresu SIP, a integrácie Five9 iných poskytovateľov overujú Five9 podľa zdrojovej adresy namiesto hesla. Preto vytvorte koncový bod `ip_allowlist` s číslom, ktoré bude Five9 vytáčať, ako číslom pre prichádzajúce hovory (pozrite si
[Platformy, ktoré vytáčajú telefónne číslo](/sk/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`: rozsahy signalizácie SIP vašich dátových centier Five9, ktoré poskytne Five9. Každý musí byť verejný rozsah IPv4 s prefixom `/16` alebo dlhším (IPv6 `/48` alebo dlhším).
- `dial_in_numbers`: číslo, ktoré bude skript Five9 vytáčať, zapísané v podobe, v akej ho Five9 odosiela. Nemusí ísť o skutočné telefónne číslo. Nesmie sa už používať v ThunderPhone ako telefónne číslo ani v inom koncovom bode: v takom prípade sa vráti `409`.

Adresy Five9 zdieľajú všetci jeho zákazníci, takže každý iný zákazník Five9, ktorý vytočí toto číslo, sa dovolá vášmu agentovi. Pri výbere čísla zvoľte dlhé číslo, ktoré nikto neuhádne (až 15 číslic), uistite sa, že ho Five9 odosiela do ThunderPhone a nie do telefónnej siete, a nezverejňujte ho.

## 2. Odosielajte hovory s kontextom

Požiadajte implementačný tím Five9, aby:

- Odosielal hovor z modulu **Prenos tretej strany** na
  `sip:+14155550188@sip.thunderphone.com` s číslom v URI požiadavky aj v hlavičke `To`. Modul používa číslo s doménou SIP poskytovateľa v hlavičke.
- Odosielal ho cez TLS (port 5061) alebo TCP (port 5060). Koncový bod odmieta UDP a Five9 nezverejňuje, ktorý prenos používa, preto sa uistite, že nejde o UDP.
- Zapol **Návrat po volaní tretej strany**, aby skript pokračoval, keď agent ukončí hovor (Five9 povoľuje pri hovore tretej strany až 3 600 sekúnd).

Sprievodca Five9 uvádza hodnoty, ktoré odosiela (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` a ďalšie), nie názvy ich
hlavičiek. Integrácie Five9 iných poskytovateľov AI ich v prenose dokumentujú
ako `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
a `X-AgentID`; overte ich pri prvom testovacom hovore. Každá sa v prompte zobrazí ako premenná, napríklad
`{{sip_x_callcampaign}}`. `X-CallID` sa uloží ako
`external_call_id` hovoru.

## 3. Vráťte hovor

Agent hovor vráti: rozlúči sa a zavesí a `BYE` obsahuje
štyri hlavičky, ktoré skript Five9 číta. Pridajte toto číslo na presmerovanie (pozrite si
[Pridanie čísla na presmerovanie](/sk/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` a `X-RouteValue` skriptu určujú, kam má volajúceho odoslať,
  v tomto prípade do zručnosti Support. Medzi hodnoty pre `X-RouteType`, ktoré dokumentujú
  iní poskytovatelia, patria `SkillTransfer`, `PhoneTransfer`, `Hangup` a `DispositionOnly`; dohodnite
  hodnoty s osobou, ktorá spravuje skript. Pre viacero cieľov pridajte jedno
  vrátenie pre každý cieľ s iným názvom a `X-RouteValue`.
- `X-RouteReason` obsahuje štítok zámeru agenta, napríklad `billing_dispute`.
- `X-CustomMetaData` obsahuje identifikátor odovzdania. `BYE` ho obsahuje aj ako
  `X-TP-Handoff-Id`, ktorý Five9 nečíta.

Skript Five9 mapuje štyri hlavičky do premenných hovoru. Pre súhrn od
agenta nechajte skript zavolať vyhľadanie odovzdania pomocou modulu IVR **Dopyt**:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` nasledovaného
`call.call_id`, s profilom autorizácie, ktorý odosiela
`Authorization: Bearer` a váš kľúč API. Pozrite si
[Vyhľadanie odovzdaného hovoru](/api-reference/calls#look-up-a-handed-off-call).

## Otestujte to

Zavolajte do skriptu IVR, požiadajte agenta o spojenie s osobou a overte, že skript
smeruje volajúceho s vyplnenými premennými hovoru. Ak hovor nikdy nedorazí k
agentovi, overte, že číslo v identifikátore URI požiadavky a hlavičke `To` zodpovedá
číslu na vytáčanie, že zdrojová adresa Five9 je v `allowed_source_cidrs` a
že hovor prišiel cez TCP alebo TLS. Potom otvorte hovor pomocou
`GET /v1/calls/{call_id}`: `sip_headers` by mali obsahovať `x-callid` a
`external_call_id` by mal zodpovedať `call.call_id` vo Five9.

## Obmedzenia

- Príručka Five9 dokumentuje údaje o smerovaní v správe `BYE` a nespomína
  prijatie správy `REFER`, takže spätné odovzdanie je studené presmerovanie vykonané skriptom.
- Five9 číta `X-RouteType`, `X-RouteValue`, `X-RouteReason` a
  `X-CustomMetaData`, nie `User-to-User`. ThunderPhone odosiela každú hodnotu hlavičky
  s dĺžkou najviac 256 bajtov.
- Five9 odporúča ponechať počet vlastných hlavičiek približne na desiatich, aby sa predišlo
  fragmentácii paketov.
