仕組み
コード不要の統合で、公開Zendesk Help Centerを簡単にIntercomに接続できます。これによりZendeskを情報源としてコンテンツを継続的に同期し、記事を使ってIntercomのAI機能を強化できます。
記事を直接Intercomで編集・管理して情報源にしたい場合は、代わりにZendeskから公開記事をインポートするをご覧ください。
記事がIntercomに同期されたら、以下が可能です:
正確で自動化された回答のためにFin AI AgentとCopilotを活用できます。
Inboxでチームメンバーが会話で共有できるようにアクセス可能にします。
Intercom Help Centerで特集し、顧客のセルフサービスを促進します。
新しいZendesk同期は堅牢なサービスパイプライン上に構築されており、コンテンツ統合の速度と信頼性を向上させます。また、Zendeskからラベルやカテゴリなどのメタデータを自動抽出し、Intercomでタグとして適用することで、コンテンツの整理やAI解決のルール適用を支援します。
新しいZendeskインポーターとの接続
この方法は安全なAPIキー認証を使用し、Zendeskからコンテンツを同期できます。
ステップ1：Zendesk APIトークンを生成する
Zendeskアカウントで管理センターに移動します。
アプリと統合 > API > Zendesk APIに進みます。
APIトークンタブをクリックし、APIトークンを追加をクリックします。
トークンに説明的な名前（例：「Intercom Integration」）を付けてコピーします。
重要：Zendeskはこのトークンを一度だけ表示するため、続行前に安全な場所に保管してください。
ステップ2：IntercomでZendeskを接続する
IntercomのワークスペースからKnowledge > Sourcesに移動します。
「公開記事」の下でZendeskを見つけ、同期またはインポートをクリックします。
Zendeskサブドメイン（例：
your-company.zendesk.com）を入力します。
「認証方法」でAPIキーを選択します。
「メールアドレス」欄にZendesk管理者のメールアドレスを入力します。
「APIトークン」欄にZendeskで生成したトークンを貼り付けます。
（オプション）Zendeskでログインユーザーのみが閲覧可能な記事がある場合は、ログインユーザー向け記事を同期をオンにします。
コンテンツを表示したいIntercomのターゲットHelp Centerを選択します。
コンテンツを同期を選択します。
同期をクリックして開始します。
同期が完了すると、登録済みのIntercomメールアドレスに同期された記事数を確認するメールが届きます。
Zendeskから公開記事を同期すると、Knowledge > Contentの左サイドバーから閲覧できる同期フォルダ内にフラットリストで表示されます。
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がヨーロッパの顧客にのみその記事を提供するようにできます。
注意：同期で作成されたタグ（例：ラベルやカテゴリタグ）をアーカイブすると、今後の同期でもアーカイブされたままになります。同期はタグ名でタグを検索し、既に存在する場合はアーカイブされていても再利用します。タグを未アーカイブにしたり重複作成したりはしません。タグ名を解放するのは削除した場合のみで、次回の同期で再作成されます。継続的なクリーンアップには削除ではなくアーカイブを推奨します。
接続を管理する
同期を削除する
重要：Help Centerで実際にはIntercomで編集可能な記事にZendeskアイコンが表示されている場合、それは以前のインポートの残留マーカーです。記事はネイティブであり、Zendesk接続は既に削除されています。アイコンを消すためにソースを削除して再接続しないでください。そうすると記事が再び閲覧専用になり、検索エンジンによるインデックス登録がブロックされ、多くのチームが望むネイティブ記事の利点と逆になります。
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：Intercom記事にリンクするWorkflows（旧Custom Bots）を使用している場合は、新しい同期記事を指すように更新する必要があります。
言語サポート：現在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」をご覧ください。