このガイドでは、HubSpotのemail ticketsでのFinのセットアップ手順を説明します。Fin MessengerとHubSpotの連携についてはFin Messenger HubSpot setupをご覧ください。

開始する前に、以下を確認してください：

HubSpotはOAuth2を使用して接続します。トークンは自動更新され、接続が維持されます。

接続後、HubSpotの属性をFinに同期できます。Finは会話のライフサイクル全体でこれらの属性をプッシュ＆プルし、両プラットフォーム間でデータを同期します。これにより、異なるオーディエンスをターゲットにしたり、ticketsを自動分類したり、workflowsで分岐を作成したりできます。

接続が成功すると、Finは自動的に：

展開フローでConfigure your connection to HubSpotをクリックします。設定ページが開き、2つの項目を完了します：Finが動作するHubSpotユーザーを選択（専用アカウントを使用、例：「Fin AI Agent」）、次にパイプラインを選択し、そのステージをFinのticket状態にマッピングします。

ライブ前に、knowledge base、ガイダンス、トーンがFin AI設定で構成されていることを確認してください。ライブになると、Assign New Tickets workflowがすぐにすべての新しいHubSpot ticketsをFinにルーティングし、構築したworkflowに基づいてFinが回答し引き継ぎます。

ライブ前に、Finがライブのticketキューに影響を与えずに正しく応答しているか検証してください。方法は2つあります：

完全にライブにする前に、Assign New Tickets workflows の条件を絞り込むことで、Fin が処理してほしい tickets のみを選択できます。これにより、Fin がキュー全体を取得することなく、実際の tickets でエンドツーエンドのフローをテストできます。

準備ができたら、デプロイフローで Go live をクリックしてください。これにより4つの HubSpot workflows がすべて有効になり、設定した workflow と knowledge base に基づいて Fin が即座に受信 tickets の処理を開始します。

Fin は各 ticket のライフサイクルを通じて3つのカスタム HubSpot プロパティを自動的に更新し、Fin の動作を完全に可視化します：

HubSpot のネイティブなレポートおよびフィルターツールでこれらのプロパティを使用し、Fin の関与度、解決率、引き継ぎパターンを ticket パイプライン全体で追跡してください。

Fin は ticket のライフサイクルを通じて Fin Tags プロパティに以下のタグ値を適用します：

設定を失うことなく統合を一時停止します。Finがチケットを処理するのを一時的に停止したい場合に使用してください。

統合の完全な解体。

Finがticketsを取得しない場合は、以下を確認してください。

専用の「Fin AI」ユーザーがエージェントリストに見つからない場合は、そのユーザーがHubSpotで正しい権限を持つ有効なサポートシートを持っているか確認してください。

Finがチケットを処理中に介入する必要がある場合、返信前にFinの割り当てを手動で解除しないでください。先にFinの割り当てを解除すると、Finはチケットに割り当てられていないため、受信メッセージを処理しません。

代わりに、割り当てを変更せずにHubSpotで直接返信してください。Finはチームメンバーの返信を検知し、自動的に後退します。これにより、追加の返信は送信されず、Finタグが引き継ぎを反映するように更新されます。