zendesk-automation

Rube MCP による Zendesk の自動化

Rube MCP を通じて、Composio の Zendesk ツールキットを使い、Zendesk の操作を自動化します。

ツールキットのドキュメント：composio.dev/toolkits/zendesk

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能）
• ツールキット zendesk を指定した RUBE_MANAGE_CONNECTIONS による有効な Zendesk 接続
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の入手：クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確かめます
2. ツールキット zendesk を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Zendesk 認証を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

主なワークフロー

1. チケットの一覧表示と検索

使用するタイミング：サポートチケットの表示、絞り込み、検索を行う場合

ツールの順序：

1. ZENDESK_LIST_ZENDESK_TICKETS - ページネーションを使用してすべてのチケットを一覧表示します［必須］
2. ZENDESK_GET_ZENDESK_TICKET_BY_ID - 特定のチケットの詳細を取得します［任意］

主なパラメーター：

• page：ページ番号（1 から開始）
• per_page：1 ページあたりの結果数（最大 100）
• sort_by：並べ替えフィールド（'created_at'、'updated_at'、'priority'、'status'）
• sort_order：'asc' または 'desc'
• ticket_id：単一のチケットを取得するためのチケット ID

注意点：

• LIST は page／per_page によるページネーションを使用し、offset ベースではありません。レスポンスの next_page を確認してください
• 1 ページあたりの結果は最大 100 件です。next_page が null になるまでページ番号を順に指定してください
• 削除されたチケットは LIST では返されません。ステータス 'deleted' を返す GET_BY_ID を使用してください
• チケットのコメントと監査情報は GET_BY_ID には含まれますが、LIST のレスポンスには含まれません

2. チケットの作成と更新

使用するタイミング：新しいチケットの作成や既存のチケットの変更を行う場合

ツールの順序：

1. ZENDESK_SEARCH_ZENDESK_USERS - リクエスター／担当者を検索します［前提条件］
2. ZENDESK_CREATE_ZENDESK_TICKET - 新しいチケットを作成します［必須］
3. ZENDESK_UPDATE_ZENDESK_TICKET - チケットのフィールドを更新します［任意］
4. ZENDESK_DELETE_ZENDESK_TICKET - チケットを削除します［任意］

主なパラメーター：

• subject：チケットの件名
• description：チケットの本文（作成時に使用され、最初のコメントになります）
• priority：'urgent'、'high'、'normal'、'low'
• status：'new'、'open'、'pending'、'hold'、'solved'、'closed'
• type：'problem'、'incident'、'question'、'task'
• assignee_id：割り当て先のエージェントのユーザー ID
• requester_id：リクエスターのユーザー ID
• tags：タグ文字列の配列
• ticket_id：チケット ID（更新／削除用）

注意点：

• UPDATE で指定したタグは既存のタグをすべて置き換えます。既存のタグを保持するには、現在のタグと統合してください
• 同時変更による競合を防ぐには、updated_stamp とともに safe_update を使用してください
• DELETE は完全かつ取り消し不能です。チケットは復元できません
• description は作成時にのみ使用されます。作成後にコメントを追加するには REPLY_ZENDESK_TICKET を使用してください
• クローズ済みのチケットは更新できません。代わりにフォローアップチケットを作成してください

3. チケットへの返信

使用するタイミング：チケットにコメントや返信を追加する場合

ツールの順序：

1. ZENDESK_GET_ZENDESK_TICKET_BY_ID - 現在のチケットの状態を取得します［前提条件］
2. ZENDESK_REPLY_ZENDESK_TICKET - 返信／コメントを追加します［必須］

主なパラメーター：

• ticket_id：返信先のチケット ID
• body：返信本文
• public：ブール値。公開返信の場合は true、内部メモの場合は false
• author_id：作成者のユーザー ID（デフォルトは認証済みユーザー）

注意点：

• エージェントのみが閲覧できる内部メモには public: false を設定してください
• デフォルトは公開返信で、リクエスターにメールが送信されます
• 本文では HTML がサポートされています
• 返信と同時にチケットのステータスを更新することもできます

4. ユーザーを管理する

使用する場面：Zendesk のユーザー（エージェント、エンドユーザー）を検索または作成したい場合

ツールの順序：

1. ZENDESK_SEARCH_ZENDESK_USERS - ユーザーを検索します［必須］
2. ZENDESK_CREATE_ZENDESK_USER - 新しいユーザーを作成します［任意］
3. ZENDESK_GET_ABOUT_ME - 認証済みユーザーの情報を取得します［任意］

主なパラメーター：

