連絡先データの管理
属性を使って連絡先を検索するには?
電話番号、メールアドレス、またはユーザーIDなど、任意の属性でフィルタリングしてIntercom UIで連絡先を見つけることができます。
Contacts に移動します。
+ フィルターを追加 をクリックします。
検索したい属性を選択します(例:Phone、Email、またはUser ID)。
条件を Is または Contains に設定します。
値を入力して Enter を押します。
一致する連絡先レコードがリストに表示されます。
Intercomはどのようにユーザーと訪問者のデータを収集しアクセスを許可していますか?
Intercomは、ログイン済みのusersとログアウト中のvisitorsまたはleadsで、サイトへのインストール方法に応じて異なる方法でデータを収集します。
ログイン済みusersの場合、通常はuser_idやメールアドレスをIntercomのJavaScriptスニペットに渡して識別します。これによりIntercomは既知のuserに活動や属性を関連付けられます。
ログインしていないvisitorsや識別情報(メールなど)を共有していない場合でも、Intercomはデフォルトで以下のデータを収集します。
初回および最終訪問日時
最終コンタクト日時(あなたまたはチームメンバーから)
ウェブセッション数
ブラウザの言語とバージョン
優先言語設定
訪問したURL
市と国
オペレーティングシステム
このvisitorデータは、訪問者が識別されuserに変換されるまで、intercom-idまたはintercom-session cookieに紐づけられます。
Intercomのworkspace(Contactsのlead/userプロフィールページ)またはIntercom APIを通じて、userとvisitorの両方のデータにアクセスでき、取得、更新、変換、削除が可能です。
Intercomはウェブサイトからusersを自動的に取得しません。サイトはJavaScript APIで明示的にIntercom('boot')を呼び出してusersを登録・追跡する必要があります。この呼び出しがないとusersはシステムに表示されません。
リードのqualificationデータはどのように更新されますか?
Intercomでリードのqualificationデータを更新する方法は3つあります。
複数のデータポイントが競合した場合はどうなりますか?
手動で編集されたデータが主要なデータソースです
手動で編集されたデータはpingやbot収集データで上書きされることはありません。
手動で追加したqualificationデータをクリアするには、そのデータにカーソルを合わせて再同期オプションを選択してください。これにより自動収集を再開できます。
注意:CSVインポートやREST APIでuserを更新すると手動編集データは上書きされます。
Pingデータは二次的なデータソースです
Pingデータはbot収集データで上書きされることはありません。
Botデータは三次的とみなされます
Bot収集データは、データ属性が空の場合にのみリードのプロフィールに追加されます。
qualificationデータとは何ですか?
Qualificationデータは、リードやuserのqualificationプロフィールで更新できる特別な属性のセットです。
Intercomのqualification設定で表示するデータを選択できます。‘Add data’を選択してください。
ここからデータを追加する方法は2つあります。
すでにIntercomに追加したカスタム属性から選択する。
‘create new data’をクリックして新しいカスタムqualificationデータを作成する。
好きなデータを‘Add’または‘Remove’して、リードやuserのプロフィールに表示されるqualificationデータを変更できます。
qualificationデータで顧客をどのように評価しますか?
Intercomで顧客を評価する方法はいくつかあります。
Fin Sales Agentは、インバウンドリードのqualificationと育成を自動で行う推奨方法です。
チャット中にInboxで手動でリードをqualificationすることもできます。
そして/またはworkflowsを使ってリードから連絡先情報を自動収集する設定を行い、ビジネスにとって最も重要なデータに基づいてください。
ヒント:
pingを使ってリードの資格データを更新することも可能です(custom attributesと同様に)。また、CSVインポートやREST API経由でも更新できます。
ビジネスに適した資格データの選び方に関するベストプラクティスをご覧ください。
ユーザーまたはリードのメールアドレスはどうやって編集しますか?
ユーザー/リードのメールアドレスの更新は、Intercomで連絡先を識別する方法によって異なります。
一意の識別子としてUser IDsを使用している場合、連絡先のユーザー/リードのプロフィールを開き、「Qualification」セクションでメールアドレスを編集することで変更できます。
User IDsを使用していない場合、メールアドレスが一意の識別子として機能し、変更できません。この場合は既存のユーザー/リードをアーカイブし、正しいメールアドレスで新しいものを作成することをお勧めします。
ユーザーとリードを完全に削除するにはどうすればよいですか?
UI経由で
ユーザー/リードに関連するすべてのデータを完全に削除して復元できないようにしたい場合は、設定の「Delete data」タブから行えます。
削除したいユーザーのユーザーIDまたはメールを入力し、ユーザーを選択します。「Permanently delete」をクリックすると、関連するすべてのデータが削除されます。設定 > Data > People > Delete Dataの順に進んでください。
REST API経由で
REST APIでユーザーを削除するには、以下が必要です:
REST APIのベアラートークンと
完全に削除したいユーザーのIntercomユーザーID
単一ユーザーを削除する場合は、Delete contact endpoint developer documentationを使用できます。このページでベアラートークンとIntercomユーザーIDをそれぞれのフィールドに入力してください。
重要:
ユーザー/リードが削除されると、Intercom UIで表示できなくなります。
誤って削除した場合は7日以内にご連絡ください。7日を過ぎるとデータは完全に破棄されます。ユーザーからのCSAT評価とコメントは削除されません。
ユーザーまたはリードが削除されると、その会話(ticketsを含む)もワークスペースから削除されます。ユーザーが復元されると、会話とticketsも復元されます。アーカイブまたは削除された連絡先の過去の会話はレポートに含まれ続けます。
エクスポートしたユーザーデータがある場合、GDPR法令に準拠するためにそれらのファイルも削除する必要があるかもしれません。
既存のプロフィールを新規作成せずに確認・更新するようにweb Messengerを調整する方法はありますか?
Intercomでユーザープロフィールの作成や更新を調整するには、一貫したユーザー識別子を渡していることを確認してください。Intercomはuser_idを主要な識別子として使用し、提供されない場合はメールアドレスを使用します。
これができないこと
Contacts APIでは、連絡先識別子フィールドはuser_idではなくexternal_idと呼ばれます。REST APIで設定するexternal_idはMessengerのJSONウェブトークン(JWT)のuser_idと同じ識別子です。両者が一致しない場合、Intercomは既存の連絡先を更新せず新しい連絡先を作成します。
新しいuser_idが渡されると、同じメールアドレスでも新しいユーザーが作成されます。既存ユーザーを更新するには、以下を守ってください:
戻ってくるユーザーには常に同じuser_idを渡してください。
web messengerをカスタムコードで使用している場合は、Intercom初期化時(JavaScript APIまたはREST API経由)にappロジックがuser_idおよび/またはメールを正しく割り当てていることを確認してください。
同じメールアドレスに異なるuser_idを使うのは避けてください。これによりマージできない重複プロフィールが発生します。
重複が発生している場合は、以下の方法があります:
手動またはAPIでクリーンアップしてください。
API実装を監査して、一貫した識別子が送信されているか確認してください。
さらなる支援が必要な場合は、現在の実装のユーザー例やコードスニペットを提供してください。
ユーザーからタグを削除するには?
これはContactsのユーザープロフィールページから行えます。プロフィールページ左側のユーザーデータメニューに「User tags」があり、タグにカーソルを合わせて[X]アイコンをクリックすると削除できます。
ユーザーノートの追加方法は?
ユーザーノートはユーザープロフィールまたはInboxの詳細セクションから追加できます。
重要: ユーザーノートを作成できるチームメンバーは誰でも削除も可能で、これを制限する方法は現在ありません。「会話からの返信とノートを削除できる」権限は、連絡先プロフィールのユーザーノート削除権限を制御しません。
削除されたユーザーと同じuser IDおよび/またはメールで新しいユーザーを作成できますか?
これは7日間の猶予期間後のみ可能です。削除されたユーザーはそのuser ID/メールでデータベースにまだ存在するためです。猶予期間中に同じuser ID/メールで新しいユーザーを急ぎ作成する場合は、以下の方法があります:
REST APIを使ってuser ID(
externnal_id)/メールを更新します。例:User ID = 123→User ID = 123_deleteその後、ユーザーを再度削除します。
その後、希望のuser ID/メールでユーザーを作成します。例:
User ID = 123.
ユーザープロフィールに直接リンクできますか?
ユーザープロフィールのリンクは、以下のURLにユーザーのUser IDまたはメールアドレスを追加するだけで作成できます。
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のユーザープロフィールページのURLでIntercom IDを確認できます。
メールアドレス:
https://app.intercom.com/apps/YOUR_APP_ID/users/show?email=THE_USER_EMAIL
このURLは一意のemailアドレスでのみ機能します。これらはユーザーリストに一度だけ存在するemailアドレスです。
地域別ワークスペース
EUまたはAU地域に地域別ワークスペースがある場合は、URLを適切に調整してください。
ホストされているデータ地域は、ワークスペースのURLで確認できます。
app.intercom.comは米国のお客様向けですapp.eu.intercom.comはEUのお客様向けですapp.au.intercom.comはオーストラリアのお客様向けです
なぜ自分のシステムに表示されているusersが見つからないのですか?
usersがEasyListや類似のリストを使用するJavaScriptブロックブラウザプラグイン/拡張機能をインストールしている可能性があります。これはIntercomで見つからないusersの割合が少なく、まれに発生する場合に特に考えられます。
なぜ広告ブロック拡張機能やプラグインがIntercomをブロックするのですか?
Intercomは広告提供者ではありませんが、広告ブロックプラグイン(例:uBlock、Ghostery、Adblock、NoScript、Firefoxのプライバシーブラウジングモード)はトラッキング機能を含むJavaScriptをブロックするオプションを提供しています。
Intercomは会話の詳細を通信し、usersの行動に関する属性やイベントを送信する機能を提供しているため、これらの二次リストに含まれています。多くのリストがありますが、Intercomのブロックの大部分はEasyListへの含有によるものです。
EasyListとは何ですか?
Intercomでは、顧客のプライバシーを尊重しているため、ここに含まれることに異議は唱えませんが、usersにこのようなプラグインを無効にするか、サイトの例外設定を追加するよう依頼することは可能です。
これらのusersのデータをIntercomと自分のシステムで同期させるには?
usersにJavaScriptブロッカーを無効にするよう依頼できます。JavaScript blocker detectionやAdblock detectionで検索すると、多くのリソースが見つかります。
バックエンドをIntercom APIと同期できます。Ruby、Node、PHP、Java、Goなど、用途に合うAPIラッパーがいくつかあります。
他の理由でIntercomにusersの詳細が欠けていると思われる場合は、統合の問題を調査するためにお気軽にお問い合わせください。
リードまたはuserにプロフィール写真やアバター画像を追加できますか?
REST APIを使ってIntercomで連絡先のアバター画像を設定できます。手順は以下の通りです。
1. Search for Contactsエンドポイントを呼び出して連絡先のIntercom IDを取得します。
2. Intercom IDを使ってUpdate Contactエンドポイントを呼び出し、連絡先画像のURLでavatarオブジェクトを設定します。
Messengerのインストールでavatarオブジェクトを設定することもできます。
ワークスペースのチームメンバーにカスタム属性を追加できますか?
いいえ。チームメンバーのプロフィールには「location」や「name」などの属性がありますが、エンドユーザーのように新しいカスタム属性を作成することはできません。詳細はこちら。
連絡先データの理解
IntercomはHIPAAに準拠していますか?
HIPAAとは?
Health Insurance Portability and Accountability Act (HIPAA)は、保護された健康情報(PHI)および電子保護健康情報(ePHI)を保護するための業界全体の基準です。
顧客は自分の健康データが安全に扱われ、デジタルプライバシーが尊重されていることを信頼できる必要があります。HIPAAはその指針と一貫性のための基準の一つです。
Intercomは準拠していますか?
IntercomはHIPAAの認証審査を成功裏に完了しており、HIPAA基準に沿った方法でデータを保存・処理することで、お客様のePHI義務の履行を支援しています。
ビジネスがHIPAA準拠を必要とする場合、Intercomとビジネスアソシエイト契約(BAA)を締結できます。これはExpertプランの契約が必要で、BAAを含むHIPAA準拠機能はこのプランのみで利用可能です。署名済みBAAなしでのePHIのIntercom経由送信は利用規約で厳禁です。
HIPAAセキュリティルールとHITECH違反通知ルールをカバーするHIPAA認証報告書を用意しており、共有可能です。機密情報のため、まだIntercomユーザーでない場合はNDA(秘密保持契約)への署名が必要です。
次は?
現在のIntercom管理者はIntercomワークスペースにログインして、セキュリティ設定からHIPAA認証報告書やその他のセキュリティ・コンプライアンス文書をダウンロード・閲覧できます。
この報告書はリクエストに応じて、Intercomワークスペースにアクセスできない方にもNDAのもとで提供可能です。Messengerまたはsecurity@intercom.comまでご連絡ください。
IntercomとBAAを締結するには、Messengerのサポートチームに連絡するか、team@intercom.ioにメールしてください。IntercomのStartupまたはEarly Stageプログラムの参加者はExpertプランにアップグレードすると特別プログラムの特典が終了し、再開はできません。
BAAはどの製品を対象としていますか?
BAAは以下のIntercom AI製品を対象としています:
Fin AI Agent
Copilot
InboxのAI機能
電話サービスのAI機能(トランスクリプトおよびFin Voiceを含む)
Pro
Fin for Sales、Fin for Ecommerce
ウェブセッションはどのように定義されますか?
以下のいずれかが発生したときにユーザーのセッション数を増やします:
1. ユーザーが30分以上Intercomにpingを送信せず、その後戻ってきた場合。
2. ユーザーが24時間以上アクティブ(30分以内にIntercomにpingを送信)であった場合。
3. ユーザーの役割が変わる(例:visitorがleadになったり、leadがuserになる)。
4. それはユーザーにとって最初のpingです。
訪問数(visitorおよびleads)はwebセッションと同じ方法で増加します。
モバイルセッションはどのように定義されますか?
当社のiOS SDKを使用している場合、ユーザーが登録された最初の時点と、その後ユーザーがアプリを開いてトリガーされるUIApplicationDidBecomeActiveNotificationごとに、20秒以上間隔が空いていればiOSセッション数を増加させます。20秒以内のアプリ起動はカウントされません。
当社のAndroid SDKはこちらで利用可能で、同様のルールがあります。
モバイルウェブセッション(つまり、モバイルのSafariやChrome)はモバイルセッションではなくwebセッションとして記録されます。
会社のセッションはどのように定義されますか?
ユーザーがその会社のコンテキストで新しいセッションを開始するたびに、会社のセッション数を増加させます。例えば、ユーザーが1日後にユーザーデータのみでログインすると、ユーザーセッションが更新されます。
その後30分以内にユーザーと会社のデータで再度pingすると、ユーザーセッションは増加せず、会社のセッションも増加しません。
したがって、あるユーザーが会社に所属している間に300セッションあったとして、そのユーザーが会社を離れても、その300セッションは会社の総セッション数の一部としてカウントされ続けます。
重要:
ユーザーが複数の会社に関連付けられている場合、company_idがない限りどの会社のセッションを更新すべきか分かりません。したがって、会社のセッションを更新するには、ユーザーの更新に会社オブジェクトが含まれている必要があります。
会社のwebセッションを増やすには、会社データをユーザーのpingの一部として送信する必要があります。
「company last seen」の値は、ユーザーと共にpingリクエストがある場合にのみ更新されます。ユーザーがユーザーデータのみでログインした場合は、ユーザーの「last seen」のみが更新され、「company last seen」は更新されません。
Intercomはユーザーの名前(名と姓)をどのように追跡しますか?
Intercomは名前属性を自動的に名と姓に分割します。例えば:
名前が「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のIntercom上のフルネームに表示され続けます。
名前が「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のプロフィール写真の横に表示される緑の点を更新します。
ユーザーリストが自動更新されると、新しい人は追加されず、既存のユーザーのオンライン状態(緑の点)が更新されるだけです。新しいユーザーを追加したり他の値を更新するには手動で更新する必要があります。
将来の日付のフィルターはどう作成しますか?
将来の日付のフィルターを作成するには、負の数を使用する必要があります。
例えば、顧客のサブスクリプション終了3日前に自動メッセージを送信したい場合、「subscription_ends_at」というカスタム属性を作成し、「-3日より前」と「0日より後」のフィルターを設定します。これにより、3日後にサブスクリプションが終了するユーザーが一致します。
重要:
これを機能させるには、カスタム属性をUnixタイムスタンプとしてIntercomに送信し、タイプを「Date」に設定する必要があります。
「_at」で終わるカスタム属性は自動的に日付として扱われます。ただし、異なる名前の場合は、アプリ設定の「People Attributes」でタイプを手動で「Date」に変更できます。
「exactly x days ago」フィルターを使用すると、24時間の期間内にこのフィルターに一致するユーザーを見つけます。例えば、「signed_up_at exactly -3 days ago」は、2〜3日前にsigned_up_atの日付があるユーザーを見つけます(3〜4日前ではありません)。
IntercomでiPadデバイスのユーザーをフィルターできますか?
いいえ、Intercom内でiPadデバイスのユーザーを特定してフィルターすることはできません。これはAppleがデスクトップ(Macデバイス)とiPadデバイスで同じOS識別子を使用しているため、Intercomが両者を区別できないためです。この制限はContacts、Messages、Workflows、Reportsなどすべてのフィルターに共通しています。
私のワークスペースで利用可能なデフォルトのカスタム属性は何ですか?
デフォルトのカスタム属性のリストは以下の通りです:
名前
アカウント
アカウント名
所有者
所有者名
Leadカテゴリ
会話評価
メールアドレス
メールドメイン
電話番号
ユーザーID
初回確認日
登録日
最終確認日
最終連絡日
最終応答日
最後にメールを開封した日
最後にメール内のリンクをクリックした日
ウェブセッション
国
地域
市区町村
タイムゾーン
大陸コード
国コード
ブラウザ言語
言語オーバーライド
ブラウザ
ブラウザセッション
OS(オペレーティングシステム)
人物タグ
メールの配信停止をした
メールをスパムとしてマークした
ハードバウンスがある
UTMキャンペーン
UTMコンテンツ
UTMメディア
UTMソース
UTM用語
リファラーURL
サブスクリプションタイプのオプトイン
最後に受け取ったアンケート
Whatsapp番号
企業
電話番号の国
注意: 「ハードバウンスがある」は読み取り専用属性です。REST API(例:GetまたはList Contactレスポンス)で読み取れますが、API更新リクエストで設定や変更はできません。Update Contactリクエストボディにsending has_hard_bouncedを含めても、200レスポンスが返っても値は変わりません。
メールアドレスが有効であることを確認できる場合(検証サービスの利用やIntercom外での最近のメール受信など)、サポートチームに連絡すればバウンスリストから削除可能です。これは連絡先レコードのhas_hard_bounced属性とは異なります。バウンスリストからの削除は送信可能に戻しますが、API、Intercom UI、またはその後の正常配信でhas_hard_bounced属性自体をリセットする確実な方法は現在ありません。
トラブルシューティング
「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に名前なしで表示され、フィルターに合わなくなったと言われるユーザーがいるのですか?
この現象はモバイルで未識別ユーザーを起動したときに発生します。モバイルでMessengerを起動する際にメールアドレスやユーザーIDが渡されていないため、未識別ユーザーとなりユーザーデータが保存されません。これを修正するには、SDKのインストールを確認し、ユーザーがアプリにサインインするときにemail/user_idが渡されているか確認してください。モバイルでのユーザー識別については、以下のドキュメントをご覧ください:iOS と Android。
「Personは会社のメールアドレスを持っており編集できません」
解決手順:
1. Email Forwardingの設定で「グループ会話で無視する会社のメールアドレス」リストからユーザーのメールアドレスを削除します。
2. リストからメールアドレスを削除した後、ユーザー名を編集できるようになります。
3. 必要な変更を行った後、必要に応じてメールアドレスをリストに戻すことができます。










