Zendeskの組織ドメインリストを表示する方法：3つの方法

Zendeskのすべての組織と、それらに関連付けられたメールアドレスのドメインの完全なリストを見つけようとしたことがあるなら、おそらく壁にぶつかったことでしょう。Zendeskには、このデータを1か所に表示するネイティブなレポートやビューがありません。個々の組織を編集するときにドメインを確認できますが、エクスポート、ドメインによる検索、または各組織を手動でクリックせずにドメインマッピング設定全体を監査する方法はありません。

これは、B2Bの顧客を管理するサポートチームにとって深刻な問題です。統合の同期の問題に対処したり、移行の準備をしたり、単にデータをクリーンに保とうとしたりするときに、そのドメインリストが必要になります。良い知らせは？回避策があるということです。

このガイドでは、Zendeskの組織ドメインリストを抽出および管理する3つの方法について説明します。APIの使用（最も完全）、CSVエクスポートの操作（制限付きですがネイティブ）、トリガーとビューの設定（継続的な監視用）です。

組織ドメインリストにアクセスする必要がある理由

方法に入る前に、これがなぜ重要なのかを見てみましょう。組織ドメインの完全なビューが必要になる最も一般的なシナリオを次に示します。

統合の同期の問題後の監査。 Salesforce連携または別のCRMコネクタを使用している場合、ドメインマッピングが同期しなくなる可能性があります。Salesforce管理者が誤って「gmail.com」をアカウントに追加し、それがZendeskに同期して、すべてのGmailユーザーがその会社に関連付けられる可能性があります。これを見つけて修正するには、すべてのドメインを1か所で確認する必要があります。

移行のためのデータの準備。 新しいZendeskインスタンスに移行したり、複数のアカウントを統合したりする場合は、組織構造をマッピングする必要があります。ドメインリストのエクスポートがないと、各組織を手動で文書化することになります。

ドメインの競合の特定。 同じドメインが複数の組織にマッピングされている場合（Zendeskはアルファベット順に処理します）、ルーティングへの影響を理解するために、どの組織が影響を受けているかを知る必要があります。

組織マッピングの一括更新。 会社が別の会社を買収したり、顧客セグメントを再編成したりする場合は、数十または数百のドメインマッピングを更新する必要がある場合があります。これを1つずつ行うのは現実的ではありません。

Zendeskコミュニティは、長年にわたってより良い組織管理ツールを要求してきました。ある管理者が指摘したように、「これがまだ可能ではないとは信じられません」。しかし、Zendeskがネイティブ機能を追加するまでは、利用可能なもので対応します。組織の管理の詳細については、Zendeskの組織の作成と管理に関するガイドを参照してください。

方法1：Zendesk APIを使用して組織ドメインを抽出する

完全なドメインデータを取得する最も信頼性の高い方法は、Zendesk Organizations APIを使用することです。この方法では、管理者アクセスとある程度の技術的な知識が必要ですが、すべてが得られます。認証の詳細とベストプラクティスについては、Zendesk APIドキュメントを参照することもできます。

ステップ1：APIトークンを生成する

まず、認証用のAPIトークンが必要です。[管理センター > アプリと連携機能 > API > Zendesk API]に移動し、新しいトークンを作成します。このトークンはすぐにコピーしてください。二度と表示されません。ZendeskのAPIトークンの生成に関するガイドで詳細な手順を確認してください。

このトークンは安全に保管してください。これにアクセスできる人は誰でもZendeskデータを読み書きできます。

ステップ2：ドメインデータを持つ組織をリストする

Organizations APIは、domain_names配列を含む組織オブジェクトを返します。次のエンドポイントを使用します。

GET /api/v2/organizations

APIはページあたり最大100件のレコードを返すため、大規模なデータセットの場合はページネーションを処理する必要があります。レスポンスには以下が含まれます。

{
  "organizations": [
    {
      "id": 35436,
      "name": "Acme Corporation",
      "domain_names": ["acme.com", "acme-corp.com"],
      "external_id": "ACME-123",
      "tags": ["enterprise", "vip"]
    }
  ]
}

