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

# Trello

発信者から折り返し電話や見積もりなど、チームによるフォローアップが必要な依頼を受けたとき、受付担当者はTrelloリストにカードを追加できます。[Webhookツール](/docs/ja/reception-ai/integrations/webhooks)がTrelloのREST APIを通じてカードを作成します。

## 始める前に

### APIキーを取得する

[Power-Up管理ポータル](https://trello.com/apps/admin)に移動し、ワークスペース用のPower-Upを作成します（名前は任意です）。そのPower-Upの **Trello Auth** タブを開き、**Generate a new API key** を選択します。

### トークンを生成する

APIキーの横にある **Token** リンクを選択するか、次のURLの`API_KEY`を自分のAPIキーに置き換えてブラウザで開きます。

```
https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=Reception&key=API_KEY
```

**Allow** を選択し、トークンをコピーします。このトークンを使うと、アクセス可能なすべてのボードを読み取り、変更できます。必要なボードにのみ参加しているアカウントから生成することをおすすめします。

### リストIDを確認する

ブラウザでボードを開き、URLの末尾に`.json`を追加してページを読み込みます。リスト名を検索すると、その横にある`id`の値がリストIDです。

## Webhookツールを作成する

**Integrations** に移動し、**Add integration** を選択して、**Webhook Tool** を選びます。

| フィールド                | 値                                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------------- |
| **Name**             | `create_trello_card`                                                                                    |
| **Description**      | 「発信者にフォローアップを約束した場合や、チームによる対応が必要な依頼を受けた場合は、チーム用のカードを作成する。」                                              |
| **Method**           | POST                                                                                                    |
| **URL**              | `https://api.trello.com/1/cards?idList=LIST_ID`                                                         |
| **Request Headers**  | `Authorization`：`OAuth oauth_consumer_key="API_KEY", oauth_token="TOKEN"`                               |
| **Body Parameters**  | `name`（文字列、必須）：「発信者の名前と要件を含む短いタイトル。例：見積もりについてJane Doeに折り返し電話する。」  `desc`（文字列、必須）：「発信者の名前、電話番号、依頼内容の詳細。」 |
| **Assign to agents** | **Receptionist**                                                                                        |

URLフィールド自体に、リストIDを使って`?idList=LIST_ID`と入力します。`idList`をクエリパラメーターとして追加しないでください。クエリパラメーターはAIによって入力されますが、URL内のテキストは記述どおりに送信されます。

> **Note**
>
> Trelloでは、`&key=API_KEY&token=TOKEN`の形式でキーとトークンをURLに含めることもできます。この方法でも動作しますが、
> ヘッダーを使えばURLにキーとトークンを含めずに済みます。URLに含める場合は、URL全体を
> 機密情報として扱ってください。

**Enable** を選択し、折り返し電話を依頼して[受付担当者をテスト](/docs/ja/reception-ai/receptionist/testing)します。カードがリストの一番下に表示されます。

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

| 問題                         | 確認事項                                                                                |
| -------------------------- | ----------------------------------------------------------------------------------- |
| Trelloが401を返す              | ヘッダーを確認してください。キーとトークンはそれぞれ二重引用符で囲み、カンマと半角スペースで区切る必要があります。トークンが取り消されている場合は再生成してください。 |
| `invalid value for idList` | URL内のリストIDが正しくありません。ボードの`id`ではなく、リストの`id`を使用してください。                                 |
| Trelloが404を返す、またはアクセスできない  | トークンのユーザーがボードのメンバーである必要があります。                                                       |
| 受付担当者がカードを作成しない            | ツールの説明に、カードを作成すべき状況を明記してください。                                                       |