# 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サイトに埋め込んだ後、以下のように表示されます:  動作する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**をクリックします。  2. 表示されるポップアップウィンドウで、プロジェクト名に「**Ecommerce**」と入力します。  3. **Create**をクリックします。 プロジェクトが作成され、開きます。  このチュートリアルでは、[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**をクリックします。  2. **Create New Bot**をクリックします。 3. **Create New Bot**ポップアップで、ボット名に「EcommerceBot」と入力します。ボットの簡単な説明を入力し、必要に応じてアイコンも設定します。  4. **Save**をクリックします。続いて表示されるページで、ボットのビジネスロジックを構築する開発プラットフォームを選択します。 このチュートリアルでは、Catalyst Integration **Functions**を使用してバックエンドロジックをコーディングします。Catalyst Integration Functionsの詳細については、[このページ](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/bot-logic/catalyst-integration-functions)を参照してください。  **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**をクリックして新しいアクションを追加します。  2. Eコマースボットの最初のアクションとして、ストアで利用可能な商品を一覧表示するアクションを作成します。 表示されるポップアップウィンドウで、アクション名に「List the items available in Store」と入力します。レスポンスを**Based on a business logic**に選択し、**Next**をクリックします。  3. 該当するサンプル文を設定します。会話形式では、ユーザーはさまざまな方法でこのアクションを呼び出す可能性があります。例えば、「list the items available」や「what are the products available in the store?」などです。  4. このアクションにはパラメータを設定しません。このステップをスキップして**Save**をクリックしてください。  同様に、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**ダイアログボックスが開きます。  パラメータ名に「productid」と入力し、以下の表を参考にプロンプトメッセージを追加します。各パラメータタイプの属性の詳細については、[このページ](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/define-params/#attributes-of-a-param)を参照してください。  このアクションには以下のパラメータを作成します:
| パラメータタイプ | 名前 | プロンプトメッセージ | バリデーション失敗時のプロンプトメッセージ |
|---|---|---|---|
| String | `productid` | Please enter the Product ID | The entered ProductID is invalid. Please check and retry. |
| `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. |
| パラメータタイプ | 名前 | プロンプトメッセージ | バリデーション失敗時のプロンプトメッセージ |
|---|---|---|---|
| `cxemail` | Please provide the email address associated with your order | The entered email address is invalid. Please check and retry. |
| パラメータタイプ | 名前 | プロンプトメッセージ | バリデーション失敗時のプロンプトメッセージ |
|---|---|---|---|
| `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. |
| パラメータタイプ | 名前 | プロンプトメッセージ | バリデーション失敗時のプロンプトメッセージ |
|---|---|---|---|
| `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. |
| フィールド名 | タイプ |
|---|---|
| `EcomProductName` | Single Line |
| `Product_image` | URL |
| `Price` | Number |
| `Inventory Count` | Number |
| `EcomProduct Owner` | User |
| フィールド名 | タイプ |
|---|---|
| `Order Name` | Single Line |
| `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 |
| 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 |