Intercom REST APIガイド (2025年版)

おそらく皆さんは毎日Intercomを使って顧客とチャットしていることでしょう。それだけでも素晴らしいツールですが、もしIntercomをビジネスで利用している他のすべてのツールと連携させることができたらどうでしょうか？ワークフローを自動化し、顧客データをシームレスに同期し、手作業なしでカスタムエクスペリエンスを構築することを想像してみてください。これこそが、Intercom REST APIの真の力です。

正直なところ、「API」という言葉は、特に専属の開発者がいない場合には、 intimidating（威圧的）に聞こえるかもしれません。でも、ご心配なく。このガイドでは、Intercom REST APIとは何か、何ができるのか、そして最も重要なこととして、一夜漬けでコーディングの専門家にならなくても、そのすべてのメリットを享受する方法を解説します。

Intercom REST APIとは？

では、REST APIとは一体何なのでしょうか？これは、異なるソフトウェアプログラムがオンラインで互いに「対話」できるようにする翻訳者のようなものだと考えてください。特にIntercom REST APIは、他のアプリがあなたのIntercomアカウント内のデータに安全にアクセスし、変更することを可能にするツールセットです。

ユーザーリストを手動でエクスポートしたり、顧客のプロフィールを手で更新したりする代わりに、APIを使えば、別のアプリケーションに自動でそれを実行させることができます。Intercomの言葉を借りれば、同社のREST APIは、「Intercomプラットフォームの中核をなす構成要素」であり、情報の取得、更新、作成、削除に使用できます。

これにより、次のような非常に便利なことが可能になります。

• 会話や顧客データをCRMと同期する。

• 社内データベースの情報を使ってユーザープロフィールにさらなるコンテキストを追加する。

• サポートチーム向けにSlackでカスタムアラートを構築する。

Intercom REST APIの主要なデータモデルを理解する

何かを構築し始める前に、Intercomがどのように情報を整理しているかを知っておくと役立ちます。Intercomはすべての情報をいくつかの主要なカテゴリに分類しています。これらを理解すれば、APIで実際に何ができるのか、より明確に把握できるでしょう。

コンタクト：訪問者、リード、ユーザー

Intercomでは、やり取りする人々を次の3つのグループに分類しています。

• 訪問者： チャットを開始する前にウェブサイトを閲覧している匿名のユーザー。

• リード： メッセージを送信したり、返信したりした訪問者。この時点でIntercomは彼らのアクティビティ履歴の記録を開始します。

• ユーザー： 製品にサインアップした、または既存のアカウントにログインしたリード。

会話とメッセージ

これはIntercomにおけるすべてのコミュニケーションの基本です。

• メッセージ: チーム、チャットボット、顧客からのものかを問わず、単一のコミュニケーション。

• 会話： あなたと顧客との間のメッセージ全体のスレッド。

Intercom REST APIの重要な要素である、Intercomの会話型メッセンジャーの画面。

会社、属性、イベント

これらのデータは、コンタクトを整理し、重要なコンテキストを追加するのに役立ちます。

• 会社: コンタクトを所属する組織ごとにグループ化できます。

• 属性： 名前、メールアドレス、契約プランなど、コンタクトや会社に関する詳細を保存するフィールドです。その他、追跡したいカスタムデータも保存できます。

• イベント： 製品の利用状況や特定のウェブサイトでのアクティビティなど、追跡したいコンタクトのアクション。

その他の重要なデータタイプ

また、社内チームの組織化や問題追跡のために、これらのオブジェクトにも遭遇するでしょう。

• タグとセグメント： コンタクトにラベルを付けたりグループ化したりして、フィルタリングやターゲットメッセージの送信に利用します。

• メモ： チームがコンタクトのプロフィールに追加できる内部コメント。

• チケット: Intercom内で特定のユーザーリクエストをより正式に追跡・管理する方法。

Intercom REST APIを介して管理できるIntercomのチケット画面のスクリーンショット。顧客詳細が表示されています。

Intercom REST APIの一般的なユースケース（と限界）

理論上、APIは素晴らしいものに聞こえますよね？サポートをカスタマイズするための様々なクールなものを構築できます。しかし、実際にこれらの統合を構築し、維持するのは、隠れたコストや複雑さを伴う、本当に頭の痛い作業になることがあります。

リードと顧客データの同期

一般的な目標は、Intercomからの新しいリードをCRMに同期したり、社内ツールからデータを取得してエージェントが会話でより多くのコンテキストを把握できるようにしたりすることです。しかし、これには落とし穴があります。このすべてを管理するためには、カスタムコードを記述してホストする必要があります。そして、もしIntercomやCRMがAPIを更新すれば、カスタム統合は壊れてしまい、最悪のタイミングでデータが同期されなくなる可能性があります。

カスタムチャットボットとワークフローの構築

もう一つのアイデアは、Intercomのネイティブボット以上の機能を持つカスタムボットを構築することです。例えば、Shopifyで注文状況を確認したり、アカウントの機能を検証したりするようなボットです。これは大規模な開発プロジェクトになります。IntercomのAPI制限内で、会話フロー、ロジック、他のシステムへのコールをすべて管理しなければなりません。

