ユーザーデータはさまざまな方法で更新できます。ほとんどの更新はIntercomによって自動的に処理されますが、手動でデータを更新することも可能です。このガイドでは、以下の方法でデータを更新する方法を説明します:
JavaScriptスニペット
モバイルSDK
アプリ
資格データ
REST API
CSVインポート
「Messengerでの会社属性の更新を防ぐ」機能を使用すると、ワークスペース内のusersに会社がリンクされるのを防ぎます。
データが自動的に更新される仕組み
JavaScriptスニペットまたはモバイルSDKを使用して
製品にIntercomをインストールすると、usersがログインするたびにユーザーデータが更新されます。更新内容には以下が含まれます:
usersがアプリにログインするたびに、プロフィールに表示されるセグメントバッジも更新されます👇
REST APIでセグメントを更新することも可能です。
アプリを使って
アプリと連携を使って、Intercomのデータを他のプラットフォームと自動同期できます。例:
StripeのデータをIntercomワークスペースに更新して、usersの詳細情報を取得できます。
Salesforceと連携して、leadsデータと活動を自動同期できます。
独自のアプリを作成して、usersのデータを自動更新することも可能です。
データを手動で更新する方法
資格データを使って
資格データは、leadsやusersとチャットしながらIntercomで手動更新できる特別な属性セットです。営業パイプライン内のleadsのステータスなど、定期的な手動更新が必要な属性の管理に最適です。
連絡先の名前を更新する際、変更に遅延が生じることがあります。これは連絡先リストが別のデータベースから取得されているためです。
Workflowsを使って資格データを自動更新することも可能です。
CSVインポートを使って
usersやleadsを一括で手動更新するには、CSVインポートを利用できます。インポート時にusersを一括タグ付けすることも可能です。CSVインポートツールの詳細はこちら。
会社データはCSVインポートでの取り込みや更新はできません。この方法で更新できるのはusersデータのみです。会社データは会社プロフィールの手動編集かREST APIでのみ更新可能です。
会社属性の編集
Intercomで会社属性を編集する方法は3つあります。すべての方法はすべての顧客に利用可能で、追加プランは不要です。
1. REST API
Companies REST APIを使って、会社属性をプログラムで作成・更新できます。これは最も柔軟な方法で、標準属性とカスタム属性の両方に対応しています。
要件:
Intercomのアクセストークン(Developer Hubから入手可能)。
設定したいカスタム属性は、まずワークスペースでカスタムデータ属性として作成する必要があります。
リクエストには会社のIntercom IDまたは割り当てた
company_idを含める必要があります。
2. JavaScript(アプリまたはウェブサイト内)
IntercomのJavaScriptスニペットがインストールされていれば、Intercom('boot')またはIntercom('update')呼び出しで会社属性を直接渡せます。呼び出しが行われるたびに属性は自動更新されます(例:ページ読み込みやユーザーログイン時)。
要件:
Intercom JavaScriptスニペットがアプリまたはウェブサイトにインストールされている必要があります。
会社データは
Intercom()呼び出し内のcompanyオブジェクトで渡す必要があります。最低限、会社を識別するためにcompany_idが必要です。カスタム属性は、値が保存される前にワークスペースでカスタムデータ属性として作成されている必要があります。
注意:「Messengerでの会社属性の更新を防ぐ」を有効にしている場合、不安全なJavaScriptによる会社属性の更新はブロックされます。有効なJWT経由の更新は引き続き機能します。
3. 資格データ(Intercom UI)
資格データを使うと、技術的な設定なしで会話や会社プロフィールから直接会社属性を手動更新できます。アカウントステータスや営業段階など、定期的な手動更新が必要な属性に便利です。
要件:
属性は編集用UIに表示される前に資格データ設定に追加されている必要があります。
チームメンバーはワークスペース内で連絡先または会社データを編集する十分な権限が必要です。
注意:資格データで手動更新したデータは、JavaScriptやREST API経由で同じ属性が送信されると上書きされます。アプリのデータベースが常に真の情報源であるべきです。
REST APIまたはZapierを使って
その他の更新には、REST APIの使用を推奨します。カスタム開発により、以下が可能です:
定期的なスケジュール更新の設定。
ユーザーデータの手動更新用のダッシュボードやインターフェースの構築。
Intercomを他のアプリやサービス、製品に接続。
開発者がいない場合や技術的な選択肢を避けたい場合は、Zapierなどのサードパーティサービスで多くのことが可能です。問題があれば直接サポートに連絡してください。
CSVとREST APIの方法についての注意点:usersがログインすると、統合からIntercomに送信されたデータがAPI/CSVインポートで設定した値を上書きします。したがって、usersデータの真の情報源は常にアプリのデータベースであるべきです(Intercomより先にアプリで更新してください)。


