---
title: "Připojení z Five9"
description: "Odesílejte hovory z Five9 hlasovému agentovi ThunderPhone přes SIP pomocí AI Agent Connect a získávejte je zpět se směrovacími hlavičkami, které čte váš skript IVR."
---

Váš skript IVR ve Five9 předá volajícího hlasovému agentovi spolu s podrobnostmi hovoru z Five9. Když hlasový agent skončí, zavěsí s hlavičkami směrování v SIP
`BYE`, které skript načte do proměnných hovoru pro směrování volajícího.

## Než začnete

- Agent ThunderPhone a [klíč API](/cs/guides/api-keys) organizace.
- Doplněk Five9 **Připojení AI agenta**. Five9 jej omezuje na poskytovatele AI, které akreditoval, a jeho implementační tým jej nastavuje: importuje šablonu skriptu IVR poskytovatele, vytvoří proměnné hovoru a nasměruje modul skriptu **Přenos třetí straně** na poskytovatele. ThunderPhone zatím není na seznamu akreditovaných poskytovatelů Five9: než s tím začnete počítat, obraťte se na svůj tým pro účet Five9 nebo podporu ThunderPhone.

## 1. Vytvořte koncový bod SIP

Modul Five9 pro přenos třetí straně vytáčí telefonní číslo, nikoli adresu SIP,
a integrace Five9 jiných poskytovatelů ověřují Five9 podle zdrojové adresy
namísto hesla. Vytvořte proto koncový bod `ip_allowlist` s číslem, které bude
Five9 vytáčet, jako číslem pro příchozí volání (viz
[Platformy, které vytáčejí telefonní číslo](/cs/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 signalizace SIP datových center Five9, které získáte od Five9. Každý musí být veřejný rozsah IPv4 o velikosti `/16` nebo menší
  (IPv6 `/48` nebo menší).
- `dial_in_numbers`: číslo, které bude vytáčet skript Five9, zapsané způsobem,
  jakým jej Five9 odesílá. Nemusí jít o skutečné telefonní číslo. Nesmí být již
  používáno v ThunderPhone, ani jako telefonní číslo, ani na jiném koncovém bodu: vrátí se `409`.

Adresy Five9 sdílejí všichni jeho zákazníci, takže jakýkoli jiný zákazník Five9,
který toto číslo vytočí, se spojí s vaším hlasovým agentem. Při volbě čísla
zvolte dlouhé číslo, které nikdo neuhodne (až 15 číslic), zajistěte, aby ho
Five9 odesílal do ThunderPhone místo do telefonní sítě, a nezveřejňujte ho.

## 2. Odesílejte hovory s kontextem

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

- Odesílal hovor z modulu **Přenos třetí straně** na
  `sip:+14155550188@sip.thunderphone.com`, přičemž číslo uvede v URI požadavku
  i v hlavičce `To`. Modul používá číslo s doménou SIP poskytovatele v hlavičce.
- Odesílal jej přes TLS (port 5061) nebo TCP (port 5060). Koncový bod odmítá UDP
  a Five9 neuvádí, jaký transport používá, proto ověřte, že nejde o UDP.
- Zapnul **Návrat po volání třetí strany**, aby skript pokračoval po zavěšení
  hlasového agenta (Five9 umožňuje u hovoru třetí strany až 3 600 sekund).

Průvodce Five9 uvádí hodnoty, které odesílá (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` a další), nikoli názvy
jejich hlaviček. Integrace Five9 jiných poskytovatelů AI je v signalizaci
dokumentují jako `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`,
`X-CallCampaign` a `X-AgentID`; ověřte je při prvním testovacím hovoru. Každá
se do promptu dostane jako proměnná, například
`{{sip_x_callcampaign}}`. `X-CallID` se ukládá jako
`external_call_id` hovoru.

## 3. Vraťte hovor zpět

Agent hovor vrátí: rozloučí se a zavěsí, přičemž zpráva `BYE` obsahuje čtyři hlavičky, které skript Five9 čte. Přidejte toto číslo pro přesměrování (viz [Přidání čísla pro přesměrování](/cs/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` určují skriptu, kam má volajícího odeslat, zde na dovednost Support. Mezi hodnoty pro `X-RouteType`, které dokumentují jiní poskytovatelé, patří `SkillTransfer`, `PhoneTransfer`, `Hangup` a `DispositionOnly`; hodnoty si odsouhlaste s osobou, která skript spravuje. Pro několik cílů přidejte pro každý cíl jedno vrácení s jiným názvem a `X-RouteValue`.
- `X-RouteReason` obsahuje štítek záměru agenta, například `billing_dispute`.
- `X-CustomMetaData` obsahuje ID předání. Zpráva `BYE` jej také obsahuje jako `X-TP-Handoff-Id`, které Five9 nečte.

Skript Five9 namapuje čtyři hlavičky do proměnných hovoru. Pro shrnutí agenta nechte skript zavolat vyhledání předání pomocí modulu IVR **Dotaz**:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` následovaného
`call.call_id`, s profilem autorizace, který odesílá
`Authorization: Bearer` a váš klíč API. Viz
[Vyhledání předaného hovoru](/api-reference/calls#look-up-a-handed-off-call).

## Otestujte to

Zavolejte do skriptu IVR, požádejte agenta o spojení s osobou a ověřte, že skript směruje volajícího s vyplněnými proměnnými hovoru. Pokud hovor nikdy nedorazí k agentovi, ověřte, že číslo v URI požadavku a hlavičce `To` odpovídá číslu pro příchozí hovory, že zdrojová adresa Five9 je v `allowed_source_cidrs` a že hovor přišel přes TCP nebo TLS. Poté otevřete hovor pomocí
`GET /v1/calls/{call_id}`: `sip_headers` by mělo uvádět `x-callid` a
`external_call_id` by mělo odpovídat `call.call_id` ve Five9.

## Omezení

- Průvodce Five9 dokumentuje data směrování v `BYE` a nezmiňuje přijímání `REFER`, takže zpětné předání je studený přenos provedený skriptem.
- Five9 čte `X-RouteType`, `X-RouteValue`, `X-RouteReason` a
  `X-CustomMetaData`, nikoli `User-to-User`. ThunderPhone odesílá každou hodnotu hlavičky v délce maximálně 256 bajtů.
- Five9 doporučuje ponechat počet vlastních hlaviček přibližně na deseti, aby nedošlo k fragmentaci paketů.
