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

連絡先のよくある質問

対応者:Matthew Pelyhes

連絡先データの管理

Intercomはどのようにusersや訪問者のデータを収集しアクセスを許可しますか?

Intercomは、サイトへのインストール方法に応じて、ログイン済みusersとログアウト済みの訪問者やleadsでデータ収集方法が異なります。

  • ログイン済みusersの場合、通常user_idやメールアドレスなどの特定データをIntercomのJavaScriptスニペットに渡して識別します。これによりIntercomは既知のuserに活動や属性を関連付けます。

  • ログインしていないか識別情報(メールなど)を共有していない訪問者の場合でも、Intercomはデフォルトで特定のデータを収集します。これには以下が含まれます:

    • 初回および最終訪問日時

    • 最終連絡日時(あなたまたはチームメンバーから)

    • ウェブセッション数

    • ブラウザの言語とバージョン

    • 優先言語設定

    • 訪問したURL

    • 市区町村と国

    • オペレーティングシステム

この訪問者データは、訪問者が識別されuserに変換されるまで、intercom-idまたはintercom-sessionクッキーに紐づけられます。

Intercomのworkspace(Contactsのlead/userプロフィールページ)またはIntercom APIを通じて、userおよび訪問者データの両方にアクセスでき、データの取得、更新、変換、削除が可能です。

Intercomはウェブサイトからusersを自動的に取得しません。サイトはJavaScript APIで明示的にIntercom('boot')を呼び出してusersを登録・追跡する必要があります。この呼び出しがなければusersはシステムに表示されません。

私のleadの資格データはどのように更新されますか?

Intercomでleadの資格データを更新する方法は3つあります。あなたは:

  • leadsのプロフィールで資格データを手動で更新する。

  • ウェブサイトや製品で取得したlead資格データを追跡し、pingを通じてIntercomに送信する(カスタム属性と同様に)。

  • Workflowを設定して、leadsのデータを自動的に収集・更新する。

複数のデータポイントが競合した場合はどうなりますか?

手動で編集されたデータが主要なデータソースです

手動で編集されたデータはpingやbot収集データによって上書きされることはありません。

手動で追加した資格データをクリアするには、その資格データにカーソルを合わせて再同期オプションを選択してください。これにより自動収集を再開できます。

CSVインポートやREST APIを通じてuserを更新すると、手動編集データは上書きされます。

Pingデータは二次的なデータソースです

Pingデータはbot収集データによって上書きされることはありません。

Botデータは三次的とみなされます

Bot収集データは、データ属性が空の場合にのみleadのプロフィールに追加されます。

資格データとは何ですか?

資格データは、leadおよびuserの資格プロフィールで更新できる特別な属性のセットです。

leadおよびuserの資格プロフィールに表示するデータは選択可能です。Intercomの資格設定にアクセスし、「データを追加」を選択してください。

ここからデータを追加する方法は2つあります。あなたは:

好きなデータを「追加」または「削除」することもでき、これによりleadおよびuserプロフィールに表示される資格データが変わります。

資格データで顧客をどのように評価しますか?

Intercomで顧客を評価する方法はいくつかあります:

ヒント:

  • ping(カスタム属性と同様)を通じてlead資格データを更新することも可能です。また、CSVインポートやREST API経由でも更新できます。

  • ビジネスに適した資格データの選び方に関するベストプラクティスをご覧ください。

userまたはleadのメールアドレスをどのように編集しますか?

user/leadのメールアドレスの更新は、Intercomで連絡先を識別する方法によります:

  • User IDsを一意の識別子として使用している場合、Contactsでuser/leadのプロフィールを開き、「Qualification」セクションのメールアドレスを編集して変更できます。

  • ユーザーIDを使用しない場合、メールアドレスが一意の識別子として機能し、変更できません。この場合、既存のユーザー/leadをアーカイブし、正しいメールアドレスで新しいものを作成することをお勧めします。

users と leads を完全に削除するにはどうすればよいですか?

UI経由で

ユーザー/leadに関連するすべてのデータを完全に削除して復元できないようにしたい場合は、設定の「Delete data」タブから行うことができます。

削除したいユーザーのユーザーIDまたはメールを入力し、ユーザーを選択します。「Permanently delete」をクリックすると、そのユーザーに関連するすべてのデータが削除されます。設定 > データ > People > Delete Data の順に進んでください。

REST API経由で

REST API経由でユーザーを削除するには、以下が必要です:

  1. REST APIベアラートークンと

  2. 永久に削除したいユーザーのIntercomユーザーID

