Zendesk Guideでリダイレクトを設定する方法：完全な2026年ガイド

Zendesk Guideで記事を削除または移動すると、リンク切れが発生します。古いURLをクリックしたユーザーは、404エラーページにアクセスします。これはユーザーエクスペリエンスにとって悪いことであり、SEOにとってはさらに悪いことです。検索エンジンはリンク切れを嫌い、顧客も同様です。

朗報があります。Zendeskには、これを処理するための2つの方法が用意されています。Redirect Rules API（適切なサーバーサイドのアプローチ）を使用するか、すぐに修正する必要がある場合はJavaScriptリダイレクトにフォールバックできます。このガイドでは、両方の方法について説明し、状況に応じて最適な方法を選択できるようにします。

Zendeskのリダイレクトの制限に不満を感じている場合は、代替手段を検討する価値があるかもしれません。私たちは、このような回避策なしでナレッジ管理を処理するためにeesel AIを構築しました。当社のAIチームメイトは、既存のドキュメントから学習し、コンテンツが変更されたときにリダイレクトを自動的に処理します。ただし、まずはZendeskを機能させることに焦点を当てましょう。

必要なもの

リダイレクトの設定を開始する前に、以下を確認してください。

• Guideの管理者権限 ヘルプセンターのテーマをカスタマイズしたり、APIを使用したりするには、アクセス権が必要です。
• APIメソッドの場合： ZendeskアカウントでAPIトークンを設定します（管理センター → アプリとインテグレーション → API → Zendesk API）。
• JavaScriptメソッドの場合： テーマのコードを編集するアクセス権（ナレッジ管理 → デザインのカスタマイズ）
• URL構造の基本的な理解 ZendeskのURLは、/hc/{locale}/articles/{id}-{slug}というパターンに従います。

両方のアプローチを詳しく見ていきましょう。

方法1：Redirect Rules APIを使用する

Zendeskは2024年10月にRedirect Rules APIを導入しました。これは、検索エンジンが理解できる適切なHTTPステータスコードを使用するため、リダイレクトを処理するための推奨されるアプローチです。

Redirect Rules APIの概要

APIは、適切なHTTPステータスコード（301、302、303、307、または308）を使用してサーバーサイドのリダイレクトを提供します。これは、検索エンジンがサーバーサイドのリダイレクトをJavaScriptリダイレクトとは異なる方法で扱うため重要です。301リダイレクトはGoogleに「このページは完全に移動しました」と伝え、SEOの価値を維持します。

知っておくべき重要なこと：

• ブランドごとに最大50,000件のリダイレクト規則を作成できます。
• レガシーGuide Liteプランを除くすべてのGuideプランで利用できます。
• Guideの管理者権限が必要です。
• 記事、セクション、カテゴリ、コミュニティ投稿で機能します。

ステップ1：API経由でリダイレクト規則を作成する

リダイレクトを作成するには、/api/v2/guide/redirect_rulesにPOSTリクエストを送信します。必要なJSON構造は次のとおりです。

{
  "redirect_rule": {
    "redirect_from": "/hc/en-us/articles/123456",
    "redirect_status": 301,
    "redirect_to": "https://yoursubdomain.zendesk.com/hc/en-us/articles/789012"
  }
}

フィールドに関する重要な注意点：

• redirect_from: リダイレクト元のパス。/から始まります。スラッグ（記事IDの後のテキスト）は省略します。IDのみを使用します。
• redirect_status: 永続的なリダイレクトには301を使用します（SEOに最適）。一時的なリダイレクトには302を使用します。
• redirect_to: リダイレクト先の完全なURLまたはパス。https://、http://、または/から始まります。

curlの例を次に示します。

