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

Conversations FAQs

Intercomの会話に関するよくある質問 — チャネル、文字起こし、返信管理、スパム、メール設定、そして API。

対応者:Ivan Branimir Skoric

このページでは、顧客がどのチャネルから連絡してきたかの確認、文字起こしのダウンロード、返信やノートの管理、スパムやメール設定の対応、そしてConversations APIとwebhookの操作まで、Intercomの会話の仕組みを説明します。

一般

顧客がどのチャネルから連絡してきたかはどうやって分かりますか?

メッセージがInboxに表示されると、メッセージが送信されたチャネルを示す小さなアイコンが表示されます。ユーザープロフィールの「すべての会話」ページでも、各会話カードのタイムスタンプの上にチャネルアイコンが表示されます。

Web Messengerで送信されたメッセージにはMessengerのアイコンが表示されます。モバイルアプリで送信されたものにはAppleまたはAndroidのアイコンが表示されます。メールには封筒、SMSには電話のアイコンが表示されます。WhatsApp、Facebook、Instagramなどのソーシャルメディアから送信されたメッセージには、それぞれのプラットフォームのロゴが表示されます。

以下は、Inboxに表示されたメッセージでチャネルアイコンを見つける場所の例です:

IntercomのInbox内でメッセージの送信元を示すチャネルアイコン — Messenger、Apple(iOS)、Android、メール(封筒)、SMS(電話)、WhatsApp、Facebook、Instagramのロゴ

会話を見ている人を表示する機能をオフにできますか?

この機能は「teammate presence」と呼ばれます。会話やticketを他の同僚が見ているかどうかを確認できる機能です。これにより、同じ会話やticketに重複して対応することを避け、他の同僚と協力して作業できます。

この機能は、Settings > Inbox > Assignments > Generalの「Teammates presence」セクションでオン/オフできます。

Settings > Inbox > Assignments > General の Teammate presence トグル(オン/オフのオプションを表示)

注意:タブを切り替えた場合や会話/ticketを積極的に表示していない場合は、あなたのteammate presenceは会話/ticketに表示されません。

会話の文字起こしをどうやってダウンロードしますか?

会話を共有したり記録を残す必要がある場合、簡単に文字起こしをダウンロードできます。

Inboxから会話の文字起こしをダウンロードするには:

  1. Inboxで会話を開きます。

  2. 会話の上部にある三点(...)メニューをクリックします。

  3. Export conversationを選択します。

Inboxの会話で三点メニューが開き、Export conversationオプションがハイライトされている

会話の文字起こしは.txtファイルとしてダウンロードされます。

あなたのusersとleadsは、Messengerでチャット中やFinとやり取りしている間に会話の文字起こしをダウンロードすることもできます:

Intercom Messenger内で顧客に表示される文字起こしダウンロードボタン

会話の文字起こしはMessengerのデスクトップ版でのみ利用可能です。

文字起こしには何が含まれますか?

会話の文字起こしには以下が含まれます:

  • 会話内のすべての返信

  • 各返信のタイムスタンプ

  • 会話が作成された日付と時刻(ワークスペースのタイムゾーン)

  • Finの返信

  • チャットボットの返信(自動メッセージ)

  • 顧客とteammateの名前

  • 会話がダウンロードされた日付と時刻

含まれないものは?

文字起こしファイルに含まれないもの:

  • 会話の異なる状態(スヌーズ、スヌーズ解除、クローズ)

  • 既読/未読のノート

  • 内部ノート

  • 会話がどのように、いつ割り当てられたか

  • CC/BCC(カーボンコピー/ブラインドカーボンコピーのメールフィールド)

  • 画像

  • 添付ファイル

  • GIF

  • 記事

  • アプリ

画像、添付ファイル、GIF、記事、アプリは、ファイル内で[GIF]や[Article - article name]のようにテキストでラベル付けされます。

ワークスペースから複数の会話の文字起こしをエクスポートすることはできませんが、Conversations APIを使用してエクスポートすることができます。

問題が発生した場合に試せるトラブルシューティング手順...

ユーザーがダウンロードした文字起こしで文字化けが発生している場合。古いマシン(古いバージョンのMac、Windows、Linux)では、文字コードに含まれないユニコード文字(例:新しい絵文字)を含む文字起こしをダウンロードすると、ブラウザで見えているものと異なるランダムな文字列として表示されることがあります。これは当社側の問題ではなく、ユーザー側の問題です。影響を受けているユーザーはOSを更新する(または文字セットを更新する)か、別のマシンで文字起こしを表示する必要があります。文字起こしを送られた他の人は同じ問題に遭遇しません(同じ古いOS/マシンを使用していない限り)。

