ナビゲーションにスキップ

Freshdesk

Webhookツールを使用して、通話からFreshdeskチケットを作成します。

Webhookツールを使うと、発信者から問題の報告やサポートの依頼があったときに、受付担当がFreshdeskチケットを作成し、チームが対応できるようになります。Growth、プロ、エンタープライズの各プランでは、FreshdeskのMCPサーバーを接続して既存のチケットを検索することもできます。

チケットを作成する

1

APIキーを取得する

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

2

認証ヘッダーを作成する

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

printf 'YOUR_API_KEY:X' | base64

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

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

3

Webhookツールを作成する

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

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

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

4

テストする

問題を報告して、受付担当をテストします。Freshdeskにチケットが表示されます。

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

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

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

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

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

フィールド値
NameFreshdesk
Server typeStreamable HTTP
Server URLhttps://YOURDOMAIN.freshdesk.com/mcp
HTTP HeadersAuthorization:プレフィックスなしの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キーを指定します。