単一のユーザーを削除する場合は、Delete contact endpoint developer documentationを使用できます。このページで、ベアラートークンとIntercomユーザーIDをそれぞれのフィールドに入力してください。

重要:

  • ユーザー/leadが削除されると、Intercom UIで表示できなくなります。
    誤って削除した場合は7日以内にご連絡ください。7日後はデータが完全に破棄されます。

  • ユーザーからのCSAT評価とコメントは削除されません。

  • ユーザーまたはleadが削除されると、そのすべての会話(ticketsを含む)がワークスペースから削除されます。ユーザーが復元されると、会話とticketsも復元されます。アーカイブまたは削除された連絡先の過去の会話はレポートに含まれ続けます。

  • エクスポートしたユーザーデータがある場合、GDPR法に準拠するためにそれらのファイルも削除する必要があるかもしれません。

既存のプロフィールを作成するのではなく、チェックして更新するようにWeb Messengerを調整する方法はありますか?

Intercomでユーザープロフィールの作成や更新を調整するには、一貫したユーザー識別子を渡していることを確認してください。Intercomはuser_idを主要な識別子として使用し、提供されていない場合はメールアドレスを使用します。

新しいuser_idが渡された場合(同じメールアドレスでも)、新しいユーザーが作成されます。既存のユーザーを更新するには、以下を必ず行ってください:

  1. 戻ってくるユーザーには常に同じuser_idを渡してください。

  2. Web messengerをカスタムコードで使用している場合は、Intercomの初期化時(JavaScript APIまたはREST API経由)にappロジックがuser_idおよび/またはメールを正しく割り当てていることを確認してください。

  3. 同じメールアドレスに異なるuser_idを使用すると、マージできない重複プロフィールが作成されるため避けてください。

重複が発生している場合は、以下の方法があります:

  • 手動でクリーンアップするかAPI経由で行えます。

  • API実装を監査して、一貫した識別子が送信されていることを確認してください。

さらにサポートが必要な場合は、現在の実装の例やスニペットを提供してください。

ユーザーからタグを削除するには?

これはContactsのユーザープロフィールページから行えます。ユーザープロフィールページの左側に「User tags」のユーザーデータメニューがあります。タグにカーソルを合わせて[X]アイコンをクリックするとタグを削除できます。

ユーザーノートの追加方法は?

ユーザーノートはユーザープロフィールまたはInboxの詳細セクションから追加できます。

重要:ユーザーノートを作成できるチームメンバーは誰でも削除も可能であり、これを制限する方法は現在ありません。「会話からの返信とノートを削除できる」権限は、連絡先プロフィールのユーザーノート削除権限を制御しません。

削除されたユーザーと同じuser IDおよび/またはメールで新しいユーザーを作成できますか?

これは7日間の猶予期間後のみ可能です。削除されたユーザーはそのuser ID/メールでデータベースにまだ存在しているためです。猶予期間中に同じuser ID/メールで新しいユーザーを緊急に作成する場合は、以下の方法があります:

  1. REST APIを使ってuser ID(externnal_id)/メールを更新します。例:User ID = 123 -> User ID = 123_delete

  2. その後、再度ユーザーを削除します。

  3. その後、希望のuser ID/メールでユーザーを作成します。例:User ID = 123.

ユーザープロフィールに直接リンクできますか?

ユーザープロフィールのリンクは、ユーザーのUser IDまたはメールアドレスを以下のURLに追加するだけで作成できます。

User ID:

https://app.intercom.com/apps/YOUR_APP_ID/users/show?user_id=THE_USER_ID

ここでのUser IDは、ユーザーに設定したIDです。User IDを使用しない場合は、すべてのUsersが持つIntercom IDを使用できる少し異なるURLが必要です。

https://app.intercom.com/apps/YOUR_APP-ID/users/show?id=INTERCOM_ID


IntercomのユーザーIDは、Intercomでプロフィールページを表示したときのURLで確認できます。

メールアドレス:

https://app.intercom.com/apps/YOUR_APP_ID/users/show?email=THE_USER_EMAIL

このURLは一意のメールアドレスにのみ機能します。つまり、ユーザーリストに一度だけ存在するメールアドレスです。

地域別ワークスペース

EUまたはAU地域に地域別ワークスペースがある場合は、URLを適切に調整してください。

ホスティングされているデータ地域は、ワークスペースのURLで確認できます。

  • USのお客様はapp.intercom.comを使用してください。

  • EUのお客様はapp.eu.intercom.comを使用してください。

  • オーストラリアのお客様はapp.au.intercom.comを使用してください。