会話の一部が文字起こしに含まれていません。会話の一部が文字起こしに含まれていない場合、これは文字起こしの表示コメント上限(現在は200行)を超えているためである可能性があります。会話が200行を超えている場合、文字起こしには会話の最初の行が含まれ、その後会話は200行の表示制限内に入るまで省略されます。

会話の特定の返信へのリンクを作成できますか?

はい。Intercomの会話内の特定の返信へのリンクを共有するには:

  1. 返信にカーソルを合わせて、三点リーダーをクリックします。

  2. Copy link to selected conversation partをクリックします。

リンクがクリップボードにコピーされます。チームメイトと共有すると、その返信に直接移動します。

顧客がどの会社のために会話を開始したかを追跡するには?

顧客が1社のみに所属している場合、Intercomはその会社を自動的に会話にリンクします。ただし、顧客が複数の会社に属している場合、現時点ではMessengerで会話を開始したときにどの会社でログインしていたかを確認するデフォルトの方法はありません。

これを追跡するには、Messengerに読み込まれたときに顧客がログインしている会社をカスタムのperson属性に記録することが考えられます。Messengerのインストールを編集して、この属性の値を設定する必要があります。

その後、顧客がMessengerで会話を開始したときに、そのカスタム属性を参照するメモを会話に追加するためのworkflowを使用できます。

例えば、Current Companyというカスタムperson属性を作成できます。

IntercomのPeople設定で構成されたCurrent Companyという名前のカスタムperson属性

次に、Messengerをインストールしているチャンネル(Web、iOS、Android)で送信される「Customer sends their first message」workflowを作成し、Add a noteアクションを選択します。

最後に、メモにCurrent Company カスタムperson属性を追加します。

WorkflowのAdd a noteアクションが、メモ本文にCurrent Companyカスタムperson属性を含めるように構成されている

公開されると、このworkflowは顧客がMessengerで会話を開始したときにログインしている会社名を含むメモを追加します。

ユーザーがどこから連絡してきたかはどうやって分かりますか?

会話のソースURLは、最初のメッセージに移動してチャットアイコンにカーソルを合わせることで確認できます。以下のスクリーンショットのように表示されます。

Inboxの会話で最初のメッセージのチャットアイコンにカーソルを合わせたときに会話のソースURLを示すツールチップ

受信メール会話のデータやレポートはどこで確認できますか?

Conversations reportを使用して受信メールのデータとレポートを表示し、+ Add filterをクリックしてメッセージのChannel (email)を選択します。


会話の管理

Inboxからleadsをusersにマージできますか?

はい、Inboxの会話のDetails パネルで、各潜在的重複とその一致属性の詳細を表示できます。

検出された重複連絡先と一致する属性が一覧表示され、レビューのために表示されているInboxのConversation Detailsパネル

会話がleadで、検出された重複がuserである場合、Merge Lead into Userをクリックできます。これにより、会話はマージされたuserの詳細でInbox内で更新され、過去の会話などを確認できます。

Leadとuserのレコードを結合するために使用されるConversation DetailsパネルのMerge Lead into Userボタン

会話をマージできますか?

はい、会話をマージできます。仕組みについてはこちらをご覧ください。

2つの会話をマージしたときに作成されるサマリーノートを削除できますか?

いいえ、現在インターフェースからこれを削除するオプションはありません。緊急の場合は、Messengerでご連絡ください。

ユーザーに送信した返信を取り消し、回収、または削除できますか?

undo send delay機能を使用して返信を取り消すことができ、また送信後に削除することもできます。

undo send delayの権限が有効になっている場合、メッセージ送信後にポップアップが表示されます — タイマーが切れる前にUndoをクリックするとメッセージを取り消せます。遅延オプションは5秒、10秒、20秒、または30秒です。この機能はダイレクトメッセージ、チャンネル、スレッドで動作します。

ただし、メールで送信された返信はユーザーのメールクライアントから削除できません。ユーザーがMessengerで3分以内に返信を確認しない場合、会話を含むメール通知がユーザーに送信されます — これも削除できません。メールの取り消し機能はありません。

注意:Conversations後のメール通知を無効にすることはワークスペースレベルでのみ可能です。特定の顧客やConversationsのためにこれらのメールをオフにするオプションは現在ありません。

