---
title: "Connettiti da Five9"
description: "Invia le chiamate Five9 a un agente ThunderPhone tramite SIP con AI Agent Connect e ricevile di nuovo con intestazioni di instradamento lette dal tuo copione IVR."
---

Il copione IVR di Five9 invia il chiamante all'agente con i dettagli della
chiamata di Five9. Al termine, l'agente riaggancia con intestazioni di instradamento nel SIP
`BYE`, che il copione legge nelle variabili di chiamata per instradare il chiamante.

## Prima di iniziare

- Un agente ThunderPhone e una [chiave API](/it/guides/api-keys) dell'organizzazione.
- L'add-on **AI Agent Connect** di Five9. Five9 lo limita ai fornitori di IA che ha
  accreditato e il team di implementazione di Five9 lo configura: importa il modello di copione IVR
  del fornitore, crea le variabili di chiamata e indirizza il modulo **Trasferimento a terzi**
  del copione al fornitore. ThunderPhone non è ancora nell'elenco dei fornitori accreditati
  da Five9: chiedi al team che gestisce il tuo account Five9 o al supporto ThunderPhone
  prima di pianificare in base a questa integrazione.

## 1. Crea l'endpoint SIP

Il modulo Trasferimento a terzi di Five9 chiama un numero di telefono, non un indirizzo SIP,
e le integrazioni Five9 di altri fornitori autenticano Five9 tramite l'indirizzo di origine
anziché una password. Crea quindi un endpoint `ip_allowlist` con il numero
che Five9 chiamerà come numero di accesso (vedi
[Piattaforme che chiamano un numero di telefono](/it/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`: gli intervalli di segnalazione SIP dei tuoi data center Five9,
  forniti da Five9. Ognuno deve essere un intervallo IPv4 pubblico di `/16` o più ristretto
  (IPv6 `/48` o più ristretto).
- `dial_in_numbers`: il numero che il copione Five9 chiamerà, scritto nel modo in cui
  Five9 lo invia. Non deve necessariamente essere un numero di telefono reale. Non può essere già
  in uso su ThunderPhone, come numero di telefono o su un altro endpoint: in tal caso viene restituito
  `409`.

Gli indirizzi di Five9 sono condivisi da tutti i suoi clienti, quindi qualsiasi altro cliente
Five9 che chiami il numero raggiunge il tuo agente. Quando scegli il
numero, scegline uno lungo che nessuno possa indovinare (fino a 15 cifre), assicurati
che Five9 lo invii a ThunderPhone anziché alla rete telefonica e
non pubblicarlo.

## 2. Invia le chiamate con contesto

Chiedi al team di implementazione di Five9 di:

- Inviare la chiamata dal modulo **Trasferimento a terzi** a
  `sip:+14155550188@sip.thunderphone.com`, con il numero sia nell'URI della richiesta
  sia nell'intestazione `To`. Il modulo utilizza il numero, con il dominio SIP del fornitore
  in un'intestazione.
- Inviarla tramite TLS (porta 5061) o TCP (porta 5060). L'endpoint rifiuta UDP,
  e Five9 non pubblica quale trasporto utilizza, quindi assicurati che non sia
  UDP.
- Attivare **Ritorno dopo chiamata di terze parti**, in modo che il copione continui quando
  l'agente riaggancia (Five9 consente fino a 3.600 secondi per la chiamata di terze parti).

La guida di Five9 elenca i valori che invia (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` e altri), non i nomi delle
intestazioni. Le integrazioni Five9 di altri fornitori di IA li documentano a livello di protocollo
come `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
e `X-AgentID`; verificali nella prima chiamata di test. Ognuno raggiunge il prompt come variabile, ad esempio
`{{sip_x_callcampaign}}`. `X-CallID` viene memorizzato come
`external_call_id` della chiamata.

## 3. Ricevi nuovamente la chiamata

L'agente restituisce la chiamata: saluta e riaggancia, e il `BYE` contiene
i quattro header letti dal copione di Five9. Aggiungi questo numero di trasferimento (vedi
[Aggiungi il numero di trasferimento](/it/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` e `X-RouteValue` indicano al copione dove inviare il chiamante,
  in questo caso alla competenza Support. Tra i valori documentati da altri provider per `X-RouteType` rientrano
  `SkillTransfer`, `PhoneTransfer`, `Hangup` e `DispositionOnly`; concorda i
  valori con chi gestisce il copione. Per più destinazioni, aggiungi un
  ritorno per ogni destinazione con un nome e un `X-RouteValue` diversi.
- `X-RouteReason` contiene l'etichetta dell'intento dell'agente, ad esempio `billing_dispute`.
- `X-CustomMetaData` contiene l'ID di passaggio. Il `BYE` lo contiene anche come
  `X-TP-Handoff-Id`, che Five9 non legge.

Il copione di Five9 associa i quattro header alle variabili della chiamata. Per il
riepilogo dell'agente, fai in modo che il copione chiami la ricerca del passaggio con un modulo IVR **Query**:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` seguito da
`call.call_id`, con un profilo di autorizzazione che invia
`Authorization: Bearer` e la tua chiave API. Vedi
[Cerca una chiamata passata](/api-reference/calls#look-up-a-handed-off-call).

## Verifica

Chiama il copione IVR, chiedi all'agente di parlare con una persona e verifica che il copione
instradi il chiamante con le variabili della chiamata compilate. Se la chiamata non raggiunge mai
l'agente, verifica che il numero nell'URI della richiesta e nell'header `To` corrisponda al
numero di accesso, che l'indirizzo di origine di Five9 sia in `allowed_source_cidrs` e
che la chiamata sia arrivata tramite TCP o TLS. Quindi apri la chiamata con
`GET /v1/calls/{call_id}`: `sip_headers` dovrebbe elencare `x-callid` e
`external_call_id` dovrebbe corrispondere a `call.call_id` in Five9.

## Limiti

- La guida di Five9 documenta i dati di instradamento nel `BYE` e non menziona
  l'accettazione di un `REFER`, quindi la restituzione è un trasferimento a freddo eseguito dal copione.
- Five9 legge `X-RouteType`, `X-RouteValue`, `X-RouteReason` e
  `X-CustomMetaData`, non `User-to-User`. ThunderPhone invia valori degli header
  lunghi al massimo 256 byte.
- Five9 consiglia di limitare gli header personalizzati a circa dieci per evitare la
  frammentazione dei pacchetti.