自分のシステムに表示されているのにusersが見つからないのはなぜですか?

usersがIntercomから欠落している場合、JavaScriptのブロックブラウザプラグイン/拡張機能がEasyListなどのリストを使用している可能性があります。これは、欠落しているusersの割合が少なく、まれに発生する場合に特に当てはまります。

なぜ広告ブロック拡張機能やプラグインがIntercomをブロックするのですか?

Intercomは広告提供者ではありませんが、広告ブロックプラグイン(例:uBlock、Ghostery、Adblock、NoScript、Firefoxのプライバシーブラウジングモード)は、トラッキング機能を含むJavaScriptをブロックするオプションを提供します。

Intercomは会話の詳細を通信し、Usersの行動に関する属性やイベントを送信する機能も提供しているため、これらの二次的なリストに含まれています。多くのリストがありますが、Intercomのブロックの大部分はEasyListリストに含まれていることが原因です。

EasyListとは何ですか?

EasyListは、ウェブバグ、トラッキングスクリプト、情報収集ツールなど、あらゆる形態のトラッキングを完全に除去するオプションの補足サブスクリプションであり、あなたの個人データを保護します。

Intercomでは、顧客のプライバシーを尊重しているため、ここに含まれることに反論はしませんが、Usersにこのようなプラグインを無効にするよう依頼したり、サイトの例外を追加してパフォーマンスを向上させることは可能です。

これらのusersのデータをIntercomとシステムで同期させるにはどうすればよいですか?

  1. UsersにJavaScriptブロッカーを無効にするよう依頼できます。JavaScript blocker detectionAdblock detectionで検索すると、多くのリソースが見つかります。

  2. バックエンドをIntercom APIと同期できます。アプリケーションに適したAPIラッパーがいくつかあり、RubyNodePHPJavaGoがあります。

Intercomで他の理由でユーザーの詳細が欠けていると思われる場合は、統合の問題を調査するためにお気軽にお問い合わせください。

リードやuserにプロフィール写真やアバター画像を追加できますか?

REST APIを使用してIntercomで連絡先のアバター画像を設定するには、以下の手順に従ってください。

1. Search for Contactsエンドポイントに呼び出しを行い、連絡先のIntercom IDを取得します。

2. Intercom IDを使用してUpdate Contactエンドポイントに呼び出しを行い、連絡先の画像のURLでavatar objectを埋めます。

Messengerのインストールでavatar objectを埋めることもできます

ワークスペースのチームメンバーにカスタム属性を追加できますか?

いいえ。チームメンバーのプロフィールには「location」や「name」などの属性がありますが、エンドユーザーのように新しいカスタム属性を作成することはできません。詳細はこちら


連絡先データの理解

IntercomはHIPAAに準拠していますか?

HIPAAとは何ですか?

Health Insurance Portability and Accountability Act (HIPAA)は、保護された健康情報(PHI)および電子保護健康情報(ePHI)を保護するための業界全体の基準です。

顧客は自分の健康データが安全に扱われ、デジタルプライバシーが尊重されていることを信頼できなければなりません。HIPAAはその指針と一貫性のための基準の一つです。

Intercomは準拠していますか?

IntercomはHIPAAの認証審査を無事に完了しており、HIPAA基準に準拠した方法でデータを保存・処理することで、お客様のePHI義務の履行を支援しています。

ビジネスがHIPAA準拠を求められる場合、Intercomはお客様の組織とビジネスアソシエイト契約(BAA)を締結できます。これはIntercomのExpertプランの契約が必要で、BAAを含むHIPAA準拠機能はこのプランのみで利用可能です。署名済みのBAAなしでのePHIのIntercom経由の送信は、Intercomの利用規約で厳しく禁止されています。

HIPAAセキュリティルールとHITECH違反通知ルールをカバーするHIPAA認証レポートを用意しており、共有可能です。機密情報のため、まだIntercomユーザーでない場合は、受け取る前にNDA(秘密保持契約)に署名する必要があります。

次は何ですか?

現在のIntercom管理者はIntercomワークスペースにログインして、セキュリティ設定からレポートやその他のセキュリティ・コンプライアンス文書をダウンロード・閲覧できます。

このレポートはリクエストに応じて、Intercomワークスペースにアクセスできない方にもNDAのもとで提供されます。Messengerまたはsecurity@intercom.comまでご連絡ください。

IntercomとBAA(ビジネスアソシエイト契約)を締結するには、Messengerのサポートチームに連絡するか、team@intercom.ioにメールしてください。IntercomのStartupまたはEarly Stageプログラムの一員の場合、Expertプランにアップグレードすると特別プログラムの特典は終了し、再開はできません。