Inboxで返信を削除するには、メッセージの横にある三点リーダーをクリックします。

Inboxの会話スレッド内のメッセージ横に表示される三点メニューアイコン

次にDelete message.を選択します。

Delete messageオプションが表示されたメッセージアクションのドロップダウン

選択を確認するよう求められます。これにより、誤ってメッセージを削除するのを防ぎます。

重要:削除したメッセージは復元できません。

ユーザーはそのメッセージをもう表示できなくなります。Messengerでの見え方は次のとおりです:

Intercom Messengerで削除されたメッセージが顧客にどのように表示されるか — 元の内容の代わりにプレースホルダーが表示される

Inboxで削除されたメッセージがあなたにどのように表示されるかは次のとおりです:

Inboxでチームメイトに表示される削除状態のインジケーターに置き換えられたメッセージの表示

なぜ作曲ツールにundo send delayオプションが表示されないのですか?

undo send delayオプションは、Can enable undo send delayの権限がアカウントに有効になっている場合にのみInboxの作曲ツールに表示されます。表示されない場合は、ワークスペースの管理者に権限を有効にするよう依頼してください。

権限が有効になったら、希望する遅延時間(5s、10s、20s、または30s)を設定できます。このオプションはダイレクトメッセージ、チャンネル、スレッドで利用できます。

ノートを削除できますか?

はい。会話のノートを削除できます。Inboxでノートを削除するには、ノートの横にある三点リーダーをクリックして「Delete message」を選択してください。確認を求められます — この操作は元に戻せません。

削除されたノートはinboxで次のように表示されます:

削除されたノートがInboxの会話ビューに表示される様子 — 元のノートの代わりにプレースホルダーが表示されます

会話から返信を削除するには、チームメンバーにCan delete replies from a conversationpermissionが必要です。ノートを削除するには、チームメンバーにCan delete notes from a conversationの権限が必要です。これらは設定 > Teammatesで個別に構成できます。

ノートを編集できますか?

はい、inboxの会話および tickets に投稿したノートは編集できます。削除して書き直す必要はありません — そのままインラインで変更して保存してください。この機能はウェブでのみ利用可能です。

ノートの編集方法:

編集されたノートには「Edited」ラベルが表示されます。このラベルにカーソルを合わせると、ノートが最後に更新されたタイムスタンプが表示されます。ノートの編集はメインの会話ストリームとサイドパネルの両方で機能します。

注意:ノートを編集できるのは元の作成者のみであり、管理者が別のチームメンバーのノートを上書きして編集することはできません。Bot、workflow、およびFinが生成したノートは編集できません。バックオフィスの ticket からクロスポストされたノートを編集しても、元のバックオフィスノートは編集されず、その逆も同様です。編集はCan edit notesのチームメンバー権限で制御されます。

ノートにリアクションできますか?

はい、チームメンバーは会話スレッド内の管理者ノートに絵文字リアクションを付けることができます。リアクションは、スレッドを冗長な返信で埋めずに、承認や同意などの軽い合図をノート上で直接伝える手段です。

ノートに絵文字リアクションを追加するには?

Intercom Inboxで任意のチームメンバーノートにカーソルを合わせ、アクションバーの笑顔アイコン(ブックマークやコピーと並んでいます)をクリックします。ピッカーから絵文字を選んで、ノートの下にリアクションとして追加します。

ノートの絵文字リアクションはどのように表示されますか?

各ユニークな絵文字リアクションはInboxのノート下に小さなバッジとして表示され、絵文字とリアクションを使ったチームメンバーの数が表示されます。バッジにカーソルを合わせると誰がリアクションしたかがわかります — あなたがリアクションしている場合は「You reacted」と、他のリアクターの名前が表示されます。自身のリアクションは視覚的にハイライトされ、どの絵文字を追加したかがわかりやすくなっています。

絵文字リアクションの切り替えや削除はどうしますか?

Intercom Inboxで既存のリアクションバッジをクリックすると、自分のリアクションをオン/オフに切り替えられます — ピッカーを再度開く必要はありません。自分以外のメンバーが追加したリアクションを削除することはできません。

絵文字リアクションはレポートの指標にカウントされますか?

絵文字リアクションはレポートでの会話参加としてはカウントされません。ノートへのリアクションはチームメンバーの帰属指標から除外されるため、リアクションを行ったチームメンバーの参加済み会話として表示されません。

