Troubleshoot Workflowsツールを使用してトリガー設定を確認し、特定の会話やticketでワークフローが実行された理由、または実行されなかった理由を理解します。

このツールは次のことに役立ちます:

各トリガーイベントに対して条件に一致した、または一致しなかったすべてのworkflowsを確認します。
どのworkflow条件が満たされたかを理解します。
ワークスペースから直接自動化の動作をデバッグします。
オーディエンスの誤設定やスケジュールの競合など、workflowの失敗の一般的な理由を理解します。
チャネルの不一致、優先順位の競合、botのインタラクション制限など、workflowのトリガーを妨げる可能性のある問題を特定します。

workflowのトラブルシューティング方法

WorkflowsセクションまたはInboxの会話/ticketから直接workflowのトラブルシューティングができます。

workflowsから

任意の会話やticketのworkflowトリガーをトラブルシューティングできます。

Fin AI Agent > Workflowsに移動します。
上部でTroubleshoot を選択します。
会話またはticketのURLを入力します。
Event type ドロップダウンを使用して、「Customer opened a new conversation in the Messenger」のような会話開始時の特定トリガーや、「Customer sent a message」のような会話中のトリガーに結果を絞り込みます。
Status ドロップダウンを使って、以下のworkflowをフィルタリングできます:
- 条件に一致し、開始された
- 条件に一致したが開始されなかった
- 条件に一致しなかった
トリガーイベントのタイムラインからworkflowを選択して詳細に分析します。

会話から

Inboxの会話やticketから直接Troubleshoot Workflowsツールにアクセスすることもできます。

Inboxで会話またはticketを開きます。
右サイドバーでEdit apps を選択し、Troubleshoot Workflowsアプリをサイドバーにピン留めします。
Troubleshoot をクリックして、この会話/ticketで利用可能なworkflowsを表示・分析します。

注意: マッチングデータは30日間のみ保持されます。

会話の最新アクティビティが30日以上前の場合、workflowトリガーデータは利用できず、サイドバーのアプリは無効になります。
会話の一部が30日以内の場合は、その最近のトリガーイベントのみが表示されます。

仕組み

Troubleshoot Workflowsツールは、会話やticketのすべてのトリガーイベントの時系列タイムラインを表示し、以下を示します:

イベントが発生した順序（Workflows overview pageと同じ優先順位に従います）。
トリガーされたworkflowsには✓ チェックマーク、トリガーされなかったworkflowsには✕ バツ印が付きます。
workflowが顧客向けかバックグラウンドかを示すアイコン。

例えば、この会話は「Customer opened a new conversation in the Messenger」のworkflowに一致して開始されました。しかし、「Customer sent a message」と「Teammate has been unresponsive」のトリガーは、ターゲティング条件が満たされなかったためworkflowは開始されませんでした。

トリガーイベントを選択すると、会話/ticketで条件に一致し、開始されたworkflowsが表示されます。

ここで、設定されたworkflowトリガー設定を確認できます。内容は以下の通りです:

オーディエンスルール: 例：leads対users。
チャネルルール: 例：web、email、WhatsAppなど。
スケジューリングルール: 例：特定の日や時間帯のみ動作するよう設計されたworkflows。

例えば、この会話はleadによって開始されたため、「Customer sent a message」トリガーはオーディエンスがuserに設定されていたため一致しませんでした。

顧客向けworkflowsでは、複数が同じ条件に一致しても最も高い優先順位のworkflowのみが開始されます。

さらに、土曜日の00:00〜08:00 GMTにスケジュールされたworkflowは、土曜日の20:00 GMTなどこの時間外のイベントではトリガーされません。

注意:

これはトリガー設定（workflowの最初のブロック）と一致したかどうかのみを表示し、workflowが完了したか、各ステップが正常に実行されたかはまだ表示しません。
再利用可能なworkflowsは現在Troubleshoot Workflowsツールでサポートされておらず、エラーメッセージが表示されます。
レガシーInboxルールが存在する場合、workflowsに干渉する可能性があります。スムーズな自動化のためにInboxルールの移行を検討してください。
Zapier統合やAPI経由で作成された会話の場合、workflowトリガーには確認済みチャネルが必要です。再利用可能なworkflowsはチャネルの検証を行わないため、これらの会話ではトリガーされません。
同じパスに割り当てステップと再利用可能なworkflowアクション（例：Salesforceへのデータ送信）を含めると、会話が意図したinboxにルーティングされない可能性があります。適切なルーティングのためには、パス内で割り当てのみを使用してください。