curl https://yoursubdomain.zendesk.com/api/v2/guide/redirect_rules \
  -X POST \
  -d '{ "redirect_rule": { "redirect_from": "/hc/en-us/articles/123456", "redirect_to": "https://yoursubdomain.zendesk.com/hc/en-us/articles/789012", "redirect_status": 301 } }' \
  -H "Content-Type: application/json" \
  -v -u your_email@company.com/token:your_api_token

ステップ2：リダイレクトをテストする

リダイレクトを作成したら、すぐにテストします。

1. シークレットブラウザウィンドウを開きます。
2. 古いURLに移動します。
3. 新しいURLにリダイレクトされることを確認します。
4. ブラウザの開発者ツール（ネットワークタブ）をチェックして、301ステータスコードを確認します。

リダイレクトが機能しない場合は、ソース記事が実際に削除されていることを再確認してください。リダイレクトは、404エラーを返すURLに対してのみトリガーされます。

ステップ3：既存のリダイレクトを管理する

すべてのリダイレクトを表示するには、リストエンドポイントを使用します。

curl https://yoursubdomain.zendesk.com/api/v2/guide/redirect_rules \
  -v -u your_email@company.com/token:your_api_token

APIはカーソルページネーションを使用します。リダイレクトが多い場合は、レスポンスにafter_cursorが表示されます。これを使用して次のページを取得します。

curl "https://yoursubdomain.zendesk.com/api/v2/guide/redirect_rules?page[after_cursor]=Y3Vyc29yIHR3bw==" \
  -v -u your_email@company.com/token:your_api_token

リダイレクトを更新するには、同じredirect_fromパスで再度POSTするだけです。新しいredirect_toとredirect_statusは、既存の規則を上書きします。

リダイレクトを削除するには、そのIDが必要です。最初にリストでIDを見つけてから、次のようにします。

curl https://yoursubdomain.zendesk.com/api/v2/guide/redirect_rules/01GFXGBX7YZ9ASWTCVMASTK8ZS \
  -X DELETE \
  -v -u your_email@company.com/token:your_api_token

方法2：JavaScriptリダイレクトの回避策

APIアクセスがない場合、または少数の記事に対してすぐに修正する必要がある場合は、JavaScriptリダイレクトがオプションです。ただし、トレードオフを事前に知っておいてください。

JavaScriptリダイレクトを使用する場合

このアプローチは、次の場合に最適です。

• 少数の記事（20未満）をリダイレクトする必要がある。
• APIを実装するための開発リソースがない。
• 一時的な変更を行っており、後でAPIを使用する予定である。

注意点は？JavaScriptリダイレクトは、ページのロード後に発生します。検索エンジンは、サーバーサイドのリダイレクトほど確実にそれらに従わない可能性があります。Zendeskは、これらが「Google検索ランキングに影響を与える可能性があり」、「長期または大規模な展開には適さない」ことを明示的に指摘しています。

ステップ1：テーマコードにアクセスする

1. Zendesk管理パネルでナレッジ管理に移動します。
2. デザインのカスタマイズ（絵筆アイコン）をクリックします。
3. アクティブなテーマでカスタマイズをクリックします。
4. コードの編集をクリックします。
5. ファイルリストでscript.jsを見つけてクリックします。

ステップ2：リダイレクトコードを追加する

他の関数の前に、script.jsファイルの先頭付近にこのコードを追加します。

// 古い記事IDを新しい記事IDにマッピングします
var oldIds = ["217352077", "216552968"];
var newIds = ["216553098", "216552958"];

for (var i = 0; i < oldIds.length; i++){
  if (window.location.href.indexOf(oldIds[i]) > -1) {
    window.location.href = 'https://yoursubdomain.zendesk.com/hc/en-us/articles/' + newIds[i];
  }
}

oldIdsおよびnewIds配列のIDを実際の記事IDに置き換えます。それらを引用符で囲み、位置が一致していることを確認します（最初の古いIDは最初の新しいIDにリダイレクトされますなど）。

言語フォールバックリダイレクトの場合（翻訳が存在しない場合にユーザーをデフォルト言語に送信します）。