ウェブセッションはどのように定義されますか?

以下のいずれかが発生したときにユーザーのセッション数を増やします。

1. ユーザーが30分以上Intercomにpingを送信しておらず、その後戻ってきた場合。

2. ユーザーが24時間以上アクティブ(30分以内にIntercomにpingを送信)であった場合。

3. ユーザーの役割が変わった場合(例:visitorがleadになった、またはleadがuserになった)。

4. ユーザーの最初のpingの場合。

訪問数(visitorとleadの場合)はウェブセッションと同様に増加します。

モバイルセッションはどのように定義されますか?

iOS SDKを使用している場合、ユーザーが登録された最初の時点と、その後ユーザーがアプリを開いてトリガーされるUIApplicationDidBecomeActiveNotificationごとにiOSセッション数を増やします。ただし、20秒以内のアプリ起動はカウントされません。

同様のルールを持つAndroid SDKはこちらで利用可能です。

モバイルウェブセッション(SafariやChromeのモバイル版)はモバイルセッションではなくウェブセッションとしてカウントされます。

会社のセッションはどのように定義されますか?

ユーザーがその会社のコンテキストで新しいセッションを開始するたびに、会社のセッション数を増やします。例えば、ユーザーが1日後にユーザーデータのみでログインすると、ユーザーセッションが更新されます。

その後30分以内にユーザーと会社のデータで再度pingすると、ユーザーセッションは増えず、会社のセッションも増えません。

したがって、あるユーザーが会社に所属している間に300セッションを持ち、その後その会社を離れても、その300セッションは会社の総セッション数に含まれ続けます。

重要:

  • ユーザーが複数の会社に関連付けられている場合、company_idがない限り、どの会社のセッションを更新すべきか分かりません。したがって、会社のセッションを更新するには、ユーザーの更新にcompanyオブジェクトが含まれている必要があります。

  • 会社のウェブセッションを増やすには、ユーザーのpingに会社データを送信する必要があります。

  • 「company last seen」の値は、ユーザーのpingリクエストがある場合にのみ更新されます。ユーザーがユーザーデータのみでログインした場合は、ユーザーの「last seen」のみが更新され、「company last seen」は更新されません。

IntercomはUsersの名前(名と姓)をどのように追跡しますか?

Intercomはname属性を自動的に名と姓に分割します。例えば:

  • nameが「Joe Bloggs」の場合、Intercomは名:「Joe」、姓:「Bloggs」として追跡します。

  • 名前が「MÁRCIA HELENA MAIA DE LIMA」の場合、Intercomは名を「MÁRCIA」、姓を「HELENA MAIA DE LIMA」として追跡します。

  • 名前が「Dr. Drew Bloggs」の場合、Intercomは名を「Drew」、姓を「Bloggs」として追跡します。

  • 名前が「Joe Bloggs, CBA」の場合、Intercomは名を「Joe」、姓を「Bloggs」として追跡します。「CBA」はJoeのフルネームに表示され続けます。

  • 名前が「Bloggs, Joe」の場合、Intercomは名を「Joe」、姓を「Bloggs」として追跡します。

  • 名前が「Dr Bloggs」の場合、Intercomは名を「存在しない」、姓を「Bloggs」として追跡します。

  • ミドルネームを設定するには、「姓, 名 ミドルネーム」の形式を使用します。名前が「Bloggs, Joe Drew」の場合、Intercomは名を「Joe Drew」、姓を「Bloggs」として追跡します。

ユーザーが名前を提供していない場合、メールアドレスまたはuser_idを使って識別します。これらも空白の場合、「Color Object from Location」の形式で一意の仮名を生成します(例:「Pink Stereo from Atlanta」)。

Intercomはユーザーが現在オンラインかどうかをどのように追跡しますか?

Intercomはリアルタイムプレゼンスを使って、ユーザーがアプリ内で現在オンラインかどうかを記録します。リアルタイムプレゼンスはMessenger経由の定期的なハートビートリクエストに基づいて動作します。

ユーザーは30秒ごとにハートビートを送信し、2分間ハートビートがない場合はオフラインとマークされます。最低レベルでも、ユーザーがブラウザを閉じた直後に接続喪失を即座に検出するわけではなく、タイムアウト後のハートビート不在で接続切断を判断します。ページ間移動中のユーザーは接続切断を即座に検出できると頻繁にオンオフを繰り返すため、これを緩和しています。

ユーザーリストはリアルタイムでどのように更新されますか?

