メインコンテンツにスキップ

Zendesk tickets向けFin:よくある質問

なぜZendeskでエージェントが関与しているのに会話が「deflected」とマークされるのですか?

Finでは、Finが解決した場合や返信が不要と自動判断した場合(通常は受信メッセージがjunkまたはspamと判定された場合)に、会話がdeflectedとしてマークされます。これはエージェントが対応する前に起こります。

Zendeskでチケットにエージェントが割り当てられて内部メモを追加したり再割り当てしたりしていても、公開返信が送信されず、Finが以前にメッセージをspamと判定していれば、その会話はFinのレポートでdeflectedとしてカウントされます。

仕組みは以下の通りです:

  • Finのspam検出機能が特定のメッセージをjunk/spamと判定し、返信しないことを選択します。

  • この処理により、会話はFinのレポート(例:Custom Report)でdeflectedとしてマークされます。

  • しかし、Zendeskは通常通りチケット処理を続けます。つまり:

    • エージェントが割り当てられることができます。

    • 内部メモを追加できます。

    • チケットは通常のサポートworkflowsを通過できます。

この設定により、Finは潜在的に有害または無関係な内容への対応を避けつつ、チームは誤判定されたものを確認・対応するための完全な可視性と管理権限を保持できます。

Zendeskのチケットフィールド名を更新したのに、workflow作成時に古い名前が表示されます。どうすれば直せますか?

Zendeskでチケットフィールド名を変更してもFinのworkflowビルダーに反映されない場合は、統合を手動で再同期する必要がある可能性があります。

チケットフィールド名を更新するには:

  1. FinのワークスペースでSettings > Zendesk Integrationに移動します。

  2. Topicsをクリックします。

  3. Re-syncをクリックします。

  4. その後、ブラウザを更新してください。

これにより、workflowビルダーを含むFinプラットフォーム全体でチケットフィールド名がZendeskの最新名に更新されます。

なぜFinの会話タグがFin Custom Reportに表示されないのですか?

これは想定された動作です。Finワークスペース内の会話タグは、FinがZendeskに適用するタグとは異なります。

FinがZendesk ticketsと連携すると、ルーティングやレポートに役立つ特定のタグをZendesk内で自動的に適用します:

  • fin-involved – Finに割り当てられた会話に追加されます。

  • fin-resolved – Finがチケットを解決したときに追加されます(ソフトまたはハード解決)。

  • fin-soft-resolution – 顧客がまだ確認していないFinによる解決を示します。

  • fin-hard-resolution – 顧客がFinの回答が役立ったと確認したときにfin-soft-resolutionに代わって適用されます。

  • fin-routed-to-team – Finが会話を人間のチームメイトに引き継いだときに追加されます。

ただし、これらのタグはFinワークスペース内には表示されず、Fin Custom Reportの「Conversation tag」フィルターにも含まれません。そのセクションに表示されるタグは、Finワークスペース内で手動で作成・適用したもののみです。

Fin Custom Reportには、Finの動作に基づく関与、解決率、チームへの引き継ぎの内訳が含まれていますが、Zendeskタグに基づくものではありません。

fin-involvedやfin-resolvedのようなタグでレポートをフィルターしたい場合は、それらのタグが適用されているZendeskのレポートツールで直接行うことができます。

なぜチケットがFinに割り当てられているのにテストメールを送ってもFinが返信しないのですか?

重要:Finは現在割り当てられているチケットにのみ返信するよう設計されています。したがって「Finが返信しない」と見える場合、それは意図された動作かもしれません。何か(通常はZendeskのトリガー)がチケットの割り当てをFinから外している可能性があります。

テストチケットがFinに割り当てられているのに返信がない場合、最も可能性が高い理由はZendeskのworkflowのステップ不足か、Finが返信に使える関連知識が不足していることです。

処理時間の目安

Finは通常、メールでの返信生成に30〜60秒かかります。チケットをFinに割り当てた後、十分な時間を待ってから調査してください。

確認手順

  1. Finワークスペースの会話イベントを確認し、Finの処理が開始されていることを確認してください。

  2. ワークスペースがZendeskなどのサポート対象プラットフォームと統合されていることを確認してください。サポート対象外の統合はFinの自動化を完全に回避する可能性があります。