• query：検索文字列（名前、メールアドレス、電話番号などに一致）
• name：ユーザーの氏名（作成時に必須）
• email：ユーザーのメールアドレス
• role：'end-user'、'agent'、または 'admin'
• verified：メールアドレスが確認済みかどうか

注意点：

• ユーザー検索はあいまい検索のため、一部のみ一致する結果が返る場合があります
• 既存のメールアドレスを使ってユーザーを作成すると、既存のユーザーが返されます（アップサート動作）
• エージェントおよび管理者のロールには、特定のプラン機能が必要な場合があります

5. 組織を管理する

使用する場面：組織を一覧表示、作成、または管理したい場合

ツールの順序：

1. ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS - すべての組織を一覧表示します［必須］
2. ZENDESK_GET_ZENDESK_ORGANIZATION - 特定の組織を取得します［任意］
3. ZENDESK_CREATE_ZENDESK_ORGANIZATION - 組織を作成します［任意］
4. ZENDESK_UPDATE_ZENDESK_ORGANIZATION - 組織を更新します［任意］
5. ZENDESK_COUNT_ZENDESK_ORGANIZATIONS - 合計数を取得します［任意］

主なパラメーター：

• name：組織名（一意である必要があり、作成時に必須）
• organization_id：取得または更新する組織の ID
• details：組織の詳細テキスト
• notes：内部メモ
• domain_names：関連付けられたドメインの配列
• tags：タグ文字列の配列

注意点：

• 組織名は一意である必要があります。同じ名前があると作成時にエラーになります
• UPDATE 時のタグは既存のタグを置き換えます（チケットと同じ動作）
• ドメイン名は、ユーザーを自動的に関連付けるために使用できます

よくあるパターン

ページネーション

一覧表示エンドポイント：

• page（1 から始まる）と per_page（最大 100）を使用します
• レスポンス内の next_page URL を確認します。null の場合は最終ページです
• count フィールドには合計結果数が含まれます

チケットのライフサイクル

new -> open -> pending -> solved -> closed
                  |          ^
                  v          |
                hold --------+

• new：未割り当てのチケット
• open：担当者に割り当てられ、対応中
• pending：顧客からの返信待ち
• hold：社内での対応待ち
• solved：解決済み。再オープン可能
• closed：完全にクローズ済み。変更不可

割り当て時のユーザー検索

1. Call ZENDESK_SEARCH_ZENDESK_USERS with query (name or email)
2. Extract user ID from results
3. Use user ID as assignee_id in ticket creation/update

既知の注意点

タグの動作：

• 更新時のタグは既存のタグをすべて置き換えます
• 更新前に必ず現在のタグを取得し、統合してください
• タグは小文字で、スペースは使用できません（アンダースコアを使用してください）

安全な更新：

• 競合を防ぐには、updated_stamp（ISO 8601）とともに safe_update: true を使用します
• スタンプ以降にチケットが変更されている場合は 409 が返されます

削除：

• チケットの削除は恒久的で、取り消せません
• 削除する代わりに、ステータスを 'closed' に設定することを検討してください
• 削除されたチケットは API から復元できません

レート制限：

• デフォルト：1 分あたり 400 リクエスト
• プランのティアによって異なります
• 429 レスポンスには Retry-After ヘッダーが含まれます

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
チケットを一覧表示	ZENDESK_LIST_ZENDESK_TICKETS	page, per_page, sort_by
チケットを取得	ZENDESK_GET_ZENDESK_TICKET_BY_ID	ticket_id
チケットを作成	ZENDESK_CREATE_ZENDESK_TICKET	subject, description, priority
チケットを更新	ZENDESK_UPDATE_ZENDESK_TICKET	ticket_id, status, tags
チケットに返信	ZENDESK_REPLY_ZENDESK_TICKET	ticket_id, body, public
チケットを削除	ZENDESK_DELETE_ZENDESK_TICKET	ticket_id
ユーザーを検索	ZENDESK_SEARCH_ZENDESK_USERS	query
ユーザーを作成	ZENDESK_CREATE_ZENDESK_USER	name, email
自分のプロフィール	ZENDESK_GET_ABOUT_ME	(none)
組織を一覧表示	ZENDESK_GET_ALL_ZENDESK_ORGANIZATIONS	page, per_page
組織を取得	ZENDESK_GET_ZENDESK_ORGANIZATION	organization_id
組織を作成	ZENDESK_CREATE_ZENDESK_ORGANIZATION	name
組織を更新	ZENDESK_UPDATE_ZENDESK_ORGANIZATION	organization_id, name
組織数を取得	ZENDESK_COUNT_ZENDESK_ORGANIZATIONS	(none)

---

Composio 提供