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

# Freshdesk

[Webhookツール](/docs/ja/reception-ai/integrations/webhooks)を使うと、発信者から問題の報告やサポートの依頼があったときに、受付担当がFreshdeskチケットを作成し、チームが対応できるようになります。Growth、プロ、エンタープライズの各プランでは、Freshdeskの[MCPサーバー](#look-up-tickets-with-the-mcp-server)を接続して既存のチケットを検索することもできます。

## チケットを作成する

### APIキーを取得する

Freshdeskでプロフィール画像を選択し、**Profile settings**を開いて、**View API key**を選択します。キーをコピーしてください。このキーはエージェントアカウントとして機能するため、チケットはその権限で作成されます。

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

Freshdeskでは、APIキーをユーザー名、`X`をパスワードとして使用します。ターミナルで、`YOUR_API_KEY`を実際のキーに置き換えてエンコードします。

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

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

> **Warning**
>
> APIキーをオンラインエンコーダーに貼り付けないでください。キーまたはエンコード済みヘッダーを知っている人は、
> チケットを閲覧・変更できます。

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

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

| フィールド                | 値                                                                                                                                                                                                                                                                              |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Name**             | `create_freshdesk_ticket`                                                                                                                                                                                                                                                      |
| **Description**      | 「発信者が問題を報告したとき、またはチームのサポートが必要なときに、サポートチケットを作成する。」                                                                                                                                                                                                                              |
| **Method**           | POST                                                                                                                                                                                                                                                                           |
| **URL**              | `https://YOURDOMAIN.freshdesk.com/api/v2/tickets`                                                                                                                                                                                                                              |
| **Request Headers**  | `Authorization`：`Basic `の後にエンコード済みキーを続ける                                                                                                                                                                                                                                       |
| **Body Parameters**  | `name`（文字列、必須）：「発信者の氏名。」  `phone`（文字列）：「発信者の電話番号。」  `email`（文字列）：「発信者が伝えた場合は、そのメールアドレス。」  `subject`（文字列、必須）：「問題の短い要約。」  `description`（文字列、必須）：「発信者が報告した内容を、提供された詳細も含めて本人の言葉で記載する。」  `status`（数値、必須）：「常に正確な値`2`。」  `priority`（数値、必須）：「常に正確な値`1`。」  `source`（数値、必須）：「常に正確な値`3`。」 |
| **Assign to agents** | **Receptionist**                                                                                                                                                                                                                                                               |

`YOURDOMAIN`をFreshdeskのサブドメインに置き換えます。**Enable**を選択してください。

### テストする

問題を報告して、[受付担当をテスト](/docs/ja/reception-ai/receptionist/testing)します。Freshdeskにチケットが表示されます。

固定値により、チケットは**Open**（status `2`）、優先度**Low**（priority `1`）で作成され、**Phone**（source `3`）からの問い合わせとして記録されます。受付担当が優先度を設定できるようにするには、代わりに値の意味を説明します。例：「低は1、中は2、高は3、緊急は4。」

Freshdeskで依頼者を検索または作成するには、電話番号かメールアドレスが必要です。発信者の電話番号を必ず確認するよう受付担当に指示してください。

## MCPサーバーでチケットを検索する

Freshdeskの[MCPサーバー](/docs/ja/reception-ai/integrations/mcp-server)は、Growth、プロ、エンタープライズの各プランで利用できます。これを使うと、受付担当が発信者の既存チケットを検索できます。MCPアクションは、プランに応じた年間利用枠にカウントされます。

Reception.aiで**Integrations**に移動し、**Add integration**を選択して、**MCP Server**を選びます。

| フィールド            | 値                                      |
| ---------------- | -------------------------------------- |
| **Name**         | Freshdesk                              |
| **Server type**  | Streamable HTTP                        |
| **Server URL**   | `https://YOURDOMAIN.freshdesk.com/mcp` |
| **HTTP Headers** | `Authorization`：プレフィックスなしのAPIキー        |

Reception.aiが入力どおりに`Authorization`ヘッダーを送信できるよう、**Secret Token**は空欄のままにします。カスタムドメインを使用している場合でも、`freshdesk.com`のサブドメインを使用してください。**Enable**を選択します。

**Tools**タブを開き、`fetchSearchTickets`や`fetchTicket`などのチケット検索ツールを**Client**（受付担当）に割り当てます。チケット、エージェント、グループ、記事を更新するツールは割り当てないでください。

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

| 問題                          | 確認事項                                                                                 |
| --------------------------- | ------------------------------------------------------------------------------------ |
| Freshdeskから401が返される         | キーの後に`:X`を付けてエンコードし、ヘッダー値の先頭を`Basic `と半角スペースにします。                                    |
| 依頼者に関する400エラー               | チケットには氏名に加えて、電話番号またはメールアドレスが必要です。受付担当がこれらを確認していることを確かめてください。                         |
| statusまたはpriorityに関する400エラー | `status`、`priority`、`source`は文字列ではなく数値パラメーターにする必要があります。                              |
| MCPサーバーにツールが表示されない          | `freshdesk.com`のサブドメインを使用し、`Authorization`ヘッダーに`Basic`や`Bearer`を付けず、未加工のAPIキーを指定します。 |