会話の右側サイドバーにあるUsersノートを削除できますか?

はい、「User notes」セクションのサイドバーにあるノートは、下のゴミ箱アイコンをクリックすると削除できます。下のスクリーンショット参照。

サイドバーのUser notesセクションでユーザーノート横に表示されたゴミ箱(削除)アイコン

グループ会話から会社のメールアドレスを削除するには?

顧客が会話に他の人をCCする場合、会社のサポートアドレス(例: support@exampleapp.io)がleadとして会話に含まれてしまうことがあります。これを防ぐには、これらのアドレスを「company addresses」としてマークし、無視するよう指示する必要があります。

Settings > Channels > Email > Email settingsで、"Ignored addresses"セクションに会社のアドレスをいくつでも追加できます。追加すると、グループ会話に表示されなくなります。

Settings > Channels > Email > Email settingsのIgnored addressesセクションに表示された、グループ会話から除外された会社のメールアドレス一覧

ヒント:Intercomは、あなたがInboxに転送するメールアドレスを自動的に検出してこのリストにIgnored addressesとして追加しようとします。自動で追加されると、アドレスの横に "Automatically detected" と表示されます。

誰かがあなたのサポートアドレスと同時にチームメンバーにもメールを送った場合、上記リストにそのチームメンバーのメールアドレスがあれば、自動的にそのチームメンバーに割り当てられません。

サポートアドレスとチームメンバーのメールの両方に送信された受信メールの例。Ignored addressesが自動割り当てに与える影響を示しています。

これをチームメンバーに割り当てたい場合は、これらのチームメンバーのメールアドレスを対象とするWorkflowでブランチングを設定する必要があります。

なぜIntercomでサポートアドレスに予期せぬメールが届くのですか?

あなたのアカウントが、サポートアドレス(例: support@examply.io)に送信されたメールを受け取るグループ、エイリアス、または配布リスト(Google WorkspaceやMicrosoft 365などのメールプロバイダで管理)に含まれている可能性があります。転送が設定されておらず、Intercom側で何も構成されていない場合、これは予期せぬメール配信の最も一般的な原因です。

Inboxからグループ会話を開始できますか?

はい、顧客とチャットしている際に、別の顧客を会話に参加させることができます。

これは、顧客が特定の問題について同僚の意見を求める必要がある場合(例えば料金)に便利です。

作曲ウィンドウでReply の隣をクリックし、現在の連絡先を選択して、名前やメールアドレスを入力して別の連絡先を参加者として追加します。

Inboxの作曲ウィンドウで、名前やメールアドレスを入力して既存の会話に別の顧客を参加者として追加するオプションが表示されている様子

Inboxから複数の人に同時にメールを送るには?

Inboxから複数の人とメール会話を開始することもできます:

  1. 左上から会話を開始し、Conversation.を選択します。

  2. チャネルをEmailに設定します。

  3. 複数の users をToフィールドに追加します。

    Email作曲ウィンドウのToフィールドに複数のusersが追加され、Inboxからグループメール会話を送信する準備ができている様子

  4. デフォルトでは、すべてのusersが同じ会話の参加者として追加されます。各ユーザーに対して別々の会話を作成したい場合は、Send Separatelyオプションをオンに切り替えてください。

注意:

  • 人を会話に追加すると、会社のサポートアドレス(例: support@exampleapp.io)が含まれることがよくあります。これらを無視するには、会社のアドレスとしてマークしてください。

  • Intercom Messengerは、Messenger内で異なる顧客を区別することができないため、複数の顧客が同時に会話に参加することはサポートしていません。ユーザーの区別は、各ユーザーのメールが表示されるメール会話でのみ可能です。

一定期間後に会話を自動的にクローズできますか?

はい、特定の基準に一致する会話をクローズする自動化Workflowを作成できる機能をリリースしました。

Inboxの会話を削除できますか?

会話に紐づくユーザーをアーカイブまたは削除した場合にのみ、Inboxの会話を削除できます。

ユーザーとその会話を削除するには、次のいずれかの方法を使用できます:

  1. 会話に紐づくユーザーをアーカイブまたは削除する。アーカイブはソフトデリートとして機能します — 人が戻った場合、関連する会話を含むすべてのデータが復元されます。

  2. ユーザーまたはleadのすべてのデータを完全に削除するには、設定 > データ > データを削除に移動し、個別に削除するためにそのユーザーIDまたはメールアドレスを入力します。

  3. IntercomのREST APIを使用してユーザーを一括で削除すると、関連する会話も削除されます。

