> 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`フィールドを1つ含む`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、ヘッダーを使用して、2つ目のWebhookツールを作成します。

| フィールド        | 値                                                            |
| ------------ | ------------------------------------------------------------ |
| **名前**       | `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/ja/reception-ai/receptionist/testing)し、2回目の会話でその依頼について尋ねます。

## 制限事項

作成ツールで設定できるのはアイテム名のみです。ステータス、日付、担当者の列を入力するには、GraphQLクエリ内にJSON値が必要ですが、レセプショニストがこれを確実に記述するのは困難です。列を設定するには、[Zapier](/docs/ja/reception-ai/integrations/zapier)経由でMonday.comの**Create Item**アクションを使用してください。

## トラブルシューティング

| 問題                   | 確認事項                                                      |
| -------------------- | --------------------------------------------------------- |
| `Not Authenticated`  | ヘッダーには`Bearer`なしで、トークンのみを設定する必要があります。                     |
| `Parse error on ...` | レセプショニストがクエリの形を変更しました。`query`の説明をより厳密にするか、アイテム名を短くしてください。 |
| アイテムが見つからない          | 検索ではアイテム名が完全に一致する必要があります。                                 |
| `Board not found`    | ボードIDと、トークンのオーナーがボードを閲覧できることを確認してください。                    |