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

会話に関するよくある質問

Intercomの会話に関するよくある質問への回答 — チャンネル、トランスクリプト、返信管理、スパム、メール設定、API。

対応者:Ivan Branimir Skoric

この記事では、Intercomの会話の仕組みを理解できます。顧客がどのチャンネルから連絡したかの特定、トランスクリプトのダウンロード、返信やメモの管理、スパムやメール設定の対応、そしてConversations APIやwebhookの活用方法について説明します。

一般的な事項

顧客がどのチャンネルから連絡しているかはどうやってわかりますか?

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

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

Inboxに表示されるメッセージでチャンネルアイコンがどこにあるかの例はこちらです。

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

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

この機能はteammate presenceと呼ばれます。別のteammateが会話やticketを見ているかどうかを確認でき、同じ会話やticketに重複して対応するのを防ぎ、teammate同士の協力を助けます。

この機能は設定 > Inbox > Assignments > 一般の「Teammates presence」セクションからオン/オフを切り替えられます。

設定 > Inbox > Assignments > 一般のTeammate presenceトグルで、機能のオン・オフを切り替えるオプションが表示されています。

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

会話のトランスクリプトをどうやってダウンロードしますか?

会話を共有したり記録を残したい場合、簡単にトランスクリプトをダウンロードできます。

Inboxから会話のトランスクリプトをダウンロードするには:

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

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

  3. 会話をエクスポートを選択します。

Inboxの会話で三点リーダーメニューが開かれ、「会話をエクスポート」オプションがハイライトされています。

会話のトランスクリプトが.txtファイルとしてダウンロードされます。

UsersやleadsもMessengerでチャット中やFinとやり取り中に会話のトランスクリプトをダウンロードできます。

Intercom Messenger内で顧客に表示されるトランスクリプトダウンロードボタン。

会話のトランスクリプトはMessengerのデスクトップ版でのみ利用可能です。

トランスクリプトには何が含まれていますか?

会話のトランスクリプトには以下が含まれます:

  • 会話内のすべての返信

  • すべての返信のタイムスタンプ

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

  • Finの返信

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

  • 顧客とteammateの名前

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

含まれていないものは?

会話のトランスクリプトファイルに含まれないものは以下の通りです:

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

  • 既読/未読のメモ

  • 内部メモ

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

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

  • 画像

  • 添付ファイル

  • GIF

  • 記事

  • アプリ

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

ワークスペースから複数の会話トランスクリプトをエクスポートすることはできませんが、Conversations APIを使ってエクスポートできます。

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

ユーザーがダウンロードしたトランスクリプトで文字化けが発生している場合。古いマシン(古いバージョンのMac、Windows、Linux)を使っているユーザーは、新しい絵文字などのUnicode文字が含まれるトランスクリプトをダウンロードすると、ブラウザで見えるものとは異なり、ランダムな文字や数字として表示されることがあります。これはユーザー側の問題であり、こちらで修正できません。影響を受けたユーザーはOSを更新するか(または文字セットを更新するか)、別のマシンでトランスクリプトを閲覧する必要があります。送信先の他の人は同じ問題は起きず、正しい文字が表示されます(同じ古いOS/マシンを使っていない限り)。

会話の一部が文字起こしに含まれていません。会話の一部が文字起こしに含まれていない場合、それは文字起こしの表示コメント制限(現在は200行)を超えているためです。会話が200行を超えると、文字起こしには会話の最初の行が含まれ、その後は200行のコメント制限内に収まるまで会話がスキップされます。

会話内の特定の返信にリンクを設定できますか?

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

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

  2. 選択した会話部分へのリンクをコピーをクリックします。

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

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

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

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

その後、ワークフローを使って、顧客がMessengerで会話を開始したときに、そのカスタム属性を参照するメモを会話に追加できます。

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

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

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

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

メモ本文にCurrent Companyカスタムperson属性を含めるように設定されたワークフローのメモ追加アクション

このワークフローが有効になると、顧客がMessengerで会話を開始したときにログインしている会社名を含むメモが追加されます。

ユーザーがどこから連絡したかを知るには?

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

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

受信メール会話のデータやレポートはどこで見られますか?

Conversations reportを使用し、+ フィルターを追加をクリックしてメッセージのチャネル(email)を選択すると、受信メールのデータとレポートを確認できます。


会話の管理

Inboxからleadsをusersに統合できますか?

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

Inboxの会話詳細パネルで、確認用に一致属性がリストされた検出された重複連絡先を表示

