メインコンテンツにスキップ

Zendeskから公開記事をインポートする

Zendeskのknowledge baseから数分でコンテンツを移行する方法。

対応者:Beth-Ann Sher

仕組み

コード不要で、公開されたZendeskのヘルプコンテンツを簡単にIntercomにインポートできます。これにより、Intercomをサポート記事の唯一の情報源にし、IntercomのAI機能を活用できます。

Zendeskインポーターは堅牢で信頼性の高いサービスパイプライン上に構築されており、エラーを大幅に減らし、コンテンツ統合の速度と信頼性を向上させます。

記事がIntercomに入ると、次のことができます:

  • Fin AI AgentとCopilotを活用して、正確で自動化された回答を提供します。

  • Inboxでチームメイトが会話で共有できるようにアクセス可能にします。

  • Help Centerで顧客がセルフサービスできるように掲載します。

ヒント: インポーターはZendeskからラベルやカテゴリなどの貴重なソースメタデータも抽出し、Intercomの記事にタグとして適用します。これにより、コンテンツの整理やより効果的なAI解決のためのルール適用が可能になります。

注意: これはZendeskのすべての公開済みヘルプ記事の移行を試みます。特定の記事を追加する場合は、個別にコピーしてKnowledge Hubに追加することをお勧めします。


データ接続方法の選択

ZendeskコンテンツをIntercomで管理する方法は2つあります。

コンテンツをインポートする

Intercomを新しい唯一の情報源にしたい場合はこのオプションを選択してください。まずZendeskコンテンツを接続・同期し、その後Knowledge > Sourcesからインポートを別途実行して、ネイティブなIntercom記事に変換します。

  • これは公開済みのZendesk記事をすべて一度だけIntercomに移行します。

  • インポート後は接続が切断されます。Zendeskでの変更はIntercomに反映されません。この変換は元に戻せません。

  • その後、これらの記事をIntercom内で直接編集・管理できます。

    インポートするには、まず以下の手順でZendeskソースを接続・同期します。同期完了後、Knowledge > Sourcesに移動し、同期済みZendeskソースのManageをクリック、Import contentを選択してインポートを確定してください。

注意: インポートは現在2段階で行われます。まず以下の手順でZendeskコンテンツを接続・同期します。同期完了後、Knowledge > Sourcesに移動し、同期済みZendeskソースのManageをクリック、Import contentを選択してインポートを確定してください。このステップは手動で行い、同期完了後に自動実行されません。インポート後は同期が削除され、Zendeskの同期フィルタリングも解除され、コンテンツは通常の編集可能な記事になります。インポートは元に戻せません。

コンテンツを同期する

このオプションを選択すると、継続的に更新される閲覧専用のコンテンツを同期できます。Zendeskが唯一の情報源のままです。

  • これは既存のknowledge baseを使ってFin AI Agentを活用したい場合に最適です。

  • 同期は信頼性が高く透明性があり、Finは常に最新のコンテンツを利用できます。

  • 記事の編集・管理は引き続きZendeskで行います。


インポート前の準備

開始前に、Help Center設定で検索エンジンのインデックス登録を有効にすることをお勧めします。これにより、記事が検索結果に表示されるまでの遅延を防げます。設定 > Help Centerに移動し、「configure and style」をクリックしてください。

一般 > プライバシーの下にインデックス検索を有効にするオプションがあります。

注意: コンテンツはZendeskで設定された言語でインポートされます。英語の場合、EN-US、EN-UK、EN-CAのみ対応し、一般的なENオプションはありません。インポートされた記事は自動的にコレクションに配置されないため、インポート後に手動で整理する必要があります。


APIトークンで接続する

安全なAPIトークンを使ってZendeskコンテンツをインポートする方法です。

ステップ1: ZendeskのAPIトークンを生成する

まずZendeskのAdmin CenterでAPIトークンを生成します。

  1. ZendeskでAdmin Centerに移動します。

  2. Apps and integrations > API > Zendesk APIに進みます。

  3. API tokenタブをクリックし、Add API tokenをクリックします。

  4. トークンに説明的な名前(例:「Intercom Integration」)を付けてコピーします。コピーして安全な場所に保存してください。Zendeskは再表示しません。

