記事の新規作成・更新の通知を設定する

Ichimoto
  • 更新

Kibelaに新規記事が投稿されたり記事にコメントがついた際に、Slack等のツールをはじめとする外部のサービスに通知することができます。

現在、以下のサービスをサポートしています。

  • Slack
  • Microsoft Teams

Slackに通知する方法

- Slack側の操作 -

  1. ブラウザでカスタムインテグレーションのページを開く。
  2. 「Incoming Webhook」をクリック。
    ※Kibelaは旧方式のIncoming Webhookに対応しております。旧方式のIncoming Webhookをこちらより設定してください。
    __________2020-02-26_13.29.09.png
    ※SlackにてIncoming Webhookを設定されていない場合は、設定をオンにしてください。（Slackヘルプセンター参照）

  3. 「Slackに追加」をクリック。
    demo1.png

  4. 「チャンネルを選択」で通知したいチャンネルを選択し「Incoming Webhookインテグレーションの追加」をクリック。
    demo2.png

  5. Webhook URLをコピーし保存しておく。
    demo4.png

 

- Kibela側の操作 -

  1. ヘッダー内のユーザーアイコンから、"設定"をクリック
  2. 左メニューの"Outgoing Webhooks"をクリックFireShot_Capture_059_-____________-_bitjourney_Kibela_-_bitjourney.kibe.la.png
    「Webhooksを追加」をクリックし希望の通知先を選択。Slackを選択します。
    demo1.png

  3. Webhookの設定を行います。FireShot_Capture_061_-_Slack_-_Webhook____-_bitjourney_Kibela_-_bitjourney.kibe.la.png


    Webhook一覧での”表示名”を設定します。

    何の為の通知かわかる名称を付けていただくことを推奨しています。（下記画像参考）
    FireShot_Capture_062_-_Outgoing_Webhooks_-_bitjourney_Kibela_-_bitjourney.kibe.la.png

    Slackの”通知用URL”を設定します。

    Slackで発行することができる通知用のURLです。URLの発行方法は、Slackヘルプ：Slack でのIncoming Webhook の利用をご確認ください。
    　FireShot_Capture_064_-_Slack_-_Webhook____-_bitjourney_Kibela_-_bitjourney.kibe.la.png


    ”共同編集”の条件を設定します。

    すべての記事、記事作成者のみが編集可能な記事、チーム全員が編集可能な記事の種類によって、通知の有無を設定することができます。
    　__________2019-10-22_14.14.50.png


    通知対象の”グループ”を設定します。

    通知したいグループを選択します。
    __________2019-10-22_14.21.53.png


    通知イベントの条件を設定します。

    「記事を投稿したとき」「記事を更新したとき」「コメントを投稿したとき」など、通知したいイベントを設定します。

　　FireShot_Capture_065_-_Slack_-_Webhook____-_bitjourney_Kibela_-_bitjourney.kibe.la.png

なお、「監査ログが記録されたとき」を選択できるのはオーナーもしくは管理者の権限があるユーザーのみで、それ以外のユーザーには項目自体が表示されません。


全ての設定が完了し終えたら「テスト送信」をクリックします。

設定した条件で通知が行われるかテストが実施され、成功すると「追加する」をクリックできるようになります。追加すると設定完了となります。

Microsoft Teamsに通知する方法

- Microsoft Teams側の操作 -

    1.  Microsoft Teamsの設定画面を開きます。
      投稿タブの3点アイコン＞コネクタをクリック
      demo1.png

    2. Incoming Webhook設定を開きます。
      Incoming Webhookの「追加」をクリック
      demo.png
      demo3.png

    3. Webhookを作成します。Kibelaと関連付いていることが分かる名前・画像を設定していただくことを推奨しています。
      ①Webhookの名前を設定（「Kibela Webhook」など）
      ②関連付ける画像（任意）よろしければ、以下の木部さん画像を「名前を付けてダウンロード」してお使いください。
      kibe1.png
      demo.png
      上記2つを設定し「作成」をクリック。

    4. Webhook URLをコピーします。
      生成されたWebhook URLをコピーし保存してください。（Kibela側の設定時に、このURLが必要となります。）
      demo1.png
        Microsoft Teamsの操作は以上です。

 

        次は、Kibela側の設定に移ります。



- Kibela側の操作 -

  1. ヘッダー内のユーザーアイコンから、"設定"をクリック
  2. 左メニューの"Outgoing Webhooks"をクリックFireShot_Capture_059_-____________-_bitjourney_Kibela_-_bitjourney.kibe.la.png
    「Webhooksを追加」をクリックし希望の通知先を選択。「Microsoft Teams」を選択します。
    demo.png

  3. Webhookの設定を行います。
    demo.png
    ① Webhook一覧での表示名を設定します。
    ② Microsoft Teams側の操作で取得した「Webhook URL」を貼り付けます。
    ③ 通知対象の記事の”共同編集の有効・無効”を設定します。例えば、共同編集が有効の記事の通知のみを受け取りたい場合は、「共同編集が有効の記事」を選択します。
    ④ 通知対象のグループを設定します。
    ⑤ 通知するイベントを設定します。

全ての設定が完了し終えたら「テスト送信」をクリックします。
demo2.png

設定した条件で通知が行われるかテストが実施され、成功すると「追加する」をクリックできるようになります。
demo3.png
「追加する」とクリックすると設定が完了となります。

 

サポート対象サービス以外に通知する方法

現在、Kibelaでは通知先としてSlack・Microsoft Teamsのみ簡単に設定できるようサポートしています。

一般的なOutgoing Webhookも提供しておりますので、その他のサービスへ通知設定を行いたい場合には、Outgoing Webhookの出力を加工してお使いください。

また、KibelaではZapier連携をベータ版として提供しています。
通知先がZapierに対応している場合には合わせてそちらもご確認ください。

関連記事