このガイドではHubSpotのemail ticketsでのFinのセットアップ手順を説明します。Fin MessengerとHubSpotの連携についてはFin Messenger HubSpot setupをご覧ください。
前提条件
開始する前に、以下を確認してください：
HubSpot Service Hub Professional：アカウントでticketsが有効になっている必要があります。
専用のHubSpotユーザー：Fin AIを代表するサポート席（例：「Fin AI Agent」）が必要です。個人アカウントより専用アカウントを推奨します。どの管理者が操作しているか明確でデバッグが容易になり、そのエージェントのアカウントが削除されたり権限が変更された場合の問題を防げます。
管理者アクセス：Finワークスペースでの完全な管理者権限。
ステップ1：HubSpotを接続する
HubSpotはOAuth2を使用して接続します。トークンは自動更新され、接続が維持されます。
Deploy > HubSpot Ticketsに移動し、Connectをクリックします。
Finにアクセス権を付与するためにHubSpotのOAuth認証フローを完了してください。
完了すると、ステータスがConnectedと表示されます。
Fin HubSpotエージェントを選択する
Fin AIを代表するHubSpotユーザーを選択します。このユーザーがFinが処理中のticketsを所有します。
注意：個人アカウントより専用アカウントを推奨します。どの管理者が操作しているか明確でデバッグが容易になり、そのエージェントのアカウントが削除されたり権限が変更された場合の問題を防げます。HubSpotユーザーがリストに表示されない場合は、有効なサポート席と正しい権限があるか確認してください。
HubSpotからのデータ同期（オプション）
接続後、HubSpotの属性をFinに同期できます。Finは会話のライフサイクルを通じてこれらの属性をプッシュおよびプルし、両プラットフォーム間でデータを同期します。これにより、異なるオーディエンスをターゲットにしたり、ticketsを自動分類したり、workflowsで分岐を作成したりできます。
自動セットアップ
接続が成功すると、Finは自動的に：
HubSpotに3つのカスタムticketプロパティ（Fin Status、Fin Tags、Fin Assignment）を「Fin AI Agent」プロパティグループの下に作成します。
4つのHubSpot workflows（初期は無効）：Assign New Tickets、Resolution、Pending、Route to Teamを展開します。これらはFinが正しく動作するために必要なので削除しないでください。
トリアージと引き継ぎのためのデフォルトFin workflowを設定します。
ステップ2：workflowを構築する
Finが顧客に挨拶し応答する方法や、対応できない場合の引き継ぎ方法をカスタマイズします。FinワークスペースのManage workflowで体験をカスタマイズし、ライブ設定してください。
ライブにする前に、Fin AI設定でknowledge base、ガイダンス、トーンが設定されていることを確認してください。ライブにすると、Assign New Tickets workflowがすぐにすべての新しいHubSpot ticketsをFinにルーティングし、Finは構築したworkflowに基づいて応答および引き継ぎを行います。
注意：HubSpotのemail conversationsチャネルでは返信オプションやチケット作成ステップは利用できません。HubSpot ticketsの唯一の引き継ぎモードはHubSpotでのエージェントへの引き継ぎです。
ステップ3：Finをテストする
ライブにする前に、Finがライブのticketキューに影響を与えずに正しく応答しているか検証します。方法は2つあります：
オプション1：Finのテスト機能を使う
Finが参照できるようにknowledge baseに十分なコンテンツを追加してください。
FinのTest機能を使って実際の顧客の質問をし、Finの応答を確認します。
Finの応答に満足するまでコンテンツとガイダンスを調整してください。
オプション2：基準に基づく段階的リリース（推奨）
完全にライブにする前に、Assign New Tickets workflowの基準を絞り、Finが処理するticketsを限定できます。これにより、実際のticketsでエンドツーエンドのフローをテストしつつ、Finがキュー全体を処理するのを防げます。
注意：Finがticketsに応答するには統合がLiveに設定されている必要があります。テストticketsも含みます。まずパート4：ライブにするを完了し、その後以下の基準でテスト中にFinが処理するticketsを制限してください。
HubSpotでAutomation > Workflows > Fin AI Agent – Assign New Tickets workflowに移動します。
基準を追加：ticketのDescriptionが「FIN test」と等しい。
説明に「FIN test」と入れたテストメールをサポートアドレスに送信します。このticketのみがFinにルーティングされ、他は影響を受けません。
解決、引き継ぎ、プロパティ更新を含むエンドツーエンドのフローを検証します。
完全にライブにする準備ができたら、workflowの基準を削除または緩和してください。
プロのヒント：この基準アプローチは段階的展開にも有効で、特定のticketタイプのみをFinにルーティングし、徐々にキュー全体に拡大できます。
ステップ4：ライブにする
ライブにする準備ができたら、Go liveをクリックします。これにより4つのHubSpot workflowsが有効になり、Finが受信ticketsの処理を開始します。
仕組み
HubSpot ticketsの流れ
HubSpotでticketが作成され、Assign New Tickets workflowが発動し、Fin AI agentに割り当てられます。
Finにwebhookが発火します。Finはticket、スレッド、連絡先を取得し、Fin conversationを作成します。
Finはticketを処理し、応答をリアルタイムでHubSpot ticketスレッドに同期します。
カスタムHubSpotプロパティは随時更新されます：Fin Status（オープン/保留/解決済み）、Fin Tags（解決タイプ）、Fin Assignment（エージェント）。
4つのHubSpot workflowsは、これらのプロパティ変更に反応してticketのパイプラインステージと割り当てを更新します。
双方向メッセージ同期
HubSpot ticketスレッドメッセージはFinの会話に同期されます。
Finの返信はHubSpot ticketスレッドの返信として同期されます。
画像添付ファイルはHubSpotからFinに同期されます。
プロパティベースのレポート
Finはticketのライフサイクル全体で3つのカスタムHubSpotプロパティを自動的に更新し、Finの動作を完全に可視化します。
プロパティ | 値 | 追跡内容 |
Finステータス | オープン、保留中、解決済み | Finがticketを処理している現在の状態 |
Finタグ | fin-involved、fin-soft-resolution、fin-resolved、fin-routed-to-team | ticketがどのように処理されたか（例：解決済み、チームにルーティング） |
Fin割り当て | fin、human-teammate | 現在ticketを所有しているのがFinか人間のチームメイトか |
HubSpotのネイティブレポートおよびフィルターツールでこれらのプロパティを使用し、ticketパイプライン全体でのFinの関与、解決率、引き継ぎパターンを追跡してください。
無効化または取り消し
無効化
設定を失うことなく統合を一時停止します。Finがticketを処理するのを一時的に停止したい場合に使用してください。
4つのHubSpot workflowsがすべて無効になります。
設定とフィールドマッピングは保持されます。
取り消し
統合の完全な解体。
すべてのHubSpot workflowsが削除されます。
OAuth接続が破棄されます。
重要：取り消しには再接続のための完全な再設定が必要です。一時的な停止が必要な場合は無効化を使用してください。
トラブルシューティング
FinがHubSpot ticketに応答しない
Finがticketを取得しない場合は、以下を確認してください：
HubSpot Workflows: HubSpotでAutomation > Workflowsに移動し、4つのFin workflowsがすべて有効になっていることを確認してください。
割り当て: Assign New Tickets workflowが指定されたFin AIエージェントユーザーに正しくticketを割り当てていることを確認してください。
接続状況: FinワークスペースのDeploy設定でOAuth接続がまだ有効か確認してください。期限切れの場合は再認証してください。
Fin Workflow: ワークスペースのFin workflowがLiveに設定されていることを確認してください。
HubSpotユーザーがセレクターに表示されない
専用の「Fin AI」ユーザーがエージェントリストに見つからない場合は、HubSpotで正しい権限を持つ有効なsupport seatがあるか確認してください。
Finから会話を引き継ぐ
Finがticketを処理中に介入する必要がある場合、返信前にFinの割り当てを手動で解除しないでください。先に解除すると、Finはticketに割り当てられていないため、受信メッセージを処理しません。
代わりに、割り当てを変更せずにHubSpotで直接返信してください。Finはチームメイトの返信を検知し、自動的に退き、これ以上返信せず、引き継ぎを反映するFinタグを更新します。
よくある質問
HubSpot ticketのタイトルは動的にできますか？
HubSpot ticketのタイトルは動的にできますか？
HubSpot ticketのタイトルは現在静的です。動的タイトル（例：オーディエンス名、訪問者メール、会話トピックを含む）はネイティブオプションとしてまだサポートされていません。
FinはHubSpot ticketにどのタグ値を適用しますか？
FinはHubSpot ticketにどのタグ値を適用しますか？
Finは会話のライフサイクル全体でticketの状態を追跡するために以下のタグを使用します：
fin-involved — Finが会話に参加しました。
fin-soft-resolution — Finが回答を提供しましたが、ticketは解決済みと確認されていません。
fin-resolved — Finがticketを完全に解決しました。
fin-routed-to-team — チケットは人間のチームメイトに引き継がれました。
これらはすべてのFin統合で使用される同じタグ値です。