APIでIntercomヘルプセンターの記事をエクスポートする方法：2025年版ガイド

何時間もかけてIntercomで素晴らしいナレッジベースを構築し、顧客の問題を解決する本当に役立つ記事で満たしたとします。次はそのコンテンツを外部に出す必要がありますが、どこにも大きくてピカピカの「エクスポート」ボタンがないことにおそらく気づいたでしょう。もし躍起になって探しているなら、あなたは一人ではありません。

新しいプラットフォームへの移行、安心のためのローカルバックアップの作成、コンテンツの詳細な分析など、どんな理由であれ、データを取り出すことが一大プロジェクトになるべきではありません。このガイドでは、APIを使ってIntercomのヘルプセンター記事をエクスポートする技術的な手順を順を追って説明します。

しかし、正直なところ、APIルートは複雑になりがちで、特有の落とし穴もあります。そこで、コードを一行も書かずにナレッジを接続・管理できる、はるかにシンプルで自動化された代替手段もご紹介します。

はじめる前に：必要なもの

APIを利用する方法に着手するには、少し準備が必要です。これは技術的なタスクなので、以下のものを準備しておくと、プロセス全体がずっとスムーズに進みます。簡単なチェックリストはこちらです：

• Intercomワークスペースへの管理者アクセス権： API認証情報を作成するための適切な権限を取得する必要があるため、これは絶対に必要です。

• 開発者アクセストークン： あなたのスクリプトやツールがIntercomと通信することを許可する安全なパスワードのようなものです。最初のステップで作成方法を説明します。

• APIリクエストを行うためのツール： コマンドライン環境に慣れているならcURLのようなツール、よりユーザーフレンドリーなアプリならPostmanなどが使えます。

• APIの基本的な理解： エンドポイント、GETリクエスト、JSONデータとは何かを知っていると、手順が理解しやすくなるので役立ちます。

Intercom APIを使って記事をエクスポートするステップバイステップガイド

準備はいいですか？ここでは、IntercomのREST APIを使って記事をエクスポートする全プロセスを4つのステップに分けて説明します。

ステップ1：Intercom開発者アクセストークンを取得する

まず、あなたのワークスペースのデータにアクセスする権限があることをIntercomに証明する方法が必要です。そこでアクセストークンの出番です。

取得は非常に簡単です。Intercomの設定にある「Developer Hub」にアクセスするだけです。そこから、内部利用のための新しいアプリを作成できます。覚えやすい名前（「Article Exporter」など）を付ければ、Intercomがアクセストークンを生成してくれます。このトークンをコピーして安全な場所に保管してください。すべてのAPI呼び出しに必要になります。

ステップ2：すべての記事をリストアップしてIDを取得する

Intercom APIには少し変わった仕様があります。すべての記事コンテンツを一度に要求することはできません。まず、すべての記事のリストをリクエストして、それぞれの一意のIDを取得する必要があります。これは、本を借り出す前に図書館の目録を手に入れるようなものです。

これを行うには、「List all articles」エンドポイントを使用します。このエンドポイントにアクセストークンを付けてリクエストを送信すると、Intercomは各記事に固有の「id」が付いた記事リストを含むJSONオブジェクトを返します。

ステップ3：各記事のコンテンツを取得する

記事IDのリストが準備できたら、実際のコンテンツを取得し始めます。これには、各記事に対して個別にリクエストを1つずつ送信する必要があります。

「Retrieve an Article」エンドポイントを使用し、リクエストURLに特定の記事の「id」を必ず含めます。各リクエストへのレスポンスは、記事に関するすべて（タイトル、著者、状態、そしてもちろんHTML形式のコンテンツを保持する「body」）を含むJSONオブジェクトになります。

これは、プロセスの中で最も繰り返し作業が多い部分です。500記事あれば、500回の個別APIリクエストを行うことになります。

ステップ4：エクスポートしたデータをフォーマットして保存する

各記事のコンテンツを取得したら、それを保存するのはあなた次第です。記事の本文はHTMLで返されるので、そのデータをファイルに保存する必要があります。.htmlファイルとして保存することもできますし、もし別の形式が必要なら、HTMLをMarkdownやプレーンテキストなどの別の形式に変換するスクリプトを書くこともできます。

ヘルプセンター全体でこれを行うには、ほぼ間違いなく、IDの完全なリストを取得し（ページネーションを処理し）、それぞれをループ処理し、APIリクエストでコンテンツを取得し、タイトルと本文を抜き出し、すべてをローカルファイルに保存する小さなスクリプトを書きたいと思うでしょう。

これで完了です。記事のエクスポートができました。しかし、ご覧の通り、ボタンを1回クリックするほど単純ではありません。

APIで記事をエクスポートする際の一般的な課題

APIを使用する方法は目的を達成できますが、完璧とはほど遠いものです。多くのチームが同じような不満に直面し、このタスクが本当のリソース消耗源になることがあります。

• 技術的で時間のかかるプロセスであること。 エンジニアでない限り、このプロセス全体は威圧的に感じるかもしれません。技術的なノウハウ、スクリプトの作成とデバッグの時間、そして複数回行う必要がある場合は継続的なメンテナンスが必要です。技術者でない人にとってはほとんど無理な話であり、開発者にとっては主要なプロジェクトから彼らを引き離す別のタスクにすぎません。

• 内部記事はエクスポートできないこと。 これは大きな問題です。現在のIntercom APIでは、内部専用記事をエクスポートすることはできません。チームが毎日使用している貴重なナレッジが閉じ込められ、自動エクスポートの目的を台無しにする手作業のコピー＆ペースト作業が残されます。

