---
title: "Yhteyskeskukset"
description: "Ohjaa puhelut Amazon Connectista, Five9:stä, Genesys Cloudista, Talkdeskista, Twiliosta, Microsoft Dynamics 365:stä, NICE CXonesta tai Zoom Contact Centeristä ThunderPhone-agentille SIPin kautta ja palauta ne agentin siirron yhteydessä."
---

ThunderPhone-agentti voi vastata puheluihin yhteyskeskuksesi puhelunkulussa.
Alustasi lähettää puhelun agentin [SIP-osoitteeseen](/fi/guides/sip-addresses)
SIP-otsakkeilla, jotka sisältävät sen oman puhelutunnuksen ja kaiken muun,
mitä se tietää soittajasta. Kun soittaja tarvitsee ihmistä, agentti palauttaa
puhelun siirtotietojen kanssa: yhteenvedon soittajan tarpeesta, lyhyen
tarkoitustunnisteen ja tunnuksen, jonka puhelunkulkusi voi hakea.

## Alustat

| Alusta | Miten puhelu saapuu | Puhelutunnuksen otsake | Miten se palautuu | Miten konteksti palautuu |
|---|---|---|---|---|
| [Amazon Connect](/fi/guides/contact-centers/amazon-connect) | Ulkoinen puheensiirtoliitin; IP-sallittujen lista | `X-Amzn-ConnectContactId` | Paluu: agentti katkaisee puhelun ja puhelunkulku jatkuu | Lambda kutsuu siirtotietojen hakua |
| [Five9](/fi/guides/contact-centers/five9) | Five9:n määrittämä AI Agent Connect soittosarjanumeroon; IP-sallittujen lista | `X-CallID` | Paluu: agentti katkaisee puhelun reititysotsakkeilla `BYE`-viestissä | `X-Route*`- ja `X-CustomMetaData`-otsakkeet IVR-puhelumuuttujiin |
| [Genesys Cloud](/fi/guides/contact-centers/genesys-cloud) | BYOC Cloud -runkoyhteys; digest | `x-inin-cnv` | `REFER`, jonka Take Back and Transfer hyväksyy | Heksadesimaalinen UUI siirto-osoitteessa, sitten datatoiminto |
| [Talkdesk](/fi/guides/contact-centers/talkdesk) | Yhdistä Autopilot Voiceen; IP-sallittujen lista | `X-Talkdesk-Interaction-Id` | `REFER` Talkdeskin eskalointiosoitteeseen | Heksadesimaalinen UUI siirto-osoitteessa, sitten Execute Action |
| [Twilio](/fi/guides/contact-centers/twilio) | `<Dial><Sip>`; digest | `X-Call-ID`, jonka lisäät | `REFER` omaan `referUrl`-käsittelijääsi | Otsakkeet siirto-osoitteessa (`ReferTransferTarget`) |
| [Microsoft Dynamics 365](/fi/guides/contact-centers/microsoft-dynamics-365) | Siirto puhelinnumeroon SBC:si kautta; digest | `X-Call-ID`, jonka lisäät | Paluu, sitten SBC:si reitittää soittajan takaisin | HTTP Request -solmu kutsuu siirtotietojen hakua |
| [NICE CXone](/fi/guides/contact-centers/nice-cxone) | Studio `Placecall` ja `Sipputheader` soittosarjanumeroon; IP-sallittujen lista | `X-Call-ID`, jonka lisäät | Paluu: agentti katkaisee puhelun (vahvista NICEltä, miten skripti palauttaa soittajan) | REST API -toiminto kutsuu siirtotietojen hakua |
| [Zoom Contact Center](/fi/guides/contact-centers/zoom-contact-center) | Zoomin runkoyhteyteen luoma bottiwidget soittosarjanumeroon; IP-sallittujen lista SRTP:llä | `X-ZOOM-Call-Sid` | `REFER` Zoomin ihmisagenttiosoitteeseen | HTTP Call -widget kutsuu siirtotietojen hakua |

## Näin se toimii

1. **Luo puheagentille SIP-päätepiste** API:n avulla kohdassa **Puhelin ja verkko**
   → sovelluksen **SIP-päätepisteet** tai pyytämällä Zeusta. Alustat, jotka voivat vastata
   salasanahaasteeseen, käyttävät päätepisteen käyttäjätunnusta ja salasanaa. Alustat, jotka
   tunnistautuvat vain lähdeosoitteidensa perusteella, käyttävät päätepistettä, jossa
   `auth` on asetettu arvoon `ip_allowlist`; katso
   [Lähde-IP-osoitteen perusteella tunnistautuvat alustat](/fi/guides/sip-addresses).
   Alustat, jotka soittavat puhelinnumeroon SIP-osoitteen sijaan, tavoittavat
   päätepisteen sen
   [soittonumeroiden](/fi/guides/sip-addresses) kautta.
