> ## 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.

# 프로젝트

> 수신자 목록을 시트로 만들고, 컬럼으로 수신자마다 다른 값을 채울 수 있어요.

**발신 > 대량 발신**의 **프로젝트** 탭에 수신자 목록이 쌓여요. 프로젝트를 열면 시트가 뜨고, 이 시트에서 통화와 문자를 보내요.

![대량 발신 프로젝트 탭의 이름, 상태, 발신, 수정일시 컬럼이 있는 프로젝트 목록](https://mintcdn.com/fleek/QFb6_BihC098mXOt/images/screens/operate/outbound/projects/list.webp?fit=max\&auto=format\&n=QFb6_BihC098mXOt\&q=85\&s=90b29c94d865209284622abd34e1febb)

## 발신 목록 만들기

오른쪽 위 **프로젝트 만들기**에서 시작 방법을 고르세요.

* **빈 프로젝트**: 빈 시트가 바로 열려요. 수신번호가 몇 건뿐이라 직접 넣는 편이 빠를 때 고르세요.
* **파일 업로드**: 정리해 둔 CSV나 Excel 파일을 올려요. 파일 이름에서 확장자를 뗀 값이 프로젝트 이름이 돼요.

![프로젝트 만들기 메뉴의 빈 프로젝트와 파일 업로드](https://mintcdn.com/fleek/QFb6_BihC098mXOt/images/screens/operate/outbound/projects/create-menu.webp?fit=max\&auto=format\&n=QFb6_BihC098mXOt\&q=85\&s=74c62e809f8ed0a4585dfa4f4eeefedf)

**파일 업로드**를 고르면 **파일 업로드** 창이 열려요. 파일을 끌어다 놓으면 미리보기에 100행까지 보이고, **만들기**를 누르면 프로젝트가 만들어져요. 형식이 헷갈리면 **템플릿 다운로드**에서 CSV나 XLSX 견본을 먼저 받으세요. 견본 헤더는 `전화번호`, `이름`, `변수1`, `변수2`예요.

![파일 업로드 창의 파일을 끌어다 놓는 영역과 템플릿 다운로드](https://mintcdn.com/fleek/QFb6_BihC098mXOt/images/screens/operate/outbound/projects/upload-dialog.webp?fit=max\&auto=format\&n=QFb6_BihC098mXOt\&q=85\&s=f9f445e5907c6409b4ffdf37133c670d)

| 항목 | 제한 |
| - | - |
| 형식 | CSV, Excel |
| 크기 | 50MB |
| 행 수 | 65,536행 |
| 필수 컬럼 | `전화번호` |

## 시트에서 수신자 다듬기

행을 누르면 시트가 열려요. 시트는 수신번호와 수신자별 값을 담는 표예요.

![프로젝트 시트의 전화번호 컬럼과 변수 컬럼, 세 행이 선택된 상태와 상단 툴바](https://mintcdn.com/fleek/QFb6_BihC098mXOt/images/screens/operate/outbound/projects/sheet.webp?fit=max\&auto=format\&n=QFb6_BihC098mXOt\&q=85\&s=7ad71d380aa05a0bfa296085c6fd9b3c)

* **수신자마다 다른 값을 넣을 때**: 표 오른쪽 끝 **열 추가**를 누르면 **변수 추가** 창이 열려요. `전화번호` 말고 다른 컬럼 이름이 그대로 [동적 변수](https://docs.tryvox.co/docs/build/variables/dynamic-variables.md) 이름이 돼요.
* **일부만 골라 보낼 때**: 행 앞 체크박스로 고르세요. 고른 건수는 화면 아래 **개수**에 보여요.
* **시트를 파일로 받을 때**: **발신** 옆 드롭다운의 **내보내기**에서 CSV나 Excel을 고르세요.
* **이 시트로 돌린 건을 볼 때**: 같은 드롭다운에서 **대량 발신 이력**을 여세요.

`전화번호` 컬럼은 왼쪽에 고정되고 이름을 바꾸거나 지울 수 없어요. 체크박스는 전화번호가 있는 행에만 보여요. 시트 제목을 누르면 프로젝트 이름을 그 자리에서 고칠 수 있어요.

![변수 추가 창의 변수 이름 입력란](https://mintcdn.com/fleek/QFb6_BihC098mXOt/images/screens/operate/outbound/projects/add-column.webp?fit=max\&auto=format\&n=QFb6_BihC098mXOt\&q=85\&s=977b331582d7dfe576cbc00442e889c3)

## 프로젝트 찾아 정리하기

목록은 **프로젝트 검색**으로 좁히세요. 눈여겨볼 컬럼은 **상태**와 **발신**이에요.

* **상태**: 그 프로젝트로 만든 대량 발신 가운데 가장 앞선 것의 상태예요. 한 번도 걸지 않았으면 **발신 전**이고, 나머지 값은 [대량 발신 이력](https://docs.tryvox.co/docs/operate/outbound/batch-history.md)의 상태와 같아요.
* **발신**: 지금까지 실행한 대량 발신 수예요. 0이면 `-`로 보여요.

행 메뉴의 **내보내기**로 시트를 파일로 받고, **삭제**로 프로젝트를 지우세요. 삭제는 되돌릴 수 없어요.

## 문제가 생겼을 때

> [accordion] 올린 파일이 거부돼요
>
> 파일에 `전화번호` 컬럼이 있는지 먼저 확인하세요. 이름이 다르면 올릴 수 없어요. 파일은 50MB, 65,536행까지 올릴 수 있으니 더 크면 파일을 나눠 프로젝트를 여러 개 만드세요.

> [accordion] 행 앞에 체크박스가 없어요
>
> 그 행의 `전화번호`를 채우세요. 번호가 비어 있는 행에는 체크박스가 보이지 않아요.

> [accordion] 전체 선택을 눌렀는데 일부만 잡혀요
>
> 검색어를 지우고 다시 누르세요. 시트 검색이 걸려 있으면 걸러진 행만 골라요.

> [accordion] 컬럼 이름을 저장할 수 없어요
>
> 다른 이름을 쓰세요. 이미 있는 컬럼 이름과 `id`, `ID`, `전화번호`는 쓸 수 없어요.

## 관련 문서

* [전화 대량 발신](https://docs.tryvox.co/docs/operate/outbound/call-batch.md): 시트로 통화 걸기
* [대량 문자 발신](https://docs.tryvox.co/docs/operate/outbound/sms-batch.md): 시트로 문자 보내기
* [대량 발신 이력](https://docs.tryvox.co/docs/operate/outbound/batch-history.md): 실행한 건 찾기와 제어
* [동적 변수](https://docs.tryvox.co/docs/build/variables/dynamic-variables.md): 수신자별로 에이전트 말 바꾸기


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.