SuperSaaS-FAN
〜 SuperSaaSの使い方 〜

Loading...

SuperSaaS管理メニューの環境設定の連携「Webhooks」でできること

【修正更新:2023-09-12】管理メニューの改修
SuperSaaSの管理メニュー改修に伴い、管理メニューの連携の中のWebhooksから遷移できるようになりましたので、掲載内容を調整しました。

ウェブフックをカスタマイズして拡張活用

SuperSaaSはウェブフックを活用できます。
SuperSaaS上でのアクションをトリガーとして、対応する情報がプッシュされますので、システムの構築や他サービスとの連携など自己構築することが可能です。

ウェブフックの管理機能は試用版として一定の期間を試用としてテスト利用できますが、無料版では継続して利用できません。

有料版に限定されるのはウェブフックをSuperSaaSでカスタマイズするウェブフックの管理機能であり、ウェブフック機能自体は無料版でも随時利用できるようでもあります。

SuperSaaSのウェブフック機能

SuperSaaSのウェブフック機能は大きく2つあります。

一つ目は、ごく簡単にカレンダーサービスやスケジュールサービスと連携できる機能で、各スケジュール管理の同期やシステムメニューの連携から設定できます。

もう一つは、少し高度なウェブフックカスタマイズ機能です。
規定のトリガーに対して独自のURLに対してプッシュしたり、独自にカスタマイズしたデータをプッシュするなどウェブフック自体をもカスタマイズできる機能です。
システムメニューの連携にあるWebhooksから設定できます。

ウェブフックのカスタマイズ管理

ウェブフック管理画面で、登録実装中のウェブフック一覧と、新規のウェブフックの登録ができます。

ウェブフック一覧

ウェブフック管理画面では登録実装中のウェブフックが一覧として確認できます。

設定概要
IDウェブフック管理用のユニーク番号です。
Trigger情報がプッシュされるトリガーとなる条件です。
Target URL情報のプッシュ先のURLです。
作成日時ウェブフックの作成日時です。
Errorsウェブフック処理でエラーが発生した場合カウントされます。
操作
アイコン名称概要
編集ウェブフックの編集画面を開きます。
消去ウェブフックを削除します。
ゴミ箱機能がないので削除したウェブフックは元に戻せません。

新規ウェブフック登録

管理画面から新規にウェブフックを登録できます。

利用可能なトリガーを選択し、データのプッシュ先URLを指定してwebhook作成をクリックするだけで登録実装されます。

トリガーによっては、対象となるスケジュールやフォームの選択肢が追加されます。
登録すると、ウェブフックの編集画面に遷移します。

ウェブフックの編集

登録したウェブフックをカスタマイズできます。

Payloadはプッシュされるデータの設定です。

データフォーマットはJSON形式です。
全てのフィールド
トリガーに関わる全てのフィールドデータがプッシュされます。
不使用
フィールドデータをプッシュしません。
カスタム
プッシュ内容を任意のフォーマットにカスタマイズできます。

操作
メニュー概要
webhookのテスト設定中のウェブフックを実際にテストできます。
webhook更新編集内容を確定して管理画面に戻ります。
webhook削除ウェブフックを削除します。
戻るウェブフック管理画面に戻ります。

ウェブフックのテストで実際にプッシュされるデータを確認しましょう。

ウェブフックのテスト

ウェブフックのテストで実際にポストされる情報を確認できます。

Post payload nowで実行にターゲットURLまでポストします。プッシュ先の挙動の動確も合わせて行いましょう。

ウェブフックの仕様やカスタマイズ、管理に関する公式情報はほとんどありません。
公式に公開されている仕様定義が少ないので、思いつきのような仕様改修が行われる可能性もありますので、そのつもりで活用することを推奨します。
ビジネス活用される場合は、仕様詳細などを公式に問い合わせながらの設計が安心かもしれません。
【修正更新:2024-06-26】参照リンクを英語版公式サイトへ変更
SuperSaaS公式日本語サイトの開発者向け情報関連ページが削除されたため、オリジナルの英語版サイトへリンクを変更しました