ステップ2: IntercomでZendeskを接続する

  1. IntercomのワークスペースからKnowledge > Sourcesに移動します。

  2. Public articlesの下でZendeskを見つけ、Sync or Importをクリックします。

  3. 接続情報を入力してください:

    • サブドメインを入力: Zendeskのサブドメインを入力します(例: mydomain.zendesk.com)。

    • 認証方法を選択: API Tokenを選択して接続します。

    • 接続をクリックします。

    • オプションで「サインインユーザー向けに記事を同期」を切り替え、認証ユーザーのみが閲覧できるコンテンツを含めることができます。

      接続処理が完了したら次のステップに進めます。

  4. ZendeskがIntercomに接続された後、MetadataタブでZendeskから取り込むコンテンツを事前にフィルタリングできます。コアフィールドやカスタムタグから選択してフィルタリング・ターゲティングを拡張可能です。+ Add Filterをクリックして、カテゴリ、ラベル、タイムスタンプなどの特定条件でコンテンツを絞り込めます。このステップを省略すると、インポーターはデフォルトで全ての対象コンテンツを取り込みます。

  5. Targetタブで、インポートしたコンテンツをIntercomのどこで使用するか決めます。

    • Fin AI Agent: Zendesk記事を自動応答に使う場合はオンにします。

    • Copilot: チームメイトへの提案回答を提供する場合は有効にします。

    • Help Center: Zendeskのコンテンツを直接Intercom Help Centerに公開したい場合は、これをオンにしてください。

    • Audience Control: このコンテンツを閲覧できる特定のオーディエンス(例:「Enterprise plan」や「UK audience」)を選択してください。

  6. インポートを開始する前に設定を最終確認してください。

    • インポートを識別するためにカスタム名を入力してください(例:「Zendesk - Public Support」)。

    • メタデータフィルターに基づいてインポートされる記事数とフィールド数の概要を確認してください。

    • Available in と Audience の設定が正しいか再確認してください。

  7. Sync and set live をクリックして、ZendeskのコンテンツをIntercomの記事に変換し始めます。


OAuthで接続中

ステップ1:Zendeskの認証

コンテンツをインポートするには、まずZendeskのソースを認証する必要があります。

  1. Zendeskのsubdomainを入力してください(例:mydomain.zendesk.com)。

  2. 認証方法としてOAuthを選択してください。

  3. Connectをクリックしてください。

接続が確立したら、オプションでSync articles for signed-in usersを切り替えて、認証された顧客のみが閲覧できるコンテンツを含めることができます。接続が成功したらNextをクリックしてください。

サブドメインはURLの.zendesk.comの前の部分です。例えば、URLがhttps://help.zendesk.comの場合、サブドメインはhelpです。

ステップ2:メタデータ

ZendeskがIntercomに接続された後、Metadataタブを使って、どのコンテンツをIntercomに取り込むかを事前にフィルターできます。

  • コアフィールドまたはカスタムタグから選択してインポートを絞り込みます。

  • + Add Filterをクリックして、Categories、Labels、Timestampsなどの特定の条件でコンテンツを選択します。

このステップをスキップすると、インポーターはデフォルトで対象となるすべてのコンテンツを取り込みます。

ステップ3:ターゲット

Targetタブを使って、インポートしたコンテンツをIntercomのどこで使用するかを決めます。

  • Fin AI Agent: Zendeskの記事を自動顧客回答に使用する場合はこれをオンにしてください。

  • Copilot: チームメイトへの提案回答を提供するためにこれを有効にしてください。

  • Help Center: Zendeskのコンテンツを直接Intercom Help Centerに公開したい場合はこれをオンにしてください。

  • Audience Control: このコンテンツを閲覧できる特定のオーディエンス(例:「Enterprise plan」)を選択してください。

ステップ4:レビュー

インポートを開始する前に最終確認をしてください。

  1. インポートを識別するためにカスタム名を入力してください(例:「Zendesk - Public Support」)。

  2. インポートされる記事数とフィールド数の概要を確認してください。

  3. Available in と Audience の設定が正しいか再確認してください。

Sync and set liveをクリックして開始してください。


レガシーインポーターでのインポート

  1. 公開記事のインポートを開始するには、 Knowledge Hub > Sourcesに移動してください。

  2. Public articlesの下でZendeskを見つけて、Sync or Importをクリックしてください。

  3. Zendeskのサブドメインを入力し、「Import content」オプションを選択してからImportをクリックしてください。

Note:

  • レガシーインポーターは4月25日以降廃止されます。この日以降:

    • 手動および自動の同期は停止します。

    • いつでも一度だけのインポートは実行できますが、新しいインポーターに移行するまで同期は再開されません。

    • 新しいインポーターに移行した後(または移行済みソースを編集した後)、新しいフィルターとメタデータ機能が利用可能になります。

  • レガシーインポーターでZendeskから記事をインポートするには、管理者アクセスでログインして認証する必要があります。

  • Multi Help Centerを使用する場合は、Intercomで対象のHelp Centerを選択する必要があります。

  • Zendeskの記事をインポートすると、Intercomで管理可能なネイティブの公開記事に変換されます。

  • Zendeskから多言語記事をインポートするには、 Help Centerの設定で追加言語を追加し、インポートされた翻訳が表示されるようにする必要があります。

  • リダイレクトをカスタムドメインで生成するために、インポート前にIntercom Help Centerのカスタムドメインを設定しておく必要があります。

