---
title: "Genesys Cloud에서 연결"
description: "대화 ID와 UUI를 포함하여 BYOC Cloud 트렁크를 통해 Genesys Cloud 통화를 ThunderPhone 에이전트로 전송하고, UUI의 핸드오프로 다시 가져옵니다."
---

Architect 플로는 대화 ID와 설정한 모든 UUI를 포함하여 BYOC Cloud 트렁크를 통해 발신자를 에이전트로 보냅니다. 발신자에게 사람이 필요하면 에이전트가 SIP `REFER`를 전송하고, Genesys가 통화를 다시 가져오며, 인계 ID는 통화의 UUI로 전달됩니다.

## 시작하기 전에

- ThunderPhone 에이전트와 조직 [API 키](/ko/guides/api-keys).
- BYOC Cloud가 있는 Genesys Cloud 및 다음 설정이 활성화된 외부 트렁크(BYOC Carrier 또는 PBX 유형)
  ([외부 트렁크 설정](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - Genesys가 `x-inin-cnv`에 대화 ID를 전송하도록 하는 **대화 헤더**. 기본적으로 비활성화되어 있습니다.
  - 헤더 유형이 `User-To-User`이고 인코딩이 Hex인 **UUI 패스스루**.
  - Genesys가 에이전트의 `REFER`를 수락하도록 하는 **가져오기 및 전환**.

## 1. SIP 엔드포인트 만들기

Genesys는 다이제스트 챌린지에 응답하므로 표준 엔드포인트를 사용합니다.

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

응답의 `password`는 한 번만 표시되므로 즉시 저장합니다. 트렁크에서 다음을 설정합니다.

| 설정 | 값 |
|---|---|
| SIP 서버 | `sip.thunderphone.com`, 포트 `5061` |
| 프로토콜 | TLS |
| 다이제스트 인증 | 엔드포인트의 `username` 및 `password` |
| 코덱 | PCMU, PCMA 또는 G.722 |

플로가 다이얼하는 주소를 번호 계획에서 포함하는 사이트의 아웃바운드 경로에 트렁크를 추가합니다.

## 2. 컨텍스트와 함께 통화 전송하기

Architect 플로에서 다음을 수행합니다.

1. 필요에 따라 에이전트용 컨텍스트(예: `account=12345`)가 포함된 **UUI 데이터 설정** 작업을 추가합니다. Genesys는 128자 이하를 권장합니다.
2. 예를 들어 `sip:agent-12-jhxmginwjx@sip.thunderphone.com`과 같이 엔드포인트의 `sip_uri`를 사용하는 **번호로 전환** 작업을 추가합니다.

Genesys는 `x-inin-cnv`에 대화 ID를 전송합니다. ThunderPhone은 이를 통화의 `external_call_id`로 저장합니다. UUI는 디코딩된 상태로 `{{sip_uui}}` 프롬프트에 전달됩니다.

Genesys의 트렁크 사용자 지정 헤더는 정적이므로 통화별 값은 UUI에 넣습니다. Genesys는 `x-inin`, `x-genesys`, `x-pcv`, `x-gcv` 헤더 접두사를 자체적으로 예약합니다.

## 3. 통화 다시 가져오기

에이전트는 Genesys의 주소로 `REFER`를 사용해 전환하며, 해당 주소 내부에 16진수 UUI로 인계 ID를 포함합니다. 이 전환 번호를 추가합니다([전환 번호 추가](/ko/guides/contact-centers/overview) 및 [전환 주소 내부의 헤더](/ko/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"
}
```

주소를 발신자를 받아야 하는 대기열 또는 플로로 다시 라우팅되는 주소로 바꾸고, 그 형식은 Genesys에서 확인합니다. `REFER`는 다음과 같습니다.

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

**가져오기 및 전환**을 활성화하면 Genesys는 트렁크에서 통화를 다시 가져와 해당 주소로 라우팅합니다. Genesys 문서에 따르면 수신 UUI는 `Call.UUIData`에 저장됩니다. 가져오기 작업에 대해서는 이를 문서화하지 않으므로 Genesys 또는 테스트 통화로 발신자를 받는 플로가 그곳에서 인계 ID를 찾는지 확인합니다. 요약과 의도를 가져오려면 Web Services Data Actions 통합의 **통화 데이터 작업**으로 인계 조회를 호출합니다.

- 요청: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  뒤에 `Call.UUIData`의 ID를 추가합니다.
- 자격 증명: `Authorization: Bearer sk_live_…`로 전송하는 API 키입니다.
- 출력: `handoff.summary` 및 `handoff.intent`를 플로 변수에 매핑합니다.

[인계된 통화 조회](/api-reference/calls#look-up-a-handed-off-call)를 참조하세요.

## 테스트

흐름에 연결되는 번호로 전화를 걸고, 에이전트에게 담당자를 요청한 다음 Genesys가 설정한 주소로 통화를 연결하는지 확인합니다. 해당 흐름에서 `Call.UUIData`에 핸드오프 ID가 텍스트로 저장되는지 확인합니다(16진수 문자가 표시되면 트렁크의 UUI 인코딩이 Hex인지 확인합니다). 그런 다음 `GET /v1/calls/{call_id}`로 통화를 엽니다.
`external_call_id`는 대화 ID여야 합니다.

## 제한 사항

- **Get SIP Headers** 작업은 초기 `INVITE`만 읽으므로 에이전트의 `REFER`에서는 아무것도 읽을 수 없습니다. 핸드오프는 UUI를 통해서만 Genesys에 전달됩니다.
- 통화에 UUI 헤더가 둘 이상 포함되면 Genesys는 모든 UUI를 삭제합니다.
- 전송 주소는 254자로 제한되므로 긴 UUI는 길이에 맞게 잘립니다.
  핸드오프 ID는 항상 들어갑니다.