会話がleadとのもので、検出された重複がuserの場合、Merge Lead into Userをクリックできます。これにより、Inboxの会話が新しく統合されたuserの詳細で更新され、過去の会話などを確認できます。

leadとuserのレコードを統合するために使用される会話詳細パネルのMerge Lead into Userボタン

会話を統合できますか?

はい、会話を統合できます。仕組みはこちらをご覧ください。

2つの会話を統合したときに作成される要約メモを削除できますか?

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

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

送信取り消し遅延機能を使って返信を取り消すか、送信後に削除できます。

undo send delayの権限が有効な場合、メッセージ送信後にポップアップが表示されます。タイマーが切れる前にUndoをクリックするとメッセージをキャンセルできます。遅延時間は5秒、10秒、20秒、30秒から選択可能です。この機能はダイレクトメッセージ、チャネル、スレッドで動作します。

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

注意:削除されたメッセージにCSVやドキュメントなどのファイルリンクが含まれていた場合、メッセージ削除時に即座にアクセスが無効になります。リンクをクリックすると「見つかりません」ページが表示されます。これはメッセージがすでに顧客のメール受信箱に配信されていても適用されます。メール自体は受信箱に残る可能性がありますが、ファイルリンクは既に無効化されており、アクセスをブロックするための追加の操作は不要です。

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

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

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

次にメッセージを削除を選択します。

メッセージアクションのドロップダウンでメッセージを削除オプションが表示されている状態

選択内容の確認を求められます。誤ってメッセージを削除しないようにするためです。

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

ユーザーはそのメッセージをもう見ることができません。Messengerでの表示は以下のようになります。

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

Inboxで削除されたメッセージがあなたにどのように表示されるかは以下の通りです。

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

なぜcomposerにundo send delayオプションが表示されないのですか?

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

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

メモを削除できますか?

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

削除されたメモはInboxで次のように表示されます:

Inboxの会話ビューで削除されたメモの表示例 — 元のメモの代わりにプレースホルダーが表示されます

会話の返信を削除するには、チームメイトにCan delete replies from a conversation permissionが必要です。メモを削除するには、Can delete notes from a conversation permissionが必要です。これらは設定 > Teammatesで個別に設定できます。

メモを編集できますか?

はい、Inboxの会話やticketに投稿したメモは編集できます。削除して書き直す必要はありません — そのままインラインで変更して保存してください。この機能はウェブ版のみ利用可能です。

メモの編集方法:

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

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

メモにリアクションできますか?

はい、チームメイトは会話スレッドの管理者メモに絵文字リアクションを追加できます。リアクションは、返信でスレッドを乱さずに、承認や同意などの軽い合図を直接メモに伝える手段です。

メモに絵文字リアクションを追加するには?

Intercom Inboxで、任意のチームメイトメモにカーソルを合わせ、アクションバーのスマイリーフェイスアイコン(ブックマークやコピーの隣)をクリックします。ピッカーから絵文字を選択すると、メモの下にリアクションとして追加されます。

メモの絵文字リアクションをどうやって見るの?

Inboxのメモの下には、各ユニークな絵文字リアクションが小さなバッジで表示され、絵文字と使用したチームメイトの数が示されます。バッジにカーソルを合わせると、誰がリアクションしたかが表示されます。あなたがリアクションした場合は「You reacted」と表示され、他のリアクターの名前も表示されます。自分のリアクションは視覚的に強調され、どの絵文字を追加したかがすぐにわかります。

絵文字リアクションを切り替えたり削除したりするには?

Intercom Inboxで、既存のリアクションバッジをクリックすると、自分のリアクションをオン・オフ切り替えできます — ピッカーを再度開く必要はありません。自分のリアクションのみ削除可能で、他のチームメイトのリアクションは削除できません。

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

絵文字リアクションはレポートの会話参加にはカウントされません。メモへのリアクションはチームメイトの貢献指標から除外されるため、リアクションしたチームメイトの参加会話としては表示されません。

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

はい、会話のサイドバーの「User notes」下にあるメモは、下のスクリーンショットのようにゴミ箱アイコンをクリックして削除できます。

会話の右サイドバーのUser notesセクションにあるユーザーメモの横に表示されたゴミ箱(削除)アイコン

Messengerのユーザーメモは改行されますか?

はい。Messengerのユーザーメモはテキストがパネル幅を超えると自動的に改行されます — 手動で改行を入れる必要はありません。

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