インポートが完了するまでお待ちください。この間にドキュメントサイトをクロールし、すべての公開記事をインポートし、既存のknowledge baseの構造に合わせてHelp Centerのコレクションに配置します。数分から1時間以上かかることがあります。完了したらメールでお知らせしますので、お待ちいただく必要はありません😄

移行が完了したら、 KnowledgeのContentページを更新して、左のサイドバーのフォルダーにインポートされた記事を表示してください。

Knowledgeから公開記事の管理方法を学び、Fin AI AgentとCopilotで有効にしてください。

重要: まだの場合は、 Help Centerをオンにしてください

4月25日以降

レガシーインポーターが廃止されると、以下の変更があります:

  • 手動および自動の同期は停止します。

  • いつでも一度限りのインポートは実行できますが、新しいインポーターに移行するまで同期は再開されません。

  • 新しいインポーターに切り替えた後(または移行したソースを編集した後)、新しいフィルターとメタデータ機能にアクセスできます。


接続後

Zendeskサイトのクロールを開始し、公開された記事をインポートして、既存のknowledge baseに合わせたコレクションに構成します。ZendeskのラベルやカテゴリはすべてIntercomの記事のタグとして追加されます。インポートされた記事は自動的にコレクションに配置されません。インポートされたタグを使ってコンテンツをフィルタリングおよび整理してください。

この処理には数分から1時間かかることがあります。完了したらメールでお知らせします。いつでもKnowledge > Sourcesで状況を確認できます。

インポートが完了したら、Knowledge > All Contentに移動してインポートされた記事を見つけてください。記事は個別に表示され、コレクション内には入りません。Zendeskからインポートされたタグを使ってフィルタリングおよび整理してください。


Zendeskのメタデータのインポート方法

時間を節約するために、インポーターはZendeskのknowledge baseの構造を自動的にIntercomに取り込みます。

Zendeskのメタデータ(ラベル、カテゴリ、コンテンツタグ)はすべてインポートされ、Intercomの記事のタグに変換されます。

このメタデータはコンテンツを有用にするために重要です。これらのタグが自動的に適用されることで、以下が可能になります:

  • Knowledgeセクションでコンテンツを特定のカテゴリ別にフィルタリングできます。

  • Fin AI Agentから関連性のないコンテンツを除外します。

  • 記事タグに基づいて特定のFin AI Agentオーディエンスを作成し、回答を適切な対象にルーティングします。

例えば、Zendeskで「EMEA-only」とラベル付けされたコンテンツがある場合、そのラベルはIntercomのタグになります。Fin AI Agentでヨーロッパの顧客向けのオーディエンスを作成し、「EMEA-only」タグのある記事のみを使用するように設定できます。


Zendesk記事のリダイレクト

記事のリダイレクトはインポートプロセス中に自動生成され、新しいインポートパイプラインによりこれまで以上に信頼性が高くなっています。ZendeskとIntercomの記事URLは異なる形式ですが、リダイレクトにより移行後も既存のリンクが切れず、SEOスコアが維持されます。

リダイレクトは恒久的なリダイレクト(HTTP 301レスポンス)の形で実装されます。

リダイレクトのマッチング方法

リダイレクトはZendesk URLに埋め込まれた安定した数値記事IDでマッチングされます。スラッグは変更される可能性があるため使用しません。これにより、同じ記事のすべてのURLバリエーションが単一のリダイレクトレコードと同じIntercom記事にマッピングされます。

訪問者が(元のZendesk URL)に到着

リダイレクト先

/hc/en-us/articles/12345678-how-to-reset-password

Intercom記事

/hc/en-us/articles/12345678-reset-your-password

同じIntercom記事

同じIntercom記事

Same Intercom article

注意:リダイレクトはインポート時に自動的に作成され、問題があってもインポートを妨げることはありません。

多言語対応

複数言語のコレクションや記事をインポートする場合、各言語バリアントには元のZendesk記事URLに関連付けられた独自のリダイレクトがあります。

既存のリダイレクトの確認

インポート完了後、Domainsセクションの設定 > Help Center > 設定とスタイルから生成されたリダイレクトを確認できます。

ここから下にスクロールしてDomainsをクリックし、「manage redirects」を選択します。

パネルには元のURLとリダイレクト先の記事/コレクションが表示されます。

重要:

  • リダイレクトは選択したカスタムドメインにのみ表示されます。例えば、Zendesk Help Centerのhttps://support.examply.comから記事をインポートしている場合、support.examply.comをカスタムドメインとして選択し、HTTPSセキュリティプロトコルを使用している場合にのみ、ドメインセクションにリダイレクトが表示されます。

  • CNAMEをIntercomに切り替える準備ができていなくても、Intercom Help Centerにカスタムドメインを追加し、HTTPSセキュリティプロトコルを使用するオプションを選択すれば、Zendeskからのインポート時にリダイレクトを作成できます。

  • Multi Help Centerでは、リダイレクトは特定のHelp Centerに紐づいていません。代わりにドメインにリンクされています。つまり、Zendesk記事があったドメインを使用している任意のHelp Centerでリダイレクトが表示されます。

  • リダイレクトは2022年9月22日以降にZendeskからインポートされたすべての記事で利用可能です。


