仕組み
コード不要で、公開された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内で直接編集・管理できます。
注意: インポートは2段階で行われます。まずIntercomがZendeskコンテンツを同期し、その後ネイティブ記事に変換します。インポート完了後、同期は自動的に削除されます。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トークンを生成します。
ZendeskでAdmin Centerに移動します。
Apps and integrations > APIs > Zendesk APIに進みます。
API tokenタブをクリックし、Add API tokenをクリックします。
トークンに説明的な名前（例：「Intercom Integration」）を付けてコピーします。コピーしたら安全な場所に保存してください。Zendeskは再表示しません。
ステップ2: IntercomでZendeskを接続する
Public articlesの下でZendeskを見つけ、Sync or Importをクリックします。
接続情報を入力してください:
サブドメインを入力: Zendeskのサブドメインを入力します（例：
mydomain.zendesk.com）。認証方法を選択: API Tokenを選択して接続します。
接続をクリックします。
オプションで「サインインユーザー向けの記事を同期」を切り替えて、認証ユーザーのみが閲覧できるコンテンツを含めることができます。
接続処理が完了したら、次のステップに進めます。
ZendeskがIntercomに接続された後、MetadataタブでZendeskから取り込むコンテンツを事前にフィルタリングできます。コアフィールドやカスタムタグから選択してフィルタリングやターゲティングを拡張可能です。+ Add Filterをクリックして、カテゴリ、ラベル、タイムスタンプなどの特定条件でコンテンツを絞り込めます。このステップをスキップすると、インポーターはデフォルトで全ての対象コンテンツを取り込みます。
Targetタブで、取り込んだコンテンツをIntercomのどこで使用するか決めます。
Fin AI Agent: Zendesk記事を自動応答に使う場合はオンにします。
Copilot: チームメイトへの提案回答を有効にします。
Help Center: Zendeskコンテンツを直接IntercomのHelp Centerに公開したい場合はオンにします。
オーディエンスコントロール：特定のオーディエンス（例：「Enterprise plan」や「UK audience」）がこのコンテンツを閲覧できるように選択します。
インポートを開始する前に設定を最終確認してください。
インポートを識別するためにカスタム名を入力してください（例：「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ページを更新して、左サイドバーのフォルダーにインポートされた記事を表示してください。
重要：まだの場合は、 Help Centerをオンにする必要があります。そうしないと記事は公開されず、FinやCopilotで有効にできません。
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記事 |
/hc/en-us/articles/12345678 | 同じIntercom記事 |
注意：リダイレクトはインポート時に自動的に作成され、問題が発生してもインポートを妨げることはありません。
多言語対応
複数言語のコレクションや記事をインポートする場合、各言語バリアントには元のZendesk記事URLに関連付けられた独自のリダイレクトがあります。
既存のリダイレクトの確認
インポート完了後、設定 > Help Center > 設定とスタイルのDomainsセクションから生成されたリダイレクトを確認できます。
ここから下にスクロールしてDomainsを見つけ、「manage redirects」をクリックします。
パネルには元のURLとリダイレクト先の記事/コレクションが表示されます。
重要：
リダイレクトは選択したカスタムドメインに対してのみ表示されます。例えば、Zendesk Help CenterのURLが
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サブドメインとは何ですか？
これは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は言語のローカライズ版の短いリストのみをサポートしています：Portuguese / Brazilian Portuguese、German / German (Formal)、Chinese Traditional / Simplified。
特に英語については、IntercomはEN-US、EN-UK、EN-CAをサポートしており、一般的な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に記事への特定のアクセス権を付与する標準的で安全な接続方法です。