---
title: "Contact center"
description: "Invia le chiamate da Amazon Connect, Five9, Genesys Cloud, Talkdesk, Twilio, Microsoft Dynamics 365, NICE CXone o Zoom Contact Center a un agente ThunderPhone tramite SIP e ricevile di nuovo con il trasferimento dell'agente."
---

Un agente ThunderPhone può rispondere alle chiamate all'interno del flusso di chiamata del tuo contact center.
La tua piattaforma inoltra la chiamata all'[indirizzo SIP](/it/guides/sip-addresses)
dell'agente con intestazioni SIP che trasportano il proprio ID chiamata e qualsiasi altra informazione nota
sul chiamante. Quando il chiamante ha bisogno di una persona, l'agente restituisce la chiamata con un
handoff: un riepilogo di ciò di cui ha bisogno il chiamante, una breve etichetta dell'intento e un ID
che il tuo flusso può cercare.

## Piattaforme

| Piattaforma | Come arriva la chiamata | Intestazione ID chiamata | Come viene restituita | Come viene restituito il contesto |
|---|---|---|---|---|
| [Amazon Connect](/it/guides/contact-centers/amazon-connect) | Connettore di trasferimento vocale esterno; allowlist IP | `X-Amzn-ConnectContactId` | Ritorno: l'agente riaggancia e il flusso riprende | Una funzione Lambda esegue la ricerca dell'handoff |
| [Five9](/it/guides/contact-centers/five9) | AI Agent Connect, configurato da Five9, verso un numero di accesso telefonico; allowlist IP | `X-CallID` | Ritorno: l'agente riaggancia con intestazioni di routing nel `BYE` | Intestazioni `X-Route*` e `X-CustomMetaData` nelle variabili di chiamata IVR |
| [Genesys Cloud](/it/guides/contact-centers/genesys-cloud) | Trunk BYOC Cloud; digest | `x-inin-cnv` | `REFER`, accettato da Take Back and Transfer | UUI esadecimale nell'indirizzo di trasferimento, quindi un'azione dati |
| [Talkdesk](/it/guides/contact-centers/talkdesk) | Connessione ad Autopilot Voice; allowlist IP | `X-Talkdesk-Interaction-Id` | `REFER` all'indirizzo di escalation di Talkdesk | UUI esadecimale nell'indirizzo di trasferimento, quindi Execute Action |
| [Twilio](/it/guides/contact-centers/twilio) | `<Dial><Sip>`; digest | `X-Call-ID`, che aggiungi tu | `REFER` al tuo gestore `referUrl` | Intestazioni nell'indirizzo di trasferimento (`ReferTransferTarget`) |
| [Microsoft Dynamics 365](/it/guides/contact-centers/microsoft-dynamics-365) | Trasferimento a un numero di telefono, tramite il tuo SBC; digest | `X-Call-ID`, che aggiungi tu | Ritorno, quindi il tuo SBC instrada nuovamente il chiamante | Il nodo HTTP Request esegue la ricerca dell'handoff |
| [NICE CXone](/it/guides/contact-centers/nice-cxone) | Studio `Placecall` con `Sipputheader`, verso un numero di accesso telefonico; allowlist IP | `X-Call-ID`, che aggiungi tu | Ritorno: l'agente riaggancia (verifica con NICE come il copione riporta indietro il chiamante) | Un'azione REST API esegue la ricerca dell'handoff |
| [Zoom Contact Center](/it/guides/contact-centers/zoom-contact-center) | Widget bot su un trunk creato da Zoom, verso un numero di accesso telefonico; allowlist IP con SRTP | `X-ZOOM-Call-Sid` | `REFER` all'indirizzo dell'agente umano di Zoom | Il widget HTTP Call esegue la ricerca dell'handoff |

## Come funziona

1. **Crea un endpoint SIP** per l'agente, con l'API, in **Telefono e web**
   → **Endpoint SIP** nell'app, oppure chiedendo a Zeus. Le piattaforme che possono rispondere a una
   verifica tramite password usano il nome utente e la password dell'endpoint. Le piattaforme che
   si identificano solo tramite i propri indirizzi di origine usano un endpoint con
   `auth` impostato su `ip_allowlist`; consulta
   [Piattaforme che si autenticano tramite IP di origine](/it/guides/sip-addresses).
   Le piattaforme che compongono un numero di telefono anziché un indirizzo SIP raggiungono
   l'endpoint tramite i relativi
   [numeri di accesso](/it/guides/sip-addresses).