リアルタイムのユーザープレゼンスは、ユーザーまたはleadのプロフィール写真の横に表示される緑の点を更新します。

ユーザーリストが自動更新されると、新しい人は追加されず、既存のユーザーのオンライン状態(緑の点)が更新されるだけです。新しいusersを追加したり他の値を更新するには手動で更新が必要です。

将来の日付のフィルターはどう作成しますか?

将来の日付のフィルターを作成する場合、負の数を使う必要があります。

例えば、サブスクリプション終了の3日前に自動メッセージを送信したい場合、「subscription_ends_at」というカスタム属性を作成し、「-3日より前」と「0日より後未満」でフィルターします。これにより、3日後にサブスクリプションが終了するusersが一致します。

重要:

  • これを機能させるには、カスタム属性をUnixタイムスタンプとしてIntercomに送信し、タイプを「Date」に設定する必要があります。

  • 「_at」で終わるカスタム属性は自動的に日付として扱われます。ただし、異なる名前の場合は、アプリ設定の「People Attributes」でタイプを手動で「Date」に変更できます。

  • 「exactly x days ago」フィルターを使う場合、24時間の期間内に一致するusersを見つけます。例えば、「signed_up_at exactly -3 days ago」は、2〜3日前のsigned_up_at日付のusersを見つけます(3〜4日前ではありません)。

IntercomでiPadデバイスのusersをフィルターできますか?

いいえ、Intercom内でiPadデバイスのusersを特定してフィルターすることはできません。これはAppleがデスクトップ(Macデバイス)とiPadデバイスで同じOS識別子を使用しているため、Intercomは両者を区別できないためです。この制限はContacts、Messages、Workflows、Reportsなどすべてのフィルターに共通しています。

私のworkspaceで利用可能なデフォルトのカスタム属性は何ですか?

デフォルトのカスタム属性のリストは以下の通りです:

  • 名前

  • アカウント

  • アカウント名

  • 所有者

  • 所有者名

  • Leadカテゴリ

  • 会話評価

  • メール

  • メールdomain

  • 電話

  • User ID

  • 初回確認日

  • 登録日

  • 最終確認日

  • 最終連絡日

  • 最終応答日

  • 最終開封メール

  • 最終クリックメール内リンク

  • ウェブセッション

  • 地域

  • 市区町村

  • タイムゾーン

  • 大陸コード

  • 国コード

  • ブラウザ言語

  • 言語の上書き

  • ブラウザ

  • ブラウザセッション

  • OS(オペレーティングシステム)

  • Personタグ

  • メールの配信停止

  • メールをスパムとしてマーク

  • ハードバウンスが発生

  • UTMキャンペーン

  • UTMコンテンツ

  • UTMメディアム

  • UTMソース

  • UTM用語

  • リファラURL

  • サブスクリプションタイプのオプトイン

  • 最後に受け取ったアンケート

  • Whatsapp番号

  • 企業

  • 電話番号の国


トラブルシューティング

「user already exists」エラーメッセージを受け取った場合はどうすればよいですか?

既存の連絡先が同じメールアドレスまたはUser ID/external_idを持っているために「user already exists」エラーメッセージが表示された場合、エラーメッセージに返されたIntercom IDを使用して既存の連絡先を特定し、Get a contact APIエンドポイントにGETリクエストを送信して既存のユーザープロファイルを取得できます。

例えば、エラーメッセージに"message': 'A contact matching those details already exists with id=65a92b7ee1a4176d9ab8b357"が含まれている場合、Get a contactリクエストをhttps://api.intercom.io/contacts/65a92b7ee1a4176d9ab8b357に送信できます。

なぜMessengerを通じて来るusersに名前がなく、フィルターに一致しなくなったと言われるのですか?

この動作は、モバイルで未識別のusersを起動したときに発生します。モバイルでMessengerを起動する際にメールアドレスやuser IDが渡されていないため、保存されたユーザーデータのない未識別のusersとなっています。これを修正するには、usersがアプリにサインインするときにemail/user_idが渡されているかSDKのインストールを確認してください。モバイルでusersを識別する方法については、こちらのドキュメントをご覧ください:iOSAndroid


「PersonはCompany Email Addressを持っており編集できません」
解決手順:

1. Email Forwardingの設定で「Company addresses to ignore in group conversations」リストからusersのメールアドレスを削除してください。

2. リストからメールアドレスを削除した後、usersの名前を編集できるようになります。

3. 必要な変更を行った後、必要に応じてメールアドレスをリストに戻すことができます。

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