以下の点を再確認してください:

  1. Finへの割り当て:トリガーが機能してチケットがFinに割り当てられていれば問題ありません。この場合、Finはfin-involvedタグを適用します。そのタグが表示されない場合は、Finがチケットに対してアクションを起こしていない可能性があります。

  2. 「Let Fin answer」ステップ:workflowに「Let Fin answer」ステップが明示的に含まれている場合にのみFinは返信します。このステップがなければ、チケットが正しく割り当てられていてもFinは返信しません。

  3. コンテンツアクセス:設定が正しくてもFinが返信しない場合、Finが回答に使える関連コンテンツを持っていない可能性があります。Help CenterやFin knowledge baseでカバーされている質問を送ってテストできます。Zendesk用の詳細セットアップガイドはこちらです:Fin for Zendesk Tickets – Set Up

  4. Fin割り当てトリガーが有効で割り当てを行っている

    • FinワークスペースでSettings > Zendesk triggers for Finに移動し、サイドバイサイドの差分表示でトリガーを確認してください。これにより、Zendeskの実際の設定と期待される設定を比較でき、トリガーがInactive、変更されている、または誤設定されているかがわかります。

    • またはZendeskでFin作成のトリガーを確認し、Inactive、変更、順序違いがないかをチェックしてください。

    • 新しいチケットをFinに割り当てるトリガー(通常「Assign to Fin」などと名付けられています)から始めて、新規チケット作成時に発動していることを確認してください。

  5. 他のトリガーがFinの割り当てを解除していない

    • 他のZendeskトリガーや自動化で、Finに割り当てた後にAssigneeを変更(またはチケットをFinエージェントから移動)するアクションがないか確認してください。

    • これは予期せず発動する「failsafe」やルーティングトリガーも含みます。

リブランディング後に接続されたZendeskサブドメインをどのように切り替えますか?

組織がリブランディングを行いZendeskのdomainが変更された場合、新しいZendeskサブドメインに接続するためにFinのワークスペースを更新する必要があります。以下の手順に従ってください:

  1. アクティブなチャネルでFinを一時停止:更新中の中断を避けるため、ライブチャネルでFinが一時停止されていることを確認してください。

  2. Deployに移動:Deploy > Zendesk ticketsに移動します。

  3. 新しいサブドメインに接続:

    • 「Connect to the Zendesk API」セクションで、Connectを選択します。

    • 新しいサブドメインを入力します(例:古いdomainを新しいものに置き換えます)。

    • Zendeskのメールアドレスと新しいAPIトークンを入力してください。トークンはZendeskのAdmin Center:Apps and integrations > APIs > Add API tokenから生成できます。

  4. 更新を完了:新しい統合を確定するためにConnect to the Zendesk APIをクリックします。

最後に、Finのワークスペースの内容を確認してください:

  • もはや関連のない古いZendeskサブドメインに紐づくインポートまたは追加されたコンテンツを削除します。

  • 新しいZendesk domainに関連する更新されたコンテンツを追加します。

これらの手順に従うことで、Finのワークスペースを新しいZendesk domainにシームレスに切り替え、一貫したサポート体験を維持できます。

Finを使ってサポートアドレスに送られた直接メールに返信できますか?

はい。support@example.comへの直接メールがZendeskでticketを作成する場合、Finはそれらに返信できます。ticketが作成されると(ウェブフォームまたは直接メールから)、ワークフローのLet Fin handleステップでFinに割り当てることができます。Finはticketの発信元チャネルを使ってメールで顧客に返信します。

トラブルシューティングのためにZendesk APIを切断して再接続した場合、ZendeskでFin用に設定されたトリガーはどうなりますか?

最近Zendeskを切断/再接続した場合、Finは必要なトリガーを再作成します。そのため、どのトリガーが有効か、カスタマイズが上書きまたは重複していないかを再確認する価値があります。各トリガーの詳細については、Understanding Fin's Zendesk Triggersを参照してください。

切断と再接続の間に何が起こるか

  • Finは統合設定の一環としてZendeskトリガーを作成します。これには割り当て、会話の更新、解決、フェイルセーフアクションのトリガーが含まれます。

  • APIの再接続はFinのZendeskトリガーを再作成します。再接続時にFinはZendeskエージェントのIDを選択するよう促し、Zendeskで必要なトリガーを(再)作成します。

  • カスタマイズされたトリガーは影響を受ける可能性があります。以前にFinのデフォルトZendeskトリガーをカスタマイズしていた場合、再接続時に上書きまたは重複する可能性があります。再接続後、Settings > Zendesk triggers for Finに移動し、サイドバイサイドの差分ビューでトリガーを確認してください。これにより期待される設定とZendeskの実際の設定が比較でき、変更点の特定やカスタマイズの再適用が容易になります。

  • 再接続時にOAuthが必要になる場合があります。ZendeskはAPIトークン認証を廃止しています。まだOAuthに切り替えていない場合、再接続にはOAuthが必要で、OAuthが有効になるまでFinのワークスペースに永続的なバナーが表示されます。

  • Finのworkflowsは保持されます。Zendesk APIの切断と再接続はFinのworkflowsを削除またはリセットしません。変更前にワークフロー設定を記録することを推奨します。

  • ZendeskトリガーはFinではなくZendeskで管理されます。Finと連携する追加のZendeskトリガーや自動化がある場合、再接続後にその状態を再確認してください。