var notDefaultLanguage = window.location.href.indexOf('/en-us/') == -1;
var isArticle = window.location.href.indexOf('/articles/') > -1;
var isErrorPage = document.getElementsByClassName("error-page").length > 0;

if ( isArticle && notDefaultLanguage && isErrorPage ) {
    var newURL = window.location.href.replace(/(.*\/hc\/)([\w-]+)(\/.*)/, "$1en-us$3");
    window.location.href = newURL;
}

異なる場合は、en-usをデフォルトの言語コードに置き換えます。

ステップ3：公開してテストする

1. 公開をクリックして変更を保存します。
2. 複数のブラウザでシークレットウィンドウでテストします。
3. モバイルの動作を確認します。リダイレクトはモバイルでも同じように機能するはずです。
4. リダイレクトがすぐに表示されない場合は、ブラウザのキャッシュをクリアします。

一般的なリダイレクトのシナリオ

削除された記事を新しい同等の記事にリダイレクトする

最も一般的なユースケース：古い記事を削除し、同じトピックをカバーする新しい記事を作成しました。SEOの価値を維持するために、301リダイレクトでAPIメソッドを使用します。

一括リダイレクトの場合（大規模なコンテンツ再編成後など）、API呼び出しをスクリプト化します。Pythonの例を次に示します。

import requests

redirects = [
    ("/hc/en-us/articles/111", "/hc/en-us/articles/222"),
    ("/hc/en-us/articles/333", "/hc/en-us/articles/444"),
]

for old_path, new_path in redirects:
    payload = {
        "redirect_rule": {
            "redirect_from": old_path,
            "redirect_status": 301,
            "redirect_to": f"https://yoursubdomain.zendesk.com{new_path}"
        }
    }
    response = requests.post(
        "https://yoursubdomain.zendesk.com/api/v2/guide/redirect_rules",
        json=payload,
        auth=("your_email@company.com/token", "your_api_token")
    )
    print(f"Redirected {old_path}: {response.status_code}")

翻訳されていないコンテンツの処理

複数の言語をサポートしているが、すべての記事を翻訳しているわけではない場合は、フォールバックリダイレクトを設定します。ユーザーが英語でのみ存在するフランス語の記事にアクセスしようとすると、404を表示する代わりに、英語バージョンにリダイレクトします。

上記の手順2のJavaScriptの例は、これを処理します。APIを使用したサーバーサイドソリューションの場合、翻訳されていない記事ごとに個別のリダイレクトを作成する必要があります。

移行リダイレクト

別のプラットフォームからZendeskに移行しますか？URLパターンが異なる可能性があります。次に例を示します。

• 古い：/support/solutions/articles/1234
• 新しい：/hc/en-us/articles/5678

古いURLごとに、新しいZendeskの同等のURLを指すリダイレクトを作成します。/knowledge/で始まるURL（HubSpotのナレッジベースURLなど）は、Zendeskのリダイレクトソースとしては機能しないことに注意してください。そのパスは予約されています。

一般的な問題のトラブルシューティング

リダイレクトがまったく機能しない

ソース記事が実際に削除されていることを確認してください。リダイレクトは404エラーに対してのみトリガーされます。アーカイブまたは非公開の記事はリダイレクトをトリガーしません。

クエリパラメータがリダイレクトを中断する

URLに追跡パラメータ（?utm_source=emailなど）が含まれている場合、リダイレクトが一致しない可能性があります。APIはパスのみで一致するため、パラメータは関係ありませんが、テストして確認してください。

Cloudflareプロキシの複雑さ

ZendeskホストマッピングでCloudflareを使用している場合は、問題が発生する可能性があります。Zendeskを指すCNAMEレコードを「オレンジクラウド」（プロキシ）すると、Cloudflare for SaaSが起動し、トラフィックをZendeskに直接ルーティングし、リダイレクト規則をバイパスします。解決策には、オリジンルールまたは別のプロキシホスト名を使用することが含まれます。

