---
title: "失敗ハンドラ"
url: https://docs.catalyst.zoho.com/ja/convokraft/help/handlers/failure-handler/
description: "アクション実行中の例外シナリオを処理するためのbot logicを設定できるFailure handlerについて説明します。"
last_updated: 2026-03-30T08:10:30Z
service: ConvoKraft
type: general
---

# Failure Handler

# はじめに

ユーザーの入力メッセージで例外が発生した場合、botはFailure handler関数で設定されたメッセージで応答します。デフォルトの応答メッセージをカスタマイズして独自の返信を行いたい場合は、botの特定のニーズに基づいてFailure Handler関数を設定できます。

Execution関数の[システム定義の入力引数](https://docs.catalyst.zoho.com/ja/convokraft/help/actions//bot-logic/deluge-functions/defining-deluge-functions/#system-defined-input-arguments)に加えて、Failure handler関数には、現在のチャットセッションにおけるユーザーからの最新の応答を格納するString型のuserInputというカスタム引数が含まれています。Failure handler関数は、Execution関数の[returnマップ](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/bot-logic/deluge-functions/execution-function/#return-values)と同様の構造を持つマップを返します。

> **注意:** ConvoKraft botの開発プラットフォームとして**Catalyst functions**または**Webhooks**を選択している場合、コンソールからhandlerを有効にし、handler関数のロジックをIntegration functionまたは設定されたwebhook URLに関連付けられたコードベースでそれぞれ定義できます。

Delugeでのhandler関数の定義の詳細については、[こちらのページ](https://docs.catalyst.zoho.com/ja/convokraft/help/handlers/code-deluge-handlers)を参照してください。

開発プラットフォームとしてFunctionsを選択した場合、Java、Node.js、Pythonスタックの以下のサンプルコードを使用できます：

### Java

```java
import org.json.JSONObject;
import java.io.*;
import java.util.logging.Logger;
public class FailureHandler {
    Logger LOGGER = Logger.getLogger(FailureHandler.class.getName());
    public JSONObject handleFailureRequest(JSONObject reqBody) throws Exception{
        JSONObject jsonResponse = new JSONObject();
        LOGGER.info("Failure Handler : : TODO : " + reqBody.get("todo"));
        jsonResponse.put("message", "Failure Response: Please define this question and try again");
        return jsonResponse;
    }
}
```

### Node.js

```javascript
import logger from "./logger.js";
// 失敗機能を処理する
export default function handleFailure() {
  logger.info('Handling failure request');
  return {
    "message": "Failure Response: Please define this question and try again"
  };
}
```

### Python

```python
import logging
def handle_failure_request():
    #  これは失敗レスポンスハンドラーです。 
    #    関数の実行中にボットが失敗した場合の失敗レスポンスを記述してください。 
    #    失敗メッセージを返す方法は次のとおりです： 
    #       {
    #           'message': '申し訳ありません、問題が発生しました'
    #       }
    #   以下に同じ設定のサンプルコードがあります。
    logging.info('Handling failure request')
    return {
        'message': 'Failure Response: Please define this question and try again'
    }
```