Gorgias 自動化
Claude Code から Gorgias ヘルプデスクの操作を自動化します。サポートチケットの作成、更新、トリアージ、顧客管理、チーム編成を、ターミナルから離れることなくすべて実行できます。
ツールキットドキュメント: composio.dev/toolkits/gorgias
セットアップ
- Claude Code の設定に Rube MCP サーバーを追加します（URL:
https://rube.app/mcp） - プロンプトが表示されたら、提供された接続リンクを使用して Gorgias アカウントを認証します
- 自然言語でサポートワークフローの自動化を開始します
コアワークフロー
1. チケットの一覧とフィルタリング
ステータス、チャネル、担当者、日付範囲などでフィルタリングしてチケットを取得します。
ツール: GORGIAS_LIST_TICKETS
過去7日間にメールチャネルで作成されたすべてのオープンチケットを一覧表示
主なパラメーター:
status-- チケットステータスでフィルタリング（例：「open」、「closed」）channel-- チャネルでフィルタリング（例：「email」、「chat」）assignee_user_id/assignee_team_id-- 担当エージェントまたはチームでフィルタリングcreated_from/created_to-- ISO 日付範囲フィルターlimit（最大100）/offset-- ページネーション制御order_by/order_dir-- ソートオプション
2. チケットの作成と更新
新しいチケットを作成したり、既存のチケットに割り当て、優先度、ステータスの変更を加えて更新します。
ツール: GORGIAS_CREATE_TICKET、GORGIAS_UPDATE_TICKET、GORGIAS_GET_TICKET
顧客12345の注文未着に関する高優先度チケットを作成（件名：「注文#9876が届いていません」）
GORGIAS_CREATE_TICKETはcustomer_idが必要です。subject、status、priority、channel、messages、tagsを受け付けますGORGIAS_UPDATE_TICKETはticket_idが必要です。その他のフィールドはすべてオプションの部分更新ですGORGIAS_GET_TICKETはticket_idで完全なチケット詳細を取得します
3. チケットタグの管理
分類、ルーティング、レポート作成のためにチケットにタグを追加します。
ツール: GORGIAS_ADD_TICKET_TAGS、GORGIAS_LIST_TICKET_TAGS
タグ101と202をチケット5678に追加し、そのチケットのすべてのタグを表示
GORGIAS_ADD_TICKET_TAGSはticket_idとtag_ids（整数の配列）が必要ですGORGIAS_LIST_TICKET_TAGSはticket_idが必要で、現在のタグを取得します
4. 顧客管理
新しい顧客を作成したり、重複する顧客レコードを結合します。
ツール: GORGIAS_CREATE_CUSTOMER、GORGIAS_MERGE_CUSTOMERS、GORGIAS_LIST_CUSTOMERS
「Jane Doe」という名前の新規顧客を作成（メール: [email protected]、電話チャネル）
GORGIAS_CREATE_CUSTOMERはnameが必要です。email、channels（typeとvalueを持つ配列）、external_id、address、dataを受け付けますGORGIAS_MERGE_CUSTOMERSはsource_customer_idとtarget_customer_idが必要です。ソースがターゲットにマージされますGORGIAS_LIST_CUSTOMERSはフィルタリングオプション付きで顧客を取得します
5. チームとアカウントの操作
チームの一覧表示、アカウント情報の取得、チケットカスタムフィールドの確認を行います。
ツール: GORGIAS_LIST_TEAMS、GORGIAS_GET_TEAM、GORGIAS_GET_ACCOUNT、GORGIAS_LIST_TICKET_FIELD_VALUES
Gorgias アカウントのすべてのサポートチームを表示
GORGIAS_GET_ACCOUNTはアカウントレベルのメトリクスと設定を返しますGORGIAS_LIST_TEAMS/GORGIAS_GET_TEAMはチーム検索を管理しますGORGIAS_LIST_TICKET_FIELD_VALUESは指定されたチケットのカスタムフィールド値を返します
6. アクティビティとイベントの追跡
チケットアクティビティと顧客イベント履歴を監視します。
ツール: GORGIAS_LIST_EVENTS
最近のイベントを一覧表示し、サポートキュー全体でどのようなアクティビティが発生したかを確認
GORGIAS_LIST_EVENTSはフィルタリングオプション付きのアクティビティタイムラインを提供します
既知の注意点
- ページネーションが必要:
GORGIAS_LIST_TICKETSはlimit/offsetページネーションを使用します。ページをループしないと古いチケットを見逃し、不完全なデータになります。 - フィルターの具体性:
GORGIAS_LIST_TICKETSでフィルターが不足していたり広すぎると、エクスポートが過負荷になったり、希望するレポート期間が抜けたりします。時間範囲クエリでは必ずcreated_from/created_toを設定してください。 - カスタムフィールドは別途取得: 主要なビジネス KPI はカスタムフィールドにしか存在しない場合があります。それらを含めるには
GORGIAS_LIST_TICKET_FIELD_VALUESを明示的にクエリする必要があります。 - レート制限:
GORGIAS_LIST_TICKETSおよび関連エンドポイントでの大量エクスポートは Gorgias のレート制限に達する可能性があります。バックオフを追加し、最後のオフセットから再開してください。 - 認証エラー: いずれかの Gorgias ツールでの 401/403 応答は、トークンまたは権限の問題を示します。部分的なデータを完全なデータセットとして扱わないでください。
クイックリファレンス
| ツールスラッグ | 説明 |
|---|---|
GORGIAS_LIST_TICKETS | フィルター付きでチケットを一覧表示（ステータス、チャネル、日付、担当者） |
GORGIAS_GET_TICKET | 特定のチケットを ID で取得 |
GORGIAS_CREATE_TICKET | 新しいチケットを作成（customer_id が必要） |
GORGIAS_UPDATE_TICKET | チケットフィールドを更新（ticket_id が必要） |
GORGIAS_ADD_TICKET_TAGS | チケットにタグを追加 |
GORGIAS_LIST_TICKET_TAGS | チケットのすべてのタグを一覧表示 |
GORGIAS_LIST_TICKET_FIELD_VALUES | チケットのカスタムフィールド値を一覧表示 |
GORGIAS_CREATE_CUSTOMER | 新しい顧客を作成（name が必要） |
GORGIAS_MERGE_CUSTOMERS | 2つの顧客レコードを結合 |
GORGIAS_LIST_CUSTOMERS | フィルター付きで顧客を一覧表示 |
GORGIAS_LIST_TEAMS | すべてのチームを一覧表示 |
GORGIAS_GET_TEAM | 特定のチームを取得 |
GORGIAS_GET_ACCOUNT | アカウント情報を取得 |
GORGIAS_LIST_EVENTS | フィルター付きでアクティビティイベントを一覧表示 |
Powered by Composio