正直なところ、これはフルタイムの仕事です。ゼロから構築する代わりに、eesel AIのようなプラットフォームを使えば、数分で強力なAIエージェントを作成できます。Intercomや自社のナレッジベースなどのツールとのシンプルな統合により、一行もコードを書かずに複雑な質問に対応する自律型エージェントを導入できます。また、AIの個性や実行可能な特定のアクションも完全にコントロールできます。

Intercom REST APIで直接構築するのと比較して、プロセスを簡素化するビジュアルワークフロービルダーの例。

アラートの作成とチームの割り当て管理

あるいは、会話をエージェントにラウンドロビンスタイルで自動的に割り当てたり、VIP顧客からメッセージが来たときにSlackアラートを受け取りたいと思うかもしれません。これを自前で行うには、開発者がこれらのイベントを常にリッスンするサービスを構築する必要があります。これもまた、チームが構築し、監視し、壊れたときに修正しなければならないカスタム技術の一つです。

ここでも、専用のAIツールが多大な労力を節約してくれます。例えば、eesel AIのトリアージ自動化は、ヘルプデスクに直接接続してルーティングとタグ付けを自動化するため、チームはキューの整理をやめて、顧客との対話に集中できます。

Intercom REST APIの始め方

さて、警告を聞いた上で、それでも自分で何かを構築したいと思っているのですね。それも良いでしょう。ここでは、そのプロセスがどのようなものか、簡単に概観します。

認証と最初のAPI呼び出し

APIを使い始めるには、まずIntercomの開発者設定からアクセストークンを取得する必要があります。このトークンは、あなたのワークスペースのデータにアクセスする権限があることを証明する鍵です。そして、このトークンをリクエストに含めます。例えば、簡単な「cURL」コマンドを使ってワークスペースの管理者リストを取得することができます。

主要なIntercom REST APIエンドポイントのナビゲーション

APIはさまざまな「エンドポイント」に分かれています。これらは、異なる種類のデータにアクセスするためのURLです。最も一般的に使用するものは、先ほど説明したデータモデルのものです。

• "/contacts"

• "/conversations"

• "/companies"

• "/tickets"

• "/messages"

Intercom REST APIに代わる、よりシンプルなノーコードの選択肢

Intercom REST APIを使って構築すると、多くのコントロールが可能になりますが、時間、費用、開発者の工数という点で大きなコミットメントが求められます。ほとんどのサポートチームにとって、これは現実的ではありません。より高速なアプローチは、そうした面倒な作業をすべて代行してくれるプラットフォームを利用することです。

eesel AIは、完全にセルフサービスで利用できるように設計されています。ワンクリックでIntercomを接続し、数ヶ月ではなく数分で運用を開始できます。過去の何千ものチケットでAIをシミュレーションして、顧客向けに有効にする前に解決率の正確な予測を確認することもできます。もう推測に頼る必要はありません。

Intercomの価格設定

コストといえば、Intercom自体の価格体系、特にAI機能に関する部分を見ることも重要です。主要なプランはエージェントごとの価格設定ですが、AIエージェントであるFinは別売りです。

価格ページによると、Finは解決ごとに$0.99の費用がかかります。これは、各エージェントに支払う料金に加えて、AIがチケットを正常にクローズするたびに追加料金が発生することを意味します。サポート量によって変動するため、月々の請求額が非常に予測しにくくなる可能性があります。

この従量課金モデルは非常に一般的ですが、予算編成にとっては本当に厄介なものです。eesel AIでは、アプローチが異なります。当社の価格設定は、月々のAIインタラクション数に基づいた、分かりやすく予測可能なものです。AIエージェント、Copilot、トリアージといったすべてのツールが、予期せぬ料金なしのシンプルな1つのプランにまとめられています。

プラン	シート価格/月（年間契約）	Fin AIエージェント費用
Essential	$29	+ 解決ごとに$0.99
Advanced	$85	+ 解決ごとに$0.99
Expert	$132	+ 解決ごとに$0.99

Intercom REST APIの基本を超えて

では、結論は何でしょうか？Intercom REST APIは、カスタムワークフローを作成し、データを連携させるのに役立つ素晴らしいツールです。しかし、すべてを自分で構築しようとすると、技術的なハードルと継続的なメンテナンスに満ちた、長く費用のかかる道のりになります。

現代のAIプラットフォームは、同等かそれ以上の結果を、はるかに迅速かつアクセスしやすい方法で提供します。コードと格闘する代わりに、eesel AIのようなツールを使えば、すべてのナレッジソースを統合し、チームがすでに愛用しているツールを使い続けながらサポートを自動化できます。

Intercomサポートを数分で自動化

専用に構築されたAIエージェントが、あなたのサポートチームに何をもたらすか見てみませんか？ワンクリックでIntercomヘルプデスクを接続し、eesel AIの無料トライアルを開始しましょう。開発者は必要ありません。

無料トライアルを開始