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を追加する」をクリックして設定は完了。

    注意事項

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



      • Related Articles

      • Webhook(受信)の設定例 Teams

        Teamsの設定例 送信Webhookを作成し、カスタムボットをTeamsに追加します。 Webhookを作成するには、以下の手順に従ってください。 1. チームを選択する。 2. 送信Webhookを作成するチームを選択し、ミートボールメニューを選択。 3. ドロップダウンメニューから、[チームを管理]を選択 4. チャネルページのアプリを選択します。 5. [送信 Webhookを作成する]を選択します。 コールバック URLにWebhook(受信)のURLを貼り付けてください。 6. ...
      • Webhook(受信)の設定例 Chatwork

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

        LINE WORKSの設定例 LINE WORKSでWebhookを設定するには以下の手順に従ってください。Botを作成して、Webhookを利用したいチャンネルにBotを招待する流れで設定をおこない 1.Bot登録 まず初めに、LINE WORKS Developers Console(リンク)にてBotの登録を行います。 管理者権限のユーザーでログイン頂き、画面のトップ画像の「Console」をクリックしてください。 Botの設定を行います。 ...
      • Webhook(受信)の設定例 Box

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

        BowNowの設定例 <JENKA側パラメータ設定> メソッド:POST 認証:NONE <Bownow側の設定> 1.https://developer.bownow.jp/jp/api/index.html#section/Webhook/スタートガイド の説明に従い、Bownow側でWebhookの設定