ステップ3：データを解析してエクスポートする

APIレスポンスを取得したら、各組織オブジェクトからdomain_names配列を抽出します。これをCSV、JSON、または分析ニーズに適した形式でフォーマットできます。

簡単なPythonスクリプトでページネーションとエクスポートを処理できます。

import requests
import csv

subdomain = "your-subdomain"
email = "your-email@company.com"
token = "your-api-token"

url = f"https://{subdomain}.zendesk.com/api/v2/organizations"
auth = (f"{email}/token", token)

organizations = []
while url:
    response = requests.get(url, auth=auth)
    data = response.json()
    organizations.extend(data["organizations"])
    url = data.get("next_page")

with open("org_domains.csv", "w", newline="") as f:
    writer = csv.writer(f)
    writer.writerow(["Organization ID", "Name", "Domains"])
    for org in organizations:
        writer.writerow([org["id"], org["name"], ", ".join(org.get("domain_names", []))])

知っておくべきAPIの制限事項

APIアプローチにはいくつかの制約があります。

• ページネーションが必要： ページあたり100件のレコードを取得するため、大規模な組織ではページネーション処理が必要です。
• レート制限が適用： ZendeskはAPIリクエストを制限します（通常、エンタープライズプランでは1分あたり700リクエスト）。
• ネイティブドメインフィルタリングなし： 「ドメインXを持つ組織」をクエリすることはできません。すべてをフェッチしてクライアント側でフィルタリングする必要があります。

方法2：CSVエクスポートの回避策

より簡単なものが必要で、不完全なデータを気にしない場合は、ZendeskのネイティブCSVエクスポートがオプションです。

組織データをエクスポートする方法

[管理センター > ユーザー > 一括操作 > 組織のエクスポート]に移動します。これにより、組織データを含むCSVファイルが生成されます。Zendeskでの組織の一括インポートとエクスポートの詳細をご覧ください。

含まれるもの（含まれないもの）

エクスポートには、組織名、ID、外部ID、タグ、およびカスタムフィールドが含まれます。ただし、重要なことに、ドメイン名フィールドは含まれません。これが、この方法がドメイン監査に不完全になる主な制限です。

エクスポートされた組織IDをAPI呼び出しで使用して、特定の組織のドメインデータをフェッチすることで、これを回避できますが、その時点で両方の方法を組み合わせることになります。

この方法を使用する場合

CSVエクスポートは、次の場合に最適です。

• 組織名とIDの簡単な参照が必要な場合
• ドメイン情報を必要としない別のシステムにデータをフィードする場合
• 他の組織フィールドを一括更新する場合（エクスポート形式は再インポートに適しています）

方法3：組織ベースのトリガーとビューを使用する

一括抽出ではなく継続的な監視の場合、Zendeskのネイティブトリガーとビューは、組織ドメインの操作に役立ちます。

組織ごとにビューを作成する

特定の組織でフィルタリングされたビューを設定して、ドメインマッピングされた顧客からのチケットを追跡します。これにより、ドメインリストを直接取得できるわけではありませんが、さまざまな組織からのチケットの流れを監視するのに役立ちます。Zendeskのビューの作成と管理に関するガイドで、ステップごとの手順を確認してください。

トリガーを使用してドメインでタグ付けする

組織のメンバーシップに基づいてタグを追加するトリガーを作成します。たとえば、「エンタープライズ」タグを持つ組織からのすべてのチケットにタグを付け、ドメインリスト自体を必要とせずに、追跡可能なセグメントを効果的に作成できます。Zendeskでのトリガー条件の構築の詳細をご覧ください。

このアプローチは、プロアクティブではなくリアクティブです。既知の組織からのチケットを管理するのに役立ちますが、ドメインマッピングの問題の監査または発見の問題は解決しません。

一般的な組織ドメインの問題の処理

ドメインデータにアクセスできるようになったら、修正が必要な問題が見つかる可能性があります。最も一般的な問題とその対処方法を次に示します。

