---
title: "Opret forbindelse fra Five9"
description: "Send Five9-opkald til en ThunderPhone-agent via SIP med AI Agent Connect, og få dem tilbage med routing-headere, som dit IVR-script læser."
---

Dit Five9-IVR-script sender opkalderen til agenten med Five9s
opkaldsoplysninger. Når agenten er færdig, afslutter den opkaldet med routingheadere i SIP
`BYE`, som scriptet læser ind i opkaldsvariabler for at dirigere opkalderen.

## Før du starter

- En ThunderPhone-agent og en organisatorisk [API-nøgle](/da/guides/api-keys).
- Five9s tilføjelse **AI Agent Connect**. Five9 begrænser den til AI-udbydere,
  som de har godkendt, og Five9s implementeringsteam konfigurerer den: Det importerer
  udbyderens IVR-scriptsskabelon, opretter opkaldsvariablerne og peger scriptets
  **Tredjepartsoverførsel**-modul på udbyderen. ThunderPhone er endnu ikke
  på Five9s liste over godkendte udbydere: Spørg dit Five9-kontoteam eller ThunderPhone
  support, før du planlægger ud fra det.

## 1. Opret SIP-slutpunktet

Five9s Tredjepartsoverførsel-modul ringer et telefonnummer op, ikke en SIP-adresse,
og andre udbyderes Five9-integrationer autentificerer Five9 efter kildeadresse
frem for en adgangskode. Opret derfor et `ip_allowlist`-slutpunkt med det nummer,
Five9 vil ringe op til, som et indringningsnummer (se
[Platforme, der ringer et telefonnummer op](/da/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`: SIP-signaleringsintervallerne for dine Five9-datacentre,
  fra Five9. Hvert interval skal være et offentligt IPv4-interval på `/16` eller
  smallere (IPv6 `/48` eller smallere).
- `dial_in_numbers`: nummeret, som Five9s script vil ringe op til, skrevet på den måde,
  Five9 sender det på. Det behøver ikke være et rigtigt telefonnummer. Det må ikke allerede
  være i brug på ThunderPhone, hverken som telefonnummer eller på et andet slutpunkt: Det giver
  `409`.

Five9s adresser deles af alle deres kunder, så enhver anden Five9-kunde,
der ringer nummeret op, når din agent. Når du vælger nummeret, skal du vælge
et langt nummer, som ingen ville gætte (op til 15 cifre), sikre, at
Five9 sender det til ThunderPhone i stedet for ud til telefonnettet, og
ikke offentliggøre det.

## 2. Send opkald med kontekst

Bed Five9s implementeringsteam om at:

- Sende opkaldet fra modulet **Tredjepartsoverførsel** til
  `sip:+14155550188@sip.thunderphone.com` med nummeret i både anmodnings-URI'en
  og `To`-headeren. Modulet tager nummeret med udbyderens
  SIP-domæne i en header.
- Sende det via TLS (port 5061) eller TCP (port 5060). Slutpunktet afviser UDP,
  og Five9 oplyser ikke, hvilken transport det bruger, så sørg for, at det ikke er
  UDP.
- Slå **Returner efter tredjepartskald** til, så scriptet fortsætter, når
  agenten afslutter opkaldet (Five9 tillader op til 3.600 sekunder for tredjepartskaldet).

Five9s vejledning angiver de værdier, den sender (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` og andre), men ikke deres
headernavne. Andre AI-udbyderes Five9-integrationer dokumenterer dem på netværket
som `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
og `X-AgentID`; kontrollér dem ved dit første testopkald. Hver værdi når prompten som en variabel, f.eks.
`{{sip_x_callcampaign}}`. `X-CallID` gemmes som opkaldets
`external_call_id`.

## 3. Få opkaldet tilbage

Agenten returnerer opkaldet: Den siger farvel og lægger på, og `BYE` indeholder
de fire headers, som Five9-scriptet læser. Tilføj dette overførselsnummer (se
[Tilføj overførselsnummeret](/da/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` og `X-RouteValue` fortæller scriptet, hvor opkalderen skal
  sendes hen, her Support-færdigheden. Værdier, som andre udbydere dokumenterer for `X-RouteType`, omfatter
  `SkillTransfer`, `PhoneTransfer`, `Hangup` og `DispositionOnly`; aftal
  værdierne med den, der vedligeholder scriptet. For flere destinationer skal du tilføje én
  returnering pr. destination med et andet navn og en anden `X-RouteValue`.
- `X-RouteReason` indeholder agentens intent-label, f.eks. `billing_dispute`.
- `X-CustomMetaData` indeholder overdragelses-id'et. `BYE` indeholder det også som
  `X-TP-Handoff-Id`, hvilket Five9 ikke læser.

Five9-scriptet mapper de fire headers til opkaldsvariabler. For agentens
opsummering skal scriptet kalde opslaget for overdragelser med et IVR-modul af typen **Forespørgsel**:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` efterfulgt af
`call.call_id`, med en autoriseringsprofil, der sender
`Authorization: Bearer` og din API-nøgle. Se
[Slå et overdraget opkald op](/api-reference/calls#look-up-a-handed-off-call).

## Test det

Ring ind til IVR-scriptet, bed agenten om en person, og kontrollér, at scriptet
ruter opkalderen med de udfyldte opkaldsvariabler. Hvis opkaldet aldrig når
agenten, skal du kontrollere, at nummeret i anmodnings-URI'en og `To`-headeren matcher
indringningsnummeret, at Five9's kildeadresse findes i `allowed_source_cidrs`, og
at opkaldet kom over TCP eller TLS. Åbn derefter opkaldet med
`GET /v1/calls/{call_id}`: `sip_headers` skal indeholde `x-callid`, og
`external_call_id` skal matche `call.call_id` i Five9.

## Begrænsninger

- Five9's vejledning dokumenterer routingdata i `BYE` og nævner ikke
  accept af en `REFER`, så tilbageleveringen er en kold viderestilling udført af scriptet.
- Five9 læser `X-RouteType`, `X-RouteValue`, `X-RouteReason` og
  `X-CustomMetaData`, ikke `User-to-User`. ThunderPhone sender hver headerværdi
  med en maksimal længde på 256 byte.
- Five9 anbefaler at holde antallet af brugerdefinerede headers på omkring ti for at undgå
  pakkefragmentering.
