使用例

Webhookブロックの追加

1. ［設定］ → ［一般］ → ［案内チャット］ に移動します。
   
2. Webhookブロック を追加したい フロー を選択します。
   
3. 案内チャットの編集画面で、 ［ブロックを追加する］ ボタン（ ）をクリックします。
   画面右側に ブロック追加用の設定画面 が表示されます。
4. この画面で ［処理ブロック］ を選択し、 ［Webhook］ を選択します。
   
   
   
   
5. 表示されたWebhookの設定画面で、以下の詳細を入力します。
   
1. ブロック名 ：ブロック名を入力します。例：連絡先の取得処理
   
2. メソッド ：APIの実行のためのメソッドの種類を一覧から選択します。
   
1. GET ：既存のデータを取得します。
   
2. PATCH ：既存のデータの一部を更新します。
   
3. POST ：データを作成するか、既存のデータを更新します。
   
4. PUT ：データの一部を修正します。
   
5. DELETE ：既存のデータを削除します。
   このAPIの実行後、WebhookのURLは処理に関する情報の受信を停止します。
3. URL に外部アプリのREST APIのURLを入力します。
   
6. クエリーパラメーター の項目をクリックして、データの並び替えやフィルターの条件を入力します。例：@email
   
7. APIの実行を選択した場合、ヘッダーとして組織IDまたはポータルIDを入力します。組織ID／ポータルIDは、 ヘッダー の値として送信される必要があります。
   APIの実行では、このポータルIDから処理が実行されます。
   
   
   
   
8. 本文のセクションでは、 JSON を選択して項目を追加するか、 ファイルのアップロード を選択してファイルをアップロードします。
   
1. JSON を選択した場合は、次の設定を行います。
   
1. 必須の変数： APIドキュメントで必須の変数を追加します。これらの項目は、Zohoサービスまたは外部サービスのポータルで有効になっており、案内チャットの要素と関連付けられている必要があります。変数の値を入力するには、変数と「@」記号を入力し、選択リストの中から変数の値を選択します。
2. カスタム項目： 本文のセクションに、必要に応じて、連携する外部サービスやZohoサービスのポータルで有効なカスタム項目を入力します。
   
2. ファイルのアップロード を選択した場合は、次の設定を行います。
   
1. アップロードファイル用の キー と 値 を入力します。
   
9. ［保存する］ をクリックします。
10. Zoho Deskのポータルとの ［連携］ を設定するには、次のいずれかを選択します。
    
1. サービスを選択： 既存のサービスと連携します
   
2. 独自サービス： 新しい連携を設定します
   

サービスの選択

1. Webhookブロックの追加 の手順1から手順9までを実行します。
   
2. 連携のラベルの隣に表示されている ［追加する］ をクリックします。
   Delugeを通じた連携設定 （DRE：Deluge Runtime Environment）のページが新しいタブで開きます。
3. ［サービスを選択］ で、すでに連携が有効になっている外部サービスまたはZohoサービスを選択します。
4. 連携と連携用リンクの 名前 を入力します。
   メモ： メッセージが表示されたら、サービスの 適用範囲 を選択する必要があります。
5. ［作成して接続する］ をクリックします。
   
6. 組織／ポータルからワークフローに連携できるようにするには、 ［承諾する］ をクリックします。
   連携の概要に関する画面は、以下のように表示されます。
   
   
   
   
7. Webhookブロックの画面の ［連携］ のセクションで、選択リストに連携名を反映させるには ［更新する］ をクリックします。
   
8. ［サービスを選択］の選択リストから、 連携名 を選択します。
   
9. 応答のセクションで ステータス番号（ステータスコード） をクリックして次の操作を実行します。
1. APIドキュメントから取得する ステータス番号 を入力します。
   ステータス番号に合う変数が自動で生成されます。
2. ボットの変数 、 応答の値 、 種類 、 データの種類 を含む応答の値を入力します。
   
3. プラス アイコン（ ）をクリックすると、ボットの変数を追加できます。
   
4. ［保存する］ をクリックします。
   別のステータス番号を追加して、対応するボットの変数を追加する場合は、 ［新しい応答を追加する］ をクリックします。
10. リクエストの制限時間を設定します。
    初期設定の制限時間は8秒です。
11. Webhookブロックで ［保存する］ をクリックします。
    
12. 設定を保存するには、フローで ［下書きを保存する］ をクリックします。
    
13. フローが正常に動作するかを確認するには、 ［プレビュー］ をクリックします。
    

独自サービス

1. Webhookブロックの追加 の手順1から手順9までを実行します。
   
2. 連携のラベルの隣に表示されている ［追加する］ をクリックします。
   Delugeを通じた連携設定 （DRE：Deluge Runtime Environment）のページが新しいタブで開きます。
3. 独自サービス のタブを選択します。
   
   
   
   
4. 独自の連携設定ページで、次の詳細を入力します。
   
1. サービス名
   
2. サービスリンク名
   
3. 認証の種類 - 接続のための認証の種類を選択します
   
4. パラメーターの種類
   
5. 連携名
   
6. 連携リンク名
   
5. ［作成して連携する］ をクリックします。
6. 組織／ポータルから連携できるようにするには、 ［承諾する］ をクリックします。
   連携の概要に関する画面が表示されます。
   
7. Webhookブロックの画面の ［外部連携］ のセクションで、選択リストに連携の名前を反映させるには ［更新する］ をクリックします。
   
8. ［サービスを選択］の選択リストから、 連携 名 を選択します。
   
9. 応答のセクションで ステータス番号（ステータスコード） をクリックして次の操作を実行します。
1. APIドキュメントから取得する ステータス番号 を入力します。
   ステータス番号に合う変数が自動で生成されます。
2. ボットの変数 、 応答の値 、 種類 、 データの種類 を含む応答の値を入力します。
   
3. プラス アイコン（ ）をクリックすると、ボットの変数を追加できます。
   
4. ［保存する］ をクリックします。
   別のステータス番号を追加して、対応するボットの変数を追加する場合は、 ［新しい応答を追加する］ をクリックします。
10. リクエストの制限時間を設定します。初期設定の制限時間は8秒です。
11. Webhookブロックで ［保存する］ をクリックします。
    
12. 設定を保存するには、フローで ［下書きを保存する］ をクリックします。
    
13. フローが正常に動作するかを確認するには、 ［プレビュー］ をクリックします。