仕組み
コード不要で、公開された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記事を一度だけIntercomに移行します。
インポート後、接続は切断されます。Zendeskでの変更はIntercomに反映されません。
その後、これらの記事をIntercom内で直接編集・管理できます。
コンテンツを同期する
このオプションを選択すると、継続的に更新される閲覧専用のコンテンツを同期します。Zendeskが唯一の情報源のままです。
これは、既存のknowledge baseを移行せずにFin AI Agentを活用するのに最適です。
同期は信頼性が高く透明で、Finが常に最新のコンテンツを持つことを保証します。
記事の編集・管理は引き続きZendeskで行います。
インポート前に
開始前に、Help Center設定で検索エンジンのインデックス作成を有効にすることをお勧めします。これにより、記事が検索結果に表示されるまでの遅延を防げます。設定 > Help Centerに移動し、「設定とスタイル」をクリックしてください。
一般 > プライバシーの下にインデックス検索を有効にするオプションがあります。
APIトークン経由で接続する
安全なAPIトークンを使ってZendeskコンテンツをインポートする方法です。
ステップ1: Zendesk APIトークンを生成する
まず、Zendesk管理センターでAPIトークンを生成します。
Zendeskで管理センターに移動します。
アプリと統合 > API > Zendesk APIに進みます。
APIトークンタブをクリックし、APIトークンを追加をクリックします。
トークンに説明的な名前（例：「Intercom Integration」）を付けてコピーします。コピーして安全な場所に保存してください。Zendeskは再表示しません。
ステップ2: IntercomでZendeskを接続する
公開記事の下でZendeskを見つけ、同期またはインポートをクリックします。
接続情報を入力してください：
サブドメインを入力: Zendeskのサブドメインを入力してください（例：
mydomain.zendesk.com）。認証方法を選択: APIトークンを選択して接続します。
接続をクリックします。
オプションで「サインインしたusers向けに記事を同期」を切り替えて、認証されたusersのみが見られるコンテンツを含めることができます。
接続プロセスが完了したら、次のステップに進めます。
ZendeskがIntercomに接続された後、メタデータタブでZendeskからどのコンテンツをIntercomに取り込むかを事前にフィルタリングできます。コアフィールドやカスタムタグから選択してフィルタリングとターゲティングを拡張します。+ フィルターを追加をクリックして、カテゴリ、ラベル、タイムスタンプなどの特定の条件でコンテンツを絞り込みます。このステップをスキップすると、インポーターはデフォルトで対象となるすべてのコンテンツを取り込みます。
ターゲットタブで、インポートしたコンテンツをIntercomのどこで使用するかを決定します。
Fin AI Agent: Zendesk記事を自動応答に使用するにはオンにします。
Copilot: チームメイトへの提案回答を提供するには有効にします。
Help Center: Zendeskコンテンツを直接Intercom Help Centerに公開したい場合はオンにします。
オーディエンスコントロール: 特定のオーディエンス（例：「Enterprise plan」や「UK audience」）がこのコンテンツを閲覧できるように選択します。
インポートを開始する前に設定を最終確認してください。
インポートを識別するために、Knowledgeリストで使用するカスタム名を入力してください（例：「Zendesk - Public Support」）。
メタデータフィルターに基づいて、正確に何件の記事とフィールドがインポートされるかを要約で確認してください。
Available in と Audience の設定が正しいか再確認してください。
Sync and set live をクリックして、ZendeskのコンテンツをIntercomの記事に変換し始めます。
OAuthで接続中
ステップ1：Zendeskを認証する
コンテンツをインポートするには、まずZendeskソースを認証する必要があります。
Zendeskのsubdomainを入力してください（例：
mydomain.zendesk.com）。認証方法としてOAuthを選択してください。
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：レビュー
インポートを開始する前に最終確認を行ってください。
インポートを識別するために、Knowledgeリストで使用するカスタム名を入力してください（例：「Zendesk - Public Support」）。
インポートされる記事数とフィールド数を要約で確認してください。
Available in と Audience の設定が正しいか再確認してください。
Sync and set live をクリックして開始してください。
レガシーインポーターでインポート中
公開記事のインポートを開始するには、Knowledge Hub > Sourcesに移動してください。
Public articlesの下でZendeskを見つけて、Sync or Importをクリックしてください。
Zendeskのサブドメインを入力し、「Import content」オプションを選択してからImportをクリックしてください。
注意：
レガシーインポーターは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のContentページを更新してインポートされた記事を確認してください。
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記事 |
/hc/en-us/articles/12345678 | 同じIntercom記事 |
注意：リダイレクトはインポート中に自動的に作成され、問題が発生してもインポートを妨げることはありません。
多言語対応
複数言語のコレクションや記事をインポートする場合、各言語バリアントには元の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は自動的に「一般」コレクションを作成します。コレクションはusersが閲覧しやすく必要なものを見つけやすくするためのものです。公開前にこれらの記事をトピック別に再編成することを検討してください。
まだサポートしていないコンテンツ
コンテンツはサポートされているフォーマットに変換されます（例：画像のコピー）。ただし、以下のフォーマットはまだサポートしていません：
カテゴリ/コレクションのURLからのインポートもサポートされていません。knowledge baseはメインのURLからインポートする必要があります。
サポートされていないフォーマットの記事
インポートに問題がある場合、記事にReviewラベルが追加され、公開前に修正できます。修正が必要な記事を開き、追加された推奨事項を確認してください。推奨事項はプレースホルダーとして機能するため、公開前に削除して推奨された内容を挿入する必要があります。
よくある質問
私のZendeskサブドメインとは何ですか？
私のZendeskサブドメインとは何ですか？
これはあなたのZendeskアカウントのdomainです（Help CenterのURLではありません）。Zendeskのサブドメインは一意の識別子で、いくつかの方法で見つけることができます。詳細はこちらをご覧ください。
私のHelp Centerには2言語の記事がありますが、インポート後に1つしか表示されませんか？
私のHelp Centerには2言語の記事がありますが、インポート後に1つしか表示されませんか？
Intercomはすべての対応言語をインポートしますが、その言語をHelp Centerで有効にしません。言語はHelp Centerの設定で追加する必要があり、その後翻訳が表示されます。
EN-USとEN-GBでローカライズされた記事があり、2つの記事にインポートされましたか？
EN-USとEN-GBでローカライズされた記事があり、2つの記事にインポートされましたか？
Intercomは言語のローカライズ版の短いリストのみをサポートしています：ポルトガル語／ブラジルポルトガル語、ドイツ語／ドイツ語（フォーマル）、中国語繁体字／簡体字。
その他のローカライズ版は、Intercomでサポートされている最も近い言語にマッピングします（例：EN-GB、EN-US、EN-AUはすべてENにマッピング）。衝突があった場合は、データ損失を避けるために各ローカライズ版ごとに別の記事を作成します。
アイルランド語の記事がありますが、インポートされませんでした。どうなったのですか？
アイルランド語の記事がありますが、インポートされませんでした。どうなったのですか？
Intercom Messengerがサポートする対応言語のいずれかの記事のみをインポートします。
メールには「X」記事がインポートされたとありますが、Help Centerには「Y」しか見えませんか？
メールには「X」記事がインポートされたとありますが、Help Centerには「Y」しか見えませんか？
メールに記載されている合計は、記事が存在するすべての異なる言語を含みます。英語、フランス語、ポルトガル語の翻訳がある記事は、メールでは3つの記事としてカウントされます。
Zendeskからの「コンテンツの同期」と「コンテンツのインポート」の違いは何ですか？
Zendeskからの「コンテンツの同期」と「コンテンツのインポート」の違いは何ですか？
Zendeskからのコンテンツの同期とインポートの主な違いは、将来的にどこで記事を編集するかという点です。
Zendeskを主な編集者として維持したい場合は、コンテンツの同期を選択してください。これにより、Zendeskのknowledge baseと常に同期されるIntercom内の閲覧専用バージョンが作成されます。
完全にIntercomに移行したい場合は、コンテンツのインポートを選択してください。これにより、Intercom内に編集可能な記事のコピーが作成され、新しい唯一の信頼できる情報源となります。
Zendeskで記事を削除すると、Intercomからも削除されますか？
Zendeskで記事を削除すると、Intercomからも削除されますか？
はい、Zendeskで記事を削除し、アクティブな同期が設定されている場合は、Intercomからも削除されます。これは次回の同期時に自動的に行われ、両方のknowledge baseの整合性が保たれます。
ZendeskのAPIキーを認証に使用しても安全ですか？
ZendeskのAPIキーを認証に使用しても安全ですか？
はい、ZendeskのAPIキーを認証に使用することは安全です。これは、管理者パスワードやその他の機密アカウント情報を公開せずに、Intercomに記事への特定のアクセス権を付与する標準的で安全な接続方法です。