Webhook(受信)コネクタ

Webhook(受信)コネクタ

概要

主にWebアプリケーション内で、特定のイベントが発生したらJENKAに対して通知する機能です。
Webhookの利用については、Webアプリケーション側の設定などを行う必要があります。Webhookの設定方法は、Webアプリケーション側の設定手順を参照してください。

設定手順

  • Webhookの送信元に合わせたHTTPメソッドや認証情報などを設定します。設定例も 
    項目名
    必須
    		内容備考
    コネクタ名
    〇
    		対象のコネクタ名を記載ex.X時間ごと○○等わかりやすいもの　
    Webhook URL
    〇
    		URLをコピーして送信側のWebアプリケーションで利用
    URLがコネクタ毎に準備
    HTTPメソッド
    〇
    		POSTかGETを選択Webアプリケーションにより異なる
    WEBHOOKを受信する

    		トリガーの対象となるフォルダ許可したフォルダから選択
    受信に成功すると、受信したデータのパラメータが表示されます。

    		設定が完了したら、一度Webhookの受信実施。 
    受信が成功すると、パラメータ表示欄に受信したキーの一覧が表示。
    受信したデータをもとに、キーを変数として、データの内容を値として保持して、後続のワークフローで偏すとして利用可能。


    Webアプリケーションの設定例などを参照ください。

  • JENKA：受信ボタンをクリックして、システム側でテストの動作
         


  •   以下のような状態になります。この間に、連携先のWebアプリケーションでWebhookを対象データを送信してください。
     

  • JENKAWebhookが受信できるとキーの一覧が表示されて完了です。

  • 後続のワークフロー作成後に公開をして、Webhookが利用できるようになります。


    • 設定例


    接続するWebサービスにより接続方法が異なります。いくつかの設定例を掲載しますのでご参照ください。

    Chatworkの設定例

    ＜JENKA側パラメータ設定＞
    メソッド：POST
    認証：NONE


    ＜Chatwork側の設定＞
    1.右上の選択メニューからサービス連携を選択


    2.Webhookの新規作成をクリック

    3.以下の通り設定し保存。
    　WebhookURL：JENKA側のWebhookコネクタで発行されたURLを貼り付け
    　イベント：ルームイベントを選択、Webhookを動かす為のアクションを選択
        ルームID：Webhookを利用するルームIDを入力
             ※ルームIDは、送信したい先のURLに記載のある数字の部分です。こちらを記載します。
       

    webhookに戻り、「webhook」を受信するにした状態で、ChatworkでWebhookを設定したマイチャットやグループでテスト送信を行ってください。

    kintoneの設定例

    ＜JENKA側パラメータ設定＞
    メソッド：POST
    認証：NONE
    ＜Kintone側設定＞
    1.利用したアプリ内の歯車の設定ボタンより「アプリの設定」画面に遷移

    2.設定タブを開き、「Webhook」を選択
    3. Webhookの一覧画面に遷移するので、「+追加する」ボタンから「Webhookの作成」に遷移
    4.下図、赤枠の欄にJENKAでコピーとURLを貼り付けする。また通知する際の条件を指定

    Salesforceの設定例

    ＜JENKA側パラメータ設定＞
    メソッド：POST
    認証：NONE

    ＜Salesforceの設定箇所＞
    1.設定箇所は、検索窓で「ワークフロールール」を検索



    2.「ワークフロールール」に遷移したら、以下の赤枠部分をクリック


    3.以下の「編集」をクリックし、Webhookのエンドポイントを設定。

    BowNowの設定例

    ＜JENKA側パラメータ設定＞
    メソッド：POST
    認証：NONE

    ＜Bownow側の設定＞
    の説明に従い、Bownow側でWebhookの設定

    Backlogの設定例

    ＜JENKA側パラメータ設定＞
    メソッド：POST
    認証：NONE

    ＜Backlog側の設定＞
    1.プロジェクトの設定画面にクリックして、インテグレーションメニューの中のWebhookの編集をクリック

    2.Webhook を追加するをクリック

    3.WebhookURLにJENKA側のWebhookコネクタで発行されたURLを貼り付け。
    通知するイベントを選択して、「Webhookを追加する」をクリックして設定は完了。

    Boxの設定例



    注意事項

    サービスによりWebhookの利用について制限事項があるため、利用先の制限事項を確認してください。



      • Related Articles

      • Zoomコネクタ

        トリガーコネクタ用の認証方法 事前にワークフロー上で、コネクタ追加 > 「トリガー」タブ > Zoom を選択してコネクタを設置し、Zoomトリガーコネクタの設定を開いておいてください。 設定画面の中で空欄の Secret Token の値と、Webhook URL 以下の項目については以降の手順で使用します。 Zoom側でのアプリ(App)の作成方法 https://marketplace.zoom.us/ にログインします 画面右上のメニューより、Develop > Build App ...

      • Boxコネクタ

        ファイルIDとフォルダIDについて Boxで連携を行うためには、ファイルIDとフォルダIDについての理解が必要になります。 ファイルID ファイルIDは、ファイルのユニークなIDです。ファイルを開いた際に表示されるURLの一部が、ファイルIDとなります。 このURLは、ファイルを開いた際のURLに記載されています。 フォルダID フォルダIDは、フォルダのユニークなIDです。フォルダを開いた際に表示されるURLの一部が、フォルダIDとなります。 アプリ設定 ...

      • Webhook(受信)の設定例 BowNow

        BowNowの設定例 ＜JENKA側パラメータ設定＞ メソッド：POST 認証：NONE ＜Bownow側の設定＞ 1.https://developer.bownow.jp/jp/api/index.html#section/Webhook/スタートガイド の説明に従い、Bownow側でWebhookの設定 設定メニューからwebhookを選択します。 Webhookの設定画面に遷移し、下図の「Webhookを設定」をクリックします。 以下のように設定し、設定登録してください。 項目 内容 ...

      • Webhook(受信)の設定例 Chatwork

        Chatworkの設定例 Chatworkのメッセージのトリガーは、Webhookを利用します。 Chatworkでは、1アカウントあたり5件までWebhookの設定が可能です。（詳しくはこちら参照） ＜JENKA側パラメータ設定＞ メソッド：POST 認証：NONE ＜Chatwork側の設定＞ 1.右上の選択メニューからサービス連携を選択 2.Webhookの新規作成をクリック 3.以下の通り設定し保存。 ...

      • Webhook(受信)の設定例 Box

        Boxの設定例 BoxではWebhookが用意されています。Webhookを作成するには、以下の手順に従います。 開発者コンソールで、カスタムアプリを選択します。 カスタムアプリに関する必要事項を記載して、2ページ分の情報を記載して作成します。オプションについては「自動化」してください。 　　 WebhookV2を利用するのが一般的なので、アプリの承認を管理者が行う必要があります。 [構成]タブをクリックして、開発者操作の[Webhook]にチェックを入れて[変更を保存]します ...