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

データの編集と更新

データを自動的に更新する方法と、手動で更新する際のベストプラクティス。

対応者:Alek Toumert

ユーザーデータはさまざまな方法で更新できます。ほとんどの更新はIntercomによって自動的に処理されますが、手動でデータを更新することも可能です。このガイドでは、以下の方法でデータを更新する方法を説明します:

  • JavaScriptスニペット

  • モバイルSDK

  • アプリ

  • 資格データ

  • REST API

  • CSVインポート

「Messengerでの会社属性の更新を防ぐ」機能を使用すると、ワークスペース内のusersに会社がリンクされるのを防ぎます。

データが自動的に更新される仕組み

JavaScriptスニペットまたはモバイルSDKを使用して

製品にIntercomをインストールすると、usersがログインするたびにユーザーデータが更新されます。更新内容には以下が含まれます:

  • 標準属性:メール、最終閲覧、ウェブセッション、OS、会社プランなど。

  • カスタム属性。追加した任意のカスタムデータ。例:作成したプロジェクト、サブスクリプションレベル、フォロワー数。

  • イベント、例えばサブスクリプションのアップグレードや機能の使用。

usersがアプリにログインするたびに、プロフィールに表示されるセグメントバッジも更新されます👇

REST APIでセグメントを更新することも可能です。

アプリを使って

アプリと連携を使って、Intercomのデータを他のプラットフォームと自動同期できます。例:

  • MailchimpMarketoから送信されたメールの配信停止時に、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より先にアプリで更新してください)。

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