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://zoom.us/ja/signin にログインします 画面右上のメニューより、Develop > Build App ...

      • Boxコネクタ

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

      • Emailコネクタ

        認証方法 Eメールコネクタは、SMTPサーバーにのみ対応しています。 トリガーのEメールについては、認証は不要です。 あらかじめSMTPサーバーのアカウント情報、パスワード、ポート番号などをご確認ください。 SMTPサーバーに関するご不明点やご質問につきましては、メールサーバーの管理者やメールホスティングなどの事業者様にご確認をお願いします。 コネクタ認証画面まではコネクタ認証を参照 ※コネクタからも直接認証を追加することが出来ます。コネクタを開いてボタンをクリックしてください。 ...

      • Gmailコネクタ

        認証方法 サービス認証画面まではサービス認証を参照 ※コネクタからも直接認証を追加することが出来ます。コネクタを開いてボタンをクリックしてください。 Googleにログイン済みの場合、認証画面が表示（ログインしていない場合はログイン画面）>接続したいアカウントを選択 アクセスできる情報を選択して続行をクリックします。※メールトリガーや下書き保存を利用する際は「すべて選択」で進めてください。 認証に成功すると以下のような画面が表示されます。✖ボタンで閉じてください。 ...

      • Slackコネクタ

        ご利用手順の概要 最初にJENKAからSlackとの認証を行ってください。認証後、Slackで利用するチャンネルにJENKAのアプリを設定します。 その後、JENKAにもどり、トリガーやアクションの設定を行ってください。 Slackの認証方法 Slackの認証方法について説明します。 あらかじめSlackにログインをして利用できる状態にしてから、ワークフローでSalckのコネクタを選択してください。 コネクタを開いてボタンをクリックしてください。 ...