お客様が会話にCCで人を追加すると、会社のサポートアドレス(例:support@exampleapp.io)がリードとして会話に含まれることがあります。これを防ぐには、これらのアドレスを「company addresses」としてマークし、無視するように設定する必要があります。

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

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

ヒント: IntercomはInboxに転送したメールアドレスを自動検出して、このリストの無視アドレスに追加しようとします。追加されると、アドレスの横に「Automatically detected」と表示されます。

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

サポートアドレスとチームメイトのメールアドレスの両方に送信された受信メールの例。無視アドレスが自動会話割り当てに与える影響を示す。

これをチームメイトに割り当てるには、これらのチームメイトのメールアドレスを対象としたWorkflowで分岐設定を行う必要があります。

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

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

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

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

これは、顧客とチャット中に、特定の問題(例えば価格設定)について同僚の意見を求める必要がある場合に便利です。

作成画面のReply の隣をクリックし、名前やメールアドレスを入力して現在の連絡先に別の連絡先を参加者として追加します。

Inboxの作成画面で、名前やメールアドレスを入力して既存の会話に別の顧客を参加者として追加するオプションを表示

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

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

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

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

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

    Inboxのメール作成画面のToフィールドに複数のユーザーが追加され、Inboxからグループメール会話を送信準備している状態

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

注意事項:

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

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

一定期間後に会話を自動的にクローズすることは可能ですか?

はい、特定の条件に一致する会話をクローズする自動化Workflowを作成できる機能をリリースしました。Workflowをご参照ください。

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

ワークスペースから連絡先が削除されると、その連絡先に関連付けられたすべての会話がinboxから削除されます。

会話に関連付けられたユーザーをアーカイブまたは削除した場合にのみ、Inbox内の会話を削除できます。

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

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

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

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

Intercomの設定 > データ > データ削除ページで、ユーザーIDまたはメールアドレスを入力して完全削除するための入力フィールドを表示しています。

注意:一括REST APIメソッド(上記のオプション3)は、ユーザーとその関連データすべてを削除します。単一の会話のみを削除する場合は、REST APIのこちらをご利用ください。

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

原因は複数考えられますが、一般的な理由は以下の通りです。

  • アーカイブまたは削除されたユーザー:leadやユーザーがアーカイブまたは削除されると、そのユーザープロファイルに関連付けられた会話もアーカイブまたは削除されます。
    最近アーカイブされたユーザーに関連する会話が見えない場合は、CSVインポートで手動でユーザーを追加するか、Intercom REST APIでユーザーのアーカイブ解除を行ってください。ユーザーが再度連絡してきた場合もプロファイルが復元されます。leadに関連する会話が見えない場合は、CSVインポートは使えず、Intercom REST APIを使うか、leadからの連絡を待つ必要があります。復元されると、lead/ユーザーのIntercomプロファイルとすべてのデータおよび会話の詳細が復元されます。
    lead/ユーザーが完全に削除された場合、Intercom UIやREST APIで復元はできません。誤って削除した場合は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を設定し、「Message Content」にスパムとみなすキーワードを識別する条件分岐を追加します。識別後、Workflowはメッセージをスパムとしてタグ付けし、会話をクローズします。

    メッセージ内容にスパムキーワードをチェックする条件分岐を持つ「Customer sends their first message」Workflowで、該当する会話をタグ付けしてクローズします。

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

正当なメールがスパムフィルターにかかる場合は、inboxのSpamフォルダを確認し、正当なメッセージを「Not Spam」とマークしてください。スパムフィルターは隠しリンク、マルウェア、フィッシング、送信者認証をチェックしますが、誤検知することがあります。

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

  • 会話は即座にクローズされます。スパムとしてマークされるとすぐにクローズ状態になります。チームやチームメイトに割り当てられていた場合でも、そのinboxのクローズ済みセクションで見つけることができます。

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

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

チケットが更新または解決されたときに顧客にメールを送らず、会話への返信は確実に届くようにするにはどうすればよいですか?

設定 > チャンネル > Email > Email設定の「Email notifications」セクションでメール通知を管理できます。

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

  • 顧客が返信メールを受け取るようにするには、「Conversation updates」を有効にしたままにしてください。これにより、会話をクローズする前に返信した際にメールが送信されます。

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

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

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

これを修正する方法

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

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

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

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

  • または、Gmail + Zapierの連携を使ってラベルやタグに基づきメールを転送してください。

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

