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

外部ソースから内部記事を同期またはインポートする

Confluence、Guru、または Notion からサポートコンテンツを同期またはインポートする方法。

対応者:Beth-Ann Sher

Confluence、Guru、または Notion から内部コンテンツを Intercom に同期またはインポートでき、ワークスペースのチームメンバーがアクセスでき、Fin AI Agent および/または Copilot で利用可能になります。Confluence と Notion のソースは、より豊富なメタデータ、事前フィルタールール、新しいレビュー フローをサポートし、どのページを Intercom に取り込み、どこで使用するかを正確に制御できます。

コンテンツが同期されるとき:

  • Intercom 内で編集できません。コンテンツの変更は元のツール(Confluence、Notion、または Guru)で行う必要があります。

  • 24時間ごとに自動的に再同期され、新しいコンテンツの変更が Intercom に反映されます。手動で再同期することも可能です。

  • 前回の同期以降にソースに更新がない場合、実行しても新しいものが生成されないため、日次同期はスキップされます。

  • コンテンツは Knowledge の新しい同期フォルダーに追加されます。同期フォルダーは変更できず、すべてのフォルダーはアルファベット順に表示されます。

コンテンツがインポートされるとき:

  • ネイティブの内部記事に変換され、Intercom の Knowledge 内で編集・削除が可能です。

  • コンテンツは Knowledge の新しいネイティブフォルダーに追加されます。ネイティブフォルダーは変更可能です。

同期またはインポートされた内部記事は Fin Copilot で利用可能ですが、公開 Help Center には公開できません。画像、表、リスト、見出しなど、元のソースのほとんどの書式は保持されますが、一部の書式(例:引用)はサポートされません。


内部記事を同期またはインポートする

新しい内部ソースを同期またはインポートするには、Fin AI Agent > トレーニング > コンテンツ に移動し、「コンテンツを追加」セクションのすべて表示を選択します。

次に、同期/インポートしたいソースを選択します。

関連する Confluence/Guru/Notion アカウントにアクセスするための認証情報を求められます。

Confluence

  1. Intercom で Confluence ソースを開きます。

  2. ソースの横にある三点メニューからソースを編集をクリックします。

  3. 接続 → メタデータ → ターゲット → レビューの手順を進めます。

  4. メタデータフィルター、対象ユーザー設定、Fin AI Agent/Copilot の利用可能性を設定します。

  5. 更新して同期をクリックします。

注意: これは v1 および v2 ソース(フォルダー対応ソース)の両方で機能します。既存の OAuth 認証情報は引き継がれますが、接続が期限切れの場合は再認証を求められることがあります。権限が制限されたスペースは正しく同期できない場合があります。Confluence に接続するユーザーアカウントが、同期対象のスペースに対して適切な閲覧およびアクセス権限を持っていることを常に確認してください。

メタデータのステップでは、Intercom に取り込むページを事前にフィルタリングできます。Confluence では、構造化フィールドとして同期されるメタデータにラベル、タイトル、親ページ、作成者、作成/編集日が含まれます。文字列条件(等しい、等しくない、含む、始まる、終わる)およびラベル条件(等しい、等しくない)を使って事前フィルタールールを作成できます。

Confluence スペース同期のトラブルシューティング

Confluence スペースを Intercom と統合する際に、特定のスペースが表示されなかったり正しく同期されなかったりする場合があります。このガイドは、これらの一般的な問題の診断と解決を支援します。

欠落している Confluence スペースの種類を確認する

  • Confluence で スペース設定 > スペース管理 > スペース詳細 に移動します。

  • スペースの「種類」を確認します。

  • Intercom は「グローバル」タイプのスペースのみ同期をサポートします。 「パーソナル」や「knowledge_base」とマークされたスペースは同期に含まれません。

新しいカスタムスペースを作成する(サポートされていないタイプの場合)

  • 欠落している Confluence スペースがサポートされていないタイプ(例:「パーソナル」や「knowledge_base」)の場合は、新しい「カスタム」スペースを作成して問題を解決できます。

  • Confluence で新しいカスタムスペースを作成します。

  • サポートされていないスペースからこの新しく作成したカスタムスペースにコンテンツを移行します。

