このガイドでは、Fin MessengerとHubSpotのhandoff設定について説明します。顧客はウェブサイトのFin Messengerを通じてFinとチャットし、Finが問題を解決できない場合は、HubSpotのエージェントキューにルーティングするか、会話の全記録を含む新しいHubSpot ticketを作成します。
前提条件
開始する前に、以下を確認してください：
OAuth経由で接続されたHubSpot：まだ接続していない場合は、Fin for HubSpot tickets: Setupの手順に従ってください。すでに接続済みの場合はスキップしてください。
ウェブサイトアクセス：Fin Messengerのスニペットをインストールするために、ウェブサイトまたはアプリのコードにアクセスできること。
HubSpotの権限：inboxチャネルを追加するために、HubSpotアカウントの管理者アクセス権が必要です。
ヒント：個人アカウントではなく、「Fin AI」などの専用ユーザーを作成してください。これにより、Finのticket所有権がチームメンバーのキューと分離され、統合の一時停止や取り消しが容易になります。
パート1：HubSpotに接続する
Deploy > Fin MessengerでHubSpotに接続できます。
HubSpotに接続する
Finに会話へのアクセス権を与え、AI対応サポートを有効にするためにHubSpotアカウントを接続してください。
「Connect」ボタンをクリックしてください。
認証のためにHubSpotにリダイレクトされます。
認証後、Finにリダイレクトされて続行します。
FinをHubSpotに接続することで、当社のサードパーティプラットフォーム利用規約に同意したことになります。
Fin MessengerチャネルをHubSpotポータルにインストールする
Fin MessengerチャネルをHubSpotのhelpdeskに接続して、Finが受信した質問に回答できるようにします。
HubSpotポータルにアクセスしてください。
CRM → Inbox → 設定に移動します。
チャネルを接続をクリックします。
リストからFin Messengerアカウントを選択して、HubSpotのinboxでFin Messengerの会話を受信し始めます。
セットアップを続行するには、Connect with Fin messengerをクリックしてください。
Fin MessengerチャネルをHubSpotのHelpdeskに接続するセットアップを完了するには、Connectをクリックしてください。
オプションで、Auto assign conversationsを有効にして、受信した会話を自動的にチームメンバーにルーティングできます。
インストール後、Finのワークスペースに戻り、Refresh statusをクリックして続行します。
ヒント：本番環境にインストールする前に、QA環境でMessengerをテストしてください。
Fin HubSpotエージェント
Fin Messengerの会話を処理する際にFinがどのHubSpotエージェントとして動作するかを選択します。このユーザーは、Finがticketを処理している間の所有者となり、HubSpotでFinとチームメンバーがどの会話を処理しているかを明確にします。
注意：個人アカウントではなく専用アカウントを推奨します。どの管理者が操作しているか明確でデバッグが容易であり、そのエージェントのアカウントが削除されたり権限が変更された場合の問題を防げます。HubSpotユーザーがリストに表示されない場合は、有効なサポートシートと正しい権限があるか確認してください。
HubSpotからデータを同期する
このステップはオプションです。データを同期するにはまずHubSpotに接続してください。このデータを使って異なるオーディエンスをターゲットにしたり、ticketを自動分類したり、workflowsで分岐を作成したりできます。
パート2：workflowを構築する
Finが顧客に挨拶し応答する方法や、対応できない場合のhandoff方法をカスタマイズします。FinのワークスペースでManage workflowに移動して体験をカスタマイズし、ライブ設定してください。
トリガーが顧客がFin Messengerで新しい会話を開始したときのworkflowは、デフォルトのフローで自動入力されます。デフォルトworkflowには以下が含まれます：
Finのトリアージステップ — Finはknowledge baseとコンテンツを使って顧客の質問を解決しようとします。
解決パス — Finが問い合わせを解決した場合、会話は終了します。
handoffパス — Finが解決できない場合、会話はHubSpotのエージェントキューにエスカレーションされるか、会話の全記録を含む新しいHubSpot ticketが作成されます。
workflow内でカスタマイズできる項目：
顧客が会話を開始したときにFinが送る挨拶メッセージ
Finの応答動作 — トーン、エスカレーショントリガー、コンテンツターゲティング
handoff条件 — Finがチームメンバーにルーティングする場合とticketを作成する場合、どのHubSpot inboxまたはキューにルーティングするか。選べるhandoffモードは2つあります：HubSpotのエージェントにhandoff（Fin MessengerチャネルがHubSpotのinboxにインストールされている場合）またはHubSpotのticketにhandoff（インストールされていない場合）。
注意：接続が成功すると、Finは自動的に4つのHubSpot workflowsを作成します：Resolution、Pending、Route to team、Assign new tickets。HubSpotで確認するには、Automation > Workflowsに移動してください。
これらは削除しないでください — Finがticketを正しく管理するために必要です。
パート3：Fin Messengerをインストールする
ウェブ用Fin Messengerをインストールする
ウェブインストールの場合：
インストール方法を選択してください（Code snippet、React、Angular、Vue、Ember、Shopify）
方法別の指示に従ってください — NPMパッケージ/コードスニペットをコピーし、Messengerを表示したいすべてのページのタグの前に貼り付けます。
動作確認にはインストールの確認を使用してください
MessengerをJWTで保護する（特にログインユーザー向け）
モバイル用にFin Messengerをインストールする
モバイルインストールの場合：
プラットフォームを選択してください（iOS、Android、またはReact Native）
コードベースでFinを初期化し、プラットフォーム固有の手順に従ってください
iOSを使用する場合はiOS SDK APIキーを生成してください
動作確認にはインストールの確認を使用してください
JWTで保護する
任意：プッシュ通知を設定する
パート4：テスト
統合をテストする
Fin Testダッシュボードを使用：FinサイドバーのTestタブに移動して、応答品質をプレビューし、ライブサイトに影響を与えずにエスカレーション経路を確認します。
Messengerの表示場所を制御：Fin Messengerはコードスニペットをインストールした場所にのみ表示されます。テストの場合はステージングURLにインストールするか、DeployセクションのURLルールを使用して特定のテストページ（例：
yoursite.com/test）に制限してから全訪問者に展開してください。
注意：Finが応答するには統合がLiveに設定されている必要があります。Messengerスニペットのインストール場所を制御できるため、ライブ中でも安全にテスト可能です。ステージングURLにインストールするか、DeployセクションのURLルールを使用して特定のテストページに制限してください。顧客はそのURLを訪問しない限り表示されません。
パート5：Fin Messengerでライブ開始
セットアップに満足したら、Go liveを選択してFinをオンにします。
エスカレーションの設定は、HubSpot inboxにFin Messengerチャネルがインストールされているかどうかによって異なります：
HubSpotでエージェントに引き継ぐ
Fin MessengerチャネルがHubSpot inboxにインストールされている場合にこのオプションを使用します。Finが会話を解決できない場合、チケットを「Waiting on us」に更新し、Finの割り当てを解除してチームメンバーがHubSpotで対応できるようにします。
HubSpotでチケットに引き継ぐ
Fin MessengerチャネルがHubSpot inboxにインストールされていない場合にこのオプションを使用します。Finはワークスペース内で会話全体を処理し、HubSpotと同期しません。エスカレーション時に、完全なトランスクリプト付きの新しいHubSpotチケットが作成されます。
重要：チケットへの引き継ぎ時にユーザー認証（OTP）を無効にすると、ログインユーザーはHubSpotチケット作成前に認証されなくなります。JSON Web Token（JWT）による本人確認がないと、顧客が他のユーザーを偽装する可能性があり、重大なセキュリティリスクです。既存の認証設定に完全に自信がある場合のみOTPを無効にしてください。Email OTPワークフローステップでの顧客認証について詳しくはこちら。
ユーザー認証
HubSpotでチケットに引き継ぐ場合、チケット作成前にusersにメールアドレスの認証を要求できます。これにより、エスカレーション時に追加の本人確認が行われます。
チケット引き継ぎ前にメール認証を強制：有効にすると、HubSpotチケットが作成される前にusersがメール認証を成功させる必要があります。
Messengerが安全でない場合はOTPを要求：MessengerがJSON Web Token（JWT）による本人確認で保護されていない場合、引き継ぎ前にusersはワンタイムパスワード（OTP）でメールアドレスを認証する必要があります。これにより、未認証のusersが他人のIDでチケットを作成するのを防ぎます。
ヒント：最も安全な設定はMessengerでJWT本人確認を実装することです。OTPは保護されていないMessengerインストールのフォールバックであり、適切な本人確認の代替ではありません。
注意：Messengerの引き継ぎ時に、顧客がHubSpotの連絡先として存在しない場合、会話中に収集された情報を使って新しい連絡先が自動的に作成されます。
オーディエンスとコンテンツターゲティング
複数のロケーションやブランドを提供している場合は、Finでそれぞれに別々のオーディエンスを設定し、関連するスニペットやウェブ同期を各オーディエンスに紐付けてください。
オーディエンス優先ルール
より広いオーディエンス（例：「URLにtheescapegame.comを含む」）は、より具体的なオーディエンス（例：「URLにtheescapegame.com/nashvilleを含む」）より優先順位が高くない限り、自動的に上書きされません。
ロケーション固有ページの訪問者が誤ったオーディエンスのコンテンツを受け取っている場合は、特定のオーディエンスルールが一般のものより上位にランクされているか確認してください。
重要：同期後にコンテンツターゲットオーディエンスを更新する場合は、コンテンツを削除して再同期してください。既に同期されたコンテンツのオーディエンスを単に更新しても正しく適用されないことがあります。これは既知の挙動であり、恒久的な制限ではありません。アップデートを確認してください。
注意：FinはウェブサイトのURLから直接コンテンツを同期できます。同期されたページのコンテンツを更新した場合、Finが変更を検出するために再同期が必要です。Finはページの更新を自動検出しません。
無効化と取り消しの違い
HubSpot統合を一時停止または削除する必要がある場合、2つのオプションがあり、その違いを理解することが重要です。
無効化は統合を一時停止しますが、設定は破壊しません。Finが作成したすべてのHubSpot workflowsは無効になり、会話はFin経由のルーティングを停止します。設定、OAuth接続、HubSpotプロパティは保持されます。いつでも再有効化でき、途中から再開可能です。
取り消しは完全な解除です。OAuth接続は破棄され、Finが作成した4つのHubSpot workflowsは永久に削除され、Finの設定も削除されます。再接続する場合は最初からセットアップが必要です。
Finからの会話引き継ぎ
FinがMessengerの会話を処理中に介入する必要がある場合、返信前に手動でFinの割り当てを解除しないでください。先に割り当てを解除すると、Finは受信メッセージを処理しなくなります。割り当てが解除されているためです。
代わりに、割り当てを変更せずにHubSpotで直接返信してください。Finはチームメンバーの返信を検知し、自動的に退きます。これにより、追加の返信は送信されず、引き継ぎを反映するためにFinタグが整理されます。
よくある質問
訪問者が戻ったときにFin Messengerの自動オープンを停止できますか？
訪問者が戻ったときにFin Messengerの自動オープンを停止できますか？
現在、訪問者がページに戻ったときにFinが再オープンするのを防ぐネイティブ設定はありません。訪問者はMessengerアイコンを手動でクリックして再オープンする必要があります。この機能の需要を追跡するためにFinアカウントチームにお問い合わせください。
「会話が転送されました」メッセージをカスタマイズできますか？
「会話が転送されました」メッセージをカスタマイズできますか？
転送確認メッセージ（「会話はサポートチケットに転送されました。更新はメールで受け取ります。」）はシステムメッセージであり、編集できません。
Fin Messengerがウェブサイトに表示されない
Fin Messengerがウェブサイトに表示されない
Messengerコードスニペットがウェブサイトに正しくインストールされていることを確認し、FinワークスペースのDeploy設定でMessengerがLiveに設定されているか確認してください。6秒後に表示されるデフォルトの「Need Help?」ポップアウトがありますが、この動作は現在完全に無効化できません。
HubSpotで重複したticketsが作成されています。
HubSpotで重複したticketsが作成されています。
両方のhandoffモードが同時に有効になっていると、重複したticketsが作成されます。設定に基づく修正方法は以下の通りです： HubSpotでHand-off to agentを使用している場合： HubSpotのinboxからFin Messengerアプリを削除してください（HubSpotの設定 → Inboxesへ移動）。Fin MessengerチャネルがHubSpotに同時にインストールされていると、各エスカレーションで2つのticketsが生成されます。 HubSpotでHand-off to ticketを使用している場合： HubSpotのinboxにFin Messengerチャネルをインストールしないでください。Fin Messengerチャネルはすでにhandoff時にticketを作成しているため、HubSpotでHand-off to ticketのステップを追加すると重複します。 handoff方法は1つだけ有効にしてください。
特定の場所に対してFinが誤った回答をしています。
特定の場所に対してFinが誤った回答をしています。
以下を確認してください：
Audiencesが正しく設定されており、場所特有のaudienceが一般的なaudienceより優先順位で上位にあることを確認してください。
関連するスニペットとweb syncが一般的なaudienceではなく、正しいaudienceに紐付けられていることを確認してください。
FinのTest機能を使って特定のURLからの訪問者をシミュレートし、Finがどのコンテンツを取得しているかを確認してください。