# NodeJS -------------------------------------------------------------------------------- title: "はじめに" description: "Catalyst ConvoKraft、Serverless Integration関数、およびZoho CRMを使用して、ECサイト向けの会話型セールスアシスタントボットを構築します。Webサイトのユーザーと対話し、注文を管理します。" last_updated: "2026-11-03T07:48:52.000Z" source: "https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/introduction/" service: "All Services" related: - Catalyst ConvoKraftアクション (/ja/convokraft/help/actions/overview/introduction) - Catalyst ConvoKraftハンドラー (/ja/convokraft/help/handlers/welcome-message-handler) - Catalyst Serverless Functions (/ja/serverless/help/functions/introduction/) - Catalyst CloudScale Webクライアントホスティング (/ja/cloud-scale/help/web-client-hosting/introduction/) -------------------------------------------------------------------------------- # Ecommerce Bot ### はじめに このチュートリアルでは、[Catalyst ConvoKraft](https://docs.catalyst.zoho.com/ja/convokraft/)を使用して、ECサイト向けの効率的なセールスアシスタントとして機能するEコマースボットを構築する方法を説明します。 電子機器や家電製品をWebサイトで販売するオンラインストアを想定します。[ConvoKraftボット](https://docs.catalyst.zoho.com/ja/convokraft/help/bots/introduction/)をWebサイト向けに構築し、ユーザーがサポートチケットを発行したりカスタマーサポートに連絡したりすることなく、シンプルで分かりやすい質問やよくある質問について、いつでも1対1の対話を行えるようにします。 Eコマースボットは、ストアの在庫にある商品リストの表示、注文の発注、注文の詳細確認、配送先住所の変更、注文の配送予定日の変更が可能です。 Eコマースボットは、Webサイトに埋め込んだ後、以下のように表示されます: ![ecommerce-website-hosted](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/ecommerce-website-hosted.webp) 動作するEコマースボットにアクセスして機能をテストできます:[アプリを試す!](https://ecommerce.catalystserverlessapp.com/app/) Eコマースボットは、以下のConvoKraftの基本コンポーネントを使用します: * **[Actions](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/overview/introduction)**:Eコマースボットに、オンラインストアの商品リストの表示、注文の発注、注文の詳細確認、配送先住所の変更、配送日の変更などの操作を設定します。 * **Bot Logic**:Eコマースボットのボットロジックを[Catalyst Integration Functions](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/bot-logic/catalyst-integration-functions/)を使用して設定します。この関数が、設定されたアクションのバックエンドロジックを処理します。このチュートリアルでは、関数を**Node.js16**でコーディングしています。 * **[Handlers](https://docs.catalyst.zoho.com/ja/convokraft/help/handlers/welcome-message-handler)**:ハンドラー関数でレスポンスを設定し、ボットとの新しい会話を開始する際のユーザーへの挨拶、失敗や例外のシナリオでのユーザーへの通知、およびボットが特定のメッセージを理解できない場合のユーザーへの通知を行います。ボットのコア実行ロジックもハンドラー関数で設定します。詳細については、[このセクション](https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/configure-function/)で説明します。 > **Note:** Integration Functionsは、EU、AU、IN、またはCAデータセンターからアクセスするCatalystユーザーには現在利用できません。これらのDCからアクセスするユーザーは、代わりにDeluge関数オプションでボットロジックを構築できます。 ConvoKraftボットは、以下のCatalystサービスとそのコンポーネントも使用します: 1. [**Catalyst Serverless**](https://docs.catalyst.zoho.com/ja/serverless/getting-started/introduction/): - **[Functions](https://docs.catalyst.zoho.com/ja/serverless/help/functions/introduction/)**:[Catalyst Integration function](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/bot-logic/catalyst-integration-functions/)を使用してConvoKraftボットのロジックをコーディングし、作成した関数をConvoKraftボットに関連付けます。 2. [**Catalyst CloudScale**](https://docs.catalyst.zoho.com/ja/cloud-scale/getting-started/introduction/): - **[Web Client Hosting](https://docs.catalyst.zoho.com/ja/cloud-scale/help/web-client-hosting/introduction/)**:クライアントアプリケーション(Webサイト)を[ホスティング](https://docs.catalyst.zoho.com/ja/cloud-scale/help/web-client-hosting/implementation/)するために、[Catalyst CloudScale](https://docs.catalyst.zoho.com/ja/cloud-scale/)サービスのこのコンポーネントを使用します。Catalystが提供するフロントエンドの[Javascript SDK](https://docs.catalyst.zoho.com/ja/convokraft/sdk/js/overview/)パッケージを使用して、ボットをWebサイトに埋め込みます。 以下のZohoサービスも設定します: * **[Zoho CRM](https://www.zoho.com/en-in/crm/)**:オンラインストアの商品と注文データを保存するために、Zoho CRMにカスタムモジュールを作成し、データソースとして使用します。カスタムモジュールの設定について詳しくは、[このセクション](https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/create-custom-modules-in-crm/)を参照してください。 このチュートリアルでは、Catalyst Integration関数を使用してConvoKraftボットを構築するためのコードと、ECサイト用のシンプルなクライアントコードが提供されます。ここで提供されるコードをコピーして、指示に従って適切なファイルに貼り付けるだけで構築できます。ボットに必要なアクションの設定、ビジネスロジックのコーディング、ボットのトレーニングとテスト、そして最後にボットをWebサイトに埋め込む手順を説明します。 -------------------------------------------------------------------------------- title: "前提条件" description: "Catalyst Authenticationの機能を使用して、ユーザーサインアップ、アプリケーションログイン、パスワードリセットを提供し、ZohoおよびGoogleサインインプロバイダーを実装するシンプルなWebアプリケーションを作成します。" last_updated: "2026-03-05T06:13:24.000Z" source: "https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/prerequisites/" service: "All Services" related: - Zoho CRMログイン (https://www.zoho.com/en-in/crm/) - CLIコマンドリファレンス (/ja/cli/v1/cli-command-reference/) - CLIのインストール (/ja/getting-started/installing-catalyst-cli/) - CLIログイン (/ja/cli/v1/login/login-from-cli/) -------------------------------------------------------------------------------- # 前提条件 アプリケーションの構築を開始する前に、以下の前提条件をシステムにインストールしている必要があります: 1. **Catalyst CLI**:Catalyst CLIには、ローカルマシンからアプリケーションのコンポーネントを初期化、開発、テスト、デプロイするためのツールが含まれています。このチュートリアルでは、Catalyst CLIを使用して作業を行います。 以下の操作を実行する必要があります: 1. **Catalyst CLIのインストール**:Catalyst CLIはNPMを通じてインストールします。そのため、CLIをインストールする前に、NPMとNode.jsがシステムにインストールされている必要があります。前提条件とインストール手順の詳細については、[**Catalyst CLIインストールヘルプページ**](https://docs.catalyst.zoho.com/ja/getting-started/installing-catalyst-cli/)を参照してください。 2. **Catalyst CLIへのログイン**:Catalyst CLIをインストールした後、使用する前にCatalystアカウントでCLIを認証する必要があります。Catalyst CLIからのログイン手順と利用可能なオプションについては、[**CLIログインヘルプページ**](https://docs.catalyst.zoho.com/ja/cli/v1/login/login-from-cli/)を参照してください。 2. **Node.jsおよびクライアントコード開発用の任意のIDEツール**:お好みのIDEをダウンロードしてシステムにインストールしてください。関数コードとクライアントコードの開発には任意のIDEを使用できます。Visual Studio Code、IntelliJ IDEA、Eclipse、Sublime Textなどが一般的な選択肢です。 > Visual Studio Code IDEをお使いの場合は、**Catalyst Tools**拡張機能をインストールし、CLIの代わりにIDE自体を使用できます。Catalyst VS Code拡張機能の詳細については、[こちらのヘルプセクション](https://docs.catalyst.zoho.com/ja/catalyst-extensions/vs-code-extension/introduction/)を参照してください。 3. **Zoho CRMアカウント**:Eコマースストアの商品在庫と注文のデータソースとして、任意のエディションのZoho CRMアカウントを設定しておく必要があります。Zoho CRMアカウントをお持ちでない場合は、[こちら](https://www.zoho.com/en-in/crm/)からサインアップできます。 -------------------------------------------------------------------------------- title: "プロジェクトの作成" description: "Catalyst ConvoKraft、Serverless Integration関数、およびZoho CRMを使用して、ECサイト向けの会話型セールスアシスタントボットを構築します。Webサイトのユーザーと対話し、注文を管理します。" last_updated: "2026-08-17T12:16:04.000Z" source: "https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/create-a-project/" service: "All Services" related: - Catalyst ConvoKraft (/ja/convokraft/) - Catalystプロジェクトの作成 (/ja/getting-started/catalyst-projects/#create-a-catalyst-project) -------------------------------------------------------------------------------- # プロジェクトの作成 まず、[Catalystコンソール](https://console.catalyst.zoho.com/baas/index)から[Catalystプロジェクトを作成](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-projects/#create-a-catalyst-project)しましょう。 1. [Catalystコンソール](https://console.catalyst.zoho.com/baas/index)にログインし、**Create new Project**をクリックします。 ![create-new-project](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/catalyst-create-project.webp) 2. 表示されるポップアップウィンドウで、プロジェクト名に「**Ecommerce**」と入力します。 ![new-project-popup](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/new-project-popup.webp) 3. **Create**をクリックします。 プロジェクトが作成され、開きます。 ![project-landing-page](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/project-created-and-opened.webp) このチュートリアルでは、[Catalyst ConvoKraft](https://docs.catalyst.zoho.com/ja/convokraft/)サービスを使用します。 -------------------------------------------------------------------------------- title: "ボットの作成" description: "Catalyst ConvoKraft、Serverless Integration関数、およびZoho CRMを使用して、ECサイト向けの会話型セールスアシスタントボットを構築します。Webサイトのユーザーと対話し、注文を管理します。" last_updated: "2026-08-17T12:16:04.000Z" source: "https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/create-a-bot/" service: "All Services" related: - Catalyst Integration Functions (/ja/convokraft/help/actions/bot-logic/catalyst-integration-functions) -------------------------------------------------------------------------------- ### ボットの作成 ConvoKraftで[ボットを作成](https://docs.catalyst.zoho.com/ja/convokraft/help/bots/create-a-bot/)しましょう: 1. [Catalystコンソール](https://console.catalyst.zoho.com/baas/index)の左ペインにある**ConvoKraft service**アイコンに移動します。**Start Exploring**をクリックします。 ![start-exploring](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/convocraft-landing-screen.webp) 2. **Create New Bot**をクリックします。 3. **Create New Bot**ポップアップで、ボット名に「EcommerceBot」と入力します。ボットの簡単な説明を入力し、必要に応じてアイコンも設定します。 ![create-new-bot-popup](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/create-new-bot-popup.webp) 4. **Save**をクリックします。続いて表示されるページで、ボットのビジネスロジックを構築する開発プラットフォームを選択します。 このチュートリアルでは、Catalyst Integration **Functions**を使用してバックエンドロジックをコーディングします。Catalyst Integration Functionsの詳細については、[このページ](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/bot-logic/catalyst-integration-functions)を参照してください。 ![choose-function](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/e-commerce-bot-function.webp) **Select function**ドロップダウンをクリックして、ConvoKraftボットに関連付けるIntegration functionを選択する必要があります。Integration functionは、このチュートリアルの[後のセクション](https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/configure-function/)で作成します。 > **Note:** ここでは**Function**を選択し、**Save**をクリックして、対応するIntegration functionは後でBots Detailsページで関連付けることもできます。 -------------------------------------------------------------------------------- title: "アクションの設定" description: "Catalyst ConvoKraft、Serverless Integration関数、およびZoho CRMを使用して、ECサイト向けの会話型セールスアシスタントボットを構築します。Webサイトのユーザーと対話し、注文を管理します。" last_updated: "2026-08-17T12:16:04.000Z" source: "https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/configure-actions/" service: "All Services" related: - ConvoKraftボットの作成 (/ja/convokraft/help/bots/create-a-bot/) - アクションの作成 (/ja/convokraft/help/actions/create-an-action/) -------------------------------------------------------------------------------- # アクションの設定 [ボットを作成](https://docs.catalyst.zoho.com/ja/convokraft/help/bots/create-a-bot/)した後、[アクションを作成](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/create-an-action/)し、必要に応じてアクションのレスポンスを設定する必要があります。一般的に、アクションのレスポンスは、ビジネスロジックに基づくもの、または操作を伴わない静的な直接レスポンスのいずれかに設定できます。このチュートリアルでは、すべてのアクションのレスポンスをビジネスロジックの実行に基づいて設定します。 Eコマースボットには以下のアクションを作成し、ユーザーが必要な時にボットと直接対話して操作を実行できるようにします。 * **Eコマースストアの商品リストを表示する** * **新規注文を行う** * **注文の詳細を確認する** * **配送先住所を変更する** * **注文を後日に変更する** アプリケーションの特定のニーズに基づいてアクションを設定するには、適切なサンプル文とパラメータを定義する必要があります。このセクションでは、Eコマースボットの上記アクションに設定する[サンプル文](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/define-sample-sentences/)と[パラメータ](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/define-params/)について詳しく説明します。 [ConvoKraftボットを作成](https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/create-a-bot/)し、ビジネスロジックを構築するための適切な開発プラットフォームを選択すると、ボットの詳細ページが表示されます。 以下の手順に従って、Eコマースボットのアクションを作成・設定してください: 1. ボットを開いた後、**Create Action**をクリックして新しいアクションを追加します。 ![create-bot-action](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/create-action-e-commerce.webp) 2. Eコマースボットの最初のアクションとして、ストアで利用可能な商品を一覧表示するアクションを作成します。 表示されるポップアップウィンドウで、アクション名に「List the items available in Store」と入力します。レスポンスを**Based on a business logic**に選択し、**Next**をクリックします。 ![create-list-action](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/create-new-action-pup-up.webp) 3. 該当するサンプル文を設定します。会話形式では、ユーザーはさまざまな方法でこのアクションを呼び出す可能性があります。例えば、「list the items available」や「what are the products available in the store?」などです。 ![listofitems-sample](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/list-the-items-action.webp) 4. このアクションにはパラメータを設定しません。このステップをスキップして**Save**をクリックしてください。 ![params-page1](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/no-params-required.webp) 同様に、Eコマースボットの残りのアクションを作成する手順を以下に示します。上記の手順はすべてのアクションに適用されますが、追加で特定のアクションに対して[パラメータの作成](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/define-params/)が必要になる場合があります。 ### 注文の発注 1. 前のステップで説明したように、ボットの詳細ページからビジネスロジックに基づいてレスポンスを返す新しいアクションを作成し、「Place an order」と名付けます。このアクションのサンプル文は以下のように定義できます: * "I want to place an order" * "Need to place order" * "I have an account **amelia.burrows@zylker.com** and I would like to place an order of the product id : 18392188283 to be delivered on 11-Dec-2025" 2. 文を設定したら**Next**をクリックします。 3. **New Param**をクリックし、以下の指示に従ってパラメータタイプを選択します。 **String**をクリックすると、**New Param**ダイアログボックスが開きます。 ![](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/place-an-order-param.webp) パラメータ名に「productid」と入力し、以下の表を参考にプロンプトメッセージを追加します。各パラメータタイプの属性の詳細については、[このページ](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/define-params/#attributes-of-a-param)を参照してください。 ![productid](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/productid.webp) このアクションには以下のパラメータを作成します:
パラメータタイプ 名前 プロンプトメッセージ バリデーション失敗時のプロンプトメッセージ
String `productid` Please enter the Product ID The entered ProductID is invalid. Please check and retry.
Email `cxemail` Please enter your Email Address The entered email address is invalid. Please check and retry.
Date `cxdate` Please enter the date on which you expect the delivery The entered date is invalid. Please check and retry.
String `cxaddr` Please enter the address where you want the order to be delivered The entered address is invalid. Please check and retry.
同様に、上記の表に記載されたパラメータタイプとプロンプトメッセージで、残りの3つのパラメータ「cxemail」、「cxdate」、「cxaddr」を作成します。 > **Note :** 日付パラメータの入力モードは、お好みに応じてTextualまたはVisualを選択できます。 4. パラメータをサンプル文内の対応するテキストにマッピングし、ボットが会話中にユーザーから入力を順次取得するよう指示できます。 サンプル文のテキストにカーソルを合わせ、対応するパラメータを選択して関連付けます。 ![place-order2](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/place-an-order-param-edit.webp) 5. アクションのサンプル文とパラメータを設定したら、**Save**をクリックします。 ### 注文詳細の確認 1. 新しいアクションを作成し、ビジネスロジックに基づくレスポンスを設定します。「View Order Details」と名付けます。 2. アクションに以下の[サンプル文](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/define-sample-sentences/)を追加します: * "Where is my order?" * "I want to view my order details of email id amelia.burrows@zylker.com" * "I want to check my order details" 3. 前のセクションで説明したように、アクションに以下のパラメータを定義します。上記のスクリーンショットに示すようにパラメータをサンプル文に関連付け、**Save**をクリックします。
パラメータタイプ 名前 プロンプトメッセージ バリデーション失敗時のプロンプトメッセージ
Email `cxemail` Please provide the email address associated with your order The entered email address is invalid. Please check and retry.
![view-order-sample-sentences](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/view-order-details-param-edit.webp) ### 配送先住所の変更 1. 上記で作成したアクションと同様に、このアクションのレスポンスもビジネスロジックに基づいて設定します。アクション名に「Change Delivery Address」と入力します。このアクションには、以下のサンプル文を定義できます: * "I want my order to be delivered at a different address" * "I want to change delivery address for my order id 5804508000000460006 under the email amelia.burrows@zylker.com" 2. アクションに以下のパラメータを追加します:
パラメータタイプ 名前 プロンプトメッセージ バリデーション失敗時のプロンプトメッセージ
Email `cxemail` Please provide the email Address associated with your order. The entered email address is invalid. Please check and retry.
String `cxorderid` Please enter your Order ID. The entered OrderID is invalid. Please check and retry.
String `cxaddr` Please enter the address where you want the order to be delivered. The entered address is invalid. Please check and retry.
以下のスクリーンショットに示すようにパラメータを関連付け、**Save**をクリックします。 ![change-delivery-address](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/change-delivery-address.webp) ### 注文日のリスケジュール 1. アクション名に「Reschedule order date」と入力します。このアクションには、以下のサンプル文を定義できます: * "Reschedule my order to later date" * "Postpone the delivery date of my order" * "I want to change my orders delivery date as 19/07/2023 for my order id 5804508000000460006 of my email amelia.burrows@zylker.com" 2. アクションに以下のパラメータを追加します:
パラメータタイプ 名前 プロンプトメッセージ バリデーション失敗時のプロンプトメッセージ
Email `cxemail` Please provide the email ID associated with your order. The entered email ID is invalid. Please check and retry.
String `cxorderid` Please enter your Order ID. The entered OrderID is invalid. Please check and retry.
Date `cxdate` Mention the date you would like to reschedule your order The entered date is invalid. Please check and retry.
![reschedule-order-sample](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/reschedule-order-sample.webp) これでボットのアクションが設定されました。 ![all-actions](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/entire-action.webp) -------------------------------------------------------------------------------- title: "CRMでカスタムモジュールを作成する" description: "Catalyst ConvoKraft、Serverless Integration関数、およびZoho CRMを使用して、ECサイト向けの会話型セールスアシスタントボットを構築します。Webサイトのユーザーと対話し、注文を管理します。" last_updated: "2026-08-17T12:16:04.000Z" source: "https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/create-custom-modules-in-crm/" service: "All Services" related: - CRMカスタムモジュール (https://help.zoho.com/portal/ja/kb/crm/customize-crm-account/customizing-modules/articles/customize-modules#Custom_Modules_or_User-Generated_Modules) -------------------------------------------------------------------------------- # CRMでカスタムモジュールを作成する [Zoho CRM](https://help.zoho.com/portal/ja/kb/crm/getting-started/articles/get-started-introduction-zoho-crm#What_is_CRM)のモジュールを使用すると、ビジネスのさまざまな側面を分類して追跡できます。商品在庫と注文情報を保存するために、EcomProductsとOrdersの2つのカスタムモジュールを作成します。カスタムモジュールの詳細については、[CRMドキュメント](https://help.zoho.com/portal/ja/kb/crm/customize-crm-account/customizing-modules/articles/customize-modules#Custom_Modules_or_User-Generated_Modules)を参照してください。 CRMでカスタムモジュールを作成するには、以下の手順に従います: 1. Zoho CRMアカウントに[ログイン](https://www.zoho.com/crm/login.html)します。 2. 以下のスクリーンショットに示すように、ダッシュボードの右上にある**Setup**をクリックし、**Customization**セクションの**Modules and Fields**をクリックします。 ![crm-customization](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/crm-customization.webp) 3. **New Module**をクリックします。 ![create-new-module](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/create-new-module.webp) #### EcomProducts このモジュールは、Eコマースオンラインストアで利用可能なさまざまな商品の詳細を保存するために使用されます。`EcomProducts`カスタムモジュールに、以下のフィールドを追加してください。
フィールド名 タイプ
`EcomProductName` Single Line
`Product_image` URL
`Price` Number
`Inventory Count` Number
`EcomProduct Owner` User
フィールドタイプをドラッグ&ドロップするだけで新しいフィールドを追加できます。 ![ecom-product-module](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/ecom-product-module.webp) フィールドを追加したら、**Save**をクリックします。 モジュール名を「EcomProducts」と入力し、以下のスクリーンショットに示すようにモジュール権限を**Administrator**に設定します。 ![module-name](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/module-name.webp) モジュールにレコードとして追加することで、任意の数の商品を作成できます。 モジュールページに戻り、以下のスクリーンショットに示すようにメニューから**Ecomproducts**をクリックします。 ![select-ecom-products](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/select-ecom-products.webp) **Create EcomProduct**をクリックします。 ![create-ecomproduct](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/create-ecomproduct.webp) すべてのフィールドに値を入力し、Saveをクリックします。 ![create-product](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/create-product.webp) #### Orders このモジュールは、Eコマースオンラインストアの注文詳細を保存するために作成します。前述の方法と同様にこの新しいモジュールを作成し、「Orders」と名付けます。このカスタムモジュールには、以下のフィールドを設定します:
フィールド名 タイプ
`Order Name` Single Line
`Email` Email
`Contact_No` Phone
`Product_Name` Single Line
`OrderID` Single Line
`Order_Status` Single Line
`Order_Owner` User
`Modified By` Single Line
`Price` Number
`Delivery_Address` Multi Line
`product_image_url` URL
`Expected_Delivery_Date` Single Line
ユーザーがボットと会話して注文を行うと、このモジュールに自動的にエントリ(レコード)が作成されます。 ![orders-page](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/orders-page.webp) レコードの詳細は以下のように表示されます: ![edit-order](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/edit-order.webp) > **Note :** ボットのビジネスロジックで使用しているフィールド名と完全に同じ名前を使用してください。 -------------------------------------------------------------------------------- title: "プロジェクトの初期化" description: "Catalyst ConvoKraft、Serverless Integration関数、およびZoho CRMを使用して、ECサイト向けの会話型セールスアシスタントボットを構築します。Webサイトのユーザーと対話し、注文を管理します。" last_updated: "2026-08-17T12:16:04.000Z" source: "https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/initialize-project/" service: "All Services" related: - Catalyst Integration Functions (/ja/convokraft/help/actions/bot-logic/catalyst-integration-functions) - プロジェクトディレクトリ構造 (/ja/cli/v1/project-directory-structure/introduction/) -------------------------------------------------------------------------------- # CLIからプロジェクトを初期化する ボットのアクションを設定した後、それらのアクションのビジネスロジックの設定に進みます。前述の通り、Eコマースボットのボットロジックのコーディングには[Catalyst Integration Functions](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/bot-logic/catalyst-integration-functions)を使用します。 Catalyst関数をコーディングするには、まず[Catalyst CLI](https://docs.catalyst.zoho.com/ja/cli/v1/login/login-from-cli/)からプロジェクトを初期化する必要があります。最初のステップとして、[CLIにログイン](https://docs.catalyst.zoho.com/ja/cli/v1/login/login-from-cli/)し、空のローカルディレクトリで[プロジェクトを初期化](https://docs.catalyst.zoho.com/ja/cli/v1/initialize-resources/introduction)します。このディレクトリがプロジェクトのホームディレクトリとなり、すべてのプロジェクトファイルがここに保存されます。 Catalystがサポートするすべてのプログラミングスタックのプロジェクトディレクトリ構造については、[このページ](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/introduction/)を参照してください。Catalystプロジェクトの初期化の詳細については、[CLIヘルプドキュメント](https://docs.catalyst.zoho.com/ja/cli/v1/initialize-resources/introduction)を参照してください。 > **Note:** アプリケーションのコードに同じ名前が含まれているため、関数のパッケージ名は指示通りに正確に入力してください。 以下の手順に従って、プロジェクトを初期化し、必要な関数とクライアントコンポーネントを作成してください: 1. ローカルマシンにプロジェクト用のフォルダを作成し、CLIターミナルからそのフォルダに移動します。 2. プロジェクトを初期化するには、以下のコマンドを実行してください: ```sh catalyst init ``` 3. CLIから[デフォルトのCatalyst組織](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-organizations/#the-default-organization)を選択するよう求められます。このチュートリアルの最初のステップでプロジェクトを作成した組織を選択し、**Enter**を押してください。 ![convokraft_ecommerce_bot_init_project](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/convokraft_ecommerce_bot_init_project.webp) 4. 現在のプロジェクトディレクトリを、この組織で作成したCatalystプロジェクトに関連付けることができます。**Ecommerce**を選択し、**Enter**を押してください。 ![convokraft_ecommerce_bot_select_proj](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/convokraft_ecommerce_bot_select_proj.webp) 5. Catalystアプリケーションに必要なコンポーネントを選択します。矢印キーでオプションを移動し、スペースバーで選択してください。**Functions**と**Client**を選択し、**Enter**を押して選択を確定します。 ![convokraft_ecommerce_bot_select_funcs](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/convokraft_ecommerce_bot_select_funcs.webp) 6. 開発する関数のタイプを選択します。このチュートリアルでは、**Functions**と**Client**を選択します。 Functionsセットアップのステップで、**Integration**を選択します。 ![convokraft_ecommerce_bot_integ_select](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/convokraft_ecommerce_bot_integ_select.webp) 7. 次のステップで、サービスとして**Convokraft**を選択します。 ![convokraft_ecommerce_bot_convokraft](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/convokraft_ecommerce_bot_convokraft.webp) 8. Catalyst Integration functionを開発するための優先スタックを選択し、**Enter**を押します。このチュートリアルでは、**Node.js 16**で関数をコーディングします。 ![convokraft_ecommerce_bot_node_select](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/convokraft_ecommerce_bot_node_select.webp) 9. プロンプトが表示されたら、Node関数のパッケージ名に「ecommerce_function」と入力し、**Enter**を押します。このステップでは、エントリポイントを`index.js`として定義し、作成者の詳細も入力する必要があります。 > **Note:** アプリケーションのコードに同じ名前が含まれているため、関数のパッケージ名は指示通りに正確に入力してください。 ![convokraft_ecommerce_bot_node_installed](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/convokraft_ecommerce_bot_node_installed.webp) 関数のディレクトリに、初期化された`ecommerce_function`、ハンドラー関数ファイル、その他の設定ファイルが含まれます。プロジェクトディレクトリ構造の詳細については、[このページ](https://docs.catalyst.zoho.com/ja/cli/v1/project-directory-structure/functions-directory/#node-modules-and-node-js-function-dependencies)を参照してください。 10. 次にCLIがクライアントのセットアップを開始します。クライアントタイプとして**Basic web app**を選択します。 ![convokraft_ecommerce_bot_basic_client_select](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/convokraft_ecommerce_bot_basic_client_select.webp) 11. クライアントパッケージの名前に`ecommerceclient`と入力し、**Enter**を押してください。任意の名前を入力できます。 ![convokraft_ecommerce_bot_basic_client_installed](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/convokraft_ecommerce_bot_basic_client_installed.webp) クライアントディレクトリが標準構造で作成され、以下のようになります: ![convokraft_ecommerce_bot_basic_client_directory](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/convokraft_ecommerce_bot_basic_client_directory.webp) 12. このCatalyst Node.js関数は、ルーティング操作を実行するために**express**フレームワークを必要とします。関数のディレクトリにexpressモジュールをインストールするには、`functions/ecommerce_function`に移動して、ターミナルで以下のコマンドを実行します: ```sh npm install express -save ``` ![convokraft_ecommerce_bot_express](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/convokraft_ecommerce_bot_express.webp) 関数のディレクトリは以下のようになります: ![convokraft_ecommerce_func_directory](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/convokraft_ecommerce_func_directory.webp) Catalystの初期化が完了しました。プロジェクトディレクトリには、関数とクライアント、およびその他のプロジェクト依存ファイルが含まれます。 -------------------------------------------------------------------------------- title: "Integration関数の設定" description: "Catalyst ConvoKraft、サーバーレスIntegration関数、およびZoho CRMを使用して、ECサイト向けの会話型セールスアシスタントボットを構成します。ウェブサイトユーザーとの対話や注文管理を行います。" last_updated: "2026-08-17T12:16:04.000Z" source: "https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/configure-function/" service: "All Services" related: - プロジェクトディレクトリ構造 (/ja/cli/v1/project-directory-structure/introduction/) -------------------------------------------------------------------------------- # Integration関数の設定 次に、先ほど初期化したIntegration関数を設定して、eコマースボットの実行ロジックのコーディングを開始します。 関数のディレクトリ`functions/ecommerce_function`には以下が含まれています: - `index.js`メイン関数ファイル - ConvoKraftハンドラー関数ファイル - `catalyst-config.json`設定ファイル - Nodeモジュール - [`package.json`](https://docs.npmjs.com/files/package.json)および[`package-lock.json`](https://docs.npmjs.com/configuring-npm/package-lock-json.html)依存関係ファイル ハンドラー関数`execute.js`、`fallback.js`、`failure.js`、`welcome.js`、およびメインの`index.js`ファイルにコードを追加します。 以下のコードをお好みのIDEを使用して、それぞれのファイルに注意深くコピー&ペーストして保存してください。 **execute.js** ```javascript import logger from "./logger.js"; import fetch from "node-fetch"; import catalyst from "zcatalyst-sdk-node"; // GETリクエストを実行する関数 async function get(url, headers) { const response = await fetch(url, { method: 'GET', headers: headers }); return await response.json(); } function getRandomNumber(min, max) { return Math.floor(Math.random() * (max - min + 1)) + min; } // POSTリクエストを実行する関数 async function post(url, headers, body) { const response = await fetch(url, { method: 'POST', headers: headers, body: JSON.stringify(body) }); return await response.json(); } // PUTリクエストを実行する関数 async function put(url, headers, body) { const response = await fetch(url, { method: 'PUT', headers: headers, body: JSON.stringify(body) }); return await response.json(); } async function getCRMToken(request) { const catalystApp = catalyst.initialize(request); var connector = catalystApp.connection({ CRMTOKEN: { client_id: `${process.env.client_id}`, client_secret: `${process.env.client_secret}`, auth_url: `${process.env.auth_url}`, refresh_url: `${process.env.refresh_url}`, refresh_token: `${process.env.refresh_token}` } }).getConnector('CRMTOKEN'); let accessTokenResponse=await connector.getAccessToken().then((accessToken) => { //console.log("Inside accesstoken"+accessToken); return accessToken; }); return accessTokenResponse; } // URL呼び出し関数 async function invokeURL(options) { if (options.type === 'GET') { const response = await get(options.url, options.headers); return response; } else if (options.type === 'POST') { const response = await post(options.url, options.headers, options.body); return response; } else if (options.type === 'PUT') { const response = await put(options.url, options.headers, options.body); return response; } else { throw new Error(`Unsupported HTTP method: ${options.type}`); } } // execute機能を処理する export default async function handleExecute(request) { logger.info('Handling execute request with params : '+JSON.stringify(request)); logger.info('Action NameSpace : '+request.action.namespace); logger.info('Params : '+JSON.stringify(request.params)); logger.info('Broadcast : '+JSON.stringify(request.broadcast)); const result = {}; const cardlist = []; switch(request.action.namespace) { case "listofitems_2": logger.info('Inside NameSpace '+request.action.namespace); const executeViewItemsLogic = async () => { //let zohocrmapiurl=process.env.crmapiurl; console.log("ENV VARIABLE "+JSON.stringify(process.env)); //console.log("Client ID"+`${process.env.client_id}`); const token=await getCRMToken(request); //console.log("ACCESSTOKEN RESP : "+token); const accessToken = 'Zoho-Oauthtoken ' + token; logger.info('Access Token : '+accessToken); const header_data = new Map(); header_data.set('Content-Type', 'application/json'); header_data.set('Authorization', accessToken); const CRMresponse = await invokeURL({ url: 'https://'+process.env.crmapiurl+'/crm/v2/EcomProducts?fields=Name,Product_image_url,Price,Inventory_Count,Product_image', type: 'GET', headers: header_data }); logger.info("Response for list of items "+ JSON.stringify(CRMresponse)); const productNote = { "type": "note", "content": "List of items available are listed as follows" }; cardlist.push(productNote); for (const record of CRMresponse.data) { logger.info('RECPORD INFO : '+JSON.stringify(record)); const name = record.Name; const price = record.Price; const product_id = record.id; const image = record.Product_image; const inventory = record.Inventory_Count; const listItem = { "type": "list", "format": "bullet", "elements": [ { "label": `Name : ${name}` }, { "label": `Total Price : $ ${price}` }, { "label": `Product ID : ${product_id}` }, { "label": `Stock : ${inventory}` } ] }; const productPic = { "type": "image", "content": image }; cardlist.push(productPic); cardlist.push(listItem); logger.info('Card List : : : :'+JSON.stringify(cardlist)); } result.card= cardlist; result.message= "List of Objects in response"; logger.info('Result Obj inside the : : : ' + result); logger.info('Result OF MAP : : : :'+JSON.stringify(result)); }; await executeViewItemsLogic(); logger.info('Result Obj before return : : : ' + JSON.stringify(result)); return result; break; case "vieworderdetails_3": logger.info('Inside NameSpace ' + request.action.namespace); const executeViewOrderLogic = async () => { const token=await getCRMToken(request); var cxemail=request.params.cxemail; const accessToken = 'Zoho-Oauthtoken ' + token; logger.info('Access Token: ' + accessToken); const header_data = new Map(); header_data.set('Content-Type', 'application/json'); header_data.set('Authorization', accessToken); let resp={} try{ resp = await invokeURL({ url: 'https://'+process.env.crmapiurl+'/crm/v4/Orders/search?criteria=((Email:equals:' + cxemail + '))', type: 'GET', headers: header_data }); }catch(er) { logger.info('ERROR WHILE CRM DATA SEARCH ' + er); } logger.info('Response: ' + JSON.stringify(resp)); let items_count = 0; for (const order of resp.data) { items_count++; logger.info('Inside Resp Iterator - Item count : '+items_count+' Order details : '+JSON.stringify(order)); const order_id = order.id; const CRMresponse = await invokeURL({ url: 'https://'+process.env.crmapiurl+'/crm/v3/Orders/' + order_id, type: 'GET', headers: header_data }); logger.info("CRMRESPONSE : : : :"+JSON.stringify(CRMresponse.data[0].product_image_url)); const orderid = order.OrderID; const name = order.Name; const contact = order.Contact_No; const email = order.Email; const product_name = order.Product_Name; const price = order.Price; const delivery_date = order.Expected_Delivery_Date; const delivery_address = order.Delivery_Address; const order_status = order.Order_Status; const listItem = { "type": "list", "format": "bullet", "elements": [ { "label": "Name: " + name }, { "label": "Contact No: " + contact }, { "label": "Email ID: " + email }, { "label": "Product Name: " + product_name }, { "label": "Total Price: $" + price }, { "label": "Expected Delivery Date: " + delivery_date }, { "label": "Delivery Address: " + delivery_address }, { "label": "Order Status: " + order_status } ] }; const productNote = { "type": "note", "content": items_count + ") Your order details for order id : " + orderid + " are listed as follows: " }; const productPic = { "type": "image", "content": CRMresponse.data[0].product_image_url }; cardlist.push(productNote); cardlist.push(productPic); cardlist.push(listItem); logger.info("CARD LIST : : : "+JSON.stringify(cardlist)); } result.card = cardlist; // broadcastを定義する result.broadcast = { "cxemail": cxemail }; result.message = "The Shoppers Stores. You don't have an order."; logger.info("Result JSON : : : "+JSON.stringify(result)); }; await executeViewOrderLogic(); //logger.info('Result Obj before return: ' + JSON.stringify(result)); return result; break; case "placeanorder_4": logger.info('Inside NameSpace ' + request.action.namespace); const executePlaceOrderLogic = async () => { const placeorder = {}; const token=await getCRMToken(request); const accessToken = 'Zoho-Oauthtoken ' + token; logger.info('Access Token: ' + accessToken); const header_data = new Map(); header_data.set('Content-Type', 'application/json'); header_data.set('Authorization', accessToken); try { const CRMresponse = await invokeURL({ url: 'https://'+process.env.crmapiurl+'/crm/v2/EcomProducts/' + request.params.productid, type: 'GET', headers: header_data }); logger.info('CRM Response: ' + JSON.stringify(CRMresponse)); if (CRMresponse.data == null && CRMresponse.status != 'error') { const stock_count = 0; logger.info('Empty response. Stock count reset.'); placeorder.put('Stock', 'Empty'); } else { const recordid = CRMresponse.data[0].id; let stock_count = CRMresponse.data[0].Inventory_Count; const imageurl = CRMresponse.data[0].Product_image; const productname = CRMresponse.data[0].Name; const price = CRMresponse.data[0].Price; logger.info(recordid+" "+stock_count+" "+imageurl+" "+productname+" "+price); if (stock_count > 0) { stock_count = stock_count - 1; const reduceStock = { id: recordid, Inventory_Count: stock_count }; const updatedata = [reduceStock]; const updatedatamap = { data: updatedata }; const updateResp = await invokeURL({ url: 'https://'+process.env.crmapiurl+'/crm/v2/EcomProducts', type: 'PUT', body: updatedatamap, headers: header_data }); logger.info('Update Response: ' + JSON.stringify(updateResp)); placeorder.Name = productname + ' ' + request.params.cxdate; // ドット記法を使用して値を代入する placeorder.Product_Name = productname; // ドット記法を使用して値を代入する placeorder.Email = request.params.cxemail; // ドット記法を使用して値を代入する placeorder.Delivery_Address = request.params.cxaddr; // ドット記法を使用して値を代入する placeorder.Expected_Delivery_Date = new Date(request.params.cxdate).toLocaleDateString(); // ドット記法を使用して値を代入する placeorder.product_image_url = imageurl; // ドット記法を使用して値を代入する placeorder.Price = price; // ドット記法を使用して値を代入する const orderID = request.params.productid + '_' + getRandomNumber(1111111, 9999999); //placeorder.put('OrderID', orderID); placeorder.OrderID = orderID; placeorder.Order_Status = 'Reviewing the Order'; // ドット記法を使用して値を代入する const insertdatamap = { data: [placeorder] }; logger.info("INSERT MAP : : :"+JSON.stringify(insertdatamap)); const insertResp = await invokeURL({ url: 'https://'+process.env.crmapiurl+'/crm/v2/Orders', type: 'POST', body: insertdatamap, headers: header_data }); logger.info('Insert Response: ' + JSON.stringify(insertResp)); result.message = 'Your order for the product - ' + CRMresponse.data[0].Name + ' is placed successfully. It will be tried to be delivered on ' + request.params.cxdate + ' to ' + request.params.cxaddr + '. Our Sales team will reach out to you via email to discuss COD or prepayment before delivery.'; } else { result.message = 'The item is out of stock. Please retry after some days as we restock.'; } } } catch (e) { logger.info(e.lineNo); logger.info(e.message); logger.info(e); result.message = 'There was some issue during the order. Please contact the support team. They shall assist in placing this order for you.'; } result.broadcast = { cxemail: request.params.cxemail }; }; await executePlaceOrderLogic(); return result; break; case "changedeliveryaddress": // 配送先住所変更の新しいケース logger.info('Inside NameSpace ' + request.action.namespace); const executeChangeDeliveryAddressLogic = async () => { const token=await getCRMToken(request); const cxorderid = request.params.cxorderid; const cxaddr = request.params.cxaddr; const cxemailid = request.params.cxemail; const accessToken = 'Zoho-Oauthtoken ' + token; logger.info('Access Token: ' + accessToken); const header_data = new Map(); header_data.set('Content-Type', 'application/json'); header_data.set('Authorization', accessToken); let searchOrderResp={}; try{ searchOrderResp = await invokeURL({ url: 'https://'+process.env.crmapiurl+'/crm/v4/Orders/search?criteria=((OrderID:equals:' + cxorderid + '))', type: 'GET', headers: header_data }); }catch(e) { logger.info("ERROR DURING SEARCH ORDER : : "+e); searchOrderResp={}; } logger.info("Result of search Order: : : "+JSON.stringify(searchOrderResp)); if(searchOrderResp.data!=undefined) { const recordId = searchOrderResp.data[0].id; //logger.info("Result of search Order: : : "+JSON.stringify(searchOrderResp.data[0])); const recordEmail=searchOrderResp.data[0].Email; const recordorderId=searchOrderResp.data[0].OrderID; if(cxemailid == recordEmail && cxorderid == recordorderId) { const updateData = [ { id: recordId, Delivery_Address: cxaddr } ]; const updateDataMap = { data: updateData }; const updateResp = await invokeURL({ url: 'https://'+process.env.crmapiurl+'/crm/v2/Orders', type: 'PUT', body: updateDataMap, headers: header_data }); logger.info('Update Response: ' + JSON.stringify(updateResp)); result.message = 'Delivery address updated successfully.'; } else{ result.message='Given Order ID or Email is not proper. Please check and retry'; } } else { result.message='Given Order ID or Email is not proper. Please check and retry'; } }; await executeChangeDeliveryAddressLogic(); return result; break; case "rescheduleorderdate": logger.info('Inside NameSpace ' + request.action.namespace); const executeChangeDeliveryDateLogic = async () => { const token=await getCRMToken(request); const accessToken = 'Zoho-Oauthtoken ' + token; logger.info('Access Token: ' + accessToken); const header_data = new Map(); header_data.set('Content-Type', 'application/json'); header_data.set('Authorization', accessToken); const cxemailid = request.params.cxemail; const cxorderid = request.params.cxorderid; let searchOrderResp={}; try{ searchOrderResp = await invokeURL({ url: 'https://'+process.env.crmapiurl+'/crm/v2/Orders/search?criteria=((OrderID:equals:' + request.params.cxorderid + '))', type: 'GET', headers: header_data }); }catch(e) { searchOrderResp={}; } if(searchOrderResp.data!=undefined){ logger.info("Result of search Order: : : "+JSON.stringify(searchOrderResp.data[0])); const recordId = searchOrderResp.data[0].id; const recordEmail=searchOrderResp.data[0].Email; const recordorderId=searchOrderResp.data[0].OrderID; if(cxemailid == recordEmail && cxorderid == recordorderId) { const datemap = { id: recordId, Expected_Delivery_Date: new Date(request.params.cxdate).toLocaleDateString() }; const updatedata = [datemap]; const updatedatamap = { data: updatedata }; logger.info("update Map : : : "+JSON.stringify(updatedatamap)); const updateResp = await invokeURL({ url: 'https://'+process.env.crmapiurl+'/crm/v2/Orders', type: 'PUT', body: updatedatamap, headers: header_data }); logger.info("updateResponse : : : "+JSON.stringify(updateResp)); result.broadcast = { cxemail: request.params.cxemail }; result.message = 'Your order has been rescheduled successfully.'; }else{ result.message='Given Order ID or Email is not proper. Please check and retry'; } } else{ result.message='Given Order ID or Email is not proper. Please check and retry'; } }; await executeChangeDeliveryDateLogic(); return result; break; default : result.message='Given request is invalid. Please check and retry'; return result; break; } //return response; } ``` **welcome.js** ```javascript import logger from "./logger.js"; // welcomeの機能を処理する export default function handleWelcome() { logger.info('Handling welcome request'); return { "welcome_response": { "message": "Welcome to your Bot. Please ask your queries" } }; } ``` **failure.js** ```javascript import logger from "./logger.js"; // failureの機能を処理する export default function handleFailure() { logger.info('Handling failure request'); const result = { "message": "Something went wrong while checking your query. Please try again later." }; return JSON.stringify(result); } ``` **fallback.js** ```javascript import logger from "./logger.js"; // fallbackの機能を処理する export default function handleFallback() { logger.info('Handling fallback request'); const result = { "message": "Sorry couldn't get that." }; return JSON.stringify(result); } ``` **index.js** ```javascript import logger from './logger.js'; import IntegResponse from './integ-response.js'; import handleWelcome from './welcome.js'; import handleFallback from './fallback.js'; import handleExecute from './execute.js'; import handleFailure from './failure.js'; export default async (request, response) => { let jsonResponse = {}; try { logger.info('REQUEST FLOW FOR : : : ' + request.todo); switch (request.todo) { case "welcome": jsonResponse = handleWelcome(); break; case "execute": jsonResponse = await handleExecute(request); break; case "fallback": jsonResponse = handleFallback(); break; case "failure": jsonResponse = handleFailure(); break; default: jsonResponse = JSON.stringify({ "message": "Error Trying to parse your details" }); } } catch (err) { logger.error('Error while executing handler: ' + err); logger.error('REQUEST OBJECT: ' + JSON.stringify(request)); jsonResponse = JSON.stringify({ "message": "Error Trying to parse your details" }); } // レスポンスはIntegResponseオブジェクトにカプセル化する必要があります response.end(new IntegResponse(jsonResponse)); }; ``` > **Note:** このセクションに記載されているすべてのコードを確認し、内容を十分に理解してください。 各関数ファイルとそのロジックを簡単に確認しましょう: 1. **`execute.js`**:このファイルには、eコマースボットのすべてのアクションのメイン実行ロジックが含まれています。これらのアクションはすべて、設定された環境変数を使用してZoho CRMアカウントを認証し、必要な詳細を取得するか、以下に示すアクションを実行します。`ecommerce_function` Catalyst関数の環境変数は、このステップで関数をコンソールにデプロイした後、Catalystコンソールから直接設定します。 * **`listofitems_2`**:このアクションはAPIリクエストを開始し、カスタムCRMモジュール`EcomProducts`に対してGETメソッドをトリガーし、商品名、商品ID、商品画像URL、価格、在庫数を取得します。 * **`placeanorder_4`**:このアクションは、ユーザーから商品IDを入力として受け取ります。次に、EcomProducts CRMモジュールでその商品の在庫状況を確認します。在庫がある場合、ボットはユーザーのメールアドレス、希望配送日、配送先住所の入力を求めます。これらの詳細が入力されると、ボットはAPIリクエストを開始し、カスタムCRMモジュール`Orders`に対してPOSTメソッドをトリガーして注文を作成します。注文が正常に完了すると、チャットボットを通じてユーザーに通知されます。商品の在庫がない場合は、その旨がユーザーに通知されます。 * **`vieworderdetails_3`**:このアクションは[Zoho CRM Search API](https://www.zoho.com/crm/developer/docs/api/v4/search-records.html)をトリガーして、カスタムモジュール`Orders`で検索操作を実行します。顧客名、連絡先番号、メールID、商品名、商品価格、商品画像URL、配送予定日、配送先住所、注文ステータスの詳細がレスポンスとして取得されます。 * **`changedeliveryaddress`**:このアクションは、注文に関連付けられたメールID、注文ID、および配送先住所を入力として受け取ります。カスタムモジュール`Orders`に対して[Zoho CRM Search API](https://www.zoho.com/crm/developer/docs/api/v4/search-records.html)がトリガーされます。指定されたメールIDと注文IDが検証され、カスタムモジュール`Orders`に対してPUTメソッドを実行することで、新しい住所が注文に更新されます。 * **`rescheduleorderdate`**:このアクションは、注文に関連付けられたメールIDと注文IDを入力として受け取ります。カスタムモジュール`Orders`に対して[Zoho CRM Search API](https://www.zoho.com/crm/developer/docs/api/v4/search-records.html)がトリガーされ、指定された注文IDで検索操作が実行されます。メールIDと注文IDが検証され、カスタムモジュール`Orders`に対してPUTメソッドを再度実行することで、次の可能な日付が配送日として更新されます。 上記のアクション名は、コンソールで作成されたアクションのnamespaceです。コードの82行目、145行目、238行目、337行目、407行目のswitchケース`listofitems_2`、`vieworderdetails`、`placeanorder`、`changedeliveryaddress`、`rescheduleordertolaterdate`について、それぞれのアクションに生成されたnamespaceを必ず更新してください。 アクションのnamespaceは、以下のスクリーンショットのようにコンソールから取得できます。 ![copy-namespace](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/copy-namespace.webp) 2. **`welcome.js`:このファイルでは、ユーザーとの新しい会話を開始する際に表示される挨拶メッセージを設定しています。 3. `Fallback.js`:このファイルでは、ボットがユーザーのメッセージを理解できなかった場合に表示されるメッセージを設定しています。この場合、ユーザーが有効なレスポンスを入力してボットが理解するまで、このレスポンスが会話に表示されます。 4. `failure.js`:このファイルでは、ビジネスロジックの実行中に例外が発生した場合にユーザーに表示されるメッセージを設定しています。 5. `index.js`**:これは関数のエントリーポイントであり、ボットの会話中の[`todo`](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/bot-logic/deluge-functions/context-handler-function/#todo)プロンプトに基づいて、execute、welcome、fallback、failureなどの対応するハンドラーファイルをマッピングします。 -------------------------------------------------------------------------------- title: "クライアントの登録" description: "Catalyst ConvoKraft、サーバーレスIntegration関数、およびZoho CRMを使用して、ECサイト向けの会話型セールスアシスタントボットを構成します。ウェブサイトユーザーとの対話や注文管理を行います。" last_updated: "2026-08-17T12:16:04.000Z" source: "https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/register-client/" service: "All Services" related: - APIトークンの生成 (/ja/api/oauth2/generate-access-and-refresh-token/#GenerateAccessandRefreshToken) -------------------------------------------------------------------------------- # クライアントの登録 CRMリソースを効果的に認証するために、アクセストークンを生成する必要があります。以下の手順に従ってください。 1. [ZohoのAPI Console](https://api-console.zoho.com/)にログインします。**Self Client**をクリックします。 ![choose-self-client](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/choose-self-client.webp) 2. 以下のスコープを追加し、スコープの有効期限を設定して説明を入力します。**Create**をクリックします。スコープの詳細については、[こちらのセクション](https://www.zoho.com/crm/developer/docs/api/v6/scopes.html)をご覧ください。 ![edit-self-client](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/edit-self-client.webp) 3. ポータルとして**CRM**を選択し、右側のペインでプロジェクトを選択します。**Create**をクリックします。 ![choose-portal](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/choose-portal.webp) 4. 指定されたスコープに対して[Grant token](https://docs.catalyst.zoho.com/ja/api/oauth2/generate-grant-token/#GenerateGrantToken)が生成されます。Client Secretタブから[Client ID](https://docs.catalyst.zoho.com/ja/api/oauth2/register-new-client/)と[Client Secret](https://docs.catalyst.zoho.com/ja/api/oauth2/register-new-client/)の資格情報を取得できます。[こちらのページ](https://docs.catalyst.zoho.com/ja/api/oauth2/generate-access-and-refresh-token/#GenerateAccessandRefreshToken)に記載されている手順に従って、アクセストークンとリフレッシュトークンを生成する必要があります。 > **Note:** これらの資格情報を必ず保存してください。[このステップ](https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/deploy-to-console)で、これらの値を関数の環境変数として設定します。 -------------------------------------------------------------------------------- title: "クライアントの設定" last_updated: "2026-02-23T12:39:41.000Z" source: "https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/configure-client/" service: "All Services" related: - ConvoKraft JS SDK (/ja/convokraft/sdk/js/overview/) -------------------------------------------------------------------------------- # クライアントの設定 それでは、クライアントコンポーネントを設定しましょう。初期化したクライアントディレクトリには以下が含まれています: * フロントエンドアプリケーションのHTMLコード用の`index.html`ファイル * CSSコード用の`main.css`ファイル * JavaScriptコード用の`main.js`ファイル * `client-package.json`設定ファイル このzipファイルをダウンロードし、中のすべてのファイルをコピーして、クライアントディレクトリに作成されたデフォルトのクライアントファイルと置き換えることができます。この[gitリポジトリ](https://github.com/catalystbyzoho/tutorial-convokraft)には、デフォルトのファイル以外にも追加のファイルが含まれています。クライアントコード全体と必要な画像やアイコンファイルがすべてパッケージされていますので、zipファイルとしてダウンロードしてください。 > **Note :** 各ファイルのコードを確認し、内容を十分に理解してください。 Catalystでは、[Catalyst Webクライアントホスティング](https://docs.catalyst.zoho.com/ja/cloud-scale/help/web-client-hosting/introduction/)コンポーネントを使用して、Webアプリケーションのクライアント部分をホストできます。[先ほど作成した](https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/configure-function/)関数と一緒に、チュートリアルの[このステップ](https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/deploy-to-console/)でクライアントをコンソールにデプロイします。 ### ウェブサイトへのボットの埋め込み ConvoKraftボットをアプリケーションに埋め込むには、クライアントディレクトリの`contact.html`ファイルに以下のJavaScriptコードスニペットを追加して保存してください。また、ConvoKraftボットの外観をカスタマイズするためにクライアントアプリケーションにすぐに組み込める定義済みメソッドを含む[ConvoKraft Javascript SDK](https://docs.catalyst.zoho.com/ja/convokraft/sdk/js/overview/)パッケージも提供しています。 ```xml <script src="https://console.catalyst.zoho.com/convokraft/assets/js/convokraft-chat-sdk.js"> </script> <style> div.anchor_zia_toBottom { width: 330px; height: 450px; position: fixed; bottom: 0; right: 0; } </style> <div class="anchor_zia_toBottom"> <convokraft-chat-bot bot-name="ecommercebot_2" project-id="10644000000029001" org-id="74779991"> </convokraft-chat-bot> </div> ``` > **Note :** 上記のコードのボット名、プロジェクトID、組織ID属性に正しい値を設定してください。コンソールで`EcommerceBot`を開き、Bots Detailsページでボットのnamespaceが`bot-name attribute`の値となります。 このページのURLを取得します。以下のように表示されます: [https://console.catalyst.zoho.com/baas/74779991/project/10644000000029001/Development#/convokraft/bots/50803000000018005](https://console.catalyst.zoho.com/baas/74779991/project/10644000000029001/Development#/convokraft/bots/50803000000018005) ここで「74779991」が`orgID`、「10644000000029001」が`projectID`です。 -------------------------------------------------------------------------------- title: "コンソールへのデプロイ" description: "Catalyst ConvoKraft、サーバーレスIntegration関数、およびZoho CRMを使用して、ECサイト向けの会話型セールスアシスタントボットを構成します。ウェブサイトユーザーとの対話や注文管理を行います。" last_updated: "2026-11-03T07:48:52.000Z" source: "https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/deploy-to-console/" service: "All Services" related: - Catalystプロジェクトのデプロイ (/ja/cli/v1/deploy-resources/introduction/) -------------------------------------------------------------------------------- # コンソールへのデプロイ コンソールからConvoKraftで設定済みのeコマースボットをトレーニングおよびテストするには、まずプロジェクトをコンソールにデプロイする必要があります。 1. CLIから[Catalystプロジェクトをデプロイ](https://docs.catalyst.zoho.com/ja/cli/v1/deploy-resources/introduction/)するには、プロジェクトディレクトリからターミナルで以下のコマンドを実行します: ```sh catalyst deploy ``` ![deploy-command](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/deploy-command.webp) 関数ディレクトリをデプロイすると、CatalystコンソールのServerless Functionsコンポーネントで利用可能になります。 ![uploaded-function](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/uploaded-function.webp) 2. 関数名**ecommerce_function**をクリックします。**Code**タブに切り替えます。ここから関数を編集し、必要に応じて**Save**をクリックできます。 ![functions-overview](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/functions-overview.webp) 3. **Configuration**タブに切り替え、**Environmental variables**タブを展開します。**Create Variable**をクリックします。 ![create-env](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/create-env.webp) 4. キーとして`client_id`を入力し、[このステップ](https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/register-client)で先ほど保存したClientIDの値をDevelopment valueとして追加します。**Save**をクリックします。 ![add-env](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/add-env.webp) 同様に、以下の環境変数を作成する必要があります:
Key Development Value
`client_secret` API Consoleから取得した値
`auth_url` https://accounts.zoho.com/oauth/v2/auth
`refresh_url` https://accounts.zoho.com/oauth/v2/token
`refresh_token` API Consoleから取得した値
`crmapiurl` www.zohoapis.com
> **Note :** 1. `client_secret`と`refresh_token`の値は、[このステップ](https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/register-client)で生成した資格情報です。 2. `crmapiurl`、`auth_url`、`refresh_url`の値については、お使いのDC固有のURLを設定してください。 クライアントのホスティングに進む前に、作成したCatalyst関数をConvokraftボットに関連付ける必要があります。以下の手順に従ってください。 ConvoKraftサービスに移動し、**EcommerceBot**をクリックします。Bots Detailsページが表示されます。以下のスクリーンショットのように**Edit Details**をクリックします: ![edit-details](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/edit-details.webp) Edit Botダイアログボックスで、**ecommerce_function**を選択し、**At the end of an action context**を選択して**Save**をクリックします。 ![associate-function](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/associate-function.webp) 以下のスクリーンショットのように、Catalystコンソールの左ペインにあるアイコンをクリックして**CloudScale**サービスに移動します。**Web Client Hosting**をクリックします。ここからホストされたクライアントのURLにアクセスできます。Webクライアントホスティングコンポーネントの詳細については、[こちらのページ](https://docs.catalyst.zoho.com/ja/cloud-scale/help/web-client-hosting/implementation/)をご覧ください。 ![web-url](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/web-url.webp) -------------------------------------------------------------------------------- title: "ボットのトレーニングとテスト" description: "Catalyst ConvoKraft、サーバーレスIntegration関数、およびZoho CRMを使用して、ECサイト向けの会話型セールスアシスタントボットを構成します。ウェブサイトユーザーとの対話や注文管理を行います。" last_updated: "2026-08-17T12:16:04.000Z" source: "https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/train-and-test-the-bot/" service: "All Services" related: - プロジェクトディレクトリ構造 (/ja/cli/v1/project-directory-structure/introduction/) -------------------------------------------------------------------------------- # ボットのトレーニングとテスト 必要なアクションを作成し、ビジネスロジックを設定した後、Bots Detailsページから`Train`と`Test this bot`をそれぞれクリックして、すべてのアクションでボットを[トレーニング](https://docs.catalyst.zoho.com/ja/convokraft/help/manage-a-bot/train-a-bot/)およびテストできます。 ![train-bot](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/train-bot.webp) 表示されたサジェストからタスクを選択するか、チャットウィンドウで新しい会話を開始できます。`Test this bot`機能の詳細については、[こちらのページ](https://docs.catalyst.zoho.com/ja/convokraft/help/manage-a-bot/test-a-bot/)をご覧ください。 **list the items available in the store**をクリックします。 ![bot-options](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/bot-options.webp) ボットが`EcomProducts` CRMモジュールからリストを取得し、ユーザーに表示します。 ![bot-list-items](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/bot-list-items.webp) 利用可能な商品のリストを確認し、次のステップで注文するために必要な商品IDをメモしてください。 ![items-response](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/items-response.webp) 次に、**I want to place an order**をクリックします。商品ID、メールアドレス、配送先住所など、ボットが要求する情報を入力します。 ![place-order-in-bot](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/place-order-in-bot.webp) 注文が正常に行われました。 ![placed-order](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/placed-order.webp) EcommerceBotで注文の詳細を確認するために、注文IDをメモしてください。 次に、注文の詳細を確認してみましょう。**View my Order**をクリックします。注文に関連付けられたメールアドレスを入力します。 ![view-order-in-bot](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/view-order-in-bot.webp) `Orders` CRMモジュールから注文の詳細が取得されました。 同様に、該当するサジェストをクリックして、注文を後日に再スケジュールできます。また、直接クエリを入力してボットとチャットすることもできます。 ![reschedule-order-in-bot](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/reschedule-order-in-bot.webp) 注文が正常に再スケジュールされました。同様に、必要に応じて注文の配送先住所を変更することもできます。 ![reschedule-order-in-bot](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/updated-delivery.webp) 注文に新しい配送先住所が更新されました。 これで、開発環境でボットのテストが正常に完了しました。次のセクションでは、本番環境へのデプロイを行います。 -------------------------------------------------------------------------------- title: "本番環境へのデプロイ" description: "Catalyst ConvoKraft、サーバーレスIntegration関数、およびZoho CRMを使用して、ECサイト向けの会話型セールスアシスタントボットを構成します。ウェブサイトユーザーとの対話や注文管理を行います。" last_updated: "2026-08-17T12:16:04.000Z" source: "https://docs.catalyst.zoho.com/ja/tutorials/ecommerce-bot/nodejs/deploy-to-production/" service: "All Services" related: - プロジェクトディレクトリ構造 (/ja/cli/v1/project-directory-structure/introduction/) -------------------------------------------------------------------------------- # 本番環境へのデプロイ 開発環境でeコマースボットのテストが完了したら、[ボットを本番環境にデプロイ](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction/)できます。これは、特定の[ConvoKraftボットを単独でデプロイ](https://docs.catalyst.zoho.com/ja/convokraft/help/manage-a-bot/deploy-a-bot/)し、その後プロジェクト全体を本番環境にデプロイして関連する関数のデプロイを有効にすることで行います。 1. ボットを本番環境にデプロイするには、Bots Detailsページに移動し、**Deploy to Production**をクリックします。 ![deploy-to-production](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/deploy-to-production.webp) 2. *Deploy to Production*ダイアログボックスで、**Include Catalyst Function Properties**を有効にします。必要なリリースタイプを選択し、**Deploy**をクリックします。 ![deploy-to-prod-popup](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/deploy-to-prod-popup.webp) 3. ボットを本番環境にデプロイした後、以下のスクリーンショットのように、コンソールから直接本番環境に切り替えることができます。 ![switch-environments](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/switch-environments.webp) ボットの使用を開始した後、ボットのDetails Pageで**Usage stats**タブをクリックして、ボットの[使用統計](https://docs.catalyst.zoho.com/ja/convokraft/help/manage-a-bot/usage-stats/)を確認できます。使用統計の詳細については、[こちらのページ](https://docs.catalyst.zoho.com/ja/convokraft/help/manage-a-bot/usage-stats/)をご覧ください。 ![usage-stats-scree](https://catalyst-docs-development.zohostratus.in/images/tutorials/ecommerce-bot/usage-stats-scree.webp) > **Note:** **Client**タブと**Usage stats**タブは、本番環境でのみ有効になります。