表示設定を確認する

  • Confluence で、同期したいスペースが「現在」ステータスに設定されていることを確認します。

  • このステータスのスペースのみが Intercom との同期対象となります。

フォルダーとページ階層のトラブルシューティング

  • Intercom は Confluence 内のフォルダーを直接同期サポートしていません。代わりに、個々のページとサブページに基づいて同期します。

  • コンテンツが正しく同期されるように、ページとサブページを使って構成してください。特定のコンテンツを除外する必要がある場合は、それらのページを Intercom との同期対象外の別の Confluence スペースに移動してください。

上記の手順で問題が解決しない場合は、ワークスペースで有効にする必要がある特定のバックエンド設定があるかもしれません。問題解決のためにサポートチームに連絡してください。トラブルシューティング手順を実施済みであることを伝え、すべての非パーソナル Confluence スペースを表示できるようにするためのバックエンド設定の有効化を依頼してください。彼らがスムーズな運用を支援してくれます。

注意:

  • Intercom の統合は現在Confluence Cloud のみをサポートしています。オンプレミス版 Confluence との統合は試みないでください。

  • フォルダーの除外はフィルターで処理されます:「先祖ページ」フィルターを使ってページのサブツリー全体を除外します。以前に拒否フォルダーを設定していた場合は、次回の同期時に自動的にフィルタールールに移行されます。操作は不要です。

  • 単一ページの同期はサポートしていません。完全同期のみサポートしています。

  • Confluence からの同期はフォルダーをサポートしますが、ホワイトボードはサポートしません。

Guru

  1. ソースとして Guru を選択します。

  2. 接続 → メタデータ → ターゲット → レビューの手順を進めます。

  3. メタデータフィルター、オーディエンスターゲティング、およびFin AI Agent/Copilotの利用可能性を設定します。

  4. 更新して同期をクリックします。

メタデータステップでは、どのカードがIntercomに取り込まれるかを事前にフィルタリングできます。Guruの場合、構造化フィールドとして同期されるメタデータにはタグ、タイトル、ボード、著者、日付、コレクション、検証ステータス、共有ステータスが含まれます。文字列条件(is, is not, contains, starts with, ends with)およびタグ条件(is, is not)を使って事前フィルタールールを作成できます。

ヒント:

  • 同期またはインポート時に、Guruアカウントに正しい権限があり、API認証情報を手元に用意していることを確認してください。

  • API認証情報は、ここに記載されている手順に従ってアクセスでき、設定ページで見つけることができます。User Tokenを選択してください。

Notion

  1. IntercomでNotionのソースを開きます。

  2. ソースの横にある三点メニューからソースを編集をクリックします。

  3. 接続 → メタデータ → ターゲット → レビューの手順を進めます。

  4. メタデータフィルター、オーディエンスターゲティング、およびFin AI Agent/Copilotの利用可能性を設定します。

  5. 更新して同期をクリックします。

注意:Notionには移行は不要です。すべては次回の同期時に自動的に処理されます。動的プロパティは構造化フィールドとして自動的に取り込まれます。


メタデータレビューの流れ

Confluence、Guru、Notionのソースは4段階のセットアップフローを使用し、コンテンツがIntercomにどのように取得されるかを明確にし、インポートされる内容と使用場所を制御できます。

接続

外部ソースに認証します。Confluenceソースの場合、既存のOAuth認証情報が引き継がれます。接続が期限切れの場合は再認証を求められることがあります。

メタデータ

外部knowledge baseのメタデータに基づく事前フィルタールールを使って、対象とするコンテンツを選択します。一般的なメタデータには以下が含まれます:

  • ラベルまたはタグ

  • タイトル

  • 親ページ / 先祖ページ

  • 著者

  • 作成日および編集日

  • 動的プロパティ(Notion)

  • ボード、コレクション、検証ステータス、共有ステータス(Guru)

