---
title: "Forbind fra Genesys Cloud"
description: "Send Genesys Cloud-opkald til en ThunderPhone-agent via en BYOC Cloud-trunk med samtale-id og UUI, og tag dem tilbage med overdragelsen i UUI."
---

Dit Architect-flow sender opkalderen til agenten via en BYOC Cloud-trunk sammen med
samtale-id'et og eventuel UUI, du angiver. Når opkalderen har brug for en person, sender
agenten en SIP-`REFER`, Genesys tager opkaldet tilbage, og overdragelses-id'et
ankommer i opkaldets UUI.

## Før du starter

- En ThunderPhone-agent og en organisations-[API-nøgle](/da/guides/api-keys).
- Genesys Cloud med BYOC Cloud og en ekstern trunk (typen BYOC Carrier eller
  PBX) med disse indstillinger aktiveret
  ([indstillinger for ekstern trunk](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Samtaleheadere**, så Genesys sender sit samtale-id i
    `x-inin-cnv`. Denne indstilling er slået fra som standard.
  - **UUI-gennemgang** med headertypen `User-To-User` og Hex-kodning.
  - **Tag tilbage og overfør**, så Genesys accepterer agentens `REFER`.

## 1. Opret SIP-slutpunktet

Genesys besvarer en digest-udfordring, så brug et standardslutpunkt:

```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": "Genesys Cloud"}'
```

Gem `password` fra svaret med det samme; det vises kun én gang. På
trunken:

| Indstilling | Værdi |
|---|---|
| SIP-server | `sip.thunderphone.com`, port `5061` |
| Protokol | TLS |
| Digest-godkendelse | slutpunktets `username` og `password` |
| Codecs | PCMU, PCMA eller G.722 |

Placér trunken på en udgående rute for dit site, hvis nummerplan dækker den
adresse, flowet ringer til.

## 2. Send opkald med kontekst

I dit Architect-flow:

1. Tilføj eventuelt handlingen **Angiv UUI-data** med kontekst til agenten,
   f.eks. `account=12345`. Genesys anbefaler 128 tegn eller færre.
2. Tilføj handlingen **Overfør til nummer** med slutpunktets `sip_uri`, f.eks.
   `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys sender samtale-id'et i `x-inin-cnv`. ThunderPhone gemmer det som
opkaldets `external_call_id`. UUI'en når frem til prompten afkodet som
`{{sip_uui}}`.

Brugerdefinerede trunk-headere er statiske i Genesys, så placer værdier pr.
opkald i UUI'en. Genesys reserverer headerpræfikserne `x-inin`, `x-genesys`,
`x-pcv` og `x-gcv` til sig selv.

## 3. Få opkaldet tilbage

Agenten overfører med en `REFER` til en adresse på Genesys med
overdragelses-id'et som hexadecimal UUI i adressen. Tilføj dette
overførselsnummer (se
[Tilføj overførselsnummeret](/da/guides/contact-centers/overview)
og [Headere i overførselsadressen](/da/guides/call-transfers)):

```json
{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

Erstat adressen med en, der dirigerer tilbage til den kø eller det flow, som
skal modtage opkalderen; bekræft formatet med Genesys. `REFER` ser sådan ud:

```
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
```

Når **Tag tilbage og overfør** er aktiveret, tager Genesys opkaldet tilbage fra
trunken og dirigerer det til den adresse. Genesys dokumenterer, at indgående
UUI havner i `Call.UUIData`; det dokumenterer ikke dette for en tilbagetagning,
så bekræft med Genesys eller i et testopkald, at flowet, som modtager
opkalderen, finder overdragelses-id'et der. For at hente resumeet og
hensigten skal du kalde opslaget for overdragelsen med en
**Opkaldsdatahandling** i en integration med Web Services Data Actions:

- Anmodning: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  efterfulgt af id'et fra `Call.UUIData`.
- Legitimationsoplysninger: Din API-nøgle, sendt som `Authorization: Bearer sk_live_…`.
- Output: Map `handoff.summary` og `handoff.intent` til flowvariabler.

Se [Slå et overdraget opkald op](/api-reference/calls#look-up-a-handed-off-call).

## Test det

Ring til et nummer, der når flowet, bed agenten om en person, og kontrollér, at
Genesys sender opkaldet til den adresse, du har angivet. Kontrollér i dette flow, at
`Call.UUIData` indeholder overdragelses-id'et som tekst (hvis det viser hex-cifre, skal du kontrollere, at
trunkens UUI-kodning er Hex). Åbn derefter opkaldet med `GET /v1/calls/{call_id}`:
`external_call_id` skal være samtale-id'et.

## Begrænsninger

- Handlingen **Hent SIP-headere** læser kun den indledende `INVITE`, så den kan ikke
  læse noget fra agentens `REFER`. Overdragelsen når kun Genesys
  via UUI.
- Genesys fjerner al UUI, når et opkald indeholder mere end én UUI-header.
- Overførselsadressen begrænses til 254 tegn, så en lang UUI afkortes, så den passer.
  Et overdragelses-id passer altid.
