---
title: "Five9에서 연결"
description: "AI Agent Connect를 사용하여 Five9 통화를 SIP를 통해 ThunderPhone 에이전트로 보내고, IVR 스크립트가 읽는 라우팅 헤더와 함께 다시 받으세요."
---

Five9 IVR 스크립트는 Five9의 통화 세부정보와 함께 발신자를 에이전트로 연결합니다. 에이전트가 작업을 마치면 SIP `BYE`의 라우팅 헤더와 함께 통화를 종료하고, 스크립트는 이를 통화 변수로 읽어 발신자를 라우팅합니다.

## 시작하기 전에

- ThunderPhone 에이전트와 조직 [API 키](/ko/guides/api-keys).
- Five9의 **AI 에이전트 연결** 추가 기능. Five9는 이를 인증한 AI 제공업체로 제한하며, Five9 구현 팀이 설정합니다. 제공업체의 IVR 스크립트 템플릿을 가져오고, 통화 변수를 생성하며, 스크립트의 **타사 전송** 모듈이 제공업체를 가리키도록 구성합니다. ThunderPhone은 아직 Five9의 인증 목록에 없습니다. 이를 전제로 계획하기 전에 Five9 계정 팀이나 ThunderPhone 지원팀에 문의하십시오.

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

Five9의 타사 전송 모듈은 SIP 주소가 아닌 전화번호로 전화를 걸며, 다른 제공업체의 Five9 통합은 비밀번호 대신 소스 주소로 Five9를 인증합니다. 따라서 Five9가 다이얼할 번호를 다이얼인 번호로 사용하여 `ip_allowlist` 엔드포인트를 만드십시오([전화번호로 전화를 거는 플랫폼](/ko/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`: Five9에서 제공하는 Five9 데이터 센터의 SIP 신호 범위입니다. 각 범위는 `/16` 또는 그보다 좁은 공용 IPv4 범위여야 합니다(IPv6는 `/48` 또는 그보다 좁아야 함).
- `dial_in_numbers`: Five9의 스크립트가 다이얼할 번호이며, Five9가 전송하는 형식으로 작성합니다. 실제 전화번호일 필요는 없습니다. ThunderPhone에서 전화번호 또는 다른 엔드포인트로 이미 사용 중인 번호일 수 없으며, 이 경우 `409`가 반환됩니다.

Five9의 주소는 모든 고객이 공유하므로, 다른 Five9 고객이 이 번호로 전화를 걸면 귀하의 에이전트에 연결됩니다. 번호를 선택할 수 있다면 아무도 추측하지 못할 긴 번호를 선택하고(최대 15자리), Five9가 이를 전화 네트워크로 내보내지 않고 ThunderPhone으로 전송하는지 확인하며, 공개하지 마십시오.

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

Five9 구현 팀에 다음을 요청하십시오.

- **타사 전송** 모듈에서 `sip:+14155550188@sip.thunderphone.com`으로 통화를 전송하고, 요청 URI와 `To` 헤더 모두에 번호를 넣습니다. 이 모듈은 제공업체의 SIP 도메인이 포함된 헤더에서 번호를 가져옵니다.
- TLS(포트 5061) 또는 TCP(포트 5060)를 통해 전송합니다. 엔드포인트는 UDP를 거부하며 Five9는 사용하는 전송 방식을 공개하지 않으므로, UDP가 아닌지 확인하십시오.
- 에이전트가 통화를 종료한 후 스크립트가 계속 진행되도록 **타사 통화 후 반환**을 켭니다(Five9는 타사 통화에서 최대 3,600초를 허용함).

Five9 가이드에는 전송하는 값(`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` 등)은 나열되어 있지만 헤더 이름은 나열되어 있지 않습니다. 다른 AI 제공업체의 Five9 통합에서는 전송 수준에서 이를
`X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
및 `X-AgentID`로 문서화합니다. 첫 번째 테스트 통화에서 이를 확인하십시오. 각 값은
`{{sip_x_callcampaign}}`와 같은 변수로 프롬프트에 전달됩니다. `X-CallID`는 통화의
`external_call_id`로 저장됩니다.

## 3. 통화를 다시 받기

에이전트가 통화를 반환합니다. 작별 인사를 하고 전화를 끊으면 `BYE`에 Five9 스크립트가 읽는 네 개의 헤더가 포함됩니다. 이 전환 번호를 추가합니다([전환 번호 추가](/ko/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` 및 `X-RouteValue`는 스크립트에 발신자를 보낼 위치를 알려 줍니다. 여기서는 Support 스킬입니다. 다른 제공업체에서 `X-RouteType`에 대해 문서화하는 값에는 `SkillTransfer`, `PhoneTransfer`, `Hangup`, `DispositionOnly`가 포함됩니다. 스크립트를 유지 관리하는 담당자와 값을 합의합니다. 여러 대상에 전송하려면 대상마다 이름과 `X-RouteValue`가 다른 반환을 하나씩 추가합니다.
- `X-RouteReason`에는 `billing_dispute`와 같은 에이전트의 의도 라벨이 포함됩니다.
- `X-CustomMetaData`에는 인계 ID가 포함됩니다. `BYE`에도 `X-TP-Handoff-Id`로 포함되지만 Five9는 이를 읽지 않습니다.

Five9 스크립트는 네 개의 헤더를 통화 변수에 매핑합니다. 에이전트 요약을 위해 스크립트가 IVR **쿼리** 모듈로 인계 조회를 호출하도록 설정합니다.
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` 뒤에
`call.call_id`를 붙이고, `Authorization: Bearer`와 API 키를 전송하는 인증 프로필을 사용합니다.
[인계된 통화 조회](/api-reference/calls#look-up-a-handed-off-call)를 참고합니다.

## 테스트하기

IVR 스크립트로 전화를 걸고 에이전트에게 담당자를 요청한 다음, 스크립트가 통화 변수를 채운 상태로 발신자를 라우팅하는지 확인합니다. 통화가 에이전트에게 도달하지 않으면 요청 URI와 `To` 헤더의 번호가 접속 번호와 일치하는지, Five9의 소스 주소가 `allowed_source_cidrs`에 포함되어 있는지, 통화가 TCP 또는 TLS를 통해 들어왔는지 확인합니다. 그런 다음 `GET /v1/calls/{call_id}`로 통화를 엽니다. `sip_headers`에 `x-callid`가 나열되어야 하며, `external_call_id`는 Five9의 `call.call_id`와 일치해야 합니다.

## 제한 사항

- Five9 가이드에는 `BYE`의 라우팅 데이터가 문서화되어 있으며 `REFER` 수락은 언급되어 있지 않습니다. 따라서 반환은 스크립트가 수행하는 콜드 전환입니다.
- Five9는 `User-to-User`가 아니라 `X-RouteType`, `X-RouteValue`, `X-RouteReason`, `X-CustomMetaData`를 읽습니다. ThunderPhone은 각 헤더 값을 최대 256바이트 길이로 전송합니다.
- Five9는 패킷 단편화를 방지하기 위해 사용자 지정 헤더를 약 10개로 유지할 것을 권장합니다.