GmailアカウントからIntercomにメールを転送するにはどうすればよいですか?

Gmailアカウントからメールを転送する場合、送信者の識別やメールのスレッド管理に問題があるため、Googleグループの使用は強く推奨しません。Googleグループが推奨されない理由とGoogle Workspaceルーティングの手順については、「Automatically forward emails to the 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が顧客の問い合わせを解決した後に会話をクローズする場合

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

注意:Finの操作はIntercomプラットフォーム上で管理者の操作として扱われます。つまり、Finによるクローズは、人間のチームメイトによるクローズと同様にconversation.admin.closedでキャプチャされます。

Intercom APIを使った会話評価の管理にはどのような機能と制限がありますか?

Intercom APIには、会話評価の管理に関して以下の機能と制限があります:

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

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

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

なぜ会話_rating.ratingはAPI経由で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が2つ目のCSATレコードを作成します。 Awayモードで会話が再割り当てされると、新しいチームメイト用に新しいCSATアンケートが作成されます。そのアンケートが回答されなければ、元の評価済みアンケートよりも内部IDが大きくなります。APIバージョン2.15未満では、APIはIDが最も大きい(未回答の)レコードを返すため、UIに評価が表示されていてもconversation_rating.ratingはnullになります。APIバージョン2.15以降にアップグレードすると、最も最近完了した評価を返すためこの問題は解決します。

  • 参加していない会話に対する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を使って会話の割り当て方法を識別するには?

REST APIのConversationオブジェクトには、会話がどのようにチームメイトに割り当てられたかを明示的に示す属性はありません。ただし、オブジェクトのconversation_part属性を調べることで、割り当て方法を特定するのに十分な情報が得られます。

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

  • デフォルト割り当てまたはワークフロー経由の割り当て:conversation_partのpart_type属性が“assignment”のものを探します。author.type属性が“bot”の場合、その会話はワークスペースのデフォルト割り当て方法またはワークフロー経由で割り当てられたことを意味します。以下のスクリーンショット参照。

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

  • バランス割り当てまたは「Pull Conversation」ボタンをクリックした場合:会話が管理者にバランス割り当てまたは「Pull Conversation」ボタンで割り当てられた場合、part_type属性は両方とも"message_strategy_assignment"の値を持ちます。ただし、「Pull Conversation」ボタンの場合、author.type属性は"admin"の値を持ちます。以下のスクリーンショット参照。

    会話_partオブジェクトのJSONスニペット。part_typeが'message_strategy_assignment'、author.typeが'admin'で、チームメイトがPull Conversationボタンを使用したことを示す。
  • バランス割り当ての場合、author.typeは"bot"の値を持ちます。以下のスクリーンショット参照。

    バランス割り当ての会話_partオブジェクトのJSONスニペット。author.typeが'bot'であることを示す。

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

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


セキュリティ

メッセージの赤い感嘆符は何を意味しますか?

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

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

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

しかし、これは潜在的な悪意のある行為者を警告する「エラーや問題」の通知としても機能します。例えば、メールが認証されていない場合や、Inboxに届く前に何度も転送された場合などです。

​

したがって、これは必ずしもエンドユーザーが悪意のある行為者であることを示すものではなく、リスクスコアが完全に正当なメールに対する当社の閾値を超えたことを示しています。

受信メール内のリンクが安全かどうかはどうやって判断できますか?

受信メール内のリンクはホバー時にツールチップが表示されます:

  • 信頼されたリンク(例:Intercom所有のドメイン)は白い背景で表示されます。

  • 信頼されていないリンクはオレンジ色の背景で表示されます。

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

  • 信頼されていないリンクは、ホバー時に消える画像上のオレンジのオーバーレイを引き起こします。

  • 信頼されていないリンクは、新しいタブでインタースティシャルを開き、完全なURLを表示します。

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


トラブルシューティング

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

まず、キャッシュやクッキーのクリア、シークレットウィンドウの使用、別のデバイスやネットワークの利用を試してください。問題が続く場合は、Content Security Policy(CSP)に関連している可能性があります。コピー&ペーストを試みる様子の録画と表示されるコンソールエラーを送信してください。あるいは、サポートエージェントにエンドユーザーとしてあなたのウェブサイトへのアクセス権を提供し、問題をテストしてもらうこともできます。

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

以下の点を知っておく必要があります:

  • ユーザー属性はユーザープロファイルに関連付けられており、そのユーザーが行うすべての会話間で引き継がれます。

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

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

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

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

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

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

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