2. **Invia chiamate con contesto.** La piattaforma chiama l'`sip_uri` dell'endpoint o
   un numero di accesso.
   Ogni intestazione `X-` e `User-to-User` inviata diventa una variabile di chiamata `{{sip_…}}`
   che il prompt può usare, mentre l'intestazione call-id viene archiviata come
   `external_call_id` della chiamata. Consulta
   [Passare il contesto della chiamata nelle intestazioni SIP](/it/guides/sip-addresses).
3. **Aggiungi un numero di trasferimento che restituisca la chiamata**, ovvero un indirizzo SIP
   sulla tua piattaforma (l'agente invia un `REFER`) oppure un
   [ritorno](/it/guides/call-transfers)
   (l'agente riaggancia e il tuo flusso prosegue). Le relative intestazioni possono contenere
   `{{handoff_summary}}`, `{{handoff_intent}}` e `{{handoff_id}}`; consulta
   [Passare il contesto al tuo contact center](/it/guides/call-transfers).
4. **Leggi il passaggio di consegne** dove lo inserisce la tua piattaforma oppure cercalo tramite
   l'ID chiamata della tua piattaforma.

### Aggiungi il numero di trasferimento

Gli indirizzi SIP, i ritorni e le relative intestazioni si impostano con la
[API Agents](/api-reference/agents#transfer-numbers). Una scrittura sostituisce l'intero
elenco, quindi includi gli altri numeri di trasferimento dell'agente, poi effettua il deploy:

```bash
curl -X PATCH https://api.thunderphone.com/v1/agents/12 \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"transfer_destinations": [{"name": "Contact center", "action": "return"}]}'

curl -X POST https://api.thunderphone.com/v1/agents/12/deploy \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

Poi indica all'agente quando usarlo, per nome, nel relativo prompt: "Quando il chiamante
chiede di parlare con una persona oppure non riesci a risolvere la richiesta, trasferisci a Contact
center."

### Cerca il passaggio di consegne

Il tuo flusso può recuperare il passaggio di consegne con la chiave API della tua organizzazione e l'ID
chiamata della piattaforma:

```bash
curl "https://api.thunderphone.com/v1/calls/handoff?external_call_id=YOUR_PLATFORM_CALL_ID" \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

La risposta contiene `handoff.summary`, `handoff.intent` e `handoff.handoff_id`,
le intestazioni SIP e le variabili con cui è iniziata la chiamata e, una volta terminata
la chiamata, il relativo riepilogo e i dati estratti. Puoi anche cercare una chiamata tramite
`handoff_id`. Vedi
[Cercare una chiamata trasferita](/api-reference/calls#look-up-a-handed-off-call).

Conserva la chiave API nell'archivio delle credenziali della tua piattaforma, non nel flusso stesso.

<Warning>
  I valori delle intestazioni provengono da chiunque invii la chiamata. Usali come contesto nel
  prompt, non per decidere chi è il chiamante o cosa può fare.
</Warning>

## Guide

<CardGroup cols={2}>
  <Card title="Amazon Connect" icon="phone" href="/it/guides/contact-centers/amazon-connect">
    Trasferimento vocale esterno in entrata, ritorno e ricerca Lambda in uscita.
  </Card>
  <Card title="Five9" icon="phone" href="/it/guides/contact-centers/five9">
    AI Agent Connect in entrata, intestazioni di instradamento alla chiusura in uscita.
  </Card>
  <Card title="Genesys Cloud" icon="phone" href="/it/guides/contact-centers/genesys-cloud">
    Trunk BYOC Cloud in entrata, Take Back e Transfer con UUI in uscita.
  </Card>
  <Card title="Talkdesk" icon="phone" href="/it/guides/contact-centers/talkdesk">
    Connessione ad Autopilot Voice in entrata, escalation con UUI in uscita.
  </Card>
  <Card title="Twilio" icon="phone" href="/it/guides/contact-centers/twilio">
    TwiML Dial in entrata, un REFER al tuo gestore referUrl in uscita.
  </Card>
  <Card title="Microsoft Dynamics 365" icon="phone" href="/it/guides/contact-centers/microsoft-dynamics-365">
    Trasferimento tramite il tuo SBC in entrata, ritorno e ricerca HTTP in uscita.
  </Card>
  <Card title="NICE CXone" icon="phone" href="/it/guides/contact-centers/nice-cxone">
    Studio Placecall in entrata, ritorno e ricerca REST in uscita.
  </Card>
  <Card title="Zoom Contact Center" icon="phone" href="/it/guides/contact-centers/zoom-contact-center">
    Widget bot in entrata, un REFER a un agente umano in uscita.
  </Card>
</CardGroup>
