L ステップ を経由して Wisora ボットを利用できます。L ステップから転送された LINE のテキストメッセージを Wisora が受け取り、回答を生成して L ステップの API を利用して返します。

(1) Wisora で L ステップ連携を有効にする

Wisora で、エンドユーザーが送信したテキストメッセージを受け取る機能を有効にします。

1. 管理コンソールにログイン して、メニューの [設置設定] → [L ステップ] を順にクリックします。

   L ステップ画面が表示されます。

2. [L ステップ連携を有効にする] にチェックを入れます。

   L ステップ連携が有効になります。

(2) L ステップに Webhook URL を登録する

L ステップが受け取った LINE のテキストメッセージを Wisora に転送するために、Wisora ボットごとに発行された Webhook URL を、L ステップの Webhook 転送先として登録します。

1. [1.Webhook エンドポイントの登録] で、 [Webhook URL] の [コピー] をクリックします。

   

   Wisora ボットの Webhook URL がコピーされます。

2. L ステップの アカウント設定 画面にアクセスして、 [外部連携設定] タブをクリックし、 [LINE Webhook転送設定] に手順 1 でコピーした Wisora ボットの Webhook URL を入力します。

   

3. [設定を保存] をクリックします。

(3) LINE Official Account Manager に L ステップの Webhook URL を登録する

LINE 公式アカウントが受け取ったメッセージを L ステップへ渡すために、LINE Official Account Manager に、L ステップの Webhook URL を登録します。

1. L ステップの アカウント設定 画面にアクセスして、 [アカウント情報] タブをクリックし、 [L ステップ Webhook URL] の [] → [OK] を順にクリックします。

   

   L ステップの Webhook URL がコピーされます。

2. LINE Official Account Manager にアクセスして、Wisora を利用する LINE 公式アカウントをクリックします。

3. [設定] → [Messaging API] を順にクリックして、 [Webhook URL] に手順 1 でコピーした値を入力し、 [保存] をクリックします。

   

   続けて、この Messaging API 画面で LINE Messaging API の Channel 情報をコピーします。

(4) Wisora に Channel Secret と API アクセストークンを登録する

次の 2 つの値を Wisora に登録します。

1. LINE Official Account Manager にアクセスし、LINE 公式アカウントの Messaging API 画面で、 [Channel Secret] の [コピー] をクリックします。

   

   LINE 公式アカウントの Channel Secret がコピーされます。

2. Wisora の L ステップ画面を表示して、 [2.L ステップの連携設定] の [Channel Secret] に手順 1 で取得した値を入力します。

   

3. L ステップの API 連携 画面にアクセスして、 [認証] タブをクリックし、 [トークンを再発行] → [再発行する] を順にクリックします。

   

   L ステップの API アクセストークンが発行されます。

4. トークンの [コピー] をクリックします。

   

5. Wisora の L ステップ画面を表示して、 [L ステップ API アクセストークン] に手順 4 で取得した値を入力します。

   

6. [保存] をクリックします。

   Channel Secret と L ステップ API アクセストークンが保存されます。

(5) L ステップに API 設定を登録する

Wisora が生成した回答を L ステップ側へ返すために、L ステップの API 連携でカスタム API 設定を追加し、表示されたエンドポイントを Wisora の [API 設定] に登録します。

1. L ステップの API 連携 にアクセスして、 [カスタム API 設定] タブ → [＋新しいエンドポイント] を順にクリックします。

   

   新しいエンドポイント画面が表示されます。

2. [エンドポイントのラベル] に任意のラベル (例: Wisora) を入力して、 [作成] をクリックします。

   エンドポイントが作成されます。

3. エンドポイントをクリックして、 [パラメータ管理] タブをクリックします。

4. [＋新しいパラメータ] をクリックして、以下のパラメータを 1 つずつすべて登録します。

   • パラメータ 1: errorCode

     項目	説明
     [JSON キー]	「errorCode」を入力します。
     [データ型]	「文字列」を選択します。
     [ラベル]	「errorCode」を入力します。

   • パラメータ 2: conversationId

     項目	説明
     [JSON キー]	「conversationId」を入力します。
     [データ型]	「文字列」を選択します。
     [ラベル]	「conversationId」を入力します。

   • パラメータ 3: chatReply

     項目	説明
     [JSON キー]	「chatReply」を入力します。
     [データ型]	「文字列」を選択します。
     [ラベル]	「chatReply」を入力します。

   パラメータをすべて登録すると以下のように表示されます。

   

