このガイドでは、HubSpotのemail ticketsでFinを設定する方法を説明します。Fin MessengerとHubSpotの連携については、Fin Messenger HubSpotセットアップをご覧ください。
前提条件
始める前に、以下を確認してください。
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は会話のライフサイクル全体でこれらの属性をプッシュおよびプルし、両プラットフォーム間でデータを同期します。これにより、異なるオーディエンスをターゲットにしたり、ticketsを自動分類したり、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が新しいticketsを監視して取得するステージ | 新規 |
顧客待ち | 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 conversationsチャネルでは返信オプションとticket作成ステップは利用できません。HubSpot ticketsの唯一の引き継ぎモードはHubSpotでのエージェントへの引き継ぎです。
ステップ4：Finをテストする
本番稼働前に、Finがライブのticketキューに影響を与えずに正しく応答していることを検証します。方法は2つあります。
オプション1：FinのTest機能を使う
Finが参照できるように、knowledge baseに十分なコンテンツを追加していることを確認してください。
FinのTest機能を使って実際の顧客の質問を投げかけ、Finの応答を確認します。
Finの応答に満足するまで、コンテンツとガイダンスを改善してください。
完全に本番稼働する前に、Assign New Tickets workflowsの条件を絞り込むことで、Finが処理するticketを限定できます。これにより、Finがキュー全体を処理することなく、実際のticketでエンドツーエンドのフローをテストできます。
注意：Finがticketに応答するには統合がLiveに設定されている必要があります（テストticketも含む）。まずステップ5：Go liveを完了し、その後以下の条件でFinがテスト中に処理するticketを制限してください。
HubSpotでAutomation > Workflows > Fin AI Agent – Assign New Tickets workflowに移動します。
条件を追加：ticketのDescriptionが「FIN test」と等しい。
説明に「FIN test」と入れたテストメールをサポートアドレスに送信します。このticketのみがFinにルーティングされ、他は影響を受けません。
解決、引き継ぎ、プロパティ更新を含むエンドツーエンドのフローを検証します。
本番稼働の準備ができたら、workflowの条件を削除または拡大してください。
プロのヒント：この条件アプローチは段階的展開にも有効で、例えば特定のticketタイプのみをFinにルーティングし、後でキュー全体に拡大できます。
ステップ5：本番稼働
準備ができたら、デプロイフローでGo liveをクリックします。これにより4つのHubSpot workflowsが有効になり、設定したworkflowとknowledge baseに基づいてFinが即座にticketの処理を開始します。
仕組み
HubSpotのticketフロー
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 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に割り当てられた進捗のないopen ticketsに1時間以内に追加されます。Finが何のアクションも取らなかった場合（例：解決、ルーティング、応答しない）にticketが停滞するのを防ぎます。 |
ヒント: これらのタグが実際にどのように動作するか、なぜfin-resolvedが会話終了前に発動することがあるのか、そして自動化の誤作動を防ぐ方法については、FinのHubSpotタグと自動化の早期発動防止をご覧ください。
無効化または取り消し
無効化
設定を失うことなく統合を一時停止します。Finがticketを処理するのを一時的に停止したい場合に使用してください。
4つのHubSpot workflowsがすべて無効化されています。
設定とフィールドマッピングは保持されます。
取り消し
統合の完全な解体。
すべてのHubSpot workflowsが削除されます。
OAuth接続が破棄されます。
重要: 取り消しには再接続のための完全な再設定が必要です。一時的な停止が必要な場合は無効化を使用してください。
トラブルシューティング
FinがHubSpot ticketsに応答していません。
Finがticketsを取得していない場合は、以下を確認してください。
HubSpot Workflows: HubSpotでAutomation > Workflowsに移動し、4つのFin workflowsがすべて有効になっていることを確認してください。
割り当て: Assign New Tickets workflowが指定されたFin AIエージェントユーザーに正しくticketsを割り当てていることを確認してください。
接続状況: メインナビゲーションのConnectに移動してOAuth接続がまだ有効か確認してください。期限切れの場合は再認証してください。
Fin Workflow: ワークスペースのFin workflowがLiveに設定されていることを確認してください。
これらのチェックの詳細なステップバイステップの説明、チャネル別workflow数、サービスシート要件、ticket所有権、沈黙のように見えるエッジケースについては、なぜFinはHubSpot ticketsに返信しないのかをご覧ください。
HubSpotユーザーがセレクターに表示されない
専用の「Fin AI」ユーザーがエージェントリストに見つからない場合は、そのユーザーがHubSpotで正しい権限を持つ有効なsupport seatを持っているか確認してください。
Finからの会話の引き継ぎ
Finがticketを処理中に介入する必要がある場合、返信する前にFinの割り当てを手動で解除しないでください。先にFinの割り当てを解除すると、ticketに割り当てられていないため、Finは受信メッセージを処理しません。
代わりに、割り当てを変更せずにHubSpotで直接返信してください。Finはチームメイトが返信したことを検知し、自動的に退きます。これ以上返信せず、Finタグを引き継ぎを反映するように更新します。
ticketのメール署名の設定方法
FinのHubSpot ticketsへの返信にメール署名を追加できます。署名はticketの返信にのみ追加され、チャット会話には表示されません。
メール署名を設定するには、設定 > 返信設定 > Finのメール返信に移動し、署名をカスタマイズをクリックしてください。
そこから以下ができます：
署名にテキスト、リンク、書式を追加する
ロゴ（PNG、JPG、GIF、1MB未満）をアップロードし、その位置とサイズを調整する
保存前に署名をプレビューする
制限事項
同期できる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 ticketsにどのタグ値を適用しますか？
FinはHubSpot ticketsにどのタグ値を適用しますか？
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 — 1時間以内に進展のないFinに割り当てられたopen ticketsに追加されます。Finが何のアクションも取らなかった場合（例：解決、ルーティング、応答しない）にticketが停滞するのを防ぎます。
これらはすべてのFin統合で使用される同じタグ値です。