IntercomのSettings > Data > Delete dataページで、ユーザーIDまたはメールアドレスを入力して永久削除するための入力フィールドが表示されている

注: 一括のREST APIメソッド(上記のオプション3)は、単一の会話ではなくユーザーとそのすべての関連データを削除します。ただし、REST APIを使用して単一の会話を削除することもできます こちら

なぜ一部の会話を表示できないのですか?

原因はいくつか考えられますが、一般的な理由は次のとおりです:

  • アーカイブ/削除されたユーザー: lead/ユーザーがアーカイブまたは削除されると、そのユーザーのプロファイルに関連付けられた会話もアーカイブまたは削除されます。
    欠落している会話が最近アーカイブされたユーザーに関連している場合、CSVインポートでユーザーを手動で追加するか、IntercomのREST APIを使用してユーザーのアーカイブを解除できます。ユーザーが再度連絡を取った場合もプロファイルは復元されます。欠落した会話がleadに関連している場合、CSVインポートは機能しません。IntercomのREST APIを使用するか、leadが連絡するのを待つ必要があります。復元されると、lead/ユーザープロファイルはすべてのデータと会話の詳細とともに復元されます。
    lead/ユーザーが永久に削除された場合、IntercomのUIやREST APIを介してlead/ユーザーとその会話を復元することはできません。誤ってlead/ユーザーを削除した場合は7日以内にご連絡ください。情報を取得できます。7日後はこのデータは完全に破壊されます。

  • チーム/担当者の割り当て: 会話が別のチームや担当者に再割り当てされると、その会話が表示されるInboxが変わります。Inboxやビューで特定の会話を探している場合、それが別の担当者に再割り当てされている可能性があります。

アーカイブされた会話はどのように表示しますか?

Intercomのinboxで会話をアーカイブまたは削除するには、会話に紐づくユーザーをアーカイブまたは削除する必要があります。ユーザーをアーカイブすることはソフトデリートとして機能し、関連する会話を含むすべてのデータがアーカイブされます。そのため、inboxで会話を再度表示するにはユーザーを復元する必要があります。アーカイブされたユーザーを復元するには、CSVインポートまたはIntercomのREST APIで再度追加するか、連絡があるのを待ってください。連絡があると自動的にプロファイルと関連するすべての会話が復元されます。

メールをスパムとしてマークするにはどうすればよいですか?

Fin AI Agentが有効になっているワークスペースでは、All inboxの会話ヘッダーから直接メール会話をスパムとしてマークできます。左ナビのFin AI Agentの下にある専用のSpamビューにはFinがフラグ付けした会話がすべて表示されます — 担当者はFinの理由を確認して、誤ってフラグ付けされたメッセージをNot spamにマークできます。

Fin AI Agentを使用していない場合は、スパムを検出して会話を自動的にクローズするWorkflowを作成できます:

  1. 「Customer sends their first message」workflowを設定し、特定のアドレスからのメールをスパムと見なすためのオーディエンスルールを追加します。特定されると、workflowはメッセージにスパムタグを付けて会話をクローズできます。

    特定の送信者メールアドレスを対象とするオーディエンスルールで構成されたCustomer sends their first message workflowが、スパム会話を識別してクローズする

  2. または、「Customer sends their first message」workflowを設定し、条件分岐を追加してメッセージコンテンツ内のスパムキーワードを識別します。識別されると、workflowはメッセージにスパムタグを付けて会話をクローズできます。

    メッセージコンテンツのスパムキーワードを確認する条件分岐を持つCustomer sends their first message workflowが、一致する会話にタグを付けてクローズする

  3. さらに、スパムを送信するユーザーをブロックすることで、そのメッセージがアーカイブされ、再度連絡できなくなります。ユーザーをブロックするには、ユーザープロファイルの右上のドロップダウンを選択し、「Block」を選びます。

正当なメールがスパムフィルターに引っかかっている場合は、inboxのSpamフォルダを確認して、正当なメッセージをNot Spamとしてマークできます。スパムフィルターは隠しリンク、マルウェア、フィッシング、送信元の認証をチェックしますが、稀に正当なメールを誤ってフラグ付けすることがあります。