ホストマッピングの競合

カスタムドメインをヘルプセンターにマッピングした場合は、リダイレクトが正しいドメインを使用していることを確認してください。リダイレクトは、Zendeskサブドメインとホストマッピングされたドメインの両方で機能します。

キャッシュの問題

JavaScriptリダイレクトのテーマの変更を公開した後、ブラウザのキャッシュをクリアします。APIリダイレクトの場合、変更はすぐに反映されますが、CDNキャッシュにより表示が遅れる場合があります。

Zendesk Guideのリダイレクトに関するSEOのベストプラクティス

301リダイレクトと302リダイレクトの使い分け

次の場合に**301（完全に移動）**を使用します。

• 記事が完全に削除され、置き換えられた場合
• 別のプラットフォームからコンテンツを移行している場合
• 古いURLが二度と使用されない場合

次の場合に**302（見つかりました）**を使用します。

• リダイレクトが一時的な場合
• 異なる記事バージョンのA/Bテストを行っている場合
• 元のコンテンツが戻る可能性がある場合

リダイレクトチェーンの回避

記事A → 記事B → 記事Cのようなチェーンを作成しないでください。Googleは数ホップ後に追跡を停止する可能性があります。常に最終目的地にリダイレクトします。

内部リンクの更新とリダイレクトへの依存

リダイレクトはセーフティネットであり、戦略ではありません。内部リンクを更新して、新しいURLを直接指すようにします。これにより、サーバーの負荷が軽減され、ユーザーが最速のエクスペリエンスを得られるようになります。

404エラーの監視

ヘルプセンターのGoogle Search Consoleを設定します。カバレッジレポートを定期的にチェックして、404エラーがないか確認します。それぞれが作成する必要がある潜在的なリダイレクトです。

代替手段：ヘルプセンターの管理にeesel AIを検討する

Zendeskのリダイレクトの管理、テーマコードの操作、またはプラットフォームの制限の回避に多くの時間を費やしている場合は、より良い方法があります。

私たちは、カスタマーサービス向けのAIチームメイトとしてeesel AIを構築しました。手動のリダイレクト管理が必要な従来のヘルプセンターとは異なり、eeselは既存のドキュメント（Confluence、Googleドキュメント、Notion、過去のチケット）から学習し、コンテンツの変更を自動的に処理します。

コンテンツを更新または移動すると、eeselのAIは関係を理解し、手動のリダイレクト構成なしで適切な情報を表示します。プレーンな英語でエスカレーションルールを定義し（「払い戻しリクエストが30日を超える場合は、丁寧に拒否する」）、eeselが残りを処理します。

当社の顧客は通常、最前線のサポートで最大81％の自律的な解決率を実現しています。Zendeskのリダイレクトの制限がプラットフォームに対する広範な不満の一部である場合は、eeselを無料で試して、AIネイティブアプローチがどのように異なるかを確認してください。

Zendesk Guideのリダイレクトを効果的に管理する

Zendesk Guideでリダイレクトを処理するための2つの確実なオプションが用意されました。本番環境で使用する場合は、Redirect Rules APIが明らかに優れています。SEOの価値を維持し、ブランドごとに50,000の規則に拡張できる適切な301リダイレクトを提供します。

簡単な修正や小規模なニーズには、JavaScriptリダイレクトが役立ちます。ただし、SEOのトレードオフと、長期的な使用には適さないというZendeskの警告を覚えておいてください。

リダイレクト管理がZendeskの制限の増え続けるリストの1つにすぎない場合は、プラットフォームがまだニーズに合っているかどうかを検討する時期かもしれません。eesel AIのような最新のAI代替手段は、これらの問題を自動的に処理し、リダイレクト規則の維持ではなく、優れたカスタマーエクスペリエンスの提供に集中できるようにします。