> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Notion

리셉셔니스트는 Notion 워크스페이스를 검색하고, 페이지를 읽고, 가격표, 제품 표, 진행 중인 채용 목록과 같은 데이터베이스를 살펴보며 발신자에게 답변할 수 있습니다. 읽기 기능은 모든 Notion 요금제에서 작동하며 공유한 페이지만 볼 수 있는 Notion 내부 연결을 통해 [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)로 이루어집니다. 데이터베이스에 항목을 추가하는 기능도 콘텐츠만 추가할 수 있는 두 번째 연결을 통해 웹훅 도구로 사용할 수 있습니다. 대신 [Zapier](/docs/ko/reception-ai/integrations/zapier)를 사용할 수도 있지만, Zapier 계정이나 Zapier 작업을 필요로 하지 않고 각 요청이 Notion으로 직접 전송되므로 웹훅 도구를 권장합니다. 단, 웹훅 도구는 제목 속성을 채울 수 없으므로 항목에 실제 제목이 필요하다면 Zapier를 사용하세요.

> **Note**
>
> Notion 콘텐츠가 거의 변경되지 않는다면 통합이 필요하지 않을 수 있습니다. Notion에서 페이지를 내보내고
> 대신 [지식 베이스에 업로드](#use-the-knowledge-base-instead)하세요.

> **Warning**
>
> 리셉셔니스트는 연결과 공유한 모든 내용을 읽고 발신자에게 그대로 말할 수 있습니다.
> 발신자가 들어도 되는 페이지만 공유하고, 리셉셔니스트가 고객 세부 정보와 같은
> 비공개 기록을 발신자에게 절대 읽어 주지 않도록 하는
> [규칙](/docs/ko/reception-ai/receptionist/rules-and-procedures)을 추가하세요.

## 설정

### 내부 연결 만들기

워크스페이스 소유자여야 합니다. [app.notion.com/developers/connections](https://app.notion.com/developers/connections)로 이동하여 **Internal connections**를 선택한 다음 **Create a new connection**을 선택하세요. 이름을 `Reception.ai`로 지정하고 워크스페이스를 선택합니다. **Configuration** 탭에서 콘텐츠 읽기만 허용하고 **API token**을 복사하세요.

### 연결에 페이지 공유하기

연결의 **Content access** 탭을 열고 **Edit access**를 선택한 뒤 리셉셔니스트가 읽을 페이지와 데이터베이스를 선택하세요. 또는 Notion에서 페이지를 열고 **•••** → **Connections** → **+ Add connection**을 선택한 다음 `Reception.ai`를 고를 수 있습니다. 하위 페이지도 함께 공유됩니다.

### 데이터 소스 ID 찾기

리셉셔니스트가 데이터베이스를 읽을 수 있도록 하려면 Notion에서 데이터베이스 설정을 열고 **Manage data sources**를 선택한 다음, 데이터 소스 옆의 **•••** 메뉴를 열어 **Copy data source ID**를 선택하세요.

### 웹훅 도구 만들기

[아래 도구](#tools)를 만드세요. 각 도구에서 **Integrations**로 이동해 **Add integration**을 선택하고 **Webhook Tool**을 고르세요.

### 테스트하기

공유한 페이지 중 하나에서 답을 찾을 수 있는 질문을 하여 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요.

## 도구

모든 도구는 다음 요청 헤더를 전송합니다.

| 헤더               | 유형     | 값                     |
| ---------------- | ------ | --------------------- |
| `Authorization`  | Secret | `Bearer ` 뒤에 연결 토큰 입력 |
| `Notion-Version` | Value  | `2026-03-11`          |

각 도구에서 **Assign to agents**를 **Receptionist**로 설정하고 **Enable**을 선택하세요.

### 페이지 검색

| 필드                  | 값                                                                                                  |
| ------------------- | -------------------------------------------------------------------------------------------------- |
| **Name**            | `search_notion`                                                                                    |
| **Description**     | "제목으로 Notion 페이지를 검색합니다. 발신자가 문서에서 답을 찾을 수 있는 내용을 물으면 사용한 뒤, 가장 적합한 결과를 `read_notion_page`로 읽으세요." |
| **Method**          | POST                                                                                               |
| **URL**             | `https://api.notion.com/v1/search`                                                                 |
| **Body Parameters** | `query` (문자열, 필수): "`pricing` 또는 `opening hours`처럼 검색할 짧은 제목입니다."  `page_size` (숫자, 고정값): `10`     |

### 페이지 읽기

| 필드                   | 값                                                         |
| -------------------- | --------------------------------------------------------- |
| **Name**             | `read_notion_page`                                        |
| **Description**      | "`search_notion`으로 찾은 Notion 페이지의 전체 텍스트를 읽습니다."          |
| **Method**           | GET                                                       |
| **URL**              | `https://api.notion.com/v1/pages/{page_id}/markdown`      |
| **Path Parameters**  | `page_id` (문자열, 필수): "`search_notion`이 반환한 페이지의 `id`입니다." |
| **Query Parameters** | `markdown_version` (문자열, 고정값): `v2`                       |

### 데이터베이스 읽기

| 필드                  | 값                                                                     |
| ------------------- | --------------------------------------------------------------------- |
| **Name**            | `read_notion_table`                                                   |
| **Description**     | "가격표의 행을 나열합니다. 발신자가 가격이나 제공 서비스에 관해 물을 때 사용하세요." 대신 여기에 자체 표를 설명하세요. |
| **Method**          | POST                                                                  |
| **URL**             | `https://api.notion.com/v1/data_sources/DATA_SOURCE_ID/query`         |
| **Body Parameters** | `page_size` (숫자, 고정값): `100`                                          |

`DATA_SOURCE_ID`를 복사한 ID로 바꾸세요. 데이터베이스마다 고유한 이름과 설명을 사용해 도구를 하나씩 만드세요.

## 웹훅 도구로 데이터베이스 항목 추가하기(권장)

통화에서 얻은 리드 또는 콜백 요청 같은 정보를 Notion 데이터베이스에 저장하려면 항목을 추가하는 도구를 만드세요.

### 새 항목용 연결 만들기

첫 번째와 같은 방법으로 예를 들어 `Reception.ai entries`라는 두 번째 내부 연결을 만드세요. **Configuration** 탭에서 콘텐츠 삽입만 허용하고 **API token**을 복사하세요. **Content access**에서는 항목을 추가할 데이터베이스만 공유하세요. 이 연결은 어떤 내용도 다시 읽을 수 없으므로 항목은 비공개로 유지됩니다.

### 데이터베이스 준비하기

[설정](#set-up)에서처럼 데이터베이스의 데이터 소스 ID를 복사하세요. 도구가 채우는 각 속성은 요청의 키가 되며 키에는 공백을 포함할 수 없으므로, 해당 속성에 `Phone`, `Email`, `Status`처럼 한 단어 이름을 지정하세요.

### 웹훅 도구 만들기

**Integrations**로 이동해 **Add integration**을 선택하고 **Webhook Tool**을 고르세요.

| 필드                   | 값                                                                                         |
| -------------------- | ----------------------------------------------------------------------------------------- |
| **Name**             | `add_notion_entry`                                                                        |
| **Description**      | "발신자가 견적이나 콜백을 원할 때 리드 데이터베이스에 새 리드를 저장합니다." 대신 여기에 자체 데이터베이스를 설명하세요.                     |
| **Method**           | POST                                                                                      |
| **URL**              | `https://api.notion.com/v1/pages`                                                         |
| **Request Headers**  | `Authorization` (Secret): `Bearer ` 뒤에 새 연결 토큰 입력  `Notion-Version` (Value): `2026-03-11` |
| **Body Parameters**  | `parent` (객체, 필수)  `markdown` (문자열, 필수)  `markdown_version` (문자열)  `properties` (객체, 필수)  |
| **Assign to agents** | **Receptionist**                                                                          |

본문 매개변수는 다음과 같이 설정하세요.

* `parent`: 필드 하나, `data_source_id` (문자열, 고정값): 데이터 소스 ID입니다.
* `markdown` (대화에서 가져오기): "Markdown 형식의 항목입니다. `# ` 뒤에 발신자의 이름과 필요한 내용을 넣은 줄로 시작하세요. 예: `# Jane Doe: quote for a new boiler`. 그다음 빈 줄을 추가하고 요청의 세부 정보를 작성하세요."
* `markdown_version` (고정값): `v2`
* `properties`: 채울 속성마다 한 번씩 **Add field**를 선택하세요. 각각은 속성과 정확히 같은 이름의 객체이며, 값용 필드 하나를 포함합니다.
  * `Phone` (객체): `phone_number` (문자열, 대화에서 가져오기): "발신자의 전화번호입니다."
  * `Email` (객체): `email` (문자열, 대화에서 가져오기): "발신자의 이메일 주소입니다. 발신자에게 다시 철자를 확인하세요. 제공하지 않았다면 생략하세요."
  * `Status` (객체, 필수): `select` (객체, 필수), 필드 하나 포함, `name` (문자열, 고정값): `New`

Notion 문서에 따르면 제목 속성을 생략하면 첫 번째 `#` 제목이 페이지 제목이 됩니다. 문서에서는 페이지 안에서 만든 페이지에 대해서만 이를 보여 주므로, 데이터베이스에서도 작동하는지 확인하세요. 어느 경우든 제목과 세부 정보는 항목 콘텐츠로 저장되고 전화번호, 이메일, 상태 속성이 채워집니다. `properties`에서 제목 속성은 생략하세요. Notion은 제목과 텍스트 값을 6단계 깊이로 중첩하는데, 이는 웹훅 도구가 허용하는 수준보다 한 단계 더 깊습니다. 전화번호, 이메일, URL, 숫자, 체크박스, 선택, 날짜 속성은 사용할 수 있습니다. 상태 유형 속성에는 `select` 대신 `status`를 사용합니다.

**Enable**을 선택한 다음 콜백을 요청하여 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. 데이터베이스에 항목이 표시됩니다.

## Zapier로 데이터베이스 항목 추가하기

대신 Zapier를 통해 항목을 추가하려면 [Zapier](/docs/ko/reception-ai/integrations/zapier)를 연결하세요. [mcp.zapier.com](https://mcp.zapier.com)의 Zapier MCP 서버에서 Notion **Create Data Source Item** 작업을 추가하고, 데이터베이스를 고정값으로 설정한 후 AI가 필드를 채우도록 하세요. Reception.ai에서 Zapier 통합의 **Tools** 탭을 열고 **Refresh tools**를 선택한 다음 작업을 **Client**(리셉셔니스트)에 할당하세요.

## 대신 지식 베이스 사용하기

자주 바뀌지 않는 콘텐츠에는 [지식 베이스](/docs/ko/reception-ai/knowledge-base/overview)가 실시간 조회보다 더 간단하고 빠릅니다. Notion에서 페이지의 **•••** 메뉴를 열고 **More** → **Export**를 선택한 다음 **PDF**, **HTML**, 또는 **Markdown & CSV**를 고르세요. HTML 및 Markdown 내보내기는 zip 파일로 다운로드되므로 먼저 압축을 푸세요. 그런 다음 [파일을 업로드](/docs/ko/reception-ai/knowledge-base/file-uploads)하세요. 데이터베이스는 CSV로 내보내지며 지식 베이스는 이를 지원하지 않으므로 데이터베이스는 PDF로 내보내세요. 콘텐츠가 변경되면 다시 내보내고 업로드하세요.

## 제한 사항

* Notion 검색은 페이지 내부 텍스트가 아니라 페이지와 데이터베이스 제목을 일치시킵니다. 페이지에 "Cancellation policy"처럼 명확한 제목을 지정하세요.
* `read_notion_table`은 처음 100개 행과 해당 속성만 반환하며, 각 행의 페이지 안에 있는 콘텐츠는 반환하지 않습니다. 리셉셔니스트가 읽는 표는 작게 유지하세요.
* Notion의 호스팅 MCP 서버는 브라우저 로그인이 필요합니다. 단, 비즈니스 및 엔터프라이즈 요금제에서는 워크스페이스 소유자가 MCP 토큰을 만들 수 있습니다. 위의 웹훅 도구는 모든 요금제에서 작동합니다.
* `add_notion_entry`는 제목 또는 텍스트 속성을 채울 수 없습니다. 대신 이름과 메모를 제목과 콘텐츠에 넣으세요.
* Zapier를 통해 항목을 추가하면 리셉셔니스트가 실행하는 각 Zapier 작업은 Zapier 요금제의 작업 수를 사용합니다. 현재 Zapier는 성공한 호출당 작업 2개를 계산합니다.

## 문제 해결

| 문제                                          | 확인할 사항                                                                                                                 |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Notion에서 401 응답                             | `Authorization` 헤더는 `Bearer ` 뒤에 연결 토큰이 와야 합니다.                                                                        |
| 버전에 관한 400 응답                               | `Notion-Version`을 `2026-03-11`로 설정하세요.                                                                                 |
| 404 또는 `object_not_found`                   | 페이지 또는 데이터베이스를 연결과 공유하고, 데이터베이스 ID가 아닌 데이터 소스 ID를 사용하세요.                                                               |
| `read_notion_page`에서 403 응답                 | 연결에 콘텐츠 읽기 권한이 필요합니다.                                                                                                  |
| `add_notion_entry`에서 403 응답                 | 항목용 연결에는 콘텐츠 삽입 권한과 데이터베이스 액세스 권한이 필요합니다.                                                                              |
| `add_notion_entry`에서 400 `validation_error` | `properties`의 각 키는 속성 이름과 정확히 일치해야 하며, 해당 필드는 속성 유형과 일치해야 합니다.                                                         |
| 새 항목이 **Untitled**로 표시됨                     | Notion이 `#` 제목을 데이터베이스의 제목으로 인식하지 못했습니다. 제목은 여전히 각 항목 페이지 상단에 있으며 전화번호나 상태로 항목을 찾을 수 있습니다. 제목을 지정하려면 Zapier 옵션을 사용하세요. |
| 검색 결과가 없음                                   | 검색은 제목만 일치시키며 연결과 공유된 페이지만 대상으로 합니다.                                                                                   |
| 큰 표에서 리셉셔니스트가 느림                            | 큰 표는 많은 데이터를 반환합니다. 표를 분할하거나 콘텐츠를 지식 베이스로 옮기세요.                                                                        |