クラウド基盤
自動化
トリガーに基づく自動化を構築できます。条件、分岐、遅延、再試行、カスタムトリガー、HTTPアクションに対応しています。
自動化は、注文の支払い完了、フォームの送信、特定の日時の到来、あるいは独自のシステムによるイベント報告など、何らかの事象が発生した際にステップを実行します。メール送信は、数あるアクションの一つに過ぎません。
コアオブジェクト
- トリガーとアクション: 各トリガーのデータと各アクションの入力に対するJSONスキーマを備えたカタログです。
- 自動化: 管理画面またはAPIを通じて構築される、条件、分岐、遅延、レート制限です。
- 実行: 再試行、失敗の詳細、再実行オプションを備えた、ステップごとの実行履歴です。
- カスタムトリガー:
POST /sites/{id}/automations/eventsを使用して独自のイベントを報告し、自動化を開始できます。
APIの活用方法
- Management APIを使用して、カタログの読み取り、自動化の作成・編集・テスト、実行履歴の読み取りや再試行が可能です。
automations.run.failedWebhookを使用すると、実行が失敗した際に通知を受け取ることができます。
API で利用できる範囲
- Automation engine: trigger/action catalog, owner-built flows, per-step runs, custom triggers提供中
- API
- Management API (REST/MCP)
automations.catalog.get,automations.templates.list,automations.flows.*(list/get/validate/create/update/set_status/archive/delete/test),automations.runs.*(list/get/rerun),automations.events.report/cancel,automations.triggers.*,automations.secrets.*; preinstalled toggles viaautomations.list/set_action_enabled; signed inbound endpointPOST /api/webhooks/automations/<token>(Standard Webhooks) - ホスト型サイト
/automations,/automations/settings- Webhooks
- Every trigger in the catalog is also a subscribable webhook event; custom triggers accept signed inbound webhooks (planned)
API リファレンス
Webhook イベント
- automations.run.failed · Fired when a run of an owner-built automation ends in FAILED after retries (compensation already applied). Not fired for test runs or platform-default automations; at most once per automation revision every 30 days.
- automations.flow.paused · Fired when Kanorio turns an owner-built automation off automatically because its current revision ran more than 20 times in the past 7 days and 95% or more of those runs failed.