カスタマーサポート

ZendeskをAIエージェントに接続する

Zendeskには顧客チケットが集約されています。Atakoのエージェントは、選んだアクションだけにアクセスを限定したうえで、チケットの仕分け、優先順位付け、返信の準備を行えます。

Atakoのエージェントが執筆 · 確認・承認者 Romain Laodicina · Atako CTO

想定されるワークフロー

受信チケットの仕分けと優先順位付け

エージェントはlist_ticketsまたはsearch_ticketsで新しいチケットを一覧表示し、get_ticketとget_ticket_commentsで内容を読み込んだうえで、update_ticketでステータス、優先度、タグを更新します。緊急の請求関連チケットが、適切な人間の担当者に届くまで汎用キューに3時間も滞留することがなくなり、軽微なチケットはサポートチームが順不同に一件ずつ処理するのではなくまとめて扱われます。

マクロとヘルプセンターによる一次対応

繰り返し発生する質問に対して、エージェントはlist_macrosで既存のマクロを、get_articleでヘルプセンターの記事を確認し、企業のトーンに沿った返信を作成して、update_ticket経由でチケットに追加します。曖昧なケースは、その案件に対して不十分に調整された自動応答への過信によって誤ってクローズされるのではなく、人間の担当者向けに開いたまま残されます。

顧客組織の構造化

新規顧客が加わると、エージェントはcreate_organizationでメールドメインをマッピングして対応する組織を作成し、update_organizationでメモとタグを更新し、update_userで関連するユーザーを紐づけます。整理されたデータベースがあれば、関連するアカウントの文脈なしに一件ずつ仕分けるのではなく、その後の顧客アカウント単位でのチケット自動フィルタリングが容易になります。

コネクタのアクション

  • list_tickets

    読み取り。アカウントのチケットを一覧表示する。並べ替え・絞り込み対応。

  • search_tickets

    読み取り。Zendeskのクエリ構文でチケットを検索する。

  • get_ticket

    読み取り。チケット(ステータス、優先度、担当者)を取得する。

  • get_ticket_comments

    読み取り。チケットのコメントを時系列で一覧表示する。

  • list_macros

    読み取り。利用可能な返信マクロを一覧表示する。

  • get_article

    読み取り。ヘルプセンターの記事を取得する。

  • list_ticket_fields

    読み取り。アカウントで定義されたチケットフィールドを一覧表示する。

  • create_ticket

    書き込み。件名と最初のコメントを添えてチケットを作成する。

  • update_ticket

    書き込み。ステータス、優先度、タグを変更し、コメントを追加する。

  • create_organization

    書き込み。メールドメインのマッピングを添えて組織を作成する。

  • update_organization

    書き込み。組織の名称、ドメイン、メモ、タグを変更する。

  • create_user

    書き込み。ユーザー(エージェントまたはエンドカスタマー)を作成する。

前提条件

  • インテグレーションを接続するための、Atako企業アカウントの管理者権限。
  • 企業のZendeskサブドメイン(yourcompany.zendesk.com)。
  • Zendesk側でエージェント以上の権限。ヘルプセンターにはGuide管理者権限が必要。
  • トークンを生成する前に、Admin CenterでAPIトークンアクセスを有効化しておく。

接続方法

  1. 1

    設定 → 連携を開く

    管理者がZendeskを選択し、企業のサブドメインを入力する。

  2. 2

    Zendesk側でトークンを有効化・生成する

    Admin Center → Apps and integrations → APIs で、Token accessを有効化してからトークンを作成する。

  3. 3

    メールアドレスとトークンをAtakoに貼り付ける

    入力欄には、Zendeskエージェントのメールアドレスとトークンをコロンで区切って入力する。

  4. 4

    エージェントにアクセス権を付与する

    エージェントごとに、読み取りのみ、または読み書きのスコープで、具体的なアクションを選択する。

自律型エージェントをZendeskに接続する理由

Zendeskには、履歴、優先度、コメント、所属組織を伴う顧客からの問い合わせが集約されています。ここにアクセスできる自律型エージェントは、受け取った指示に応じて、ツールコーリングを通じて、チケットを検索するか、優先順位をつけるか、返信を準備するかを自ら判断します。

接続には、APIキー、メールアドレス、トークンを組み合わせ、あなたのアカウント専用のZendeskサブドメインを使用します。Zendeskアカウント自体のパスワードが送信されることはありません。

この仕組みは、サポート仕分けサポート自動化のエージェントによく適合します。継続的に稼働し、新しいチケットを随時受け取り、人間が朝Zendeskアカウントを開くのを待つことなく作業を準備します。Zendeskはスタンダードプランに含まれるコネクタの一つで、このインテグレーション固有の追加費用はかかりません。

制限とベストプラクティス

ZendeskはAPIトークンによる認証を段階的に廃止し、OAuthへ移行しています。2026年7月末以降、30日間使用されていないトークンは無効化され、2026年10月末には新規トークンの作成がブロックされ、2027年4月30日にはすべてのトークンが動作を停止します(Zendeskの発表)。現在トークンで設定されている接続は、この期限までに見直す必要があります。

トークンを生成するために使用するアカウントの役割は、Atako側のgrantに加えて、Zendesk側でトークンが何をできるかを規定します。チケットの操作にはエージェント権限で十分ですが、ヘルプセンターの管理にはアカウント上のGuide管理者権限が必要です。

ドキュメントには、メールチャネルやWebhookチャネルで文書化されているクォータとは異なり、このコネクタ固有のレート制限に関する記載はありません。成功・拒否を問わず、各呼び出しはエージェントページの監査ログで確認できます。

関連するユースケース

関連する連携機能

よくある質問

エージェントは確認なしにチケットをクローズしたり返信したりできますか。

書き込みスコープでupdate_ticketのgrantがあれば可能です。ステータスの変更とコメントの追加を直接行います。多くの企業はこのgrantを単純なチケットに限定し、機微な案件は人間のエージェントに任せています。

AtakoからZendeskへのアクセスをどう取り消しますか。

設定 → 連携から、Zendesk接続のRevokeをクリックします。暗号化されたトークンは即座に削除され、それを使用していたすべてのエージェントは直ちにアクセスを失います。

ZendeskはAPIトークン認証を廃止する予定ですか。

はい、ZendeskはAPIトークンを段階的に廃止し、OAuthへ移行しています。完全な無効化は2027年4月末に予定されています。現在トークンで設定されている接続は、この期限までに見直す必要があります。

次に読む

出典

Romain Laodicina

Atako CTO

このコンテンツはAtakoのAIエージェントが執筆し、その後Atako CTOのRomain Laodicinaが確認・修正・承認しました。

最初のAIエージェントを導入

無料でアカウントを作成し、コード不要で数分でエージェントを起動できます。

AIの最前線を 常にキャッチアップ。

新機能、新しいエージェント、当社のAI分析を直接受信箱にお届けします。スパムなし、いつでも配信停止できます。