5. [連携アクション] タブ → [＋連携アクションを追加] を順にクリックします。

   連携アクション新規作成画面が表示されます。

   このアクションに名前を付けて、3 つのテキスト送信アクションを登録します。

6. [連携アクション] に任意のアクション名 (例: アクション) を入力します。

7. [アクション設定] をクリックします。

   アクション設定画面が表示されます。

8. アクション設定画面で、テキスト送信アクションを 3 つ登録します。

   • テキスト送信アクション 1: 通常メッセージ

     errorCode が含まれないことを条件に、chatReply を送信します。具体的には以下の手順で設定します。

     1. [テキスト送信] をクリックします。

        

     2. [条件 OFF] をクリックします。

        

     3. [名前] 、 [タグ] 、 [友だち情報] の [] をクリックして、条件を削除します。

        

     4. [外部 API 連携] をクリックします。

        

     5. エンドポイントのラベル (例: Wisora) → [errorCode] を順にクリックします。

        

     6. 「登録なし」を選択して、 [この条件を設定する] をクリックします。

        

     7. [メッセージ] を以下のように設定します。

        

        chatReply や conversationId は、エンドポイントのラベル (例: Wisora) → [chatReply] などを順にクリックすると挿入できます。

        

   • テキスト送信アクション 2: Wisora で設定したレートリミットを超えたときのメッセージ

     続けて、errorCode に rate_limit_exceeded が含まれることを条件に、エラーメッセージを送信します。具体的には以下の手順で設定します。

     1. [テキスト送信] をクリックします。

        

     2. [条件 OFF] をクリックします。

     3. [名前] 、 [タグ] 、 [友だち情報] の [] をクリックして、条件を削除します。

     4. [外部 API 連携] をクリックします。

     5. エンドポイントのラベル (例: Wisora) → [errorCode] を順にクリックします。

     6. 「完全一致」を選択して、「rate_limit_exceeded」を入力します。

        

     7. [この条件を設定する] をクリックします。

     8. [メッセージ] を以下のように設定します。

        このメッセージはサンプルです。自由に変更できます。

        

        conversationId は、エンドポイントのラベル (例: Wisora) → [conversationId] を順にクリックすると挿入できます。

   • テキスト送信アクション 3: 予期せぬエラーが発生したときのメッセージ

     続けて、errorCode が登録されていて、かつ rate_limit_exceeded と完全一致しないことを条件に、エラーメッセージを送信します。具体的には以下の手順で設定します。

     1. [テキスト送信] をクリックします。

        

     2. [条件 OFF] をクリックします。

     3. [名前] 、 [タグ] 、 [友だち情報] の [] をクリックして、条件を削除します。

     4. [外部 API 連携] をクリックします。

     5. エンドポイントのラベル (例: Wisora) → [errorCode] を順にクリックします。

     6. 「登録あり」を選択します。

        

     7. もう一度 [外部 API 連携] をクリックします。

     8. エンドポイントのラベル (例: Wisora) → [errorCode] を順にクリックします。

     9. 「完全一致除外」を選択して、「rate_limit_exceeded」を入力します。

        

     10. [この条件を設定する] をクリックします。

     11. [メッセージ] を以下のように設定します。

         このメッセージはサンプルです。自由に変更できます。

         

         conversationId は、エンドポイントのラベル (例: Wisora) → [conversationId] を順にクリックすると挿入できます。

9. [この条件で決定する] → [保存] を順にクリックします。

   アクションが保存されます。

(6) Wisora に API エンドポイントを登録する

1. L ステップの API 連携 にアクセスして、 [カスタム API 設定] タブをクリックし、エンドポイントの [] をクリックします。

   

   L ステップのエンドポイント URL がクリップボードにコピーされます。

2. Wisora の L ステップ画面を表示して、 [＋API 設定を追加] をクリックします。

   表に入力欄が追加されます。

3. 以下の項目を設定します。

   項目	説明
   [有効]	チェックを入れると、その API 設定を利用します。
   [名前]	管理用の名前です。Wisora の画面で識別しやすい名称を入力します。
   [エンドポイント（必須）]	手順 1 でコピーした L ステップのエンドポイント URL を入力します。https://api.lineml.jp/ で始まる URL を指定し、同じ URL は重複登録できません。

4. [保存] をクリックします。

   設定が保存されます。

API 設定へ送信される内容

Wisora は、回答を返すときに chatReply、conversationId、errorCode を送信します。L ステップの API 設定では、errorCode を使って配信内容や分岐を設定してください。詳しくは、(5) L ステップに API 設定を登録する を参照してください。