このガイドでは、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を使って接続します。トークンは自動更新され、接続が維持されます。
メインナビゲーションのConnectに移動し、Connect to HubSpotをクリックします。
HubSpotのOAuth認証フローを完了してFinへのアクセスを許可します。
完了すると、ステータスがConnectedと表示されます。
HubSpotからのデータ同期（オプション）
接続後、HubSpotからFinに属性を同期できます。Finは会話のライフサイクル全体でこれらの属性をプッシュ＆プルし、両プラットフォーム間でデータを同期します。これにより、異なるオーディエンスをターゲットにしたり、ticketを自動分類したり、workflowsで分岐を作成したりできます。
自動セットアップ
接続が成功すると、Finは自動的に：
HubSpotに3つのカスタムticketプロパティ（Fin Status、Fin Tags、Fin Assignment）を「Fin AI Agent」プロパティグループの下に作成します。これらはHubSpotの設定で以下のように表示されます。
4つのHubSpot workflows（初期は無効）を展開します：Assign New Tickets、Resolution、Pending、Route to Team。これらのworkflowsはステップ2で設定するパイプラインとステージを使って構築されます。削除しないでください—Finが正しく動作するために必要です。
トリアージと引き継ぎのためのデフォルトFin workflowを設定します。
ステップ2：HubSpotへの接続を設定
Deploy › HubSpot Ticketsで、Configure your connection to HubSpotをクリックします。設定ページが開き、Finが動作するHubSpotユーザー（専用アカウント推奨、例：「Fin AI Agent」）を選択し、パイプラインとそのステージをFinのticket状態にマッピングします。
Finの状態 | 意味 | デフォルトサポートパイプラインステージ |
新しいticket | Finが新しいticketを取得するために監視するステージ | 新規 |
顧客待ち | Finは顧客の返信を待つ間、ticketをここに移動します。 | 連絡先待ち |
チーム待ち | Finは人間のチームメイトに引き継ぐ際にticketをここに移動します。 | 私たち待ち |
解決済み | Finは会話を解決するとticketをここに移動します。 | クローズ済み |
注意：HubSpotでパイプラインとステージ名を確認するには、設定 > データ管理 > オブジェクト > Tickets > パイプラインに移動し、パイプライン名をクリックします。カスタムパイプラインを使用している場合は、それを選択しステージをマッピングしてください。この設定はすべてのHubSpotチャネルで共有されます。すでにFin Messengerで設定済みなら、このステップはスキップ可能です。将来的に設定を更新するには、設定 > チャネル > HubSpot Ticketsに移動してください。
ステップ3：workflowを構築
公開前に、Fin AI設定でknowledge base、ガイダンス、トーンが設定されていることを確認してください。公開すると、Assign New Tickets workflowがすぐにすべての新しいHubSpot ticketsをFinにルーティングします。Finは構築したworkflowに基づいて回答し、引き継ぎます。Deploy › HubSpot Tickets > Create a workflowで+ add workflowをクリックしてください。
HubSpotのemailチャネルで会話が開始されたときのパスを設計します。
注意：HubSpot email会話チャネルでは返信オプションとticket作成ステップは利用できません。HubSpot ticketsの唯一の引き継ぎモードはHubSpotでのエージェントへの引き継ぎです。
ステップ4：Finのテスト
本番稼働前に、Finがライブのticketキューに影響を与えずに正しく応答しているかを検証します。方法は2つあります。
オプション1：Finのテスト機能を使用する
Finが参照できるように、knowledge baseに十分なコンテンツを追加していることを確認してください。
Finのテスト機能を使って実際の顧客の質問を投げかけ、Finの応答を確認します。
Finの応答に満足するまで、コンテンツとガイダンスを改善してください。
本格稼働前にAssign New Tickets workflowsの条件を絞り込み、Finが処理するticketを限定できます。これにより、Finがキュー全体を処理することなく、実際のticketでエンドツーエンドのフローをテストできます。
注意：Finがticket（テストticketを含む）に応答するには、統合がLiveに設定されている必要があります。まずステップ5：本番稼働を完了し、その後以下の条件でテスト中にFinが処理するticketを制限してください。
HubSpotでAutomation > Workflows > Fin AI Agent – Assign New Tickets workflowに移動します。
条件を追加：ticketのDescriptionが「FIN test」と等しい。
説明に「FIN test」と入れたテストメールをサポートアドレスに送信します。このticketのみがFinにルーティングされ、他のticketは影響を受けません。
解決、引き継ぎ、プロパティ更新を含むエンドツーエンドのフロー全体を検証します。
本格稼働の準備ができたら、workflowの条件を削除または拡大してください。
プロのヒント：この条件アプローチは段階的展開にも有効で、例えば特定のticketタイプのみをFinにルーティングし、後でキュー全体に拡大することができます。
ステップ5：本番稼働
準備ができたら、デプロイフローでGo liveをクリックします。これにより4つのHubSpot workflowsが有効になり、設定したworkflowとknowledge baseに基づいてFinが即座にticketの処理を開始します。
仕組み
HubSpotのticketフロー
HubSpotでticketが作成され、Assign New Tickets workflowが発動し、Fin AIエージェントに割り当てられます。
webhookがFinに送信されます。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 Status | オープン、保留、解決済み | Finがticketを処理している現在の状態 |
Fin Tags | fin-involved、fin-soft-resolution、fin-hard-resolution、fin-resolved、fin-routed-to-team、fin-failed | ticketがどのように処理されたか（例：解決、チームにルーティング） |
Fin Assignment | fin、human-teammate | 現在ticketを所有しているのがFinか人間のチームメイトか |
HubSpotのネイティブなレポートおよびフィルターツールでこれらのプロパティを使用し、Finの関与度、解決率、引き継ぎパターンをticketパイプライン全体で追跡してください。
Fin Tagsリファレンス
Finはticketのライフサイクル全体でFin Tagsプロパティに以下のタグ値を適用します。
タグ | 意味 |
fin-involved | Finが会話に参加しました。 |
fin-soft-resolution | Finは回答を提供しましたが、ticketは解決済みと確認されませんでした。 |
fin-hard-resolution | 顧客はFinの回答が問題を解決したことを明確に確認しました。 |
fin-resolved | Finはticketを完全に解決しました。 |
fin-routed-to-team | ticketは人間のチームメイトに引き継がれました。 |
fin-failed | Finに割り当てられた進捗のないオープンticketに1時間以内に追加されます。Finが何のアクションも取らない場合（例：解決、ルート、応答しない）にticketが停滞するのを防ぎます。 |
無効化または取り消し
無効化
設定を失うことなく統合を一時停止します。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を割り当てていることを確認してください。
接続状況：メインナビゲーションのConnectに移動して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同期のみで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-hard-resolution — 顧客はFinの回答が問題を解決したことを明確に確認しました。
fin-resolved — Finはticketを完全に解決しました。
fin-routed-to-team — ticketは人間のチームメイトに引き継がれました。
fin-failed — Finに割り当てられた進捗のないオープンticketに1時間以内に追加されます。Finが何のアクションも取らない場合（例：解決、ルート、応答しない）にticketが停滞するのを防ぎます。
これらはすべてのFin統合で使用される同じタグ値です。