Webhook とは
メッセージの送信などのトークルーム内で発生したイベント情報を、ユーザーが設定したWebhook URLに通知する機能です。Webhookを使うことで、DiSCUS上で動作する対話型Botのような外部サービスと連携できるようになりますので、ぜひご活用ください。
※テナント管理者が機能制限している場合、Webhook機能は利用できません。
Webhook の設定方法
DiSCUS の設定画面から、チャット設定→Webhook 設定と進むと、Webhook の作成、変更、削除を行う事ができます。
1.画面右上の［管理画面］アイコンを押下します。
2.画面左のメニューから［チャット設定］を押下します。
3.［Webhook設定］を押下します。
4.［Webhook新規作成］アイコンを押下します。
5.Webhook機能を利用したいユーザーを選択します。
6.必要項目を入力し［作成］を押下することでWebhookの作成が完了します。
Webhook設定項目詳細
| 項目 | 必須 | 内容 | 備考 |
|---|---|---|---|
| 対象ユーザ | 〇 |
Webhook を設定するユーザを１名指定します。
|
Webhook 作成時に決定し、以後変更不可です。
|
| 送信先URL | 〇 |
メッセージやイベントを送信するURLを指定します。
|
http または https スキームのURLを設定
|
| Webhook説明 |
メモ用の任意文字列
|
Webhookの挙動には影響しない
|
|
|
シークレットキー
|
〇 |
DiSCUS からのリクエストを検証するためのキーです。任意文字列を指定してください
|
|
|
通知失敗時の再通知
|
ー |
送信先URLへのリクエストに失敗した際、
一定期間・回数のリトライを行うかどうかの On / Off 設定 |
ユーザ様の都合にて、イベントの重複受信制御などが難しい場合には Off を選択してください
|
| 設定の有効無効 | ー |
この Webhook を有効にするかどうかの On / Off 設定
|
初期状態ではオン（有効状態）に設定されています。 |