仕組み
コード不要の統合で、公開されたZendesk Help Centerを簡単にIntercomに接続できます。これによりZendeskのコンテンツを継続的に同期し、記事をIntercomのAI機能に活用できます。
記事を直接Intercomで編集・管理して（ソースとして使用）たい場合は、代わりにImport public articles from Zendeskを参照してください。
記事がIntercomに同期されたら、以下が可能です：
正確で自動化された回答のためにFin AI AgentとCopilotで活用できます。
チームメンバーが会話で共有できるようにInboxでアクセス可能にします。
Intercom Help Centerで表示し、顧客のセルフサービスを支援します。
新しいZendesk同期は堅牢なサービスパイプライン上に構築されており、コンテンツ統合の速度と信頼性を向上させます。また、Zendeskからラベルやカテゴリなどのメタデータを自動抽出し、Intercomでタグとして適用。コンテンツ整理やAI解決のルール適用に役立ちます。
新しいZendeskインポーターとの接続
この方法は安全なAPIキーで認証し、Zendeskからコンテンツを同期できます。
ステップ1：Zendesk APIトークンを生成する
ZendeskアカウントでAdmin Centerに移動します。
Apps and integrations > APIs > Zendesk APIに進みます。
API tokenタブをクリックし、Add API tokenをクリックします。
トークンに説明的な名前（例：「Intercom Integration」）を付けて、トークンをコピーします。
重要：Zendeskはこのトークンを一度だけ表示するため、続行前に安全な場所に保管してください。
ステップ2：IntercomでZendeskを接続する
IntercomのワークスペースからKnowledge > Sourcesに移動します。
「Public articles」欄でZendeskを見つけ、Sync or Importをクリックします。
Zendeskサブドメインを入力します（例：
your-company.zendesk.com）。
「Authentication method」でAPI keyを選択します。
「Email address」欄にZendesk管理者のメールアドレスを入力します。
「API token」欄にZendeskで生成したトークンを貼り付けます。
（オプション）Zendeskでログインユーザーのみが閲覧可能な記事がある場合は、Sync articles for signed-in usersをオンにします。
コンテンツを表示したいIntercomのTarget Help Centerを選択します。
Sync contentを選択します。
開始するにはSyncをクリックします。
同期が完了すると、登録済みのIntercomメールアドレスに何件の記事が同期されたか確認のメールが届きます。
Zendeskから公開記事を同期すると、Knowledge > Contentの左サイドバーから閲覧できる同期フォルダー内にフラットリストで表示されます。（既存のZendeskフォルダー構造はKnowledgeで現在サポートされていませんが、近日対応予定です）。
Zendeskから同期された公開記事はKnowledgeで閲覧専用として表示され、編集はできません。すべての変更はZendeskで行い、次回同期時に自動的にIntercomに反映されます。ただし、設定でFinの有効化や対象ルールの管理が可能です。
注意：
Intercom Help Centerで利用可能にし、Intercomで編集したい場合はZendeskから記事をインポートする必要があります。
再同期は自動的に毎時実行され、Zendeskの記事の新規作成、内容変更、削除がIntercomに反映されます。
最初の同期後に自動実行される同期は完了時にメールを送信しません。
すでにIntercomに記事が公開されている場合、既存の記事は保持され、重複コンテンツが発生する可能性があります。最初の同期前にすべてのIntercom記事を削除することも可能です。
WorkflowsにIntercom記事が含まれている場合は、新しい同期記事に更新して、Zendeskでの変更に合わせて正しいコンテンツにリンクされていることを確認してください。
最初の同期が開始されると強制停止はできません。初回同期完了後に同期を解除できます。
同期された記事はIntercomで非公開扱いとなるため、Finが利用するにはIntercom help centerが公開されている必要があります。
Zendeskサブドメインとは？
これはZendeskアカウントのドメイン（Help CenterのURLではありません）です。Zendeskサブドメインは固有の識別子で、見つける方法はいくつかあります。こちらをご覧ください。
接続後の流れ
Zendeskサイトのクロールを開始し、公開記事をIntercomに取り込みます。記事数により数分から1時間以上かかることがあります。完了後にメールを送信し、その後は毎時同期して最新コンテンツを取得します。
状態はいつでもKnowledge > Sourcesで確認できます。処理完了後はKnowledgeのContentページを更新して記事を確認してください。
Zendeskのメタデータ同期方法
時間短縮のため、同期はZendesk knowledge baseの構造とメタデータをIntercomで有用な形式に自動変換します。
Zendeskのラベル、カテゴリ、コンテンツタグはすべて同期され、Intercomの記事タグに変換されます。
Zendeskの記事構造（コレクションとセクション）はIntercomに複製されます。未分類のコンテンツは「General」というコレクションに配置されます。
ヒント：これらのタグが自動適用されることで、KnowledgeでのコンテンツフィルターやFin AI Agentで特定顧客向けの記事選択が可能になります。例えば、Zendeskラベル「EMEA-only」はIntercomのタグとなり、Finが欧州の顧客にのみその記事を提供するよう制御できます。
接続を管理する
同期を削除する
Zendeskとの同期（および関連データ）を削除したい場合は、Knowledge > Sourcesから、公開記事の下にあるManage > Remove this sourceをクリックしてください。
削除が成功したことを示す緑色の確認バナーが表示され、同期された記事はIntercomのKnowledgeから削除されます。
重要：接続を削除すると、同期されたすべてのZendesk記事がIntercomから削除されます。これにより、記事レポートのデータも削除され、レポート数値が減少する可能性があります。
重要な考慮事項
Zendeskはあなたの信頼できる情報源のままです：顧客向けのHelp CenterウェブサイトはZendeskに残り、すべての編集はそこで行う必要があります。
Intercomでは読み取り専用：同期された記事はIntercomで閲覧のみ可能です。Zendeskでの変更は次の1時間ごとの同期時にIntercomに反映されます。
検索インデックス：重複コンテンツのペナルティを避けるため、同期が有効な間は検索エンジンがIntercomのHelp Centerをインデックスしないようにしています。ZendeskのHelp Centerが検索エンジンにとって主要なものと見なされます。
リンク：お客様が同期されたMessenger内の記事の「Open in Help Center」リンクをクリックすると、ZendeskのHelp Centerで記事が開きます。
同期されるもの：公開済みで公開またはサインインユーザーに表示されるZendesk記事のみ処理します。内部またはプライベートなknowledge base記事はサポートされません。
重複コンテンツ：同期開始時にすでにIntercomに公開されている記事がある場合、重複コンテンツが発生する可能性があります。
Workflows：Workflows（旧Custom Bots）でIntercom記事へのリンクを使用している場合は、新しい同期記事を指すように更新する必要があります。
言語サポート：現在Intercomでサポートされていない言語の記事はサポートしていません。複数の英語バリアント（例：
en-usやen-gb）がある場合、Intercomの一般的な英語（en）にマッピングされ、データ損失を避けるために別々の記事が作成されることがあります。ビデオサポート：Zendeskの「ビデオ追加」ボタンを使った
iframe埋め込み動画（YouTube、Vimeo、Loomなど）をサポートします。カスタムHTML、CSS、JavaScriptの動画埋め込みはサポートしていません。Help centerの要件：同期された記事はIntercomで非公開リストされるため、Fin AI Agentが使用するにはIntercomのhelp centerが稼働している必要があります。
注意：FinがZendesk記事を参照する場合、ソースリンクはお客様をZendeskのHelp Centerにリダイレクトします。
レガシーZendeskインポーターとの同期
重要：レガシーZendeskインポーターは4月25日に廃止されます。この日以降、自動（日次）および手動の同期は停止します。同期を継続するには、4月25日までに新しいインポーターに移行する必要があります。
新しいインポーターへの移行方法
Knowledge > Sourcesに移動し、旧バージョンのZendesk help centerソースを開きます。
Manage（三点リーダー）> Migrate importerをクリックします。
Zendeskで認証を行い、移行を完了するための指示に従ってください。再度Zendeskにサインインするよう求められます。Zendeskの管理者アカウント（または元の同期と同じアクセス権を持つエージェントアカウント）を使用してください。
移行後、新しいインポーターを開き、Editをクリックしてメタデータフィルターを設定し、Finのオーディエンス、Copilotの設定、タグを確認します。
注意：移行中は既存の記事設定がすべて保持されます。移行が完了し、新しいインポーターを開いてEdit / Edit sourceをクリックするまで、新しいメタデータフィルターは使用できません。
4月25日以降
以前のインポーターは動作しなくなり、手動および自動の同期が停止します。
4月25日以降もいつでも移行は可能ですが、移行を行うまで古いインポーターからの同期は停止したままです。
新しいインポーターに切り替えた後（または移行したソースを編集した後）、新しいフィルターとメタデータ機能にアクセスできます。
注意：Zendeskインポーターは当社チームによって有効化される必要があります。ワークスペースに表示されない場合は、サポートチームに連絡して有効化を依頼してください。有効化されると、自分で移行を実行できます。
Intercomで同期された記事の使用
Zendesk記事をIntercomと同期した後、プランに含まれている場合は以下の機能に利用できます。
記事の閲覧
記事の検索
記事の提案（Messengerホーム）
AIによる回答
記事の提案
AIによる回答
会話内で記事を検索して送信する
読み取り専用機能
Public APIを介した同期記事の使用
同期された記事とその内容はPublic APIからIntercom記事と同様に取得可能です。ただし、APIコールで同期記事を編集または操作することはできません。
影響を受けるAPIエンドポイント：
影響を受けないAPIエンドポイント：
同期された記事のレポート
同期されたZendesk記事のパフォーマンスは、ネイティブのIntercom記事と同様に追跡できます。
同期コンテンツのすべての閲覧数、リアクション、検索データはメインのArticles reportに表示されます。これにより、どの記事が最も利用されているか、顧客が何を検索しているか、Zendeskで改善が必要な記事がわかります。
レポートはReports > All reports > Intercom reportsで見つけられます。このレポートの詳細な使い方については、記事「Articles report」をご覧ください。