> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Monday.com

리셉셔니스트는 신규 리드나 콜백 요청과 같은 항목을 Monday.com 보드에 추가하고, 이름으로 항목을 찾을 수 있습니다. Monday.com의 API는 GraphQL입니다. 모든 요청은 `query` 필드 하나를 포함하는 `POST`이므로, 각 도구는 리셉셔니스트가 채울 수 있는 쿼리 템플릿을 제공합니다.

## 시작하기 전에

| 값          | 확인 위치                                          |
| ---------- | ---------------------------------------------- |
| **API 토큰** | 프로필 사진 → **Developers** → **My access tokens** |
| **보드 ID**  | 보드 URL에서 `/boards/` 뒤에 있는 숫자                   |

이 토큰은 모든 보드에 대한 사용자 권한으로 작동합니다.

## 항목 만들기

**Integrations**로 이동해 **Add integration**을 선택한 다음 **Webhook Tool**을 선택하세요.

| 필드           | 값                                                 |
| ------------ | ------------------------------------------------- |
| **이름**       | `create_monday_item`                              |
| **설명**       | "팀 보드에 콜백 요청을 추가합니다. 발신자에게 후속 연락을 약속할 때마다 사용하세요." |
| **메서드**      | POST                                              |
| **URL**      | `https://api.monday.com/v2`                       |
| **요청 헤더**    | `Authorization`: `Bearer` 없이 API 토큰 입력            |
| **본문 매개변수**  | 아래 설명이 포함된 `query`(문자열, 필수)                       |
| **에이전트에 할당** | **Receptionist**                                  |

`query`에는 아래 설명을 사용하고, `1234567890`을 보드 ID로 바꾸세요.

```text
A GraphQL mutation in exactly this form, changing only ITEM_NAME:
mutation { create_item(board_id: 1234567890, item_name: "ITEM_NAME") { id } }
ITEM_NAME is the caller's name, phone number, and request, without double quotes.
```

**Enable**을 선택하세요.

## 항목 찾기

동일한 메서드, URL, 헤더로 두 번째 웹훅 도구를 만드세요.

| 필드          | 값                                                          |
| ----------- | ---------------------------------------------------------- |
| **이름**      | `find_monday_item`                                         |
| **설명**      | "보드에서 발신자의 항목을 정확한 이름으로 찾습니다. 발신자가 기존 작업에 관해 문의할 때 사용하세요." |
| **본문 매개변수** | 아래 설명이 포함된 `query`(문자열, 필수)                                |

```text
A GraphQL query in exactly this form, changing only ITEM_NAME:
query { items_page_by_column_values(board_id: 1234567890, limit: 5, columns: [{column_id: "name", column_values: ["ITEM_NAME"]}]) { items { name column_values { text column { title } } } } }
```

콜백 요청으로 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)한 후, 두 번째 대화에서 해당 요청에 관해 물어보세요.

## 제한 사항

만들기 도구는 항목 이름만 설정합니다. 상태, 날짜 또는 담당자 열을 채우려면 GraphQL 쿼리 안에 JSON 값을 작성해야 하는데, 리셉셔니스트가 이를 안정적으로 작성하기는 어렵습니다. 열을 설정하려면 [Zapier](/docs/ko/reception-ai/integrations/zapier)를 통해 Monday.com의 **Create Item** 액션을 사용하세요.

## 문제 해결

| 문제                   | 확인할 사항                                                       |
| -------------------- | ------------------------------------------------------------ |
| `Not Authenticated`  | 헤더에는 `Bearer` 없이 토큰만 입력해야 합니다.                               |
| `Parse error on ...` | 리셉셔니스트가 쿼리 구조를 변경했습니다. `query` 설명을 더 엄격하게 작성하거나 항목 이름을 줄이세요. |
| 항목을 찾을 수 없음          | 조회는 전체 항목 이름과 정확히 일치해야 합니다.                                  |
| `Board not found`    | 보드 ID와 토큰 소유자가 해당 보드를 볼 수 있는지 확인하세요.                         |