このガイドでは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をクリックします。
HubSpotのOAuth認証フローを完了してFinへのアクセスを許可します。
完了すると、ステータスが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にルーティングし、構築したworkflowに基づいてFinが応答・引き継ぎを行います。
注意：HubSpotのemail conversationsチャネルでは返信オプションやticket作成ステップは利用できません。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の会話を作成します。
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ステータス | open、pending、resolved | 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タグを更新します。
制限事項
同期できるknowledge baseは1つのみです。複数のknowledge baseを同期するには、それぞれ別の同期設定を行ってください。
knowledge baseの同期と過去のticketインポートにはContent Hub（CMS Hub）ProfessionalまたはEnterpriseが必要です。HubSpotのGraphQL Collector APIはknowledge baseデータのクエリに唯一対応しており、
collector.graphql_query.executeスコープが必要で、これらのプランでのみ利用可能です。詳細はHubSpotのスコープリファレンスおよびGraphQLによるknowledge baseデータのクエリを参照してください。
よくある質問
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 — ticketは人間のチームメイトに引き継がれました。
これらはすべてのFin統合で使用される同じタグ値です。