> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 통화 전환 노드

> 통화를 다른 번호로 전환하는 노드를 설정하는 방법을 안내합니다.

통화 전환 노드는 진행 중인 전화 통화를 상담원이나 부서 번호로 넘깁니다. 이 노드는 웹 통화가 아닌 전화 통화에서만 작동합니다.

하나의 통화 전환 노드는 하나의 전환 대상만 가집니다. 여러 번호나 부서로 나눠 보내야 한다면 [조건 노드](/docs/build/flow/nodes/condition-node)로 먼저 분기한 뒤, 각 분기마다 통화 전환 노드를 하나씩 연결하세요.

## 프롬프트 타입

통화 전환 시 에이전트가 말할 내용을 설정합니다:

<CardGroup cols={3}>
  <Card title="동적 프롬프트" icon="pen">
    전환 시 동적으로 생성할 메시지 프롬프트를 작성합니다.
  </Card>

  <Card title="고정 발화" icon="comment">
    전환 시 말할 고정된 문장을 설정합니다.
  </Card>

  <Card title="없음" icon="ban">
    에이전트가 아무런 메시지 없이 즉시 통화를 전환합니다.
  </Card>
</CardGroup>

## 전환 구성

### 전환 대상

전환할 전화번호를 입력합니다. `{{variableName}}` 형식으로 동적 변수를 사용하여 런타임에 번호를 결정할 수도 있습니다.

API로 플로우를 작성할 때도 전환 대상은 `transferConfiguration.transferTo` 하나만 사용합니다.

### 여러 전환 대상 구성

통화 전환 노드 안에서 여러 대상을 조건별로 고르지는 않습니다. 여러 대상이 필요하면 조건 노드에서 먼저 분기하세요.

1. 조건 노드에서 문의 유형이나 사용자 선택을 판단합니다.
2. 각 조건의 다음 노드로 별도 통화 전환 노드를 연결합니다.
3. 각 통화 전환 노드에는 하나의 전환 대상만 입력합니다.

### 전환 방식

<CardGroup cols={2}>
  <Card title="즉시 전환" icon="forward">
    AI가 다음 상담원에게 브리핑 없이 통화를 전달합니다. 사용자를 다른 부서의 대기열로 보내거나 일반적인 문의를 위한 다른 번호로 연결할 때 유용합니다.
  </Card>

  <Card title="안내 후 전환" icon="handshake">
    AI가 통화를 전달한 후 다음 상담원에게 브리핑을 제공합니다. 상담원이 통화를 이어받기 전에 고객의 상황을 미리 파악해야 할 때 유용합니다.
  </Card>
</CardGroup>

### 안내 후 전환 설정

안내 후 전환을 선택하면 추가 설정이 가능합니다:

| 설정            | 설명                                                     |
| ------------- | ------------------------------------------------------ |
| **발신자 표시 번호** | 상담원에게 표시될 번호를 선택합니다: 에이전트 번호 또는 사용자 번호                 |
| **안내 메시지**    | 상담원에게 전달할 안내 메시지를 설정합니다. 동적 프롬프트 또는 고정 발화를 선택할 수 있습니다. |

### SIP 헤더

PBX나 내부 VoIP 시스템으로 전환할 때만 사용합니다. 일반 전화번호로 전환할 때는 설정하지 않아도 됩니다.

### 입력 검증

시스템은 입력된 전환 대상의 유효성을 자동으로 검증합니다:

* **전화번호**: 한국 전화번호 형식 및 최소 8자리 이상 확인
* **SIP URI**: SIP 전환을 사용할 때만 형식 확인

## 실제 사용 예시

### 상담원 직접 연결

에이전트가 처리할 수 없는 문의를 사람 상담원에게 넘기는 패턴입니다.

| 항목        | 설정            |
| --------- | ------------- |
| **전환 대상** | 010-XXXX-XXXX |
| **전환 방식** | 안내 후 전환       |

안내 후 전환을 사용하면 상담원이 통화를 이어받기 전에 고객 상황을 미리 파악할 수 있습니다.

### 문의 유형별 연결

조건 노드에서 분기한 뒤, 각 문의 유형에 맞는 전화번호로 통화를 전환합니다.

| 조건 노드 결과 | 다음 노드     | 전환 대상         |
| -------- | --------- | ------------- |
| 항공 문의    | 항공팀 전환 노드 | 070-XXXX-XXXX |
| 투어 문의    | 투어팀 전환 노드 | 070-XXXX-XXXX |
| 숙소 문의    | 숙소팀 전환 노드 | 070-XXXX-XXXX |

**조건 노드 분기 조건 예시:**

```text theme={null}
- "사용자가 항공 관련 문의를 선택한 경우"
- "사용자가 투어/티켓 관련 문의를 선택한 경우"
```

<Tip>
  SIP 전환이나 SIP 헤더는 PBX, 교환기, 내부 VoIP 시스템과 연동할 때만 설정하세요.
</Tip>

## 노드 설정

* **글로벌 노드**: 자세한 내용은 [글로벌 노드](../advanced/global-node)에서 확인하세요.

***

<Accordion title="연관 검색어">
  통화 전환 노드, transfer node, 전화 전환, 콜 트랜스퍼, SIP, 상담원 연결, cold transfer, warm transfer
</Accordion>