このガイドを使って、Finが接続されているのにHubSpot ticketsに返信しない理由を診断してください。以下のチェックを順番に進め、最初に問題が見つかったところで止めてください。最後には原因を特定し修正できます。これらの手順を完了するには、FinのワークスペースとHubSpotの両方で管理者アクセスが必要です。
始める前に
まず以下の3つの質問に答えてください。これでほとんどの原因を1分以内に除外できます。
すべてのticketですか、それとも一部だけですか？ あるチャネルは機能し、別のチャネルが機能しない場合、接続は問題ありません。問題はそのチャネルの設定にあります。
以前は動作していて、今は止まっていますか？ 以下のチェック3（Service Seat）から始めてください。seatの変更や削除が最も一般的な原因です。
返信が遅いだけで、届いていないわけではありませんか？ Finは通常数秒で返信します。20分以上の一貫した遅延は設定の問題ではありません。サポートに連絡してください。
1. Fin AI Agent workflowsがオンになっているか確認する
HubSpot → Automation → Workflowsで、Finが作成したworkflowsを探してください。HubSpot TicketsにはAssign New Ticketsを含む5つあります。そのworkflowがオフなら、それが原因です。
チャネルごとにworkflowsのセットが異なるため、数を数えて診断しないでください。
HubSpot Tickets — Assign New Ticketsを含む5つのworkflows
Fin Messenger — 4つのworkflows。正しくAssign New Tickets workflowはありません。
WhatsApp — 独自に2つの追加workflowsを持ちます。
手動でworkflowsをオフにした場合、個別にオンに戻さないでください。チャネルのデプロイエリアでPauseしてからGo liveを使ってください。これで全てがきれいにリセットされます。
重要： Fin AI Agent workflowsの名前変更、編集、削除はしないでください。Finが同期を保つため、手動変更は上書きされ、ticketの更新が停止する可能性があります。
2. パイプラインステージのマッピングが完了しているか確認する
4つのFin状態すべてがパイプラインの実際のステージを指している必要があります。どれかが未マッピングだと、Finはticketを正しく更新できず、処理を停止することがあります。
New ticket — Finが新しいticketsを取得するために監視するステージ
Waiting on customer — Finが顧客の返信を待つ間、ticketをここに移動します
Waiting on your team — Finが人間のチームメイトに引き継ぐ際にticketをここに移動します
Resolved — Finが会話を解決したときにticketをここに移動します
マッピングを確認するには、Deploy → HubSpot Tickets → Configure your connection to HubSpotに移動してください。4つの状態のいずれかでステージが選択されていなければ、正しいステージにマッピングして保存してください。
3. FinユーザーにService Seatがあるか確認する
FinがHubSpotで操作するユーザー（例：Fin AI Agent）にはService Seatが必要です。これはService Hub機能（ticket処理を含む）へのアクセス権を与えるHubSpotのseatタイプです。これがないと、Assign New Tickets workflowはエラーを表示せずに静かに失敗します。
確認するには、HubSpot → Settings → Users & Teams → Usersに行き、Fin AI Agentユーザーを開いてください。Seats列でService Seatが割り当てられているか確認します。なければ、または変更されていれば、復元して新しいテストticketを送信し、Finが取得するか確認してください。
4. Finがticketの所有者であるか確認する
HubSpot Ticketsでは、Finは所有しているticketsにのみ対応します。会話の所有者であるだけでは不十分で、Finはticket ownerでなければなりません。
影響を受けているticketをHubSpotで開き、ticket ownerフィールドを確認してください。Finがticket ownerでなければ、Assign New Tickets workflowがFin AI Agentユーザーにticket所有権を割り当てているか確認してください。
5. ご自身のスキルベースルーティングを確認する
HubSpotのルーティングはFinより先に実行されます。既存のルーティングルールのいずれかがticketを先に取得すると、Finは所有権を取れません。
確認するには、HubSpot → Settings → Inbox → Inboxesに行き、サポートパイプラインに接続されている各inboxを開き、設定されているルーティングルールを確認してください。また、HubSpot → Automation → Workflowsで、Assign New Ticketsが実行される前にticket所有権を割り当てるworkflowがないかも確認してください。ルールがticketを横取りしている場合は、その条件を調整するか、順序を早めてFinのAssign New Tickets workflowが最初に実行されるようにしてください。変更後、新しいテストticketを送信し、Finが所有権を取るか確認してください。
返信がないように見えるが実際はそうでない2つの状況
Finは返信したが、顧客に届いていない。 Finの返信がFin上では見えるがHubSpot ticketスレッドにない場合、設定の問題ではありません。Finの会話IDとHubSpot ticket IDを添えてサポートに連絡してください。
ticketに会話スレッドがない。 Finは会話に返信するため、workflowで作成されたticket、インポートされたticket、またはレコード上で直接作成されたticketには返信できません。これは主にフォームに影響します。詳細はWhat Fin can and can't do on HubSpotを参照してください。
よくある質問
上記をすべて確認したがFinがまだ返信しない。次は？
以下を添えてサポートに連絡してください：HubSpot ticket ID、Fin会話ID（作成されていれば）、パイプラインステージマッピングのスクリーンショット、有効なworkflowsの確認。これでサポートチームは迅速に調査できます。
完全に運用開始する前に、少数のticketsでFinをテストできますか？
はい。Assign New Tickets workflowにフィルターを追加し、特定の条件（例：Descriptionが"FIN test"）に合致するticketsのみFinが取得するようにしてください。準備ができたらフィルターを削除または緩和してください。詳細なテスト手順はFin for HubSpot tickets: Setupを参照してください。
workflowを個別にオフ・オンすると問題が起きますか？
起こる可能性があります。個別の切り替えはworkflowsを不整合な状態にすることがあります。必ずFinのチャネルのデプロイエリアでPauseしてからGo liveを使ってください。これで全workflowsがきれいにリセットされます。
なぜFinはあるチャネルでは返信するが、別のチャネルではしないのか？
各チャネル（HubSpot Tickets、Fin Messenger、WhatsApp）には独自のworkflowsセットがあります。Finがあるチャネルで動作し、別のチャネルで動作しない場合、問題はそのチャネルのworkflow設定に限定されます。影響を受けるチャネルで正しいworkflowsが有効になっているか確認してください。