# 봇 액션 - 연락처 정보 추가

## 봇 액션 - 연락처 정보 추가

**연락처 정보 추가** 기능을 사용하면 AI 대화에서 바로 연락처 정보를 쉽게 추가할 수 있어요. 사업 정보, 주소, 날짜 등을 고객의 응답에서 직접 수집해서 수동 데이터 입력을 줄이고 연락처 기록을 최신 상태로 유지할 수 있습니다.

***

**목차**

* [연락처 정보 추가 봇 액션이란?](#연락처-정보-추가-봇-액션이란)
* [연락처 정보 추가 액션의 주요 장점](#연락처-정보-추가-액션의-주요-장점)
* [연락처 정보 추가 액션 설정 방법](#연락처-정보-추가-액션-설정-방법)
* [자주 묻는 질문](#자주-묻는-질문)

***

## 연락처 정보 추가 봇 액션이란?

**연락처 정보 추가** 봇 액션은 대화 AI 채팅 중에 중요한 정보를 수집하고 자동으로 연락처 기록에 저장하는 기능이에요. 고객과 리드에 대한 정확하고 최신 정보를 효율적으로 관리할 수 있게 도와줍니다.

**중요**: 이 기능은 연락처 정보의 빈 필드만 업데이트해요. 연락처의 이메일과 전화번호는 자동으로 업데이트되므로 이 액션으로 이메일이나 전화번호를 추가하거나 업데이트할 필요는 없습니다.

**팁**: 연락처 정보를 저장한 후에는 봇의 프롬프트에서 고객에게 연락처 세부 정보를 명시적으로 요청하세요. 이 지시가 프롬프트에 포함되지 않으면 봇이 필요한 정보를 요청하지 않고, 연락처 필드가 업데이트되지 않아요.

***

### 연락처 정보 추가 액션의 주요 장점

* **빠른 데이터 수집**: 자연스러운 대화의 일환으로 주소, 사업 정보, 생년월일 등의 세부 정보를 수집할 수 있어요.
* **깔끔한 CRM 기록**: 연락처 프로필에 정보를 직접 저장해서 팀이 다시 입력할 필요가 없어요.
* **더 나은 개인화**: 수집된 세부 정보를 활용해서 응답, 후속 조치, 예약 플로우를 맞춤화할 수 있어요.
* **유연한 필드**: 표준 필드와 지원되는 커스텀 필드 유형을 모두 업데이트할 수 있어 특정 사용 사례에 맞게 활용 가능해요.

***

### 연락처 정보 추가 액션 설정 방법

**1단계: 에이전트 열기**

**AI Agents(AI 직원)** > **Conversation AI(대화 AI)** > \*\*Agents List(에이전트 목록)\*\*으로 이동하세요. 편집하려는 에이전트를 열어주세요.

![AI 에이전트 목록](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066406893/original/C5Nk7Rgv033kTT-VlvkhtqyMilhZ_UclVA.png?1772833791)

**2단계: 봇 목표 열기**

에이전트가 열리면 **Bot Goals(봇 목표)** 탭을 선택하세요.

![봇 목표 탭](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066406906/original/ME_6LQl4tJAW0tt4sXRMkHReNCI2pGZWkQ.png?1772833891)

**3단계: 연락처 정보 선택**

Setup your Actions(액션 설정) 섹션으로 스크롤해서 Contact Info(연락처 정보)를 선택하세요.

![연락처 정보 액션 선택](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066406925/original/9GMyHVOHGIhx4eYOFj1HATk14u6WcxiCiQ.png?1772833923)

**4단계: 액션 설정**

연락처 세부 정보 업데이트 액션을 설정하려면 다음 단계를 따라하세요:

* **Action Name(액션 이름)**: 원하는 액션 이름을 지정하세요. 나중에 액션을 알아보기 쉽게 도와줍니다. 예: "연락처 생년월일 업데이트"
* **Which contact field to be updated(업데이트할 연락처 필드)**: 드롭다운 메뉴에서 업데이트하려는 필드를 선택하세요(예: 이름, 전화번호, 이메일, 사업명 등).
* **What to update in the field(필드에서 업데이트할 내용)**: 세 번째 필드에 업데이트할 내용에 대한 간단한 설명을 작성하세요. 이 정보는 AI가 더 정확하고 개인화된 응답을 생성하는 데 도움이 돼요. 예를 들어, 생년월일을 선택했다면 "연락처의 생년월일입니다"라고 쓸 수 있어요. 사업명을 선택했다면 "연락처의 사업명입니다"라고 쓸 수 있습니다.
* **Output Example(출력 예시) (커스텀 필드만 해당)**: 해당되는 경우 업데이트된 정보의 예시를 최소 2개 제공하세요. 예를 들어, "좋아하는 음식은 무엇인가요?"를 업데이트한다면 "타코"와 "햄버거"를 입력할 수 있어요.

완료되면 \*\*Save(저장)\*\*를 클릭해서 새 연락처 정보 설정을 완료하세요.

![연락처 정보 액션 설정](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066406938/original/ZlCgvC0yucIJED6KAQNY9gUNva_NpN_PYA.png?1772834007)

**5단계: 프롬프트 업데이트**

봇의 Additional Information Prompt(추가 정보 프롬프트)를 업데이트해서 업데이트하려는 연락처 세부 정보를 고객에게 명시적으로 요청하세요. 이 지시가 프롬프트에 포함되지 않으면 봇이 필요한 정보를 요청하지 않고, 연락처 필드가 업데이트되지 않아요.

**예시**: 예약 전에 이름, 이메일, 전화번호, 사업명, 생년월일을 수집하고 싶다고 해보세요. 봇이 이러한 질문을 하도록 프롬프트의 Additional Information(추가 정보) 섹션에 다음을 추가하세요:

#### 필수 지시사항: 예약하기 전에 반드시 다음 질문들을 차례대로 물어보며 대화를 시작하세요

1. 고객의 이름을 물어보세요
2. 고객의 이메일을 물어보세요
3. 고객의 전화번호를 물어보세요
4. 고객의 생년월일을 물어보세요
5. 고객의 사업명을 물어보세요

**중요**: 이 지시가 프롬프트에 포함되지 않으면 봇이 필요한 정보를 요청하지 않고 연락처 필드가 업데이트되지 않아요.

![프롬프트 업데이트](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155066406960/original/BiVl3YyyKBwJsT5YTOgrJ_8GMIsQSZ7x0Q.png?1772834065)

***

### 자주 묻는 질문

**Q: 연락처 정보 추가 액션으로 추가할 수 있는 연락처 필드 수에 제한이 있나요?** 연락처 정보 추가 액션은 한 번에 제한된 수의 필드만 매핑할 수 있어요. 추가 정보를 수집해야 한다면 대화 AI에서 워크플로우를 트리거하고 워크플로우 안에서 연락처 필드 업데이트 액션을 사용해서 대화를 기반으로 필요한 만큼 많은 연락처 필드를 채울 수 있습니다.

**Q: 연락처 정보 추가 액션이 기존 값을 덮어쓸 수 있나요?**

아니에요. 이 액션은 빈 필드만 업데이트합니다.

***

*원문 최종 수정: 2026-03-06* *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/ai-ai-employee/bot-actions-add-contact-info.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.