連絡先データの管理
属性を使って連絡先を検索するには？
電話番号、メールアドレス、またはuser 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クッキーに紐づけられます。
Intercom workspace（Contactsのlead/userプロフィールページ）またはIntercom APIを通じて、userとvisitorの両方のデータにアクセスできます。APIではこのデータの取得、更新、変換、削除が可能です。
Intercomはウェブサイトからusersを自動的に取得しません。サイトはJavaScript APIで明示的にIntercom('boot')を呼び出してusersを登録・追跡する必要があります。この呼び出しがないとusersはシステムに表示されません。
リードの資格データはどのように更新されますか？
Intercomでリードの資格データを更新する方法は3つあります。あなたは：
複数のデータポイントが競合した場合はどうなりますか？
手動で編集されたデータが主要なデータソースです
手動で編集されたデータはpingやbot収集データによって上書きされることはありません。
手動で追加した資格データをクリアするには、その資格データにカーソルを合わせて再同期オプションを選択してください。これにより自動収集を再開できます。
注意：CSVインポートやREST APIでuserを更新すると、手動編集データが上書きされます。
Pingデータは二次的なデータソースです
Pingデータはbot収集データによって上書きされることはありません。
Botデータは三次的とみなされます
Bot収集データは、データ属性が空の場合にのみリードのプロフィールに追加されます。
資格データとは何ですか？
Intercomの資格設定にアクセスし、「データを追加」を選択して、リードやuserの資格プロフィールに表示するデータを選択できます。
ここからデータを追加する方法は2つあります。あなたは：
すでにIntercomに追加したカスタム属性から選択する。
「新しいデータを作成」をクリックして新しいカスタム資格データを作成する。
好きなデータを「追加」または「削除」して、リードやuserのプロフィールに表示される資格データを変更できます。
資格データで顧客をどのように評価しますか？
Intercomで顧客を評価する方法はいくつかあります：
Fin Sales Agentは、インバウンドのlead資格付けと育成を自動的に処理する推奨アプローチです。
チャット中にInboxでleadsを手動で資格付けすることもできます。
または、workflowsを使ってleadsから連絡先情報を自動収集する設定を、ビジネスに最も重要なデータに基づいて行うことができます。
ヒント:
pingを使ってリード資格データを更新することも可能です（custom attributesと同様に）。また、CSVインポートやREST API経由でも更新できます。
ビジネスに適した資格データの選び方については、ベストプラクティスをご覧ください。
ユーザーまたはleadのメールアドレスはどう編集しますか？
ユーザー/leadのメールアドレスの更新は、Intercomで連絡先を識別する方法によって異なります。
User IDsを一意の識別子として使用している場合は、Contactsに移動し、ユーザー/leadのプロフィールを開いて「Qualification」セクションでメールアドレスを編集することで変更できます。
User IDsを使用していない場合、メールアドレスが一意の識別子として機能し、変更できません。この場合は、既存のユーザー/leadをアーカイブし、正しいメールアドレスで新しいものを作成することをお勧めします。
usersとleadsを完全に削除するには？
UI経由で
ユーザー/leadに関連するすべてのデータを完全に削除して復元できないようにしたい場合は、設定の「Delete data」タブから行えます。
削除したいユーザーのユーザーIDまたはメールを入力し、ユーザーを選択します。「Permanently delete」をクリックすると、関連するすべてのデータが削除されます。設定 > Data > People > Delete Dataの順に進んでください。
REST API経由で
REST APIでユーザーを削除するには、以下が必要です：
REST APIのベアラートークンと
永久に削除したいユーザーのIntercomユーザーID
単一のユーザーを削除する場合は、Delete contact endpoint developer documentationを使用できます。このページでベアラートークンとIntercom User IDをそれぞれのフィールドに入力してください。
重要:
ユーザー/leadが削除されると、Intercom UIで表示できなくなります。
誤って削除した場合は7日以内にご連絡ください。7日を過ぎるとデータは完全に破棄されます。ユーザーからのCSAT評価とコメントは削除されません。
ユーザーまたはleadが削除されると、その会話（ticketsを含む）はワークスペースから削除されます。ユーザーが復元されると、会話とticketsも復元されます。アーカイブまたは削除された連絡先の過去の会話はレポートに含まれ続けます。
エクスポートしたユーザーデータがある場合、GDPR法に準拠するためにそれらのファイルも削除する必要があるかもしれません。
新しいプロフィールを作成するのではなく、既存のプロフィールを確認・更新するようにweb Messengerを調整する方法はありますか？
Intercomでユーザープロフィールの作成や更新を調整するには、一貫したユーザー識別子を渡していることを確認してください。Intercomはuser_idを主要な識別子として使用し、提供されない場合はメールアドレスにフォールバックします。
同じメールでも新しい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.
ユーザープロフィールに直接リンクできますか？
ユーザープロフィールのリンクは、ユーザーの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のUserプロフィールページのURLでIntercom IDを確認できます。
メールアドレス:
https://app.intercom.com/apps/YOUR_APP_ID/users/show?email=THE_USER_EMAIL
このURLは一意のメールアドレスにのみ機能します。これはユーザーリストに一度だけ存在するメールアドレスです。
地域別ワークスペース
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オブジェクトを埋めます。
ワークスペースのチームメンバーにカスタム属性を追加できますか？
いいえ。チームメンバーのプロフィールには「location」や「name」などの属性がありますが、エンドユーザーのように新しいカスタム属性を作成することはできません。
連絡先データの理解
IntercomはHIPAAに準拠していますか？
HIPAAとは何ですか？
Health Insurance Portability and Accountability Act (HIPAA)は、保護された健康情報（PHI）および電子保護健康情報（ePHI）を保護するための業界全体の基準です。
顧客は自分の健康データが安全に扱われ、デジタルプライバシーが尊重されていることを信頼できる必要があります。HIPAAはその指針と一貫性のための基準の一つです。
Intercomは準拠していますか？
IntercomはHIPAAの認証試験に合格しており、HIPAA基準に沿った方法でデータを保存・処理することで、お客様のePHI義務の履行を支援しています。
ビジネスがHIPAA準拠を求められる場合、IntercomのExpertプランに加入することで、ビジネスアソシエイト契約（BAA）を締結できます。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プランにアップグレードすると、特別プログラムの特典は終了し、再開はできません。
ウェブセッションはどのように定義されますか？
以下のいずれかが発生したときにuserのセッション数を増やします：
1. userが30分以上Intercomにpingを送信せず、その後戻ってきた場合。
2. userが24時間以上アクティブ（30分以内にIntercomにpingを送信）であった場合。
3. userの役割が変わった場合（例：visitorがleadに、またはleadがuserに変わる）。
4. userの最初のpingである場合。
訪問数（visitorとleadの場合）はウェブセッションと同様に増加します。
モバイルセッションはどのように定義されますか？
iOS SDKを使用している場合、userが登録された最初の時点と、その後ユーザーがアプリを開いてトリガーされるUIApplicationDidBecomeActiveNotificationが20秒以上間隔を空けて発生するたびにiOSセッション数を増やします。20秒以内のアプリ起動はカウントされません。
Android SDKはこちらで利用可能で、同様のルールがあります。
モバイルウェブセッション（SafariやChromeのモバイル版）はウェブセッションとしてカウントされ、モバイルセッションには含まれません。
会社のセッションはどのように定義されますか？
userがその会社のコンテキストで新しいセッションを開始すると、会社のセッション数を増やします。例えば、userが1日後にuserデータのみでログインすると、userセッションが更新されます。
その後30分以内にuserとcompanyデータで再度pingすると、userセッションは増えず、会社のセッションも増えません。
したがって、あるユーザーが会社の一員である間に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」として追跡します。
nameが「MÁRCIA HELENA MAIA DE LIMA」の場合、Intercomは名を「MÁRCIA」、姓を「HELENA MAIA DE LIMA」として追跡します。
nameが「Dr. Drew Bloggs」の場合、Intercomは名を「Drew」、姓を「Bloggs」として追跡します。
nameが「Joe Bloggs, CBA」の場合、Intercomは名を「Joe」、姓を「Bloggs」として追跡します。「CBA」はJoeのフルネームに表示され続けます。
nameが「Bloggs, Joe」の場合、Intercomは名を「Joe」、姓を「Bloggs」として追跡します。
nameが「Dr Bloggs」の場合、Intercomは名を「存在しない」として、姓を「Bloggs」として追跡します。
ミドルネームを設定するには、「姓, 名 ミドルネーム」の形式を使用します。nameが「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」は、signed_up_at日付が今から2〜3日後の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となり、保存されたユーザーデータがありません。これを修正するには、SDKのインストールを確認し、usersがアプリにサインインするときにemail/user_idが渡されていることを確認してください。モバイルでusersを識別する方法については、こちらのドキュメントをご覧ください：iOS と Android。
「Personは会社のメールアドレスを持っており、編集できません」
解決手順：
1. Email Forwardingの設定で「グループ会話で無視する会社のアドレス」リストからusersのメールアドレスを削除してください。
2. リストからメールアドレスを削除した後、usersの名前を編集できるようになります。
3. 必要な変更を行った後、必要に応じてメールアドレスをリストに戻すことができます。