統合後のドメインの競合

Salesforceやその他のCRM連携では、同期エラーが発生するとドメインの競合が発生する可能性があります。Zendesk Salesforce連携は、フィールドマッピングが正しく構成されていない場合に特に発生しやすくなります。「gmail.com」のようなドメインが組織に誤ってマッピングされていることが判明した場合は、次のことを行う必要があります。

1. Zendeskで影響を受ける組織からドメインを削除します
2. 再同期を防ぐために、ソースシステム（Salesforce）を確認します
3. 誤って関連付けられたユーザーを手動で再割り当てします

完全なドメインリストがあれば、これらの問題をはるかに迅速に特定できます。

ドメインのない組織の検索

手動で作成された組織、または特定のAPIインポートを介して作成された組織には、ドメインマッピングがないことがよくあります。抽出したデータを使用して、空のdomain_names配列を持つ組織を特定し、チケットのボリュームまたは顧客層に基づいてドメインを追加する必要がある組織に優先順位を付けます。

ドメイン管理のベストプラクティス

• 定期的な監査の実施： 毎月または四半期ごとのAPI抽出は、問題を早期に発見するのに役立ちます
• 命名規則の使用： 明確な組織名は、競合が発生した場合に適切な組織を特定しやすくします
• マッピングの文書化： 特に複数のドメインを持つ複雑なB2Bアカウントの場合は、どのドメインがどの組織にマッピングされるかの参照を保持します

ネイティブのZendesk機能を超えたスケーリング

APIスクリプトと手動エクスポートは、小規模なチームまたは1回限りの監査には適しています。ただし、数千の組織を管理している場合、またはリアルタイムのドメインベースのルーティングが必要な場合は、これらの回避策が大きな頭痛の種になります。

ここで、AI自動化を検討する価値があります。複雑なスクリプトと手動プロセスを維持する代わりに、AIシステムは組織パターンを学習し、ルーティングをインテリジェントに処理できます。

eesel AIでは、これに異なるアプローチを取ります。ドメインマッピングに関するより複雑なルールを構築するのではなく、Zendesk用のAIエージェントは、チームがさまざまな組織からのチケットを実際にどのように処理するかを学習します。過去の解決策を見て、ドメインフィールドだけでなくコンテキストを理解し、明示的なプログラミングなしでインテリジェントなルーティングの決定を行うことができます。

このアプローチは段階的です。最初に、AIがエージェントがレビューする返信を下書きするので、ビジネスを理解していることを確認できます。自信がついたら、ルーチンチケットを直接処理させることができます。これにより、単純なルールベースのルーティングから、完璧なドメインデータに依存しないインテリジェントな自動化に移行できます。

組織ドメイン管理がうまくいっているものの、限界に達している場合は、AI自動化がワークフローに追加できるものを検討する価値があるかもしれません。Zendeskと直接統合し、カスタムスクリプトのメンテナンスの負担なしにサポート業務を強化できます。

Zendesk組織ドメインの効果的な管理を開始する

組織ドメインを表示するためのZendeskのネイティブ制限を回避する3つの方法ができました。

1. 完全なデータ抽出と監査のためにAPIを使用します
2. 簡単な参照のためにCSVをエクスポートします（ドメインフィールドの制限を受け入れます）
3. 継続的なチケット監視のためにトリガーとビューを設定します

ほとんどのチームでは、最初の監査にはAPIメソッドから始めることをお勧めします。その完全なドメインリストを取得し、問題を特定し、データをクリーンアップします。次に、継続的なAPIスクリプトが理にかなっているかどうか、またはよりスケーラブルな自動化を検討する時期かどうかを判断します。

組織管理の手作業を完全に減らしたい場合は、eesel AIをお試しください。当社のAIエージェントはパターンを学習し、複雑なドメインマッピングやスクリプトを維持しなくてもルーティングを処理します。AI Copilotで返信を下書きしたり、AI Triageでチケットの自動ルーティングを行ったりすることもできます。