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

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

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 > Train > Content に移動し、「コンテンツを追加」セクションのすべて表示を選択します。

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

関連する 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 は 「global」タイプ のスペースのみ同期をサポートしています。 「personal」や「knowledge_base」とマークされたスペースは同期に含まれません。

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

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

  • Confluence で新しい Custom スペースを作成します。

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

表示設定を確認する

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

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

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

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

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

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

注意:

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

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

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

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

Guru

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

  2. Guru のメールアドレスと API トークンを入力します。

  3. コレクション、フォルダー、インポートまたは同期するかを選択します。

  4. 同期/インポートが開始されると、Knowledgeにステータスバナーと進行状況アイコンが表示されます。

  5. 同期/インポートが完了すると、ステータスアイコンは緑のチェックマークに更新されます。

ヒント:

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

  • API認証情報はこちらの手順に従って取得でき、設定ページで確認できます。User Tokenを選択してください。

Notion

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

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

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

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

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

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


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

ConfluenceとNotionのソースは4段階のセットアップフローを使用し、Intercomへのコンテンツ取得方法が明確で、インポート内容と使用場所を制御できます。

接続

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

メタデータ

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

  • ラベルまたはタグ

  • タイトル

  • 親ページ / 先祖ページ

  • 作成者

  • 作成日と編集日

  • 動的プロパティ(Notion)

文字列条件(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 に移動して記事を開きます。

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

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

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

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

同期されたコンテンツのインポート

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

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

重要:

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

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

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