# 워크플로우 액션 - 통화 중 입력값 수집 (IVR)

**목차**

* [개요](#개요)
* [액션 이름](#액션-이름)
* [액션 설명](#액션-설명)
* [액션 세부사항](#액션-세부사항)
* [예시](#예시)

## 개요

통화 중 입력값 수집(Gather Input On Call) 액션을 사용하면 발신자로부터 키패드를 통해 입력값을 수집할 수 있습니다. 이는 발신자가 특정 키를 누르도록 안내하는 IVR 시스템에서 사용됩니다(예: "고객지원은 1번, 메시지 남기기는 2번을 눌러주세요"). 이 액션은 응답을 자동화하고 사용자 입력에 따라 다음 단계로 진행하는 데 도움이 됩니다.

## 액션 이름

**통화 중 입력값 수집(Gather Input On Call)**

## 액션 설명

**통화 중 입력값 수집(IVR)** 액션은 DTMF(Dual Tone Multi-Frequency) 입력을 통해 발신자로부터 정보를 수집합니다. 주로 IVR 플로우에서 사용되며, 사용자가 전화기의 키를 눌러 시스템과 상호작용합니다. 키 입력에 따라 다양한 분기를 설정할 수 있어, 입력값에 따른 맞춤형 플로우가 가능합니다.

## 액션 세부사항

![통화 중 입력값 수집 액션 설정 화면](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155032467893/original/UcwBIizZxLaiHIF6_C7pXEdsTOKADGR4dg.png?1725822507)

![매치 조건 설정 화면](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155032467902/original/GGJsEM9GZ_TeC1H01k3e01ossdpOH4BbWA.png?1725822537)

### **설정 방법:**

* **액션 이름**: 이 IVR 입력값 수집 액션에 적절한 이름을 설정하세요.
* **메시지 말하기 또는 재생**: "메시지 말하기"(텍스트 음성 변환) 또는 미리 녹음된 오디오 파일 업로드 중 선택하세요.
* **읽을 텍스트**: "메시지 말하기"를 선택한 경우, 재생될 메시지를 입력하세요(예: "고객지원은 1번을 눌러주세요").
* **언어**: 텍스트 음성 변환에 사용할 언어를 선택하세요.
* **메시지 음성**: 텍스트 음성 변환 메시지에 "남성" 또는 "여성" 음성 중 선택하세요.
* **반복 횟수**: 다음 단계로 진행하기 전에 메시지를 몇 번 반복할지 설정하세요.
* **고급 설정**: 입력값 수집을 중단할 시간 초과(초 단위)를 설정하고, 선택적으로 사용자가 키를 누르면 입력값 수집을 중단하도록 설정할 수 있습니다.
* **매치 조건**: 이 기능을 사용하여 발신자의 입력에 따른 분기를 만들 수 있습니다. 예:
  * 분기 1: 고객지원 "1"번
  * 분기 2: 영업팀 "2"번

| 필드명           | 설명                                       | 필수 여부 |
| ------------- | ---------------------------------------- | ----- |
| 액션 이름         | 액션의 이름을 입력하세요.                           | 예     |
| 메시지 말하기 또는 재생 | 메시지를 말할지 미리 녹음된 오디오 파일을 재생할지 선택하세요.      | 예     |
| 읽을 텍스트        | "메시지 말하기"를 선택한 경우, 발신자에게 읽어줄 텍스트를 입력하세요. | 예     |
| 언어            | 메시지를 읽을 언어를 선택하세요.                       | 예     |
| 메시지 음성        | 남성 또는 여성 음성 중 선택하세요.                     | 예     |
| 반복 횟수         | 메시지를 몇 번 재생하거나 반복할지 선택하세요.               | 예     |
| 수집 중단 시간(초)   | 몇 초 후에 수집을 중단할지 설정하세요.                   | 예     |
| 수집 중단 자릿수     | 입력 수집을 중단하기 전에 몇 자리 숫자를 수집할지 지정하세요.      | 아니오   |
| 키 입력 시 수집 중단  | 키가 눌리면 즉시 입력값 수집을 중단하려면 활성화하세요.          | 아니오   |
| 매치 조건         | 키 입력값에 따른 분기를 정의할 수 있는 옵션입니다.            | 예     |

## 예시

**시나리오**: 은행 IVR 시스템에서 발신자로부터 입력값을 수집하는 경우.

**메시지**: "계좌 내역 조회는 1번, 상담원 연결은 2번, 종료는 3번을 눌러주세요."

키 입력:

* "1"번을 누르면 계좌 내역을 읽어주는 분기로 이동합니다.
* "2"번을 누르면 고객지원 상담원에게 연결됩니다.
* "3"번을 누르면 고객에게 감사 인사 후 통화를 종료합니다.

***

*원문 최종 수정: 2024년 9월 8일* *Hyperclass 사용 가이드 — hyperclass.ai*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hyperclass.gitbook.io/hyperclass-docs/workflows/workflow-action-ivr-gather-input-on-call.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.