2. **Lähetä puhelut kontekstin kanssa.** Alusta soittaa päätepisteen `sip_uri`-osoitteeseen tai
   soittonumeroon.
   Jokaisesta sen lähettämästä `X-`-otsakkeesta ja `User-to-User`-otsakkeesta tulee `{{sip_…}}`-puhelumuuttuja,
   jota kehote voi käyttää, ja sen call-id-otsake tallennetaan puhelun
   `external_call_id`-tunnuksena. Katso
   [Välitä puhelukonteksti SIP-otsakkeissa](/fi/guides/sip-addresses).
3. **Lisää yksi siirtonumero, joka palauttaa puhelun**, joko alustallasi oleva SIP-osoite
   (agentti lähettää `REFER`-pyynnön) tai
   [palautus](/fi/guides/call-transfers)
   (agentti katkaisee puhelun ja työnkulkusi jatkuu). Sen otsakkeet voivat sisältää
   `{{handoff_summary}}`, `{{handoff_intent}}` ja `{{handoff_id}}`; katso
   [Välitä konteksti yhteyskeskukseesi](/fi/guides/call-transfers).
4. **Lue siirto** siitä, mihin alustasi sen tallentaa, tai hae se alustasi puhelutunnuksella.

### Lisää siirtonumero

SIP-osoitteet, palautukset ja niiden otsakkeet määritetään
[Agents API](/api-reference/agents#transfer-numbers) -rajapinnalla. Kirjoitus korvaa
koko luettelon, joten sisällytä agentin muut siirtonumerot ja ota sitten käyttöön:

```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"
```

Kerro sitten agentille kehotteessa nimeltä, milloin sitä käytetään: "Kun soittaja
pyytää ihmistä tai et pysty ratkaisemaan pyyntöä, siirrä puhelu kohteeseen Contact
center."

### Hae siirtotiedot

Työnkulkusi voi hakea siirtotiedot organisaatiosi API-avaimella ja alustasi
puhelutunnuksella:

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

Vastauksessa ovat `handoff.summary`, `handoff.intent` ja `handoff.handoff_id`,
SIP-otsakkeet ja muuttujat, joilla puhelu alkoi, sekä puhelun päätyttyä sen
yhteenveto ja poimitut tiedot. Voit hakea puhelun myös `handoff_id`-tunnuksella.
Katso
[Hae siirretty puhelu](/api-reference/calls#look-up-a-handed-off-call).

Säilytä API-avain alustasi tunnistetietovarastossa, älä itse työnkulussa.

<Warning>
  Otsakkeiden arvot tulevat puhelun lähettäjältä. Käytä niitä kehotteessa
  kontekstina, älä soittajan tunnistamiseen tai sen päättämiseen, mitä hän voi tehdä.
</Warning>

## Oppaat

<CardGroup cols={2}>
  <Card title="Amazon Connect" icon="phone" href="/fi/guides/contact-centers/amazon-connect">
    Ulkoinen puheensiirto sisään, palautus ja Lambda-haku takaisin.
  </Card>
  <Card title="Five9" icon="phone" href="/fi/guides/contact-centers/five9">
    AI Agent Connect sisään, reititysotsakkeet puhelun lopetuksen yhteydessä takaisin.
  </Card>
  <Card title="Genesys Cloud" icon="phone" href="/fi/guides/contact-centers/genesys-cloud">
    BYOC Cloud -runko sisään, Take Back ja Transfer UUI:n kanssa takaisin.
  </Card>
  <Card title="Talkdesk" icon="phone" href="/fi/guides/contact-centers/talkdesk">
    Yhdistä Autopilot Voiceen sisään, eskalointi UUI:n kanssa takaisin.
  </Card>
  <Card title="Twilio" icon="phone" href="/fi/guides/contact-centers/twilio">
    TwiML Dial sisään, REFER takaisin referUrl-käsittelijääsi.
  </Card>
  <Card title="Microsoft Dynamics 365" icon="phone" href="/fi/guides/contact-centers/microsoft-dynamics-365">
    Siirto SBC:si kautta sisään, palautus ja HTTP-haku takaisin.
  </Card>
  <Card title="NICE CXone" icon="phone" href="/fi/guides/contact-centers/nice-cxone">
    Studio Placecall sisään, palautus ja REST-haku takaisin.
  </Card>
  <Card title="Zoom Contact Center" icon="phone" href="/fi/guides/contact-centers/zoom-contact-center">
    Bottiwidget sisään, REFER takaisin ihmisagentille.
  </Card>
</CardGroup>