• フォーマットやコンテンツがおかしくなる可能性があること。 エクスポートされたHTMLは、必ずしも完璧な複製ではありません。Intercom自身のドキュメントでも言及されているように、独自に行った画像のサイズ変更は失われ、コールアウトや折りたたみセクションなどの動的要素は完全にはサポートされていません。美しくフォーマットされた記事が、少し壊れたように見えるかもしれません。

• 一度きりのスナップショットであること。 おそらく最大の欠点は、エクスポートが完了した瞬間に古くなることです。Intercomで行われた新しい記事、更新、編集はエクスポートされたファイルには含まれません。最新の状態を保つには、手動で技術的なプロセス全体をもう一度やり直す必要があります。

より良い代替案：ナレッジの統合

これらの頭痛の種はすべて、興味深い問いを提起します。エクスポートすることが問題に対する誤った解決策だとしたら？本当の目標は、単にHTMLファイルのフォルダを手に入れることではなく、そのナレッジを他の場所で活用することです。

もし、記事を全くエクスポートする必要がなかったとしたら？もし、Intercomのナレッジベースを他の使用ツールに安全に接続し、すべてを自動でライブかつ同期した状態に保てるとしたら？

それがeesel AIのすべてです。一度きりのエクスポートと格闘する代わりに、eesel AIはIntercomとのワンクリック統合を提供し、これらの問題を完全に回避できます。

以下にその利点を挙げます：

• すべてのナレッジを一つにまとめる。 数分でIntercomヘルプセンターを接続できます。しかし、そこで止まる必要はありません。Confluence、Google Docs、さらには過去のサポートチケットなど、チームが情報を保存している他の場所も接続できます。あなたのナレッジは、手動の作業なしで常にライブで最新の状態に保たれます。

• 数ヶ月ではなく数分で始められる。 開発者が必要な複数ステップのAPIプロセスは忘れてください。eesel AIを使えば、サインアップし、ソースを接続し、すぐに価値を実感し始めることができます。すべて自分一人でできます。

• ナレッジを実用化する。 静的なエクスポートの用途は限られています。一方、ライブで接続されたナレッジベースは、大きなアドバンテージです。接続されると、Intercomのナレッジは、エージェントの返信を下書きするAIコパイロット、チケットを自律的に解決する自律型AIエージェント、またはSlack内の社内Q&Aボットの動力源となります。これは単なるデータダンプではなく、真の結果です。

eesel AIコパイロットが返信を作成している様子。統合されたナレッジがサポートツールを直接強化する方法を示しています。

Intercomナレッジ管理のためのプロのヒント

手動エクスポートから考え方を変えることで、ナレッジを管理するためのより良い方法が開かれます。より効果的な戦略を構築するためのヒントをいくつか紹介します。

1. ナレッジギャップを自動的に見つけて埋める。 ヘルプセンターを管理する上で最も難しいことの一つは、次に何を書くべきかを知ることです。推測する代わりに、顧客との対話に導いてもらいましょう。eesel AIのようなAIツールは、サポートチケットを調べて、ヘルプセンターで回答されていない繰り返しの質問を見つけ、そのギャップを埋めるための記事の下書きを自動的に生成できます。

eesel AIのダッシュボード。サポート会話からナレッジギャップを特定する方法を示しており、分析のためにAPIでIntercomヘルプセンターの記事を手動でエクスポートする必要がありません。

2. ナレッジがサイロに閉じ込められないようにする。 あなたの会社の集合知はIntercomだけに存在するわけではありません。重要なプロセスはConfluenceに記録され、製品の更新はGoogle Docsで共有され、簡単な修正はSlackでやり取りされます。より良いサポート戦略は、これらすべてのソースを統合し、チームとAIが回答を見つけるための信頼できる一つの場所を提供します。

3. 自動化する前にシミュレーションする。 ナレッジをAIの動力源として使用するなら、それが正しく機能すると信頼できる必要があります。リスクなしでテストできるツールを探しましょう。例えば、eesel AIのシミュレーションモードでは、何千もの過去のチケットでAI設定を実行できます。それがどのように応答したかを正確に確認し、解決率に関する確かな予測を得ることができるため、ライブ顧客向けにオンにする前に自信を築くのに役立ちます。

eesel AIのシミュレーション機能。チームが過去のチケットでAI設定をテストし、本番稼働前に自信を築くことを可能にします。

APIでIntercomヘルプセンターの記事をエクスポートする必要性を超えて

技術的にはAPIでIntercomヘルプセンターの記事をエクスポートできますが、そのプロセスが手動で技術的に要求が高く、いくつかの重大な制限があることは明らかです。社内ナレッジは置き去りにされ、すぐに役に立たなくなるコンテンツの静的なスナップショットしか得られません。

より現代的で効率的なアプローチは、一度きりのエクスポートについて考えるのをやめ、ライブで統合されたナレッジシステムの構築を始めることです。データを引き出すのではなく、ツールを接続すべきです。

'eesel AI'のようなツールは、このために作られています。チームがナレッジソースを数分で接続し、APIをいじったりコードを書いたりすることなく、その情報をすぐに活用できるようにします。あなたのナレッジベースが本当にできることを解き放つ時です。

ナレッジを統合する準備はできましたか？

手動のエクスポートや複雑なAPIスクリプトに時間を費やすのはやめましょう。Intercomヘルプセンターを含むすべてのナレッジソースをeesel AIで数分で接続できます。

今すぐ無料トライアルを開始して、真に統合されたナレッジでサポートを強化するのがいかに簡単かをご覧ください。