--- title: "Catalyst 統合ファンクション" url: https://docs.catalyst.zoho.com/ja/convokraft/help/actions/bot-logic/catalyst-integration-functions/ description: "Catalyst Integration Functionsについて学び、ConvoKraft BotのBusiness Logicをコーディングするために使用する方法を説明します。" last_updated: 2026-08-17T12:16:04Z service: ConvoKraft type: general --- # Catalyst Integration Functions # はじめに Catalyst Integration Functionsを使用すると、他のZohoまたはCatalystサービスのBusiness Logicをコーディングし、2つのサービス間の統合を確立するためのバックエンドとして使用できます。関連するサービスで特定の機能にアクセスすると、HTTP呼び出しを通じてCatalystでコーディングされたIntegration Functionの実行が自動的に呼び出されます。Catalystがサポートする以下のプラットフォームで、サービスのバックエンド機能のBusiness Logicをコーディングできます： * **Java** * **Node.js** * **Python** ConvoKraft Bots用にCatalyst Functionsで構築するBusiness LogicはBot Logicと呼ばれ、Integration Function型です。CLIから[Catalyst Integration Functionを初期化](https://docs.catalyst.zoho.com/ja/cli/v1/initialize-resources/initialize-functions/)し、ローカル環境で作業し、[サーブ](https://docs.catalyst.zoho.com/ja/cli/v1/serve-resources/serve-all-resources/#serve-functions-and-basic-web-applications)してテストするか、リモートコンソールに[デプロイ](https://docs.catalyst.zoho.com/ja/cli/v1/deploy-resources/deploy-functions/)できます。その後、作成するBotに関数を関連付けることができます。 Catalyst Integration Functionsを使用する場合、[Catalyst Logs](https://docs.catalyst.zoho.com/ja/devops/help/logs/introduction/)や[Application Performance Monitoring](https://docs.catalyst.zoho.com/ja/devops/help/apm/introduction/)を通じて関数実行のログやレポートを表示できる、他のCatalyst機能も活用できます。 Catalyst Integration Functionsの詳細については、[こちらのページ](https://docs.catalyst.zoho.com/ja/serverless/help/functions/integration-functions/)をご覧ください。 ### ConvoKraft Integration ConvoKraft Integration Functionsを使用すると、ConvoKraft BotsのBusiness Logicをコーディングし、以下のConvoKraftハンドラーを通じてバンドルできます： **1. [Welcome Message Handler](https://docs.catalyst.zoho.com/ja/convokraft/help/handlers/welcome-message-handler)**：新しいチャットセッションを開く際に表示される応答を設定できます。 **2. [Fallback Handler](https://docs.catalyst.zoho.com/ja/convokraft/help/handlers/fallback-handler)**：Botがユーザーの入力を理解できなかった場合に表示される応答を設定できます。 **3. [Failure Handler](https://docs.catalyst.zoho.com/ja/convokraft/help/handlers/failure-handler)**：会話中のユーザーのメッセージで例外が発生した場合に表示される応答を設定できます。 ### 関数構造 Integration Functionを作成すると、CatalystはBusiness Logicを構築するためのボイラープレートテンプレートコードを提供します。**Java**、**Node.js**、**Python**プログラミング環境でBusiness Logicを構築するために、それぞれのテンプレートを使用できます。Catalystでサポートされているすべてのスタックの完全な関数ディレクトリ構造の詳細については、[こちらのページ](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/functions-directory/)を参照してください。 Integration FunctionをCatalystで作成する方法の詳細については、後述の[こちら](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/bot-logic/catalyst-integration-functions/#implementation)で説明します。 ## Java Javaファイル構造には、メインJavaファイル、Action実行のコアBusiness Logicを保持するExecuteHandlerファイル、およびその他のハンドラーと設定ファイルが含まれます。 ![java-structure](https://catalyst-docs-development.zohostratus.in/images/help/convokraft/java-structure.webp) 上記のファイルとボイラープレートテンプレートコードは、CLIから`ConvoKraft`型のJava Integration Functionを初期化すると、関数ディレクトリに自動的に利用可能になります。CLIからCatalyst関数を初期化する方法の詳細については、[こちらを参照](https://docs.catalyst.zoho.com/ja/cli/v1/working-with-functions/set-up-functions/)してください。 初期化が完了したら、Bot Logicのコーディングに進み、[ローカルでテスト](https://docs.catalyst.zoho.com/ja/cli/v1/serve-resources/serve-all-resources/#serve-functions-and-basic-web-applications)してから[Catalyst Functionをデプロイ](https://docs.catalyst.zoho.com/ja/cli/v1/deploy-resources/deploy-functions/)できます。 ## Node.js Nodeファイル構造には、メイン関数ファイルとハンドラーファイル、ノードモジュール、設定ファイルが含まれます。 ![nodejs-structure](https://catalyst-docs-development.zohostratus.in/images/help/convokraft/nodejs-structure.webp) 上記のファイルとボイラープレートテンプレートコードは、CLIまたはコンソールから`ConvoKraft`型のNode.js Integration Functionを初期化すると、関数ディレクトリに自動的に利用可能になります。[こちら](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/bot-logic/catalyst-integration-functions/#implementation)に記載された手順に従って、CatalystコンソールからConvoKraft Integration Functionを作成できます。 CLIからCatalyst関数を初期化する方法の詳細については、[こちらを参照](https://docs.catalyst.zoho.com/ja/cli/v1/working-with-functions/set-up-functions/)してください。 初期化が完了したら、Bot Logicのコーディングに進み、[ローカルでテスト](https://docs.catalyst.zoho.com/ja/cli/v1/serve-resources/serve-all-resources/#serve-functions-and-basic-web-applications)してから[Catalyst Functionをデプロイ](https://docs.catalyst.zoho.com/ja/cli/v1/deploy-resources/deploy-functions/)できます。 ## Python JavaおよびNode.jsと同様に、Pythonファイル構造にはメイン関数ファイル、ハンドラー関数ファイル、設定ファイル、および追加でPythonモジュールファイルが含まれます。 `requirements.txt`ファイルには、Catalyst Python関数を実装するために必要なインストール済み依存関係のリストが含まれています。`requirements.txt`ファイルの使用方法の詳細については、[こちらのページ](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/functions-directory/#python-modules-and-function-dependencies)をご覧ください。 ![python-structure](https://catalyst-docs-development.zohostratus.in/images/help/convokraft/python-structure.webp) Java関数と同様に、Catalyst CLIからPython関数を初期化できます。`ConvoKraft`型のPython Integration Functionを初期化すると、上記のファイルとボイラープレートテンプレートコードがローカル環境の対応する関数ディレクトリに自動的に利用可能になります。 初期化が完了したら、Bot Logicのコーディングに進み、[ローカルでテスト](https://docs.catalyst.zoho.com/ja/cli/v1/serve-resources/serve-all-resources/#serve-functions-and-basic-web-applications)してから[Catalyst Functionをデプロイ](https://docs.catalyst.zoho.com/ja/cli/v1/deploy-resources/deploy-functions/)できます。 > **注意:** コンソールエディタから直接JavaおよびPython関数をコーディングすることはできません。エディタからはNode.js関数のみ作業できます。または、[ローカル環境から](https://docs.catalyst.zoho.com/ja/serverless/help/functions/introduction/#steps-to-work-with-functions-from-a-local-environment)JavaおよびPython関数を作業し、対応するコードバンドルをコンソールに[アップロード](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/bot-logic/catalyst-integration-functions/#implementation)できます。 ### リクエスト形式 ConvoKraftは、Catalyst Integration Functionに以下の形式でリクエストを送信します： ```json { "todo": "prompt || execute || fallback || button", "bot" : "", "action" : "", "button_id" : "", "environment" : "development || production" "params":{ }, "userInput" : "", "previousParam" : "", "user" : {}, "org" : {}, "broadcast" : {}, "cache" : {}, "sessionData" : {} "clientData" : {} } ``` ### レスポンス形式 ConvoKraftは、意図した応答を理解してユーザーに伝えるために、Catalyst Integration Functionからのレスポンスが以下の形式であることを期待します。ConvoKraftは、コンテンツをさまざまな形式で表示するための複数の応答タイプをサポートしています。応答を設定する際は、定義された標準に従う必要があります。応答構造の詳細については、[こちらのセクション](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/define-bot-responses/)を参照してください。 **ケース1**：入力paramをユーザーにプロンプトする必要がある場合 ```json { "status" : "prompt", "prompt" : { "param_name" : "leave_type", "options":[ { "id" : "111" ,"label" : "", "image" : "image_url"}, {"id" : "112" ,"label" :"" ,"image" : "image_url"} ], "buttons" : [] }, "message" : "You don't have enough casual leaves. Please choose some other leave type.", "data" : {} } ``` **ケース2**：出力メッセージをユーザーに表示する必要がある場合 ```json { "status" : "execution", "message":"Please check your screen.", "card":[], "data":{}, "broadcast":{}, "trigger":{}, "followup" : {} } ``` Catalyst Integration Functionから受信するレスポンスには、以下のようないくつかの制限があります： * レスポンスの最大サイズは3 MBです。 * リクエストタイムアウトの最大時間は15秒です。 レスポンスが上記のガイドラインに準拠していない場合、ユーザーへの応答としてエラーメッセージが送信されます。 ### 実装 Catalyst Integration Functionは、CatalystコンソールまたはCLIから作成できます。コンソールからIntegration Functionを作成するには、以下の手順に従ってください。CLIから関数を作成する手順については、[こちらのページ](https://docs.catalyst.zoho.com/ja/cli/v1/working-with-functions/set-up-functions/)を参照してください。 1. CatalystコンソールからCatalyst Integration Functionを直接作成するには、Catalystコンソールの左ペインの**Serverless**アイコンに移動し、**Create Function**をクリックします。 ![create-integration-function](https://catalyst-docs-development.zohostratus.in/images/help/convokraft/create-integration-function.webp) 2. 意味のある関数名を入力し、Function Typeとして`Integration`を選択し、Zoho Serviceとして`ConvoKraft`を選択します。**Java**、**Node.js**、**Python**のいずれかのプログラミング環境でロジックをコーディングすることを選択できます。**Create**をクリックして、新しいCatalyst Integration Functionを作成します。 ![create-function-popup](https://catalyst-docs-development.zohostratus.in/images/help/convokraft/create-function-popup.webp) > **注意:** コンソールエディタからJavaおよびPython関数をコーディングすることはできません。Node.js関数のみ作業できます。JavaおよびPython関数は[ローカル環境から](https://docs.catalyst.zoho.com/ja/serverless/help/functions/introduction/#steps-to-work-with-functions-from-a-local-environment)作業し、**File Upload**オプションを使用して対応するコードバンドルをコンソールにアップロードできます。 3. **Code tab**に切り替えて、BotのBusiness Logicの記述を開始できます。 ![functions-overview](https://catalyst-docs-development.zohostratus.in/images/help/convokraft/functions-overview.webp) Business Logicをコーディングした後、**Save**をクリックします。 ![code-tabs](https://catalyst-docs-development.zohostratus.in/images/help/convokraft/code-tabs.webp) ConvoKraft BotのBusiness Logicを開発したら、[Botの作成](https://docs.catalyst.zoho.com/ja/convokraft/help/bots/create-a-bot)時またはBotの詳細ページから後で、適切なCatalyst Integration Functionを開発プラットフォームとしてマッピングできます。関連付けられたIntegration Functionは、Botの設定済みActionsの呼び出し時に実行されます。