ベストプラクティス

  • 切断前にアクティブなチャネルでFinを一時停止し、予期しないticket処理を避けてください。

  • 再接続後にZendeskトリガーを確認およびテストし、割り当て、解決、フェイルセーフの動作が期待通りか確認してください。Settings > Zendesk triggers for Finのサイドバイサイド差分ビューを使い、すべてのトリガーが期待される設定と一致しているか素早く検証できます。

  • Zendeskの依存関係の問題に注意してください。切断時にエラーが発生した場合(例えばトリガーの依存関係による)、再接続前にZendeskトリガーや統合の調整や順序変更が必要になることがあります。

FinがZendeskのticketsやフォローアップに応答しない場合、どのようにトラブルシューティングできますか?

Finが応答しない一般的なシナリオ

  1. Finが解決済みticketのフォローアップコメントに返信しない

    Finが「solved」とマークされたticketのフォローアップコメントに返信しない場合、以下を確認してください:

    • フォローアップコメントの種類を確認:Finは公開コメントにのみ返信します。コメントがプライベート/内部としてマークされている場合(Zendeskにリンクされたエージェントのメールアドレスから送信された場合に一般的)、Finは返信しません。非エージェントのメールを使ってコメントが公開されているかテストしてください。

    • Zendeskトリガーを確認:ticketステータスが「solved」の場合でもFinに通知するよう設計されたZendeskトリガーが適用されていることを確認してください。さらに、ticketがsolvedにマークされた後もFinが割り当てられていることを確認してください。

  2. Finが割り当てられたticketに応答しない

    ticketがFinに割り当てられているが応答がない場合、以下を確認してください:

    • アクティブなZendeskトリガー:「Finに割り当てられた会話に更新がある場合、Finに通知する」トリガーが有効であることを確認してください。このトリガーがないと、ticketに変更があってもFinは更新されません。

    • 必要なFinトリガー:新しいticketをFinに割り当てるトリガーなど、必要なFinトリガーが有効であることを確認してください。

Finの会話から作成されたZendesk ticketsに会社名を表示させるにはどうすればよいですか?

Zendesk ticketの会社名はFinのワークフロー設定内の変数を使って入力されます。ただし、この変数は会話に関わるユーザーがFinで会社に関連付けられている場合にのみ名前を取得できます。関連付けがない場合、会社名フィールドには代替値が表示されます(代替値が設定されている場合)。

Zendesk ticketsに会社名を確実に表示させるには:

  1. Finでユーザーを会社に関連付ける:会話の前または最中に、ユーザーがFinシステム内で会社に関連付けられているか確認してください。

  2. ワークフロー設定を確認:Finのワークフローが会社名変数を適切に使用して、Zendesk ticketの目的のフィールド(例:件名)を入力していることを確認してください。

  3. 代替値の使用:ユーザーと会社の関連付けがない場合、ワークフローは実際の会社名の代わりに事前設定された代替値をticketフィールドに挿入します。混乱を避けるために代替値を適切に設定してください。

新しいZendesk ticketに引き継ぎ時のエラーメッセージをどう修正しますか?

以下のようなエラーが表示される場合:

"新しいZendesk ticketへの引き継ぎに失敗しました。"

​Intercomのエラー詳細:

​IntercomリクエストID: 00593v4q2hugigda4ptg

​IntercomジョブID: vmulk01gct

​エラーが発生しました。Intercomサポートにお問い合わせください。"

通常、これらの問題の原因となるIP制限があるかどうかを確認してください。制限がある場合、解決方法は2つあります:

  1. 制限を解除するか、

  2. 当社のパブリックIPを許可リストに追加することができます:

    1. US: 34.231.68.152, 34.197.76.213, 35.171.78.91, 35.169.138.21, 52.70.27.159, 52.44.63.161

    2. ​Europe: 54.217.125.63, 54.246.173.113, 54.216.9.3

    3. ​Australia: 52.63.36.185, 3.104.68.152, 52.64.2.165

Fin for Zendeskが統合エラーを検出したときに通知を受け取るには?

エラーが発生した際にFin for Zendeskの統合エラーを通知するには、エラーログのwebhookを追加してください。設定 > エラーログに移動し、WebhookをクリックしてHTTPSエンドポイントURLを追加します。Finは新しいエラーごとに署名付きPOSTリクエストを送信するため、Error logsを手動で確認する代わりにincident.ioやPagerDutyなどのアラートツールに中継できます。

こちらの回答で解決しましたか?