アクセスと利用可能性
Finは地域ホストされたワークスペースでデータコネクタを使用できますか？
Finは地域ホストされたワークスペースでデータコネクタを使用できますか？
データコネクタは全ての米国、EU、AUのホストされたワークスペースで利用可能です。
カスタムアクションはどうなりましたか？
カスタムアクションはどうなりましたか？
アクションまたは「カスタムアクション」は単に「データコネクタ」に名称変更されました。機能や設定に変更はありません。
機能：外部システムでAPIコールをトリガーする能力。これらはFinによって直接トリガーされ、リアルタイムデータを使ったパーソナライズされた回答を生成します（例：「注文状況を取得」）。またはWorkflowsやFin Proceduresに追加され、特定条件を満たした後にトリガーされます（例：注文がまだ発送されていない場合のみ「注文キャンセル」を使用）。
ナビゲーション：設定 > 統合 > データコネクタ
データのプライバシーとセキュリティ
Finとの会話で機密データはどのように扱われますか？
Finとの会話で機密データはどのように扱われますか？
IntercomはPANマスキング機能を提供しており、会話内容をスキャンしてクレジットカード番号のように見え、ルーンチェックを通過する番号を検出します。該当番号が見つかると、番号の最後の4桁以外はマスクされ、顧客はウェブメッセンジャーおよびiOS・Android SDKでマスクされたバージョンを確認できます。番号はInboxの会話でもマスク表示されます。
追加の制御のために、Stracアプリをインストールして、Intercomのメッセージや添付ファイルから機密データを検出・マスキングできます。これにより、SSN、誕生日、運転免許証、パスポート、クレジットカード、デビットカード、APIキーなどの機密データ要素のリストを設定してマスキング可能です。
なりすましを防ぐにはどうすればよいですか？
なりすましを防ぐにはどうすればよいですか？
なりすましを防ぐために、JWTによるメッセンジャーのセキュリティ強化を強く推奨します。これにより、データは認証済みのUsersのみに公開されます。認証を有効にしないと、悪意のある者が不正操作やデータコネクタのトリガーを行う可能性があります。
LeadsやMessenger以外のチャネルからの会話には、メッセンジャー認証は適用されません。その場合は、ワンタイムパスコード（OTP）や他の安全な認証方法を使用して、ユーザーデータの公開前に検証してください。
データコネクタのテストはデータに影響しますか？
データコネクタのテストはデータに影響しますか？
はい、データコネクタのテストでPOST、PUT、DELETEメソッドを使用すると、それらの操作が実際にデータに対して行われます。例えば、DELETEコールのテストでユーザーが実際に削除されます。
Finがユーザー以外の人に個人データを共有しないようにするには？
Finはプレビュ―タブでアクセスを許可したデータのみを読み取ります。Finはこのデータを使ってユーザーの質問に基づく回答を生成します。アクセスさせたくない機密内部データがある場合は、制限付きデータアクセスを選択し、Finに回答生成に使用させたいフィールドのみアクセスを許可してください。さらに、顧客向けの名前や値に応答データを変換することも可能です。例えば、申請状況「四つ目の目の確認待ち」を「レビュー待ち」など顧客に使う言葉に変換できます。
このリスクを最小限に抑えるための推奨設定は以下の表をご覧ください：
ユースケース | リスク | リスク軽減のベストプラクティス |
FinはIntercom CDAに保存されたユーザーIDに基づき顧客のパーソナライズデータを取得します。 | 悪意のある者がCDAの値を操作し、Finに別のアカウントのデータを取得させる可能性があります。 | Messenger経由でこれらの属性の更新をユーザーが行えないようにすることを推奨します。これにより、悪意のある者が他人のデータにアクセスするのを防げます。設定は設定 > データ > 人で該当属性を選択し、「Messenger経由の更新を防止」をオンにしてください。 |
FinはFinが収集したデータ値に基づき顧客のパーソナライズデータを取得します。 | 悪意のある者がアクセス権のないアカウントの値をFinに提供する可能性があります。 | APIサーバー側でユーザーが要求したデータへのアクセス権を持つかどうかをチェックすることを推奨します。 |
FinはFinが収集したデータ値に基づき顧客のパーソナライズデータを取得します。 | Finが別の顧客の値を誤って生成し、誤ったデータを取得することがあります。 | この誤生成のリスクはゼロではありませんが低いです。 しかし、APIサーバー側でユーザーのアクセス権をチェックすることを推奨します。 |
保存、認証、実行
データコネクタでトークンはどのように保存されますか？
データコネクタでトークンはどのように保存されますか？
トークンはヘッダー設定の一部として保存されます。これらの値は保存時に暗号化されます。Intercomのセキュリティについて詳しくはこちら。
データコネクタはどのような認証オプションをサポートしていますか？
データコネクタはどのような認証オプションをサポートしていますか？
データコネクタは固定トークンと動的トークンの両方を認証にサポートしています。認証トークンの設定と管理が可能で、リクエストに使用しヘッダーに追加できます。
データコネクタでリクエストはどのように実行されますか？
データコネクタでリクエストはどのように実行されますか？
すべてのリクエスト設定（本文、URL、ヘッダー）は保存時に暗号化されます。
すべてのリクエストはバックエンドから送信されます。つまり、ブラウザからAPIコールは行われません。例えば、ユーザーがアクションをトリガーすると、そのアクションはUIではなくIntercomシステムによってトリガーされます。
重要：サードパーティのデータはIntercomによって検証されず、データコネクタがIntercomに保存したデータを上書きする可能性があります。データコネクタから返されるデータを信頼できることを確認してください。
APIエラーコード（例：4xxや5xx）に基づいて分岐できますか？
APIエラーコード（例：4xxや5xx）に基づいて分岐できますか？
workflowsでのエラー処理：現時点では、データコネクタが返す特定のAPIエラーコード（4xxや5xxなど）で直接分岐することはできません。workflowsはデータコネクタのトリガーが成功したか失敗したかでのみ分岐します。ただし、APIがJSONペイロード内にレスポンス詳細（例：statusフィールド）を返す場合は、その値をConversation Data Attribute（CDA）として保存し、後続のworkflowステップで分岐ロジックに利用できる場合があります。
Fin Proceduresでのエラー処理：Fin Proceduresはデータコネクタの失敗を自動的に処理しません。コネクタがタイムアウトやエラーを返した場合、Finはリトライや自動回復を行いません。明確なフォールバック指示がないと、Finは予期せず停止したり、設定に基づかない回答を生成する可能性があります。
これを避けるために、Procedureには失敗時の明確な指示を含めてください。例：「検索に失敗した場合は謝罪し、人間のエージェントにエスカレーションする」。より高度なフォールバック動作が必要な場合は、サブプロシージャ内にデータコネクタ呼び出しをラップしてエラー処理を制御してください。高度な失敗処理では、データコネクタ呼び出しで返されるstatus_codeが出力属性として公開されました。これを条件ステップで参照し、特定のHTTPレスポンスコード（例：404と500）で分岐できます。詳細はFin Proceduresのコード条件の書き方をご覧ください。
会話作成時にAPI経由でブランド属性を設定できますか？
会話作成時にAPI経由でブランド属性を設定できますか？
いいえ、Brand属性は会話作成時にAPI経由で設定できません。ブランドの関連付けは、顧客が使用しているMessengerインターフェースやworkflow設定に基づいて自動的に決定され、APIリクエストによるものではありません。特定のブランドに会話を関連付けたい場合は、顧客が正しいブランドのMessengerを通じて会話を開始するか、workflowを設定して会話条件に基づき適切なブランドを割り当ててください。
注意：APIリクエストボディでブランド値を渡そうとしても効果はありません。その値は無視され、ブランドの関連付けはMessengerまたはworkflowの設定から解決されます。
Data connectorsはXMLを返すAPIと連携できますか？
Data connectorsはXMLを返すAPIと連携できますか？
はい、Data connectorsは現在、APIからのXMLレスポンスを自動的にJSONに変換します。これにより、より多くのAPIに簡単に接続でき、Fin、Workflows、Inboxでデータ形式を手動で変換することなくデータを利用できます。
IntercomはどのIPアドレスからData connectorリクエストを送信しますか？
IntercomはどのIPアドレスからData connectorリクエストを送信しますか？
IntercomからのData connector、Canvas Kit、webhookリクエストを受け入れるために、以下のIntercomのIPアドレスを許可リストに追加する必要があるかもしれません。以下の通りです：
アメリカ合衆国：
34.231.68.152
34.197.76.213
35.171.78.91
35.169.138.21
52.70.27.159
52.44.63.161
ヨーロッパ：
54.217.125.63
54.246.173.113
54.216.9.3
オーストラリア：
52.63.36.185
3.104.68.152
52.64.2.165
Finは単なる情報提供AIですか、それともアカウント更新のような操作も行えますか？
Finは単なる情報提供AIですか、それともアカウント更新のような操作も行えますか？
Finは単なる情報提供以上のものです。サポートコンテンツに基づく質問に答えるだけでなく、操作を実行するよう設定も可能です。Fin Proceduresを使えば、アカウント更新のような複数ステップの処理をFinに教えられます。Data connectorsを使うと、Finは外部システムのデータを安全に取得・更新できます（例：注文状況の変更やユーザー情報の更新）。
Finの動作
FinがProcedures、Guidance、Data connectors、Workflowsと連携する仕組み
機能 | 機能内容 | 使用タイミング | 注意事項 |
Procedures | Finに自然言語とルールベースのステップを使って、返金やアカウント更新のような特定の複数ステップ処理を教えます。 | Finに自然言語でトリガーされる複雑な複数ステップ処理を管理させたいとき。 | 労力がかかり論理的なリクエストに最適。会話の流れを完全にコントロール可能。 |
Guidance | Finに正確な回答を提供し、コミュニケーションスタイルやポリシーに基づいて問題をエスカレーションするようトレーニングします。 | Finにトーンを合わせ、エスカレーションルールを適用し、ポリシーに沿ったサポートを保証させたいとき。 | 操作は行わず、Finの話し方、説明、エスカレーション方法を管理します。 |
Data connectors | Fin ProceduresやWorkflowsでトリガーされるAPI呼び出しなど、外部システムのデータにFinがアクセスできるようにします。 | Fin Procedures、Workflow、Inboxのworkflowの一部として外部データを取得または更新する必要があるとき。 | Finが直接パーソナライズされた回答を生成するために使用。ProceduresやWorkflowsの内部でも使用されます。 |
Workflows | チケットの振り分け、リードの資格確認、プロアクティブサポートなどの運用ワークフローをハードコードされたパスで自動化します。 | 柔軟性を必要とせず、構造化された既知のパスに従う標準的なサポート業務を自動化するとき。 | エッジケースが増えるとスケールやメンテナンスが難しくなる可能性があります。 |
Fin ProceduresとWorkflowsの比較
特定のイベントやボタン選択でトリガーされるルーティング、タグ付け、スケジュールメッセージ送信のような厳格で事前定義された自動化パスが必要な場合はWorkflowを使用します。Finに会話的で複数ステップの処理（質問して予約を取る、情報収集、トラブルシューティングなど）を動的に自然言語リクエストや顧客の応答に適応させて処理させたい場合はFin Procedureを使用します。
Fin ProceduresとData connectorsの比較
Data connectorsは注文状況を取得してパーソナライズされた回答を生成しますが、Fin Procedureは注文キャンセルを処理し、返金の適格性を確認し、該当すれば返金を完了します。
Fin ProceduresとFin Guidanceの比較
Fin Guidanceは、返金リクエストに対してFinが非常に丁寧に対応することを保証し、Fin Procedureは適格ルールに基づいて返金プロセスを自動化します。
なぜFinが保留中の会話を閉じたときに自動終了メッセージが送信されなかったのですか？
なぜFinが保留中の会話を閉じたときに自動終了メッセージが送信されなかったのですか？
Let Fin Handleのworkflowステップ内でAuto-close pending Fin conversationsを有効にすると、Finが会話を閉じる前に送信するメッセージを選択できます。ただし、場合によってはFinがそのメッセージを送信せずに会話を閉じることがあります。
Finは、ジョブが実行中に顧客が非アクティブになる場合や、Finがインタラクティブ要素（返信ボタンなど）への顧客の応答を待っている間は、自動終了メッセージの送信をスキップします。この場合でも、Finは期待通りに会話を静かに閉じます。
Finはワークフローを壊さないようにこのように設計されています。Finがアクティブなジョブやインタラクティブなステップ中に自動終了メッセージを送信した場合：
自動終了メッセージが会話に表示され、返信ボタンがすべて削除されます。
しかしFinはまだ顧客がその返信オプションのいずれかを選択するのを待っています。
これによりワークフローが停止してしまいます。
これを避けるために、Finはバックグラウンドで閉じる処理を行い、ワークフローがジョブ中または返信ボタンの選択を待っている間は自動終了メッセージを送信しません。
注意：メッセージがスキップされても、Finは以下を行います：
顧客が非アクティブになったことを検出します。
会話を自動的に閉じます。
会話イベントに閉鎖を記録します。
一般的なFinの自動化問題
なぜFinは会話を早期に閉じるのですか？
なぜFinは会話を早期に閉じるのですか？
Finは自動終了設定やworkflowの構成により会話を自動的に閉じることがあります。一般的な原因：
workflowが顧客に追加の質問がないことを確認した後、終了ステップに到達すると会話が閉じられます。
自動終了設定はFinの最後のメッセージから数分後に会話を閉じるように設定されている場合があります。早期終了を防ぐには、workflowのLet Fin handleステップをクリックし、自動終了タイマーを長く調整してください。
なぜFinは顧客の問い合わせに応答しないのですか？
なぜFinは顧客の問い合わせに応答しないのですか？
Finが顧客の問い合わせに応答しない理由は以下の通りです：
ワークスペースで設定された使用制限に達している。Fin Usageページを確認し、必要に応じて制限を増やしてください。
Finよりも人間のエージェントへのルーティングを優先するworkflowの構成。workflowのトリガーを見直し、Finが適切に使用されるよう調整してください。
なぜFinは不必要に問い合わせを人間のエージェントにエスカレーションするのですか？
なぜFinは不必要に問い合わせを人間のエージェントにエスカレーションするのですか？
Finはワークスペースで設定された解決制限に達すると、不必要に問い合わせを人間のエージェントにエスカレーションすることがあります。Settings > Billing > Usageに移動し、Resolutionグラフを確認してください。必要に応じて制限を増やしてください。
なぜFinは追加情報を求めた後に会話を閉じるのですか？
なぜFinは追加情報を求めた後に会話を閉じるのですか？
Finが満足のいく回答を提供できなかった後に顧客がエスカレーションを要求しない場合、会話が閉じられることがあります。会話が閉じられた後でも顧客はFinにさらに質問できます。返信があればFinは会話を再開します。
なぜFinは質問がされていないのに応答するのですか？
なぜFinは質問がされていないのに応答するのですか？
Finは会話内のすべての以前の入力（クイックリプライボタンの選択を含む）を考慮して応答を形成します。Finに明確な質問にのみ応答させたい場合は、そのように指示するためにGuidanceの指示を更新してください。
なぜFinはOutboundメッセージに返信する顧客に応答しないのですか？
なぜFinはOutboundメッセージに返信する顧客に応答しないのですか？
FinがOutboundメッセージの返信に応答するオプションは、Simple展開設定でのみ機能します。Advanced展開でWorkflowsを使用している場合、Finはこれらの返信に自動応答しません。Simple展開設定に切り替えるか、Let Fin handleステップを含むAdvanced Workflowで返信を処理してください。
なぜFinはエスカレーションする代わりに会話を閉じるのですか？
なぜFinはエスカレーションする代わりに会話を閉じるのですか？
Finは「この問題をエスカレーションしてくれてありがとう」のようなメッセージを解決の合図と解釈し、エスカレーションせずに会話を閉じることがあります。Fin Guidanceを更新して、エスカレーションの言葉の扱いを明確に指示し、感謝のメッセージを解決済みとみなさないようにしてください。
なぜFinは顧客に営業時間外に連絡したと伝えるのですか？
なぜFinは顧客に営業時間外に連絡したと伝えるのですか？
Finは設定された営業時間外に会話が開始された場合、営業時間外メッセージを送信します。アカウント設定で営業時間を確認・調整し、運用スケジュールに合わせてください。Workflowsはチームごとに設定されたカスタム営業時間ではなく、デフォルトの営業時間のみを使用します。
なぜFinは期待通りにメールに応答しないのですか？
なぜFinは期待通りにメールに応答しないのですか？
Finが期待通りにメールに応答しない理由は以下の通りです：
Intercomでチームメイトのメールとして設定されていないメールアドレスからテストメールを送信している。適切に設定されたテストアドレスを使用していることを確認してください。
Finの初回応答後にworkflowの割り当てルールが会話をチームメイトに割り当てている。workflowを見直し、割り当てステップがFinのメール自動化と競合しないようにしてください。
なぜFinはバイパスすべきメールに返信するのですか？
なぜFinはバイパスすべきメールに返信するのですか？
レガシーFin Profilesが新しい展開方法と競合し、Finがバイパスすべきメールに応答してしまうことがあります。アクティブなFin Profilesを一時停止し、FinはWorkflowsまたはSimple展開のみで展開してください。
Fin AI Agentを無効にするには？
Fin AI Agentを無効にするには？
Fin AI Agentを無効にするには、無効にしたいチャネルのFin AI Agent Deployページに移動してオフにします。Finが完全に無効になるように以下の手順に従ってください：
Fin AI Agent > Deployに移動し、該当チャネルのFinを無効にします。チャットとメールの設定横の緑の点が無効時に黄色に変わるはずです。
すべてのアクティブなWorkflowsからFinを削除します。
Finが有効なライブのProceduresやWorkflowsを無効にします。主要チャネルが一時停止されていても、FinはアクティブなWorkflows、データコネクター、Proceduresを通じて顧客とやり取りできます。