---
title: "Conectați din Five9"
description: "Trimiteți apeluri Five9 către un agent ThunderPhone prin SIP cu AI Agent Connect și primiți-le înapoi cu antete de rutare pe care scriptul dumneavoastră IVR le citește."
---

Scriptul IVR Five9 trimite apelantul către agent împreună cu detaliile
apelului Five9. Când agentul termină, închide apelul cu antete de rutare în SIP
`BYE`, pe care scriptul le citește în variabilele apelului pentru a ruta apelantul.

## Înainte de a începe

- Un agent ThunderPhone și o cheie [API](/ro/guides/api-keys) a organizației.
- Suplimentul Five9 **Conectare agent AI**. Five9 îl limitează la furnizorii AI
  pe care i-a acreditat, iar echipa de implementare Five9 îl configurează:
  importă șablonul de script IVR al furnizorului, creează variabilele apelului și
  direcționează modulul **Transfer către terți** al scriptului către furnizor.
  ThunderPhone nu se află încă pe lista de furnizori acreditați Five9:
  consultați echipa de cont Five9 sau asistența ThunderPhone înainte de a vă
  baza planurile pe această integrare.

## 1. Creați endpointul SIP

Modulul Five9 Transfer către terți apelează un număr de telefon, nu o adresă
SIP, iar integrările Five9 ale altor furnizori autentifică Five9 după adresa
sursă, nu printr-o parolă. Prin urmare, creați un endpoint `ip_allowlist` cu
numărul pe care Five9 îl va apela ca număr de apelare (consultați
[Platforme care apelează un număr de telefon](/ro/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`: intervalele de semnalizare SIP ale centrelor dvs. de
  date Five9, furnizate de Five9. Fiecare trebuie să fie un interval IPv4 public
  de `/16` sau mai restrâns (IPv6 `/48` sau mai restrâns).
- `dial_in_numbers`: numărul pe care scriptul Five9 îl va apela, scris în modul
  în care îl trimite Five9. Nu trebuie să fie un număr de telefon real. Nu poate
  fi deja utilizat în ThunderPhone, ca număr de telefon sau pe alt endpoint:
  aceasta returnează `409`.

Adresele Five9 sunt partajate de toți clienții săi, astfel că orice alt client
Five9 care apelează numărul ajunge la agentul dvs. Când alegeți numărul,
alegeți unul lung pe care nimeni nu l-ar ghici (până la 15 cifre), asigurați-vă
că Five9 îl trimite către ThunderPhone, nu către rețeaua telefonică, și nu îl
publicați.

## 2. Trimiteți apeluri cu context

Cereți echipei de implementare Five9 să:

- Trimită apelul din modulul **Transfer către terți** către
  `sip:+14155550188@sip.thunderphone.com`, cu numărul atât în URI-ul
  solicitării, cât și în antetul `To`. Modulul preia numărul, cu domeniul SIP al
  furnizorului într-un antet.
- Îl trimită prin TLS (portul 5061) sau TCP (portul 5060). Endpointul refuză
  UDP, iar Five9 nu publică ce transport utilizează, deci asigurați-vă că nu
  este UDP.
- Activeze **Revenire după apelul către terț**, astfel încât scriptul să continue
  când agentul închide apelul (Five9 permite până la 3.600 de secunde pentru
  apelul către terț).

Ghidul Five9 enumeră valorile pe care le trimite (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` și altele), nu numele
antetelor. Integrările Five9 ale altor furnizori AI le documentează în
semnalizare drept `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`,
`X-CallCampaign` și `X-AgentID`; verificați-le la primul apel de test. Fiecare
ajunge în prompt ca variabilă, cum ar fi
`{{sip_x_callcampaign}}`. `X-CallID` este stocat ca
`external_call_id` al apelului.

## 3. Primiți apelul înapoi

Agentul returnează apelul: își ia rămas-bun și închide, iar `BYE` conține
cele patru antete pe care le citește scriptul Five9. Adăugați acest număr de transfer (consultați
[Adăugați numărul de transfer](/ro/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` și `X-RouteValue` îi indică scriptului unde să trimită apelantul,
  în acest caz către competența Support. Alți furnizori documentează pentru `X-RouteType`
  valorile `SkillTransfer`, `PhoneTransfer`, `Hangup` și `DispositionOnly`; stabiliți
  valorile cu persoana care administrează scriptul. Pentru mai multe destinații, adăugați câte un
  retur pentru fiecare destinație, cu un nume și un `X-RouteValue` diferite.
- `X-RouteReason` conține eticheta intenției agentului, precum `billing_dispute`.
- `X-CustomMetaData` conține ID-ul predării. `BYE` îl conține și ca
  `X-TP-Handoff-Id`, pe care Five9 nu îl citește.

Scriptul Five9 mapează cele patru antete în variabile de apel. Pentru rezumatul
agentului, configurați scriptul să apeleze căutarea predării cu un modul IVR **Interogare**:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` urmat de
`call.call_id`, cu un profil de autorizare care trimite
`Authorization: Bearer` și cheia dumneavoastră API. Consultați
[Căutați un apel predat](/api-reference/calls#look-up-a-handed-off-call).

## Testați

Apelați scriptul IVR, cereți agentului o persoană și verificați că scriptul
direcționează apelantul cu variabilele apelului completate. Dacă apelul nu ajunge niciodată la
agent, verificați că numărul din URI-ul solicitării și antetul `To` corespunde
numărului de apelare, că adresa sursă Five9 se află în `allowed_source_cidrs` și
că apelul a venit prin TCP sau TLS. Apoi deschideți apelul cu
`GET /v1/calls/{call_id}`: `sip_headers` ar trebui să listeze `x-callid`, iar
`external_call_id` ar trebui să corespundă cu `call.call_id` în Five9.

## Limite

- Ghidul Five9 documentează datele de rutare în `BYE` și nu menționează
  acceptarea unui `REFER`, astfel că returnarea este un transfer neasistat realizat de script.
- Five9 citește `X-RouteType`, `X-RouteValue`, `X-RouteReason` și
  `X-CustomMetaData`, nu `User-to-User`. ThunderPhone trimite fiecare valoare de antet
  cu o lungime de cel mult 256 de octeți.
- Five9 recomandă păstrarea antetelor personalizate la aproximativ zece pentru a evita
  fragmentarea pachetelor.
