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

# Nutshell

受付担当は、Nutshellにすでに登録されている発信者を認識し、新しい発信者を人物として追加して、チームがフォローアップするためのリードを作成できます。発信者の検索には[Webhookツール](/docs/ja/reception-ai/integrations/webhooks)を使用します。人物とリードの追加には[Zapier](/docs/ja/reception-ai/integrations/zapier)を使用します。NutshellのAPIでレコードを作成するにはリストとネストされた値が必要ですが、Webhookツールでは送信できないためです。

## 発信者を検索する

### APIキーを作成する

Nutshellで左下の **Settings** を選択し、**Connections** の下にある **API keys** を選択します。**Add API key** を選択し、Zapierでも必要となる **API + user impersonation** を選びます。キーをコピーしてください。

### 認証ヘッダーを作成する

NutshellのAPIでは、Nutshellのメールアドレスをユーザー名、APIキーをパスワードとして使用します。ターミナルで両方の値を置き換え、その間のコロンを残したままエンコードします。

```bash
printf 'YOUR_EMAIL:YOUR_API_KEY' | base64
```

ヘッダー値は `Basic ` の後に出力結果を続けたものです。

> **Warning**
>
> APIキーをオンラインエンコーダーに貼り付けないでください。キーまたはエンコード済みヘッダーを持つ人は誰でも、
> Nutshellのデータを読み取り、変更できます。

### Webhookツールを作成する

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

| フィールド                | 値                                                             |
| -------------------- | ------------------------------------------------------------- |
| **Name**             | `find_nutshell_person`                                        |
| **Description**      | 「電話番号、氏名、またはメールアドレスでCRM内の発信者を検索する。通話の開始時に使用し、既存の顧客かどうかを確認する。」 |
| **Method**           | GET                                                           |
| **URL**              | `https://app.nutshell.com/rest/contacts`                      |
| **Request Headers**  | `Authorization`: `Basic ` の後にエンコードした値を続ける                     |
| **Query Parameters** | `q`（文字列、必須）：「発信者の電話番号、氏名、またはメールアドレス。」                         |
| **Assign to agents** | **Receptionist**                                              |

**Enable** を選択します。

## 人物とリードを追加する

### Zapierを接続する

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

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

[mcp.zapier.com](https://mcp.zapier.com)にあるZapier MCPサーバーで、APIキーを使ってNutshellアカウントを接続し、以下のアクションを追加します。

* **Create Person**：AIが発信者の氏名、電話番号、メールアドレスを入力できるようにします。
* **Create Lead**：ソース、パイプライン、担当者を固定値として設定し、発信者の希望内容と対象者の説明をAIが入力できるようにします。

> **Tip**
>
> 人物のタイムラインに通話を記録するには、**Log Activity** も追加し、AIが
> 短い要約を入力できるようにします。

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

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

### テストする

Nutshellの人物に保存されている番号から電話をかけ、次に見積もりを希望する新規発信者として[受付担当をテスト](/docs/ja/reception-ai/receptionist/testing)します。新しい人物とそのリードがNutshellに表示されます。

## 制限事項

* ZapierのNutshellアプリには、フォローアップタスクを作成するアクションがありません。代わりに、リードの担当者がNutshellで新しいリードを確認します。
* ZapierのNutshellアプリでは誰の空き状況も確認できないため、受付担当はNutshellでミーティングを予約できません。[Google Calendar](/docs/ja/reception-ai/integrations/google-calendar)を使ったReception独自の予約機能を使用してください。
* 受付担当が実行するZapierアクションごとに、Zapierプランのタスクが消費されます。現在、Zapierでは成功した通話1件につき2タスクとしてカウントされ、失敗した通話はカウントされません。プランの上限に達すると、リセットされるまでアクションは停止します。

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

| 問題                                 | 確認事項                                                             |
| ---------------------------------- | ---------------------------------------------------------------- |
| Nutshellから401が返される                 | Nutshellのメールアドレス、コロン、キーをエンコードし、ヘッダー値を `Basic ` で始めてください。         |
| 登録済みの発信者が見つからない                    | Nutshellの人物に保存されている番号からテスト通話をかけるか、代わりに発信者の氏名を尋ねてください。            |
| 受付担当が人物を重複して作成する                   | 検索ツールの説明で、発信者が見つからなかった場合にのみ人物を追加するよう指示してください。                    |
| NutshellのアクションがReception.aiに表示されない | Zapierでアクションを追加した後、Zapierインテグレーションで **Refresh tools** を選択してください。 |
| ZapierからNutshellに接続できない            | **API + user impersonation** が有効なAPIキーを使用してください。                 |