データコネクタは Fin で全ての価格プランで利用可能で、成果ごとに課金されます。

データコネクタは全ての米国、EU、AUのホストされたワークスペースで利用可能です。

アクションまたは「カスタムアクション」は単に「データコネクタ」に名称変更されました。機能や設定に変更はありません。

Intercom はPAN 伏字機能を提供しており、会話内容をクレジットカード番号のような数字でルーンチェックを通過するものをスキャンします。該当番号が見つかると、番号の最後の4桁以外はマスクされ、顧客はウェブメッセンジャーやiOS・Android SDKで伏字版を確認できます。Inbox の会話でも番号は伏字表示されます。

追加の制御にはStrac アプリをインストールして、Intercom メッセージや添付ファイルから機密データを検出・伏字化できます。SSN、誕生日、運転免許証、パスポート、クレジットカード、デビットカード、API キーなどの機密データ要素リストを設定可能です。

なりすまし防止には、Messenger のセキュリティを JWT で強化することを強く推奨します。これによりデータは認証済みの Users のみがアクセス可能になります。認証を有効にしないと、悪意ある者が不正操作やデータコネクタのトリガーを行う可能性があります。

Leads や Messenger 以外のチャネルからの会話には Messenger 認証は適用されません。その場合はワンタイムパスコード（OTP）や他の安全な認証方法を使い、ユーザーデータ公開前に検証してください。

はい。データコネクタのテストで POST、PUT、DELETE メソッドを使うと、その操作が実際にデータに対して行われます。例えば、ユーザーに対する DELETE 呼び出しのテストは実際にユーザーを削除します。

Fin はプレビュ―タブでアクセス許可したデータのみを読み取ります。Fin はこのデータを使いユーザーの質問に基づく回答を生成します。機密の内部データを Fin にアクセスさせたくない場合は、制限付きデータアクセスを選び、回答生成に使うフィールドのみアクセス許可してください。さらに回答データを顧客向けの名称や値に変換も可能です。例えば申請状況「四眼チェック待ち」を「審査中」など顧客向けの言葉に変換できます。

トークンはヘッダー設定の一部として保存されます。これらの値は保存時に暗号化されます。Intercom のセキュリティについて詳しくはこちら。

データコネクタは固定トークンと動的トークンの両方を認証にサポートします。認証トークンの設定と管理が可能で、リクエストに追加してヘッダーに含められます。

Workflows のエラー処理：現時点では、データコネクタが返す特定のAPIエラーコード（4xx や 5xx など）で直接分岐できません。Workflows はデータコネクタのトリガー成功・失敗でのみ分岐可能です。ただし、API が JSON ペイロード内にレスポンス詳細（例：status フィールド）を返す場合、Conversation Data Attribute (CDA) に保存し、その値を後続の Workflows ステップの分岐ロジックに使う回避策があるかもしれません。

Fin Procedures のエラー処理：Fin Procedures はデータコネクタの失敗を自動的に処理しません。コネクタがタイムアウトやエラーを返した場合、Fin はリトライや自動回復を行いません。明確なフォールバック指示がないと、Fin は予期せず停止したり設定に基づかない回答を生成する可能性があります。

これを避けるには、Procedure に失敗時の明確な指示を含めてください。例：「検索に失敗したら謝罪し、人間のエージェントにエスカレーションする」。より高度なフォールバック動作が必要な場合は、サブプロシージャ内でデータコネクタ呼び出しをラップし、エラー処理を制御してください。高度な失敗処理では、データコネクタ呼び出しで返されるstatus_codeが出力属性として公開されました。これを条件ステップで参照し、特定のHTTPレスポンスコード（例：404 と 500）で分岐できます。詳細は「Fin Procedures のコード条件の書き方」を参照してください。

いいえ、会話作成時にAPI経由でBrand属性を設定することはできません。ブランドの関連付けは、顧客が使用しているMessengerインターフェースやworkflow設定に基づいて自動的に決定され、APIリクエストによっては決まりません。特定のブランドに会話を関連付けたい場合は、顧客が正しいブランドのMessengerを通じて会話を開始するか、会話条件に基づいて適切なブランドを割り当てるようworkflowを設定してください。

注意：APIリクエストボディでブランド値を渡そうとしても効果はありません。その値は無視され、ブランドの関連付けはMessengerまたはworkflowの設定から解決されます。

はい、Data connectorsは現在、APIからのXMLレスポンスを自動的にJSONに変換します。これにより、より多くのAPIに簡単に接続でき、Fin、Workflows、Inboxでデータ形式を手動で変換することなくデータを利用できます。

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は単なる情報提供以上のものです。サポートコンテンツに基づく質問に答えるだけでなく、操作を実行するよう設定することも可能です。Fin Proceduresを使えば、アカウント更新のような複数ステップのプロセスをFinに教えることができます。Data connectorsを使うと、Finは外部システムのデータを安全に取得・更新できます（例：注文状況の変更やユーザー情報の更新）。

Finは自動終了設定やworkflowの構成により会話を自動的に閉じることがあります。主な原因：

Finが顧客の問い合わせに応答しない理由は以下の通りです：

Finはワークスペースで設定された解決制限に達すると、不必要に問い合わせを人間のエージェントにエスカレーションすることがあります。設定 > 請求 > 使用状況に移動し、解決グラフを確認してください。必要に応じて制限を増やしてください。

Finが満足のいく回答を提供できず、顧客がエスカレーションを要求しなかった場合、会話が閉じられることがあります。会話が閉じられた後でも顧客はFinに質問を続けることができ、返信があればFinは会話を再開します。

Finは会話内のすべての入力（クイックリプライボタンの選択も含む）を考慮して応答を形成します。Finに明確な質問にのみ応答させたい場合は、ガイダンス指示を更新してその動作を指定してください。

FinがOutboundメッセージの返信に応答するオプションは、Simple展開設定でのみ機能します。Workflowsを使ったAdvanced展開では、Finはこれらの返信に自動応答しません。Simple展開設定に切り替えるか、Let Fin handleステップを含むAdvanced Workflowで返信を処理してください。

Finは「この問題をエスカレーションしてくれてありがとう」などのメッセージを解決の合図と解釈し、エスカレーションせずに会話を閉じることがあります。Finガイダンスを更新し、エスカレーション言語の扱いを明確に指示し、感謝のメッセージを解決済みとみなさないようにしてください。

Finは設定された営業時間外に会話が開始されると営業時間外メッセージを送信します。アカウント設定で営業時間を確認・調整し、運用スケジュールに合わせてください。Workflowsはチームごとに設定されたカスタム営業時間ではなく、デフォルトの営業時間のみを使用します。

Finが期待通りにメールに応答しない理由は以下の通りです：

旧Finプロファイルが新しい展開方法と競合し、Finがバイパスすべきメールに応答してしまうことがあります。アクティブなFinプロファイルを一時停止し、FinはWorkflowsまたはSimple展開のみで展開してください。

Fin AIエージェントを無効にするには、無効にしたいチャネルのFin AI Agent Deployページに移動してオフにします。Finが完全に無効化されていることを確認するために以下の手順に従ってください。