--- title: "フォールバックハンドラ" url: https://docs.catalyst.zoho.com/ja/convokraft/help/handlers/fallback-handler/ description: "ConvoKraftがユーザーメッセージを理解できないシナリオに対してbot応答を設定できるfallback handlerについて説明します。" last_updated: 2026-03-30T08:10:30Z service: ConvoKraft type: general --- # Fallback Handler # はじめに botが理解できない入力メッセージを受信した場合、botはfallback handler関数で設定されたメッセージで応答します。デフォルトの応答メッセージをカスタマイズして独自の返信を行いたい場合は、botの特定のニーズに基づいてfallback handler関数を設定できます。 Execution関数の[システム定義の入力引数](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/bot-logic/deluge-functions/defining-deluge-functions/#system-defined-input-arguments)に加えて、Fallback Handler関数には、現在のチャットセッションにおけるユーザーからの最新の応答を格納するString型の`userInput`というカスタム引数が含まれています。Fallback handler関数は、Execution関数の[returnマップ](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/bot-logic/deluge-functions/execution-function/#return-values)と同様の構造を持つマップを返します。 > **注意:** 1. ConvoKraft botの開発プラットフォームとして**Catalyst functions**または**Webhooks**を選択している場合、コンソールからhandlerを有効にし、handler関数のロジックをIntegration functionまたは設定されたwebhook URLに関連付けられたコードベースでそれぞれ定義できます。 2. fallback handler関数の成功シナリオの応答ステータスは、`handled`として設定する必要があります。設定しない場合、ステータスは失敗とみなされます。関数の返却応答は、fallback function handlerで設定されたロジックに依存します。これはCatalyst functionsとWebhooksの両方に適用されます。 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 FallbackHandler { Logger LOGGER = Logger.getLogger(FallbackHandler.class.getName()); public JSONObject handleFallbackRequest(JSONObject reqBody) throws Exception{ JSONObject jsonResponse = new JSONObject(); LOGGER.info("Fallback Handler : : TODO : "+ reqBody.get("todo")); jsonResponse.put("message", "Fallback Response: Please define this question and try again"); return jsonResponse; } } ``` ### Node.js ```javascript import logger from "./logger.js"; // フォールバック機能を処理する export default function handleFallback() { logger.info('Handling fallback request'); return { "message": "Fallback Response: Please define this question and try again" }; } ``` ### Python ```python import logging def handle_fallback_request(): # これはフォールバックレスポンスハンドラーです。 # ボットがユーザーへの応答方法を知らない場合のフォールバックレスポンスを記述してください。 # フォールバックメッセージを返す方法は次のとおりです: # { # 'message': 'フォールバックレスポンス:この質問を定義してもう一度お試しください' # } # 以下に同じ設定のサンプルコードがあります。 logging.info('Handling fallback request') return { 'message': 'Fallback Response: Please define this question and try again' } ```