未分類のコンテンツ

サイトに未分類のコンテンツがある場合、Articlesは自動的に「General」コレクションを作成します。コレクションはusersが閲覧しやすく必要なものを見つけやすくするためのものです。公開前にトピック別に記事を再整理することを検討してください。


まだサポートしていないコンテンツ

コンテンツはサポートされているフォーマットに変換されます(例:画像のコピー)。ただし、以下のフォーマットはまだサポートしていません:

カテゴリ/コレクションのURLからのインポートはサポートされていません。knowledge baseはメインのURLからインポートする必要があります。


サポートされていないフォーマットの記事

コンテンツのインポートに問題がある場合、記事にReviewラベルを追加して、公開前に修正できるようにします。レビューが必要な記事を開き、追加した推奨事項をお読みください。推奨事項はプレースホルダーとして機能するため、公開前にこれを削除し、推奨する内容を挿入する必要があります。


よくある質問

私のZendeskサブドメインとは何ですか?

これはZendeskアカウントのドメインです(Help CenterのURLではありません)。Zendeskサブドメインは一意の識別子で、いくつかの方法で見つけることができます。詳細はこちらをご覧ください。

私のHelp Centerには2言語の記事がありますが、インポート後に1つしか表示されません。

Intercomはサポートされているすべての言語をインポートしますが、その言語をHelp Centerで有効にはしません。言語はHelp Centerの設定で追加する必要があり、その後翻訳が表示されます。

EN-USとEN-GBでローカライズされた記事があり、2つの記事に分かれてインポートされましたか?

Intercomは言語のローカライズ版の短いリストのみをサポートしています:ポルトガル語/ブラジルポルトガル語、ドイツ語/ドイツ語(フォーマル)、中国語(繁体字/簡体字)。

英語に関しては、IntercomはEN-US、EN-UK、EN-CAをサポートしており、一般的なENオプションはありません。ロケールの衝突がある場合、データ損失を避けるために各バリアントごとに別の記事が作成されます。

アイルランド語の記事がありますが、インポートされませんでした。どうしてですか?

Intercom Messengerがサポートする言語のいずれかの記事のみをインポートします。

メールには「X」記事がインポートされたとありますが、Help Centerには「Y」しか表示されませんか?

メールに記載されている合計は、記事が存在するすべての異なる言語を含みます。英語、フランス語、ポルトガル語の翻訳がある記事は、メールでは3記事としてカウントされます。

Zendeskからの「コンテンツの同期」と「コンテンツのインポート」の違いは何ですか?

Zendeskからのコンテンツ同期とインポートの主な違いは、今後どこで記事を編集するかにあります。

  • Zendeskを主要な編集者として維持したい場合は、コンテンツを同期することを選択してください。これにより、Zendesk knowledge baseと常に同期されるIntercom内の閲覧専用バージョンが作成されます。

  • 完全にIntercomに移行したい場合は、コンテンツをインポートすることを選択してください。これにより、Intercom内で編集可能な記事のコピーが作成され、新しい唯一の情報源となります。

記事がIntercomで編集可能なのにZendeskアイコンが表示されたままです。これを修正するために同期として再接続すべきですか?

いいえ、残ったZendeskアイコンを修正するために同期として再接続すべきではありません。記事がIntercomで編集可能であれば、それらはインポートされており(同期ではなく)、すでにネイティブなIntercom記事です。Zendesk接続は削除されており、アイコンはインポート時の見た目の残りです。同期として再接続すると、これらの記事は再び閲覧専用になり、検索エンジンによるインデックス登録がブロックされます。これは、同期された記事がZendesk Help Centerとの重複コンテンツペナルティを避けるためにインデックスから除外されるためです。ネイティブ記事をGoogleにインデックスさせたい場合は、インポートをそのままにしてください。アイコンは機能やSEOに影響しません。

Zendeskで記事を削除すると、Intercomからも削除されますか?

はい、Zendeskで記事を削除し、アクティブな同期が設定されている場合、Intercomからも削除されます。これは次回の同期時に自動的に行われ、両方のknowledge baseの整合性が保たれます。

Zendesk APIキーを認証に使用しても安全ですか?

はい、Zendesk APIキーを認証に使用することは安全です。これは、管理者パスワードやその他の機密情報を公開せずに、Intercomに記事への特定のアクセス権を付与する標準的で安全な接続方法です。

こちらの回答で解決しましたか?