会話がスパムとしてマークされると、次のことが起こります:

  • 会話は直ちにクローズされます。 スパムとしてマークされるとすぐにクローズ状態になります。チームや担当者に割り当てられていた場合でも、消えることはありません — そのInboxのクローズ済みセクションで見つけることができます。

  • 送信者はブロックされません。 会話をスパムとしてマークしても、送信者が再度メールを送るのを防ぐことはできません。そのアドレスからの将来のメールは通常どおりinboxに配信されます — ただしSpamビューには表示されません。送信者からの連絡を完全に停止したい場合は、代わりにプロファイルからユーザーをブロックする必要があります。

  • Fin AI Agentはスパム会話に再対応しません。 会話がスパムとしてマークされると、Finはその会話を再キューしたり新しい返信を送信したりしません。同じ顧客がまったく新しい会話を開始した場合、Finはそれを新規会話として扱い、通常どおり応答します — スパムフラグはマークされた特定の会話にのみ適用されます。

チケットが更新/解決されたときに顧客へのメール送信を停止しつつ、会話への返信は確実に受け取れるようにするにはどうすればよいですか?

「Settings > Channels > Email > Email settings」の「Email notifications」セクションでメール通知を管理できます:

  • チケットが更新または解決されたときに顧客がメールを受け取らないようにするには、「Ticket updates」を無効にします。これにより「あなたの問題は解決しました」などの自動ステータス更新メールが送信されなくなります。

  • 返信時に顧客がメールを確実に受け取るようにするには、「Conversation updates」を有効のままにします。これにより、会話をクローズする前に返信した場合にメールが送信されます。

なぜウェブサイトのフォームからの会話がIntercomの間違ったInboxに割り当てられるのですか?

問題:
ウェブサイトのフォームがIntercomにメールを送信すると、reply-toが正しく設定されていても、会話がユーザーのメールではなく技術的なメールに割り当てられてしまいます。

説明:
Intercomは送信者を'From:'フィールドに基づいて判断し、'Reply-To'フィールドではありません。問い合わせフォームのような場合、送信者はフォームを提出した元のユーザーではなく転送アカウントに変更されることがあります。

修正方法

ウェブサイトのお問い合わせフォームの場合:

  • フォームデータをメールで送信する代わりに、会話を直接作成するためにIntercom’s REST APIを使用してください。これにより正しいユーザーが割り当てられます。

Gmailアカウントからのメール転送の場合:

  • Googleのルーティングオプションを使用して、メールを正しくIntercomのinboxに転送してください。

  • または、ラベルやタグに基づいてメールを転送するためにGmail + Zapier統合を使用してください。

これらのベストプラクティスに従うと、問題が解決し、会話が正しいinboxに割り当てられるようになります。

GmailアカウントからIntercomにメールを転送する方法は?

Gmailアカウントからメールを転送する場合、送信者の識別とメールのスレッド処理に問題があるため、Googleグループをメール転送に使用することは強くお勧めしません。Google Workspaceのルーティング手順と非推奨の理由の詳細については、自動的にメールをInboxに転送する方法の記事を参照してください。

Intercomのconversation.user.created、conversation.admin.single.created、conversation.deleted webhookイベントの違いは何で、いつ使用すべきですか?

webhookイベントの違いは次のとおりです:

  • conversation.user.created: 顧客が最初のメッセージを送信して会話を開始したときにトリガーされます。

  • conversation.admin.single.created: 担当者が先に顧客に連絡して新しい会話を作成したときにトリガーされます。

  • conversation.deleted: 会話が削除されたときにトリガーされます。

Intercomで会話の作成と削除のwebhookを設定するには、次のイベントを使用します:

  • 会話削除通知にはconversation.deletedを使用してください。

  • conversation.user.created(顧客発信の会話)用。

  • conversation.admin.single.created(同僚発信の会話)用。

会話がクローズされたときに通知を受け取るには、どの webhook トピックを使えばよいですか?

会話がクローズされるたびに通知を受け取りたい場合は、conversation.admin.closed トピックを購読してください — クローズを引き起こした主体に関係なく通知されます。

このトピックはすべてのクローズ状況をカバーします:

  • 同僚が Inbox から会話を手動でクローズする場合

  • Fin が顧客の問い合わせを解決した後に会話をクローズする場合

  • workflow が会話を自動的にクローズする場合

注:Fin の操作は Intercom プラットフォーム上では管理者の操作として扱われます。したがって、Fin によってトリガーされたクローズは、人間の同僚が行ったクローズと同様に conversation.admin.closed によって記録されます。

Intercom API で会話の評価(rating)を管理する際の機能と制限は何ですか?

