しくみ
ジョブをスケジュールする
選んだ時刻にタスクを実行します。
Webhookを追加する
何かが起きた瞬間に、ほかのツールへ知らせます。
イベントを選ぶ
サイトの公開、フォームの受信、レコードの変更があったとき。
定期ジョブ
スケジュールジョブは、設定したスケジュールで指定のアドレスを呼び出します。サイト自身の /api/ のパスか、公開されている任意のhttpsアドレスを指定し、GETまたはPOSTを選びます。用途が分かるように名前を付けてください。
スケジュールは、多くのスケジューラーが読み取る5つのフィールド(分、時、日、月、曜日)で指定します。直接入力するか、プリセットから始められます。プリセットは、5分ごと、毎時、毎日09:00、毎週月曜09:00、毎月1日です。各ジョブは選んだタイムゾーンで実行され、次の実行予定がスタジオに表示されます。
時計の切り替えは自動で処理されます。時計が戻るときに2回ある時刻は1回だけ実行され、時計が飛ばす時刻は切り替え直後の最初の瞬間に実行されるので、毎日02:30のジョブが抜けることはありません。ジョブの一時停止と再開はスイッチで行えます。
Webhook
Webhookは、サイトで何かが起きた瞬間に別のツールへ知らせます。イベントは3種類です。サイトが新しいバージョンを公開したとき、訪問者がフォームを送信したとき、データベースのレコードが追加、変更、削除されたときです。送信先のアドレスと、用途のメモを入力してください。
すべての配信には、一度だけ表示されるシークレットで署名が付くため、受信側のツールはプロジェクトから届いたものだと確認できます。受信側が停止している場合、Briksは再試行します。合計で最大5回、約30秒、2分、8分、32分の間隔をあけ、毎回同じ配信idを付けるので、重複は無視できます。
テストイベントを送って受信側を確認し、各配信の結果をスタジオで確かめ、必要なときに新しい署名シークレットを作成できます。古いシークレットはすぐに使えなくなります。
プランごとの上限
各プロジェクトで使えるジョブとWebhookは、Freeは各1つ、Starterは各5つ、Proは各10、Studioは各25、Agencyは各50です。
呼び出しは UTC の1日単位で数えます。ジョブの実行と配信の試行が、それぞれ1回の呼び出しです。1つのプロジェクトで1日に行える回数は、Free が2,000回、Starter が5,000回、Pro が10,000回、Studio が50,000回、Agency が100,000回です。
アドレスは公開されているものに限ります。プライベートネットワークのアドレスは、ジョブやWebhookの保存時に拒否され、呼び出しのたびに再確認されます。
使いみち
ジョブは、決まったスケジュールで行いたいことに向いています。たとえば、前日の問い合わせをまとめる朝のサマリー、古いレコードを整理する夜間の片付け、リストを更新する別ツールを週に一度呼び出す処理などです。
Webhookは、何かが変わった瞬間に動かしたい処理に向いています。たとえば、フォームが届いたら顧客リストに新しい行を追加する、新しいバージョンが公開されたらチームにメッセージを送る、レコードが変わったらカタログを更新する、といった使い方です。
ジョブはアドレスを呼び出すだけで、作業そのものは行いません。そのアドレスは存在し、応答する必要があります。ご自身のサイト内のパスでも、他のツールの公開アドレスでも構いません。
スケジュールジョブとWebhookの活用例
3つの事業の例と、それぞれの使い方です。サイトの画像は、例として作った事業向けに Briks が作ったサンプルで、お客様のサイトではありません。
- 01心理カウンセリング
平日朝のジョブ
ある診療所のサイトには専用の/api/パスがあり、前日の問い合わせの一覧をマネージャーに送ります。スケジュールされたジョブが、診療所のタイムゾーンで平日の8:00に呼び出し、春と秋の時計の切り替えがあっても時刻はずれません。
Calder Psychology は、心理カウンセリングの例として Briks が作ったサンプルサイトで、実在のお客様ではありません。 サンプルを開く - 02建設請負業
見積依頼を事務所のツールへ
建設会社が、フォーム受信時のWebhookを追加し、見積もり依頼を事務所で使っているスプレッドシートツールに送っています。そのツールが一時的に止まっていても、Briksは約40分間再試行を続けます。
Construction Pro は、建設請負業の例として Briks が作ったサンプルサイトで、実在のお客様ではありません。 サンプルを開く - 03サリーの店
最新の状態を保てるカタログ
サリーのお店では、商品コレクションをレコードとして管理しています。レコード変更のWebhookにより、サリーが追加されたときや価格が変わったときにカタログツールへ知らせが届きます。サイト公開のWebhookにより、新しいバージョンが公開されるたびにチームへ知らせが届きます。
Saree Shop は、サリーの店の例として Briks が作ったサンプルサイトで、実在のお客様ではありません。 サンプルを開く
得られるもの
- プロジェクトごとのジョブとwebhook:Freeは各1、Starterは各5、Proは各10、Studioは各25、Agencyは各50
- イベント：サイトの公開、フォームの受信、レコードの変更
- プリセットつきで、ご自分のタイムゾーンでスケジュール設定
- 署名付きの配信、最大5回まで再試行