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

# Copper

受付担当は、Copperに登録済みの発信者を識別し、新規発信者をリードとして追加できます。また、発信者の要望をメモし、チーム向けのフォローアップタスクを作成できます。発信者の検索とタスクの作成には[Webhookツール](/docs/ja/reception-ai/integrations/webhooks)を使用します。リードとメモの追加には[Zapier](/docs/ja/reception-ai/integrations/zapier)を使用します。Copperでは電話番号とメモのリンクがネストされたデータとして保存されますが、Webhookツールでは送信できないためです。

## 始める前に

Copperで**System settings** → **API Keys**を開き、**Generate API key**を選択します。たとえば`Reception.ai`というラベルを付けます。このキーはユーザー本人と同じ権限を持つため、アクセス可能なデータの閲覧や変更ができます。

以下のすべてのWebhookツールは、次のリクエストヘッダーを送信します。

| ヘッダー               | 値                   |
| ------------------ | ------------------- |
| `X-PW-AccessToken` | APIキー               |
| `X-PW-Application` | `developer_api`     |
| `X-PW-UserEmail`   | キーを作成したユーザーのメールアドレス |

> **Warning**
>
> APIキーとメールアドレスを持つ人は誰でもCopperのデータを閲覧・変更できます。キーを
> 共有ドキュメントには記載せず、漏えいした場合はCopperで削除してください。

## Webhookツールを作成する

ツールごとに**Integrations**に移動し、**Add integration**を選択して、**Webhook Tool**を選び、**Assign to agents**を**Receptionist**に設定します。Copperの検索エンドポイントでは、本文に検索条件を含むPOSTを使用します。

### 連絡先を検索する

| フィールド               | 値                                                       |
| ------------------- | ------------------------------------------------------- |
| **Name**            | `find_copper_person`                                    |
| **Description**     | 「電話番号で連絡先から発信者を検索します。通話の開始時に使用し、顧客かどうかを確認してください。」       |
| **Method**          | POST                                                    |
| **URL**             | `https://api.copper.com/developer_api/v1/people/search` |
| **Request Headers** | [始める前に](#before-you-start)に記載されたヘッダー                    |
| **Body Parameters** | `phone_number`（文字列、必須）：「発信者の電話番号。」                      |

### リードを検索する

| フィールド               | 値                                                      |
| ------------------- | ------------------------------------------------------ |
| **Name**            | `find_copper_lead`                                     |
| **Description**     | 「電話番号でリードから発信者を検索します。発信者が連絡先に登録されていない場合に使用してください。」     |
| **Method**          | POST                                                   |
| **URL**             | `https://api.copper.com/developer_api/v1/leads/search` |
| **Request Headers** | [始める前に](#before-you-start)に記載されたヘッダー                   |
| **Body Parameters** | `phone_number`（文字列、必須）：「発信者の電話番号。」                     |

### フォローアップタスクを作成する

| フィールド               | 値                                                                                       |
| ------------------- | --------------------------------------------------------------------------------------- |
| **Name**            | `create_copper_task`                                                                    |
| **Description**     | 「発信者に折り返しを約束した場合は、必ずチーム向けのタスクを作成してください。」                                                |
| **Method**          | POST                                                                                    |
| **URL**             | `https://api.copper.com/developer_api/v1/tasks`                                         |
| **Request Headers** | [始める前に](#before-you-start)に記載されたヘッダー                                                    |
| **Body Parameters** | `name`（文字列、必須）：「例：キッチンの見積もりについてJane Doeに折り返し電話する。」  `details`（文字列、必須）：「発信者の名前、電話番号、要件。」 |

各ツールで**Enable**を選択します。

## リードとメモを追加する

### Zapierに接続する

まだ接続していない場合は、Reception.aiで[Zapier](/docs/ja/reception-ai/integrations/zapier)に接続します。

### Copperのアクションを追加する

[mcp.zapier.com](https://mcp.zapier.com)のZapier MCPサーバーでCopperアカウントに接続し、次のアクションを追加します。

* **Create Lead**：オーナーとリードソースを固定値として設定し、発信者の名前、電話番号、メールアドレス、要望をAIに入力させます。
* **Create Activity**：アクティビティの種類をメモに設定し、検索ツールで見つかった人物またはリードと、発信者の要件をAIに入力させます。

### ツールを割り当てる

Reception.aiでZapierインテグレーションの**Tools**タブを開き、**Refresh tools**を選択して、両方のCopperアクションを**Client**（受付担当）に割り当てます。

### テストする

Copperの連絡先に保存されている番号から電話をかけて[受付担当をテスト](/docs/ja/reception-ai/receptionist/testing)し、次に折り返しを依頼する新しい番号からテストします。新規発信者がリードとして表示され、Copperにタスクが表示されます。

> **Tip**
>
> [手順](/docs/ja/reception-ai/receptionist/rules-and-procedures)を追加して、受付担当が最初に
> 連絡先とリードを検索し、どちらにも発信者が見つからなかった場合にのみリードを作成するようにします。

## 制限事項

* Webhookツールはフラットな値を送信しますが、Copperではネストされた値を使ってタスクを人物またはリードにリンクします。そのため、`create_copper_task`で作成したタスクは発信者のレコードにリンクされません。代わりに、タスクの詳細に発信者の名前と電話番号が保存されます。
* Copperは期限をUnixタイムスタンプとして受け取りますが、AIでは確実に算出できないため、`create_copper_task`では期限が空欄になります。
* タスクを発信者にリンクしたり期限を設定したりするには、Webhookツールの代わりにZapier経由でCopperの**Create Task**アクションを使用してください。
* 受付担当がZapierアクションを実行するたびに、Zapierプランのタスクが消費されます。プランの上限に達すると、リセットされるまでアクションは停止します。

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

| 問題                            | 確認事項                                                                           |
| ----------------------------- | ------------------------------------------------------------------------------ |
| Copperから401または403エラーが返される     | 3つのヘッダーをすべて確認します。`X-PW-UserEmail`には、キーを生成したユーザーのメールアドレスを指定する必要があります。           |
| 登録済みの発信者が見つからない               | Copperは保存されている形式の電話番号と照合します。番号の形式を統一し、発信者が会社ではなく人物またはリードとして登録されていることを確認してください。 |
| 受付担当が重複するリードを作成する             | 検索ツールの説明で、発信者が見つからなかった場合にのみリードを作成するよう指示します。                                    |
| Copperのアクションが表示されない           | Zapierでアクションを追加した後、Zapierインテグレーションで**Refresh tools**を選択します。                    |
| アクションに**Changed**と表示され、使用されない | Zapierでアクションが編集されています。**Tools**タブで**Update**を選択します。                            |