Intercom API には会話評価の管理に関して次のような機能と制限があります:

  • 会話の評価を API 経由で直接トリガーまたは送信することはできません。

  • 会話評価を実装するには、API の代わりに workflows や簡単な自動化を設定する必要があります。

  • 既存の評価スコアを API で取得することはできます が、API 経由で評価を更新・変更することはできません。

API で conversation_rating.rating が null を返すのは、レポートに評価が表示されているのにどうしてですか?

Intercom API には別々の評価フィールドが2つあり、それぞれ異なる内容を追跡しています:

  • conversation_rating.rating人間の同僚 に対して顧客が提出した CSAT(顧客満足度)を記録します。人間の同僚が評価されていないか、アンケートが作成されたが回答されなかった場合は null になります。

  • ai_agent.rating — Fin AI Agent に対して提出された CSAT を記録します。このフィールドは、fin_participated が true の場合(つまり、Fin が「Let Fin handle」ステップで会話に実際に回答した場合)のみに設定されます。

null が発生する一般的なシナリオ:

  • Away & Reassign が二つ目の CSAT レコードを作成する。 会話が Away モードで再割り当てされると、新しい同僚向けに新しい CSAT アンケートが作成されます。そのアンケートが回答されなかった場合、元の評価済みアンケートより内部 ID が大きくなります。API バージョン 2.15 より前では、API は ID が最も大きい(未回答の)レコードを返すため、UI には評価が表示されていても conversation_rating.rating は null になります。API バージョン 2.15 以降 にアップグレードすると、直近に完了した評価を返すようになるため、これが解消されます。

  • Fin が参加していない会話の Fin CSAT。 CSAT アンケートが Fin に紐づけられている(会話がオペレーター/ボットのアクションでクローズされたため)場合でも、Fin の fin_participated フラグが false のときは、API では ai_agent.rating に評価が表示されません — たとえ Intercom のレポーティング上では表示されていても。これは現在調査中の既知の不一致です。

ヒント:外部レポートを作成する際は、conversation_rating.rating(人間の CSAT)と ai_agent.rating(Fin の CSAT)の両方を確認して全体像を把握してください。最も最近に完了した人間の評価が返されるように API バージョン 2.15 以降を使用してください。

会話に特定の会社を紐づけることはできますか?

はい、会話に会社を紐づけることができます。顧客が複数の会社に紐づいている場合、この機能は会話がどの会社に関するものかをチームが理解するのに役立ちます。会話の整理やチーム全員が適切なコンテキストを持つことを保証するのに特に有用です。

会社を会話に紐づけるにはどうすればよいですか?

会話に会社を紐づけるには、更新したい会話を開きます。右側のサイドバーで Conversation attributes セクションを探し、Company フィールドをクリックします。ユーザーに紐づくすべての会社のドロップダウンリストが表示されます。リストから正しい会社を選択するか、名前を入力して特定の会社を検索できます。会社を選択すると、その会話はその会社にリンクされます。会社が1つだけのユーザーの場合、このフィールドは自動的に事前入力されます。

新しい会話に対して会社を設定できますか?

はい。ただし、時間を節約するために、顧客が1つの会社にのみ所属している場合は、その会社が会話作成時に自動的に新しい会話に紐づけられます。

顧客が複数の会社に所属している(または所属していない)場合、自動的な紐づけは適用されません。その場合は、右側のサイドバーの Details セクションから手動で会社を設定できます。

注:自動紐づけは会話が作成されたときのみ発生します。顧客の会社が後で変更された場合、会話は自動的に更新されません。

ユーザーが会社に紐づかなくなった場合はどうなりますか?

ユーザーが会社に紐づかなくなった場合、その会社は新しい会話の割り当て用ドロップダウンには表示されません。ただし、それまでに割り当てられていた既存の会話にはリンクが残ります。

REST API を使用して会話の割り当て方法をどのように識別しますか?

Conversation オブジェクトに、会話がどのように同僚に割り当てられたかを明示的に示す特定の属性はありません。ただし、オブジェクトの conversation_part 属性を調べることで、識別に十分な情報が得られるはずです。