文字列条件(is, is not, contains, starts with, ends with)およびラベル条件(is, is not)を使って同期されるコンテンツの範囲を絞り込みます。例えば、「fin-ai」とラベル付けされたページのみ、または特定の日付以降に更新されたコンテンツのみなど。

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

ターゲット

インポートされたコンテンツがIntercom内でどこで使用されるかを決定します。以下を設定します:

  • Fin AI Agent — コンテンツを使って顧客の質問に自動で回答します(デフォルトはOFF)

  • Copilot — チームメイトが提案回答としてコンテンツを利用できるようにします。

  • オーディエンスターゲティング — ソースレベルでオーディエンスルールを定義し、インポート時に自動適用します。

レビュー

同期開始前に設定を確認します。レビューでは以下が表示されます:

  • 接続の詳細(接続している外部アカウントまたはサブドメイン)

  • メタデータフィルター適用後の対象アイテム

  • ターゲットで有効な宛先

  • オーディエンスおよびターゲティングルール

ソースにわかりやすい名前を付けてから確認してください。例:「Confluence – Internal Support KB」や「Notion – Product Docs (EMEA)」。その後、更新して同期をクリックします。

ヒント:同じフローを後で再度開いて、メタデータ、ターゲット、またはレビュー設定を調整できます。ソースを再作成する必要はありません。


同期またはインポートされた内部記事を管理する

同期またはインポートが完了すると、メール通知が届き、内部記事はKnowledge > Contentのフォルダーに表示されます。

設定を構成する

Knowledgeで内部記事を開くと、その記事のコンテンツを表示し、右側の「詳細」パネルで設定を構成できます。

  • データ:コンテンツタイプ、言語、作成日、作成者、最終更新日、最終更新者を表示します。

  • Fin: FinとCopilotの有効/無効を切り替えます。有効にすると、コンテンツはFin AI Agentを通じて顧客に、Copilotを通じてチームメイトにそれぞれ利用可能になります。

    • オーディエンス:FinまたはCopilotが応答する際に、顧客が関連性のある回答のみを受け取り、関連コンテンツのみを閲覧できるようにします。

  • タグ:内部記事をグループ化し、コンテンツを整理するためにタグを追加します。

  • フォルダー:Knowledge内の関連フォルダーに記事を追加してコンテンツを整理します。同期された記事はすでにソースフォルダーに属しており、移動できません。

注意:

  • 同期された内部記事は編集できない同期フォルダ内に保存されます。フォルダの変更を行う場合は、元のソースから行う必要があります。

  • インポートされた内部記事とフォルダはKnowledge内で編集・管理できます。ソースとは同期されないため、変更はKnowledge内で行う必要があります。

Finに利用可能にする

内部記事をFin Copilotで利用可能にするには、Knowledgeにアクセスし、記事を開いてください。

「Details」パネルから下にスクロールして「Fin」を見つけ、トグルをオンにします。

  • Fin Copilot - この設定により、スニペットがFin Copilotでチームメイトへの応答時に利用可能になります。

再同期またはソースの削除

ソースは24時間ごとに自動で同期されますが、Fin AI Agent > Train > Contentに移動し、ソース横の3点メニューから手動で再同期または削除できます。

同期コンテンツのインポート

すでに外部ソース(Confluence/Guru/Notion)と同期した内部記事を、Intercomで管理(再構成、編集など)したい場合はインポートを選択できます。

Fin AI Agent > Train > Contentに移動し、ソース横の3点メニューを選択してコンテンツをインポートをクリックしてください。

重要:

  • 内部記事を完全にインポートすると、外部ソースとの接続が切断されます。ソースは表示されなくなり、コンテンツは同期フォルダからIntercomの非同期フォルダに移動します。

  • これらの特定のフォルダとコンテンツで同期を再作成する方法はありません。ソースは元の手順を再度実行して新しい同期として作成する必要があり、インポートされたフォルダとは一切リンクしない新しい同期フォルダとコンテンツのセットが作成されます。

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