以下は、会話が割り当てられる可能性のある方法と、REST API を介してその割り当て方法を識別する方法の一覧です:

  • デフォルトの割り当てまたは Workflow による割り当て: part_type 属性が “assignment” の conversation_part を探します。author.type 属性の値が “bot” の場合、その会話はワークスペースのデフォルト割り当て方法または Workflow によって割り当てられたことを意味します。

    会話_part オブジェクトの JSON スニペット:part_type が 'assignment' で author.type が 'bot'、これは Workflow またはワークスペースのデフォルト割り当て方法で割り当てられたことを示します

  • Balanced Assignment または「Pull Conversation」ボタンをクリックした場合:会話が Balanced Assignment または「Pull Conversation」ボタンで管理者に割り当てられた場合、どちらの場合も part_type 属性は "message_strategy_assignment" という値になります。ただし、「Pull Conversation」ボタンの場合、author.type 属性は "admin" という値になります。

    会話_part オブジェクトの JSON スニペット:part_type が 'message_strategy_assignment' で author.type が 'admin'、これは同僚が Pull Conversation ボタンを使用したことを示します
  • Balanced Assignment の場合、author.type は 'bot' という値になります。

    Balanced Assignment 用の conversation_part オブジェクトの JSON スニペット:author.type が 'bot' を示す

API 経由で作成された会話は bot inbox 割り当ての対象になりますか?

いいえ。API 経由で作成された会話は bot inbox 割り当ての対象になりません。この制限は、API 統合を使用して会話を作成するすべての顧客に適用されます。


セキュリティ

メッセージに表示される赤い感嘆符は何を意味しますか?

赤い感嘆符エラーは通常、送信者がメール設定で Reply-To アドレスを From アドレスと異なるものに設定している場合にメッセージに表示されます。

これは送信者が返信を受け取りたいメールアドレスを指定するために使用するメールヘッダーです。この問題はエンドユーザー側の設定によるもので、Intercom 内で変更することはできません。

Intercom はメールの From フィールドを使用して送信者を識別しますが、コンタクトフォームや一部のメール転送設定では、送信者が元の送信者ではなく転送を行っているアカウントに変更されることがあります。

ただし、これは潜在的な不正行為者を警告するための「エラーと問題」に関する汎用的な通知でもあります。たとえば、メールが確認されていない、または受信までに何度も転送されている場合などです。

必ずしもエンドユーザーが悪意のある行為者であることを示すものではなく、単に適用されたリスクスコアが正当なメールに対する当社の閾値より高かったということです。

受信メール内のリンクが安全かどうかはどう判断しますか?

受信メール内のリンクはホバーでツールチップを表示します:

  • Trusted links(例:Intercom 所有ドメイン)は白背景で表示されます。

  • Untrusted links はオレンジ背景で表示されます。

受信メール内のリンク付き画像は、ホバーで消えるツールチップとオレンジのオーバーレイを表示します:

  • Untrusted links は、ホバーで消える画像上のオレンジのオーバーレイを表示します。

  • Untrusted links は、完全なURLを表示するインタースティシャルを新しいタブで開くトリガーになります。

受信メール内で、Inbox に表示される信頼されたリンクのツールチップ(白背景)と信頼されていないリンクのツールチップ(オレンジ背景)の並列比較


トラブルシューティング

顧客が Intercom チャットウィンドウにスクリーンショット/画像を貼り付けられなくなった場合、どうすればよいですか?

まず、キャッシュ/クッキーのクリア、シークレットウィンドウの利用、別のデバイス/ネットワークでの試行を試してください。問題が続く場合は、Content Security Policy(CSP)に関連している可能性があります。コピー&ペーストを試みる操作の録画と表示されるコンソールエラーを送ってください。代替案として、サポート担当者がエンドユーザーとしてサイトにアクセスして問題をテストできるように権限を提供することもできます。

なぜユーザーデータが会話をまたいで保持されるのですか?

以下を知っておいてください:

  • User 属性はユーザープロファイルに紐づいており、そのユーザーが行うすべての会話間で引き継がれます。

  • ユーザーが新しい会話を作成すると、既存のユーザー属性の詳細が自動的に再利用されます。

  • 会話ごとに特定のデータが必要な場合は、代わりにconversation attributesを使用してください。

  • 望ましくないデータの保持を防ぐため、会話間で引き継ぎたくないユーザー属性はarchiveすることを推奨します。

なぜ顧客にメッセージを送るときに余分なスペースやインデントが削除されるのですか?

Messenger 内のメッセージは、すべてのチャネルで顧客に最も一貫した体験を提供するために正規化されます。Tab を使ったインデントや Composer でメッセージ内に複数のスペースを追加しても、送信されると削除されます。

代わりに、行区切りやリストを使ってメッセージの一部を強調することを試してください。

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